@wix/auto_sdk_media_files 1.0.21 → 1.0.23

package/build/es/index.typings.d.mts

@@ -1013,8 +1013,9 @@ interface BulkImportFileResult {
 }
 interface ListFilesRequest {
     /**
-     * ID of the file's parent folder. <br />
-     * Default:`media-root`.
+     * ID of the file's parent folder.
+     *
+     * Default: `media-root`.
      * @maxLength 100
      */
     parentFolderId?: string | null;
@@ -1023,13 +1024,22 @@ interface ListFilesRequest {
      * @maxSize 30
      */
     mediaTypes?: MediaTypeWithLiterals[];
-    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)). */
+    /**
+     * Whether to return only private or only public files.
+     * + `true`: Returns only private files.
+     * + `false`: Returns only public files.
+     * + `undefined`: Returns public and private files.
+     *
+     * Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)).
+     */
     private?: boolean | null;
     /**
-     * Field name and order to sort by. One of: <br />
-     * * `displayName`
-     * * `updatedDate`
-     * * `sizeInBytes`
+     * Field name and order to sort by. One of:
+     *
+     * `displayName`
+     * `updatedDate`
+     * `sizeInBytes`
+     *
      * Default: `updatedDate` in `desc` order.
      */
     sort?: Sorting;
@@ -1090,14 +1100,17 @@ interface Cursors {
 }
 interface SearchFilesRequest {
     /**
-     * Term to search for. Possible terms include the value of a file's
-     * `displayName`, `mimeType`, and `label`. <br />
-     * For example, if a file's label is cat, the search term is 'cat'.
+     * Free text to match in searchable fields.
+     *
+     * For example, search for specific values in a file's
+     * `displayName`, `mimeType`, or `label`.
      * @maxLength 200
      */
     search?: string | null;
     /**
-     * A root folder in the media manager to search in. <br />
+     * The root folder in the media manager to search in.
+     * For more information, see Root Folders in Terminology ([SDK](https://dev.wix.com/docs/sdk/backend-modules/media/introduction#terminology) | [REST](https://dev.wix.com/docs/rest/assets/media/media-manager/introduction#terminology)).
+     *
      * Default: `MEDIA_ROOT`.
      */
     rootFolder?: RootFolderWithLiterals;
@@ -1106,13 +1119,23 @@ interface SearchFilesRequest {
      * @maxSize 30
      */
     mediaTypes?: MediaTypeWithLiterals[];
-    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)). */
+    /**
+     * Whether to return only private or only public files.
+     * + `true`: Returns only private files.
+     * + `false`: Returns only public files.
+     * + `undefined`: Returns public and private files.
+     *
+     * Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)).
+     */
     private?: boolean | null;
     /**
-     * Field name and order to sort by. One of: <br />
-     * * `displayName`
-     * * `updatedDate`
-     * * `sizeInBytes`
+     * Field name and order to sort by.
+     *
+     * One of:
+     * `displayName`
+     * `updatedDate`
+     * `sizeInBytes`
+     *
      * Default: `updatedDate` in `desc` order.
      */
     sort?: Sorting;
@@ -1120,18 +1143,20 @@ interface SearchFilesRequest {
     paging?: CursorPaging;
 }
 declare enum RootFolder {
-    /** Root of all site media */
+    /** Contains all files and folders in the Media Manager's **Site Files** tab in the UI. */
     MEDIA_ROOT = "MEDIA_ROOT",
-    /** Root of the trash system folder */
+    /** Contains all files and folders in the Media Manager's **Trash** tab in the UI. */
     TRASH_ROOT = "TRASH_ROOT",
-    /** Root of all visitor uploads */
+    /** Contains all files and folders created by site visitors or members. */
     VISITOR_UPLOADS_ROOT = "VISITOR_UPLOADS_ROOT"
 }
 /** @enumType */
 type RootFolderWithLiterals = RootFolder | 'MEDIA_ROOT' | 'TRASH_ROOT' | 'VISITOR_UPLOADS_ROOT';
 interface SearchFilesResponse {
     /**
-     * Files matching the query.
+     * Retrieved files that match the search criteria specified in the request.
+     *
+     * Each file includes all standard file information.
      * @maxSize 200
      */
     files?: FileDescriptor[];
@@ -1448,18 +1473,23 @@ declare enum WebhookIdentityType {
 }
 /** @enumType */
 type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
+/** @docsIgnore */
 type GenerateFileDownloadUrlValidationErrors = {
     ruleName?: 'INVALID_ASSET_KEY';
 };
+/** @docsIgnore */
 type GetFileDescriptorValidationErrors = {
     ruleName?: 'RESOURCE_NOT_FOUND';
 };
+/** @docsIgnore */
 type GetFileDescriptorsValidationErrors = {
     ruleName?: 'RESOURCE_NOT_FOUND';
 };
+/** @docsIgnore */
 type UpdateFileDescriptorValidationErrors = {
     ruleName?: 'FIELD_MASK_IS_EMPTY_OR_MISSING';
 };
+/** @docsIgnore */
 type GenerateFileUploadUrlValidationErrors = {
     ruleName?: 'MISMATCH_MIME_TYPE';
 } | {
@@ -1471,6 +1501,7 @@ type GenerateFileUploadUrlValidationErrors = {
 } | {
     ruleName?: 'SITE_QUOTA_EXCEEDED';
 };
+/** @docsIgnore */
 type GenerateFileResumableUploadUrlValidationErrors = {
     ruleName?: 'MISMATCH_MIME_TYPE';
 } | {
@@ -1480,19 +1511,23 @@ type GenerateFileResumableUploadUrlValidationErrors = {
 } | {
     ruleName?: 'FILE_SIZE_OVER_LIMIT';
 };
+/** @docsIgnore */
 type ImportFileValidationErrors = {
     ruleName?: 'SITE_QUOTA_EXCEEDED';
 };
+/** @docsIgnore */
 type ListFilesValidationErrors = {
     ruleName?: 'UNSUPPORTED_MEDIA_TYPE';
 } | {
     ruleName?: 'UNSUPPORTED_SORT_VALUE';
 };
+/** @docsIgnore */
 type SearchFilesValidationErrors = {
     ruleName?: 'UNSUPPORTED_MEDIA_TYPE';
 } | {
     ruleName?: 'UNSUPPORTED_SORT_VALUE';
 };
+/** @docsIgnore */
 type ListDeletedFilesValidationErrors = {
     ruleName?: 'UNSUPPORTED_MEDIA_TYPE';
 } | {
@@ -1563,6 +1598,8 @@ interface FileDescriptorDeletedEnvelope {
  * @permissionScopeId SCOPE.DC-MEDIA.MANAGE-MEDIAMANAGER
  * @permissionScope Manage Portfolio
  * @permissionScopeId SCOPE.PORTFOLIO.MANAGE-PORTFOLIO
+ * @permissionScope View SEO Settings
+ * @permissionScopeId SCOPE.PROMOTE.VIEW-SEO
  * @permissionScope Manage Blog
  * @permissionScopeId SCOPE.BLOG.MANAGE-BLOG
  * @permissionScope Access Verticals by Automations
@@ -1598,6 +1635,8 @@ interface FileDescriptorFileFailedEnvelope {
  * @permissionScopeId SCOPE.DC-MEDIA.MANAGE-MEDIAMANAGER
  * @permissionScope Manage Portfolio
  * @permissionScopeId SCOPE.PORTFOLIO.MANAGE-PORTFOLIO
+ * @permissionScope View SEO Settings
+ * @permissionScopeId SCOPE.PROMOTE.VIEW-SEO
  * @permissionScope Manage Blog
  * @permissionScopeId SCOPE.BLOG.MANAGE-BLOG
  * @permissionScope Access Verticals by Automations
@@ -1635,6 +1674,8 @@ interface FileDescriptorFileReadyEnvelope {
  * @permissionScopeId SCOPE.DC-MEDIA.MANAGE-MEDIAMANAGER
  * @permissionScope Manage Portfolio
  * @permissionScopeId SCOPE.PORTFOLIO.MANAGE-PORTFOLIO
+ * @permissionScope View SEO Settings
+ * @permissionScopeId SCOPE.PROMOTE.VIEW-SEO
  * @permissionScope Manage Blog
  * @permissionScopeId SCOPE.BLOG.MANAGE-BLOG
  * @permissionScope Access Verticals by Automations
@@ -1670,6 +1711,8 @@ interface FileDescriptorUpdatedEnvelope {
  * @permissionScopeId SCOPE.DC-MEDIA.MANAGE-MEDIAMANAGER
  * @permissionScope Manage Portfolio
  * @permissionScopeId SCOPE.PORTFOLIO.MANAGE-PORTFOLIO
+ * @permissionScope View SEO Settings
+ * @permissionScopeId SCOPE.PROMOTE.VIEW-SEO
  * @permissionScope Manage Blog
  * @permissionScopeId SCOPE.BLOG.MANAGE-BLOG
  * @permissionScope Access Verticals by Automations
@@ -1685,7 +1728,6 @@ interface FileDescriptorUpdatedEnvelope {
  * @slug updated
  */
 declare function onFileDescriptorUpdated(handler: (event: FileDescriptorUpdatedEnvelope) => void | Promise<void>): void;
-type FileDescriptorNonNullablePaths = `_id` | `displayName` | `url` | `hash` | `private` | `mediaType` | `media.image.colors.palette` | `media.image.faces` | `media.image.faces.${number}.confidence` | `media.image.faces.${number}.x` | `media.image.faces.${number}.y` | `media.image.faces.${number}.height` | `media.image.faces.${number}.width` | `media.audio._id` | `media.audio.assets` | `media.archive._id` | `media.archive.url` | `media.model3d._id` | `media.model3d.url` | `operationStatus` | `labels` | `siteId` | `state`;
 /**
  * Generates a URL for downloading a compressed file containing specific files in the Media Manager.
  *
@@ -1704,7 +1746,7 @@ type FileDescriptorNonNullablePaths = `_id` | `displayName` | `url` | `hash` | `
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.GenerateFilesDownloadUrl
  */
-declare function generateFilesDownloadUrl(fileIds: string[]): Promise<NonNullablePaths<GenerateFilesDownloadUrlResponse, `downloadUrl`>>;
+declare function generateFilesDownloadUrl(fileIds: string[]): Promise<NonNullablePaths<GenerateFilesDownloadUrlResponse, `downloadUrl`, 2>>;
 /**
  * Generates one or more temporary URLs for downloading a specific file in the Media Manager.
  *
@@ -1727,7 +1769,7 @@ declare function generateFilesDownloadUrl(fileIds: string[]): Promise<NonNullabl
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.GenerateFileDownloadUrl
  */
-declare function generateFileDownloadUrl(fileId: string, options?: GenerateFileDownloadUrlOptions): Promise<NonNullablePaths<GenerateFileDownloadUrlResponse, `downloadUrls` | `downloadUrls.${number}.url` | `downloadUrls.${number}.assetKey`> & {
+declare function generateFileDownloadUrl(fileId: string, options?: GenerateFileDownloadUrlOptions): Promise<NonNullablePaths<GenerateFileDownloadUrlResponse, `downloadUrls` | `downloadUrls.${number}.url` | `downloadUrls.${number}.assetKey`, 4> & {
     __validationErrorsType?: GenerateFileDownloadUrlValidationErrors;
 }>;
 interface GenerateFileDownloadUrlOptions {
@@ -1781,7 +1823,7 @@ interface GenerateFileDownloadUrlOptions {
  * @returns Information about the file.
  * @fqn com.wix.media.site_media.v1.FilesService.GetFileDescriptor
  */
-declare function getFileDescriptor(fileId: string): Promise<NonNullablePaths<FileDescriptor, FileDescriptorNonNullablePaths> & {
+declare function getFileDescriptor(fileId: string): Promise<NonNullablePaths<FileDescriptor, `_id` | `displayName` | `url` | `hash` | `private` | `mediaType` | `media.image.colors.palette` | `media.image.faces` | `media.image.faces.${number}.confidence` | `media.image.faces.${number}.x` | `media.image.faces.${number}.y` | `media.image.faces.${number}.height` | `media.image.faces.${number}.width` | `media.audio._id` | `media.audio.assets` | `media.archive._id` | `media.archive.url` | `media.model3d._id` | `media.model3d.url` | `operationStatus` | `labels` | `siteId` | `state`, 6> & {
     __validationErrorsType?: GetFileDescriptorValidationErrors;
 }>;
 /**
@@ -1796,9 +1838,7 @@ declare function getFileDescriptor(fileId: string): Promise<NonNullablePaths<Fil
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.GetFileDescriptors
  */
-declare function getFileDescriptors(fileIds: string[]): Promise<NonNullablePaths<GetFileDescriptorsResponse, {
-    [P in FileDescriptorNonNullablePaths]: `files.${number}.${P}`;
-}[FileDescriptorNonNullablePaths]> & {
+declare function getFileDescriptors(fileIds: string[]): Promise<NonNullablePaths<GetFileDescriptorsResponse, `files` | `files.${number}._id` | `files.${number}.displayName` | `files.${number}.url` | `files.${number}.hash` | `files.${number}.private` | `files.${number}.mediaType` | `files.${number}.media.audio._id` | `files.${number}.media.archive._id` | `files.${number}.media.archive.url` | `files.${number}.media.model3d._id` | `files.${number}.media.model3d.url` | `files.${number}.operationStatus` | `files.${number}.siteId` | `files.${number}.state`, 6> & {
     __validationErrorsType?: GetFileDescriptorsValidationErrors;
 }>;
 /**
@@ -1814,7 +1854,7 @@ declare function getFileDescriptors(fileIds: string[]): Promise<NonNullablePaths
  * @returns Information about the updated file.
  * @fqn com.wix.media.site_media.v1.FilesService.UpdateFileDescriptor
  */
-declare function updateFileDescriptor(file: NonNullablePaths<FileDescriptor, `_id`>): Promise<NonNullablePaths<FileDescriptor, FileDescriptorNonNullablePaths> & {
+declare function updateFileDescriptor(file: NonNullablePaths<FileDescriptor, `_id`, 2>): Promise<NonNullablePaths<FileDescriptor, `_id` | `displayName` | `url` | `hash` | `private` | `mediaType` | `media.image.colors.palette` | `media.image.faces` | `media.image.faces.${number}.confidence` | `media.image.faces.${number}.x` | `media.image.faces.${number}.y` | `media.image.faces.${number}.height` | `media.image.faces.${number}.width` | `media.audio._id` | `media.audio.assets` | `media.archive._id` | `media.archive.url` | `media.model3d._id` | `media.model3d.url` | `operationStatus` | `labels` | `siteId` | `state`, 6> & {
     __validationErrorsType?: UpdateFileDescriptorValidationErrors;
 }>;
 /**
@@ -1832,7 +1872,7 @@ declare function updateFileDescriptor(file: NonNullablePaths<FileDescriptor, `_i
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.GenerateFileUploadUrl
  */
-declare function generateFileUploadUrl(mimeType: string, options?: GenerateFileUploadUrlOptions): Promise<NonNullablePaths<GenerateFileUploadUrlResponse, `uploadUrl`> & {
+declare function generateFileUploadUrl(mimeType: string, options?: GenerateFileUploadUrlOptions): Promise<NonNullablePaths<GenerateFileUploadUrlResponse, `uploadUrl`, 2> & {
     __validationErrorsType?: GenerateFileUploadUrlValidationErrors;
 }>;
 interface GenerateFileUploadUrlOptions {
@@ -1890,7 +1930,7 @@ interface GenerateFileUploadUrlOptions {
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.GenerateFileResumableUploadUrl
  */
-declare function generateFileResumableUploadUrl(mimeType: string, options?: GenerateFileResumableUploadUrlOptions): Promise<NonNullablePaths<GenerateFileResumableUploadUrlResponse, `uploadProtocol` | `uploadUrl` | `uploadToken`> & {
+declare function generateFileResumableUploadUrl(mimeType: string, options?: GenerateFileResumableUploadUrlOptions): Promise<NonNullablePaths<GenerateFileResumableUploadUrlResponse, `uploadProtocol` | `uploadUrl` | `uploadToken`, 2> & {
     __validationErrorsType?: GenerateFileResumableUploadUrlValidationErrors;
 }>;
 interface GenerateFileResumableUploadUrlOptions {
@@ -1957,9 +1997,7 @@ interface GenerateFileResumableUploadUrlOptions {
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.ImportFile
  */
-declare function importFile(url: string, options?: ImportFileOptions): Promise<NonNullablePaths<ImportFileResponse, {
-    [P in FileDescriptorNonNullablePaths]: `file.${P}`;
-}[FileDescriptorNonNullablePaths]> & {
+declare function importFile(url: string, options?: ImportFileOptions): Promise<NonNullablePaths<ImportFileResponse, `file._id` | `file.displayName` | `file.url` | `file.hash` | `file.private` | `file.mediaType` | `file.media.image.colors.palette` | `file.media.image.faces` | `file.media.image.faces.${number}.confidence` | `file.media.image.faces.${number}.x` | `file.media.image.faces.${number}.y` | `file.media.image.faces.${number}.height` | `file.media.image.faces.${number}.width` | `file.media.audio._id` | `file.media.audio.assets` | `file.media.archive._id` | `file.media.archive.url` | `file.media.model3d._id` | `file.media.model3d.url` | `file.operationStatus` | `file.labels` | `file.siteId` | `file.state`, 7> & {
     __validationErrorsType?: ImportFileValidationErrors;
 }>;
 interface ImportFileOptions {
@@ -2037,9 +2075,7 @@ interface ImportFileOptions {
  * @replacedBy com.wix.media.site_media.v1.FilesService.BulkImportFile
  * @targetRemovalDate 2024-03-31
  */
-declare function bulkImportFiles(importFileRequests: NonNullablePaths<ImportFileRequest, `url`>[]): Promise<NonNullablePaths<BulkImportFilesResponse, {
-    [P in FileDescriptorNonNullablePaths]: `files.${number}.${P}`;
-}[FileDescriptorNonNullablePaths]>>;
+declare function bulkImportFiles(importFileRequests: NonNullablePaths<ImportFileRequest, `url`, 2>[]): Promise<NonNullablePaths<BulkImportFilesResponse, `files` | `files.${number}._id` | `files.${number}.displayName` | `files.${number}.url` | `files.${number}.hash` | `files.${number}.private` | `files.${number}.mediaType` | `files.${number}.media.audio._id` | `files.${number}.media.archive._id` | `files.${number}.media.archive.url` | `files.${number}.media.model3d._id` | `files.${number}.media.model3d.url` | `files.${number}.operationStatus` | `files.${number}.siteId` | `files.${number}.state`, 6>>;
 /**
  * Imports a bulk of files to the Media Manager using external urls. <br/>
  *
@@ -2066,9 +2102,7 @@ declare function bulkImportFiles(importFileRequests: NonNullablePaths<ImportFile
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.BulkImportFile
  */
-declare function bulkImportFile(importFileRequests: NonNullablePaths<ImportFileRequest, `url`>[], options?: BulkImportFileOptions): Promise<NonNullablePaths<BulkImportFileResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | {
-    [P in FileDescriptorNonNullablePaths]: `results.${number}.item.${P}`;
-}[FileDescriptorNonNullablePaths] | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
+declare function bulkImportFile(importFileRequests: NonNullablePaths<ImportFileRequest, `url`, 2>[], options?: BulkImportFileOptions): Promise<NonNullablePaths<BulkImportFileResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item._id` | `results.${number}.item.displayName` | `results.${number}.item.url` | `results.${number}.item.hash` | `results.${number}.item.private` | `results.${number}.item.mediaType` | `results.${number}.item.operationStatus` | `results.${number}.item.siteId` | `results.${number}.item.state` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
 interface BulkImportFileOptions {
     /** Default: `true` */
     returnEntity?: boolean | null;
@@ -2083,15 +2117,14 @@ interface BulkImportFileOptions {
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.ListFiles
  */
-declare function listFiles(options?: ListFilesOptions): Promise<NonNullablePaths<ListFilesResponse, {
-    [P in FileDescriptorNonNullablePaths]: `files.${number}.${P}`;
-}[FileDescriptorNonNullablePaths]> & {
+declare function listFiles(options?: ListFilesOptions): Promise<NonNullablePaths<ListFilesResponse, `files` | `files.${number}._id` | `files.${number}.displayName` | `files.${number}.url` | `files.${number}.hash` | `files.${number}.private` | `files.${number}.mediaType` | `files.${number}.media.audio._id` | `files.${number}.media.archive._id` | `files.${number}.media.archive.url` | `files.${number}.media.model3d._id` | `files.${number}.media.model3d.url` | `files.${number}.operationStatus` | `files.${number}.siteId` | `files.${number}.state`, 6> & {
     __validationErrorsType?: ListFilesValidationErrors;
 }>;
 interface ListFilesOptions {
     /**
-     * ID of the file's parent folder. <br />
-     * Default:`media-root`.
+     * ID of the file's parent folder.
+     *
+     * Default: `media-root`.
      * @maxLength 100
      */
     parentFolderId?: string | null;
@@ -2100,13 +2133,22 @@ interface ListFilesOptions {
      * @maxSize 30
      */
     mediaTypes?: MediaTypeWithLiterals[];
-    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)). */
+    /**
+     * Whether to return only private or only public files.
+     * + `true`: Returns only private files.
+     * + `false`: Returns only public files.
+     * + `undefined`: Returns public and private files.
+     *
+     * Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)).
+     */
     private?: boolean | null;
     /**
-     * Field name and order to sort by. One of: <br />
-     * * `displayName`
-     * * `updatedDate`
-     * * `sizeInBytes`
+     * Field name and order to sort by. One of:
+     *
+     * `displayName`
+     * `updatedDate`
+     * `sizeInBytes`
+     *
      * Default: `updatedDate` in `desc` order.
      */
     sort?: Sorting;
@@ -2114,30 +2156,49 @@ interface ListFilesOptions {
     paging?: CursorPaging;
 }
 /**
- * Searches all folders in the Media Manager and returns a list of files that match the terms specified in the parameters. <br/>
+ * Retrieves a list of up to 200 files with the specified filtering, sorting, and cursor paging.
+ *
+ * If no parameters are specified, the method returns all files in the `MEDIA_ROOT` folder.
+ *
+ * ## Defaults
+ *
+ * Search Files has the following default setting, which you can override:
+ * + Sorted by `updatedDate` in descending order.
+ *
+ * ## Filters
  *
- * If no parameters are specified, the endpoint returns all files in the `MEDIA_ROOT` folder.
+ * When using filters for dates, you must use
+ * [UTC time](https://en.wikipedia.org/wiki/Coordinated_Universal_Time).
+ *
+ * ## See also
+ *
+ * To learn about working with *Search* methods, see
+ * _API Query Language_
+ * ([SDK](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/api-query-language) | [REST](https://dev.wix.com/docs/rest/articles/get-started/api-query-language))
+ * and *Sorting and Paging*
+ * ([SDK](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/api-query-language#the-sort-array) | [REST](https://dev.wix.com/docs/rest/articles/get-started/sorting-and-paging)).
  * @public
  * @param options - Options to specify which folders to search.
  * @permissionId MEDIA.SITE_MEDIA_FILES_LIST
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.SearchFiles
  */
-declare function searchFiles(options?: SearchFilesOptions): Promise<NonNullablePaths<SearchFilesResponse, {
-    [P in FileDescriptorNonNullablePaths]: `files.${number}.${P}`;
-}[FileDescriptorNonNullablePaths]> & {
+declare function searchFiles(options?: SearchFilesOptions): Promise<NonNullablePaths<SearchFilesResponse, `files` | `files.${number}._id` | `files.${number}.displayName` | `files.${number}.url` | `files.${number}.hash` | `files.${number}.private` | `files.${number}.mediaType` | `files.${number}.media.audio._id` | `files.${number}.media.archive._id` | `files.${number}.media.archive.url` | `files.${number}.media.model3d._id` | `files.${number}.media.model3d.url` | `files.${number}.operationStatus` | `files.${number}.siteId` | `files.${number}.state`, 6> & {
     __validationErrorsType?: SearchFilesValidationErrors;
 }>;
 interface SearchFilesOptions {
     /**
-     * Term to search for. Possible terms include the value of a file's
-     * `displayName`, `mimeType`, and `label`. <br />
-     * For example, if a file's label is cat, the search term is 'cat'.
+     * Free text to match in searchable fields.
+     *
+     * For example, search for specific values in a file's
+     * `displayName`, `mimeType`, or `label`.
      * @maxLength 200
      */
     search?: string | null;
     /**
-     * A root folder in the media manager to search in. <br />
+     * The root folder in the media manager to search in.
+     * For more information, see Root Folders in Terminology ([SDK](https://dev.wix.com/docs/sdk/backend-modules/media/introduction#terminology) | [REST](https://dev.wix.com/docs/rest/assets/media/media-manager/introduction#terminology)).
+     *
      * Default: `MEDIA_ROOT`.
      */
     rootFolder?: RootFolderWithLiterals;
@@ -2146,13 +2207,23 @@ interface SearchFilesOptions {
      * @maxSize 30
      */
     mediaTypes?: MediaTypeWithLiterals[];
-    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)). */
+    /**
+     * Whether to return only private or only public files.
+     * + `true`: Returns only private files.
+     * + `false`: Returns only public files.
+     * + `undefined`: Returns public and private files.
+     *
+     * Learn more about private files ([SDK](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files) | [REST](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files)).
+     */
     private?: boolean | null;
     /**
-     * Field name and order to sort by. One of: <br />
-     * * `displayName`
-     * * `updatedDate`
-     * * `sizeInBytes`
+     * Field name and order to sort by.
+     *
+     * One of:
+     * `displayName`
+     * `updatedDate`
+     * `sizeInBytes`
+     *
      * Default: `updatedDate` in `desc` order.
      */
     sort?: Sorting;
@@ -2174,7 +2245,7 @@ interface SearchFilesOptions {
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.GenerateVideoStreamingUrl
  */
-declare function generateVideoStreamingUrl(fileId: string, options?: GenerateVideoStreamingUrlOptions): Promise<NonNullablePaths<GenerateVideoStreamingUrlResponse, `downloadUrl.url` | `downloadUrl.assetKey`>>;
+declare function generateVideoStreamingUrl(fileId: string, options?: GenerateVideoStreamingUrlOptions): Promise<NonNullablePaths<GenerateVideoStreamingUrlResponse, `downloadUrl.url` | `downloadUrl.assetKey`, 3>>;
 interface GenerateVideoStreamingUrlOptions {
     /** Video stream format. */
     format?: StreamFormatWithLiterals;
@@ -2232,9 +2303,7 @@ declare function bulkRestoreFilesFromTrashBin(fileIds: string[]): Promise<void>;
  * @applicableIdentity APP
  * @fqn com.wix.media.site_media.v1.FilesService.ListDeletedFiles
  */
-declare function listDeletedFiles(options?: ListDeletedFilesOptions): Promise<NonNullablePaths<ListDeletedFilesResponse, {
-    [P in FileDescriptorNonNullablePaths]: `files.${number}.${P}`;
-}[FileDescriptorNonNullablePaths]> & {
+declare function listDeletedFiles(options?: ListDeletedFilesOptions): Promise<NonNullablePaths<ListDeletedFilesResponse, `files` | `files.${number}._id` | `files.${number}.displayName` | `files.${number}.url` | `files.${number}.hash` | `files.${number}.private` | `files.${number}.mediaType` | `files.${number}.media.audio._id` | `files.${number}.media.archive._id` | `files.${number}.media.archive.url` | `files.${number}.media.model3d._id` | `files.${number}.media.model3d.url` | `files.${number}.operationStatus` | `files.${number}.siteId` | `files.${number}.state`, 6> & {
     __validationErrorsType?: ListDeletedFilesValidationErrors;
 }>;
 interface ListDeletedFilesOptions {