@wix/auto_sdk_media_files 1.0.22 → 1.0.24

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

@@ -428,35 +428,39 @@ declare enum State {
 /** @enumType */
 type StateWithLiterals = State | 'OK' | 'DELETED';
 declare enum Namespace {
+    /** No namespaces */
     NO_NAMESPACE = "NO_NAMESPACE",
+    /** Custom namespace */
     OTHERS = "OTHERS",
-    /** ANY = 2; */
+    /** Wix videos */
     WIX_VIDEO = "WIX_VIDEO",
-    /** _nsWixMusic */
+    /** Wix music */
     WIX_MUSIC = "WIX_MUSIC",
-    /** _nsArtStore */
+    /** Albums and art store */
     ALBUMS_AND_ART_STORE = "ALBUMS_AND_ART_STORE",
-    /** _nsDigitalProduct */
+    /** Wix ecom */
     WIX_ECOM = "WIX_ECOM",
-    /** _nsPhotoShareApp */
+    /** Photo share */
     PHOTO_SHARE_APP = "PHOTO_SHARE_APP",
-    /** _nsSharingApp, */
+    /** Sharing app */
     SHARING_APP = "SHARING_APP",
-    /** engage */
+    /** Chat (engage) */
     CHAT = "CHAT",
-    /** logobuilder */
+    /** Logo builder */
     LOGO_BUILDER = "LOGO_BUILDER",
-    /** WixExposure */
+    /** Albums old namespace */
     ALBUMS_OLD = "ALBUMS_OLD",
-    /** chat-mobile-uploads */
+    /** Mobile chat */
     CHAT_MOBILE = "CHAT_MOBILE",
-    /** _nsWixForms */
+    /** Wix Forms */
     WIX_FORMS = "WIX_FORMS",
-    /** _nsWixLegends */
-    WIX_LEGENDS = "WIX_LEGENDS"
+    /** Wix legends */
+    WIX_LEGENDS = "WIX_LEGENDS",
+    /** Portfolio */
+    PORTFOLIO = "PORTFOLIO"
 }
 /** @enumType */
-type NamespaceWithLiterals = Namespace | 'NO_NAMESPACE' | 'OTHERS' | 'WIX_VIDEO' | 'WIX_MUSIC' | 'ALBUMS_AND_ART_STORE' | 'WIX_ECOM' | 'PHOTO_SHARE_APP' | 'SHARING_APP' | 'CHAT' | 'LOGO_BUILDER' | 'ALBUMS_OLD' | 'CHAT_MOBILE' | 'WIX_FORMS' | 'WIX_LEGENDS';
+type NamespaceWithLiterals = Namespace | 'NO_NAMESPACE' | 'OTHERS' | 'WIX_VIDEO' | 'WIX_MUSIC' | 'ALBUMS_AND_ART_STORE' | 'WIX_ECOM' | 'PHOTO_SHARE_APP' | 'SHARING_APP' | 'CHAT' | 'LOGO_BUILDER' | 'ALBUMS_OLD' | 'CHAT_MOBILE' | 'WIX_FORMS' | 'WIX_LEGENDS' | 'PORTFOLIO';
 interface IdentityInfo {
     /** The type of the user that uploaded the file */
     identityType?: IdentityTypeWithLiterals;
@@ -1013,8 +1017,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 +1028,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 +1104,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 +1123,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 +1147,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 +1477,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 +1505,7 @@ type GenerateFileUploadUrlValidationErrors = {
 } | {
     ruleName?: 'SITE_QUOTA_EXCEEDED';
 };
+/** @docsIgnore */
 type GenerateFileResumableUploadUrlValidationErrors = {
     ruleName?: 'MISMATCH_MIME_TYPE';
 } | {
@@ -1480,19 +1515,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';
 } | {
@@ -2087,8 +2126,9 @@ declare function listFiles(options?: ListFilesOptions): Promise<NonNullablePaths
 }>;
 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;
@@ -2097,13 +2137,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;
@@ -2111,9 +2160,27 @@ 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
@@ -2125,14 +2192,17 @@ declare function searchFiles(options?: SearchFilesOptions): Promise<NonNullableP
 }>;
 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;
@@ -2141,13 +2211,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;

package/build/es/index.typings.mjs

@@ -1022,6 +1022,7 @@ var Namespace = /* @__PURE__ */ ((Namespace2) => {
   Namespace2["CHAT_MOBILE"] = "CHAT_MOBILE";
   Namespace2["WIX_FORMS"] = "WIX_FORMS";
   Namespace2["WIX_LEGENDS"] = "WIX_LEGENDS";
+  Namespace2["PORTFOLIO"] = "PORTFOLIO";
   return Namespace2;
 })(Namespace || {});
 var IdentityType = /* @__PURE__ */ ((IdentityType2) => {