@wix/bex-utils 2.30.0 → 2.31.0

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/folder.proto

@@ -0,0 +1,48 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+import "wix/api/validations.proto";
+import "google/protobuf/timestamp.proto";
+import "wix/api/entity.proto";
+import "wix/api/annotations.proto";
+import "com/wix/media/site_media/v1/namespace.proto";
+
+
+message Folder {
+  enum State {
+    OK = 0 ;
+    DELETED = 1;
+  }
+
+  //flynt-disable missing-extensible
+  option (.wix.api.entity) = {
+    fqdn: "wix.media.site_media.v1.folder"
+    segment: USERS
+    trashbin: false
+    app_def_id: "ad919edb-8ae2-403c-bef4-d5083b76d9e9"
+    domain_events_read_permission: "MEDIA.SITE_MEDIA_FOLDERS_READ"
+    appendix_files: {
+      type: DOCS_CONF,
+      path: "appendices/docs/folder"
+    }
+    appendix_files: {
+      type: AUTO_VELO
+      path: "appendices/velo/folder"
+    }
+  };
+  // Folder ID. Generated when a folder is created in the Media Manager.
+  string id = 1 [(.wix.api.readOnly) = false, (.wix.api.maxLength) = 100];
+  // Folder name as it appears in the Media Manager.
+  string display_name = 2 [(.wix.api.maxLength) = 256, (.wix.api.readOnly) = false];
+  // ID of the folder's parent folder. <br /> Default: `media-root` folder.
+  string parent_folder_id = 3  [(.wix.api.readOnly) = false, (.wix.api.maxLength) = 100];
+  // Date the folder was created.
+  google.protobuf.Timestamp created_date = 4 [(.wix.api.readOnly) = true];
+  // Date the folder was updated.
+  google.protobuf.Timestamp updated_date = 5 [(.wix.api.readOnly) = true];
+  // State of the folder.
+  State state = 6 [(.wix.api.readOnly) = true];
+  // The namespace of the folder
+  Namespace namespace = 7 [(.wix.api.field_exposure) = INTERNAL, (.wix.api.readOnly) = false];
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/folders_service.proto

@@ -0,0 +1,367 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+import "wix/api/validations.proto";
+import "wix/api/permissions.proto";
+import "wix/api/annotations.proto";
+import "google/api/annotations.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/wrappers.proto";
+import "com/wix/media/site_media/v1/folder.proto";
+import "com/wix/media/site_media/v1/root_folders.proto";
+import "wix/api/entity.proto";
+import "com/wix/media/site_media/upstream/wix/common/paging.proto";
+import "wix/api/callback.proto";
+import "wix/common/sorting.proto";
+import "wix/http/field_mask.proto";
+import "wix/api/api_errors.proto";
+import "wix/sdk/definitions.proto";
+import "com/wix/media/site_media/v1/namespace.proto";
+
+
+
+
+message CreateFolderRequest {
+    // Folder name that appears in the Media Manager.
+    string display_name = 1 [(.wix.api.maxLength) = 200];
+    // ID of the folder's parent folder.
+    google.protobuf.StringValue parent_folder_id = 2 [(.wix.api.maxLength) = 100];
+
+    // The namespace this folder will be created under
+    google.protobuf.StringValue raw_namespace = 3 [(.wix.api.field_exposure) = INTERNAL, (.wix.api.maxLength) = 100];
+
+    // The namespace this folder will be created under
+    // Note - Namespace value `Others` is not supported and will produce an error
+    Namespace namespace = 4 [(.wix.api.field_exposure) = INTERNAL];
+}
+
+message CreateFolderResponse {
+    // Information about the newly created folder.
+    Folder folder = 1;
+}
+
+
+message GetFolderRequest {
+    // Folder ID.
+    string folder_id = 1 [(.wix.api.maxLength) = 100];
+}
+
+message GetFolderResponse {
+    // Information about the folder.
+    Folder folder = 1;
+}
+
+
+message GetFoldersRequest {
+    // A list of folder ids
+    repeated string folder_ids = 1  [(.wix.api.maxSize) = 199, (.wix.api.maxLength) = 100];
+}
+
+message GetFoldersResponse {
+    // The information for the requested folders
+    repeated Folder folders = 1  [(.wix.api.maxSize) = 200];
+}
+
+
+message ListFoldersRequest {
+    // ID of the folder's parent folder. 
+    // <br /> Default: `media-root` folder. 
+    google.protobuf.StringValue parent_folder_id = 1 [(.wix.api.maxLength) = 100];
+    // Field name and order to sort by. One of: <br />
+    // * `displayName` 
+    // * `updatedDate`
+    // Default: `updatedDate` in `desc` order.
+    .wix.common.Sorting sort = 2;
+    // Cursor and paging information.
+    com.wix.media.site_media.upstream.wix.common.CursorPaging paging = 3;
+    // List folders of the specified namespace
+    google.protobuf.StringValue raw_namespace = 4 [(.wix.api.field_exposure) = INTERNAL, (.wix.api.maxLength) = 100];
+
+    // List folders of the specified namespace
+    // Note - Namespace value `Others` is not supported and will produce an error
+    Namespace namespace = 5 [(.wix.api.field_exposure) = INTERNAL];
+}
+
+message ListFoldersResponse {
+    // Information about the folders in the requested folder.
+    repeated Folder folders = 1  [(.wix.api.maxSize) = 200];
+    // The next cursor if it exists.
+    com.wix.media.site_media.upstream.wix.common.PagingMetadataV2 next_cursor = 2;
+}
+
+
+message SearchFoldersRequest {
+    // A root folder in the media manager to search in. <br />
+    // Default: `MEDIA_ROOT`.
+    RootFolder root_folder = 1;
+    // Field name and order to sort by. One of: <br />
+    // * `displayName` 
+    // * `updatedDate`
+    // Default: `updatedDate` in `desc` order.
+    .wix.common.Sorting sort = 2;
+    // Cursor and paging information.
+    com.wix.media.site_media.upstream.wix.common.CursorPaging paging = 3;
+
+    // Term to search for, such as the value of a folder's `displayName`. <br />
+    // For example, if a folder's `displayName` is 'my-videos-folder', the search term is 'my-videos-folder'.
+    google.protobuf.StringValue search = 4 [(.wix.api.maxLength) = 200];
+
+    // Search folders of the specified namespace
+    google.protobuf.StringValue raw_namespace = 5 [(.wix.api.field_exposure) = INTERNAL, (.wix.api.maxLength) = 100];
+
+    // Search folders of the specified namespace
+    // Note - Namespace value `Others` is not supported and will produce an error
+    Namespace namespace = 6 [(.wix.api.field_exposure) = INTERNAL];
+}
+
+message SearchFoldersResponse {
+    // Information about the folders in the requested folder.
+    repeated Folder folders = 1  [(.wix.api.maxSize) = 200];
+    // The next cursor if it exists.
+    com.wix.media.site_media.upstream.wix.common.PagingMetadataV2 next_cursor = 2;
+}
+
+
+
+message UpdateFolderRequest {
+    // ID of the folder to update.
+//    string folder_id = 1 [(.wix.api.field_deprecated) = {
+//        replaced_by: "folder"
+//        target_removal_date: "2023-02-25"
+//    }];
+    reserved 1;
+
+    // Folder name that appears in the Media Manager.
+//    google.protobuf.StringValue display_name = 2 [(.wix.api.field_deprecated) = {
+//        replaced_by: "folder"
+//        target_removal_date: "2023-02-25"
+//    }];
+    reserved 2;
+    // ID of the folder's parent folder.
+//    google.protobuf.StringValue parent_folder_id = 3 [(.wix.api.field_deprecated) = {
+//        replaced_by: "folder"
+//        target_removal_date: "2023-02-25"
+//    }];
+     reserved 3;
+    // The folder to update.
+    Folder folder = 4;
+    // Set of fields to update. Fields that aren't included in `fieldMask.paths` are ignored. 
+    google.protobuf.FieldMask field_mask = 5 [(.wix.api.field_exposure) = INTERNAL];
+}
+
+message UpdateFolderResponse {
+    // Information about the updated folder.
+    Folder folder = 1;
+}
+
+
+message GenerateFolderDownloadUrlRequest {
+    // Folder ID.
+    string folder_id = 1 [(.wix.api.maxLength) = 100];
+}
+
+message GenerateFolderDownloadUrlResponse {
+    // URL for downloading a specific folder in the Media Manager.
+    string download_url = 1 [(.wix.api.format) = WEB_URL];
+}
+
+
+message BulkDeleteFoldersRequest {
+    // IDs of the folders to move to the Media Manager's trash bin. 
+    repeated string folder_ids = 1 [(.wix.api.maxSize) = 100, (.wix.api.maxLength) = 100];
+   
+   // Whether the specified folders are permanently deleted. <br />
+   // Default: `false`
+    bool permanent = 2;
+}
+
+message BulkDeleteFoldersResponse {
+}
+
+message BulkRestoreFoldersFromTrashBinRequest {
+    // IDs of the folders to restore from the Media Manager's trash bin. 
+    repeated string folder_ids = 1 [(.wix.api.maxSize) = 100, (.wix.api.maxLength) = 100];
+}
+
+message BulkRestoreFoldersFromTrashBinResponse {
+}
+
+message ListDeletedFoldersRequest {
+    // ID of the folder's parent folder.
+    google.protobuf.StringValue parent_folder_id = 1 [(.wix.api.maxLength) = 100];
+    // Field name and order to sort by. One of: <br />
+    // * `displayName` 
+    // * `updatedDate`
+    // Default: `updatedDate` in `desc` order.
+    .wix.common.Sorting sort = 2;
+    // Cursor and paging information.
+    com.wix.media.site_media.upstream.wix.common.CursorPaging paging = 3;
+    // List folders of the specified namespace
+    google.protobuf.StringValue raw_namespace = 4 [(.wix.api.field_exposure) = INTERNAL, (.wix.api.maxLength) = 100];
+
+    // List folders of the specified namespace
+    // Note - Namespace value `Others` is not supported and will produce an error
+    Namespace namespace = 5 [(.wix.api.field_exposure) = INTERNAL];
+}
+
+message ListDeletedFoldersResponse {
+    // List of folders in the Media Manager's trash bin.
+    repeated Folder folders = 1  [(.wix.api.maxSize) = 200];
+    // The next cursor if it exists.
+    .com.wix.media.site_media.upstream.wix.common.PagingMetadataV2 next_cursor = 2;
+}
+
+service FoldersService {
+    option (.wix.api.service_maturity) = GA;
+    option (.wix.api.service_exposure) = PUBLIC;
+    option (.wix.api.service_entity).message = "com.wix.media.site_media.v1.Folder";
+
+
+    // Creates a new folder in the Media Manager. <br/>
+    //
+    // Use the `parentFolderId` parameter to specify in which existing folder you want the new folder to be created. 
+    // If no folder is specified, the new folder is created in the `media-root` folder. 
+    rpc CreateFolder (CreateFolderRequest) returns (CreateFolderResponse) {
+        option (.wix.api.callback) = {
+            event_type: CREATED
+        };
+        option (google.api.http) = {post: "/v1/folders"};
+        option (.wix.api.required) = "CreateFolderRequest.display_name";
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_CREATE";
+        // cannot add CRUD annotations because we don't comply with the standard of the folder object+fieldMask
+
+    }
+
+    // Gets information from a specific folder in the Media Manager. 
+    rpc GetFolder (GetFolderRequest) returns (GetFolderResponse) {
+        option (.wix.api.required) = "GetFolderRequest.folder_id";
+        option (google.api.http) = {get: "/v1/folders/{folder_id}"};
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_READ";
+        option (.wix.api.crud) = {
+            method: GET_ITEM
+            get_options: {
+                id_field: "folder_id"
+                item_field: "folder"
+            }
+        };
+    }
+
+    // Retrieves a list of folders in the Media Manager. To retrieve a list of folders within a specific folder in the Media Manager, pass the specific folder's ID in the `parentFolderId` parameter. If no folder is specified, the endpoint retrieves a list of folders within the root folder of the Media Manager.
+    rpc ListFolders (ListFoldersRequest) returns (ListFoldersResponse){
+        option (google.api.http) = {get: "/v1/folders"};
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_LIST";
+        // cannot add CRUD annotations because we don't use a query object
+    }
+
+    // Searches the Media Manager and returns a list of folders that match the terms specified in the parameters. <br/>
+    //
+    // If no parameters are specified, the endpoint returns all folders in the `MEDIA_ROOT` folder.
+    rpc SearchFolders (SearchFoldersRequest) returns (SearchFoldersResponse){
+        option (google.api.http) = {post: "/v1/folders/search"};
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_LIST";
+    }
+
+    // Updates a folder. <br />
+    //
+    // You can use the `parentFolderId` parameter to move a folder from its current parent folder to a different parent folder.
+    rpc UpdateFolder (UpdateFolderRequest) returns (UpdateFolderResponse) {
+        option (.wix.api.callback) = {
+            event_type: UPDATED
+        };
+        option (.wix.api.required) = "UpdateFolderRequest.folder.id";
+        option (.wix.api.required) = "UpdateFolderRequest.folder";
+        option (google.api.http) = {patch: "/v1/folders/{folder.id}"};
+        option (.wix.sdk.signature) = {params: "folder"};
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_UPDATE";
+        option (.wix.http.infer_fieldmask) = {
+            from: "folder"
+            fieldmask: "field_mask"
+        };
+
+        // Field mask field is empty or missing from the request
+        option (.wix.api.custom_validation_error) = {
+            rule_name: "FIELD_MASK_IS_EMPTY_OR_MISSING"
+            data: "com.wix.media.site_media.v1.UnsupportedRequestValueError"
+        };
+        option (.wix.api.crud) = {
+            method: UPDATE
+            update_options: {
+                item_field: "folder"
+                fieldmask_field: "field_mask"
+            }
+        };
+    }
+
+    // Generates a URL for downloading a compressed file containing a specific folder in the Media Manager. <br/>
+    //
+    // The compressed file can contain sub-folders, and up to 1000 files. <br/>
+    rpc GenerateFolderDownloadUrl (GenerateFolderDownloadUrlRequest) returns (GenerateFolderDownloadUrlResponse) {
+        option (.wix.api.required) = "GenerateFolderDownloadUrlRequest.folder_id";
+        option (google.api.http) = {post: "/v1/folders/{folder_id}/generate-download-url"};
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_DOWNLOAD";
+    }
+
+    // Temporarily deletes the specified folders from the Media Manager. <br/>
+    //
+    // The deleted folders are moved to the Media Manager's `trash-root` folder (trash bin) unless permanently deleted. To permanently delete folders, pass the `permanent` parameter with the value `true`. Permanently deleting folders isn't reversible, so make sure that the files in these folders aren't being used in a site or in any other way as the files will no longer be accessible.
+    //
+    // Note the following:
+    // * When a folder is deleted, the files in that folder are deleted.
+    // * The specified folders can be from different parent folders.
+    // * Moving multiple folders at once is an asynchronous action, and may take time for the changes to appear in the Media Manager.
+    // * Attempting to delete folders that are already in the trash bin doesn't result in an error.
+    // * If your site contains files from a deleted media folder, the files still appear on your site as the deleted folder is still in the Media Manager (in the trash bin).
+    // * You can use the [Bulk Restore Folders From Trash Bin](https://dev.wix.com/api/rest/media/media-manager/folders/bulk-restore-folders-from-trash-bin) endpoint to restore folders from the Media Manager's trash bin.  
+    rpc BulkDeleteFolders (BulkDeleteFoldersRequest) returns (BulkDeleteFoldersResponse) {
+        option (.wix.api.required) = "BulkDeleteFoldersRequest.folder_ids";
+        option (.wix.api.callback) = {
+            event_type: DELETED
+        };
+        option (google.api.http) = {post: "/v1/bulk/folders/delete"};
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_MOVE_TO_TRASH";
+        option (.wix.api.crud) = {
+            method: BULK_DELETE
+            bulk_delete_options: {
+                ids_field: "folder_ids"
+            }
+        };
+    }
+
+    // Restores the specified folders from the Media Manager's trash bin, and moves them to their original locations in the Media Manager.
+    rpc BulkRestoreFoldersFromTrashBin(BulkRestoreFoldersFromTrashBinRequest) returns (BulkRestoreFoldersFromTrashBinResponse) {
+        option (.wix.api.required) = "BulkRestoreFoldersFromTrashBinRequest.folder_ids";
+        option (google.api.http) = {
+            post : "/v1/bulk/trash-bin/folders/restore"
+        };
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_RESTORE_FROM_TRASH";
+    }
+
+    // Retrieves a list of folders in the Media Manager's trash bin.
+    rpc ListDeletedFolders(ListDeletedFoldersRequest) returns (ListDeletedFoldersResponse) {
+        option (google.api.http) = {
+            get : "/v1/trash-bin/folders"
+        };
+        option (.wix.api.permission).name = "MEDIA.SITE_MEDIA_FOLDERS_LIST_DELETED";
+        // cannot add CRUD annotations because we don't use a query object
+    }
+
+    // Triggered when a folder is created. 
+    //
+    // This event is also triggred when a folder is restored from the Media Manager's trash bin.
+    option (.wix.api.event) = {
+        event_type: CREATED
+    };
+
+    // Triggered when a folder is updated, including when a folder is moved to a different parent folder.
+    option (.wix.api.event) = {
+        event_type: UPDATED
+    };
+
+    // Triggered when a folder is deleted.
+    //
+    // If the `movedToTrash` property in the event object is `true`, the folder was moved to the Media Manager's trash bin. If the `movedToTrash` property in the event object is `false`, the folder was permanently deleted.
+    option (.wix.api.event) = {
+        event_type: DELETED
+    };
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/identity_info.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+import "google/protobuf/wrappers.proto";
+import "wix/api/validations.proto";
+import "com/wix/media/site_media/upstream/wix/common/identification.proto";
+
+message IdentityInfo {
+  // The type of the user that uploaded the file
+  com.wix.media.site_media.upstream.wix.common.IdentificationData.IdentityType identity_type = 1;
+  // User Id. empty when UNKNOWN
+  google.protobuf.StringValue identity_id = 2 [(.wix.api.format) = GUID];
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/image_media.proto

@@ -0,0 +1,84 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/validations.proto";
+import "com/wix/media/site_media/upstream/wix/common/media.proto";
+import "wix/api/annotations.proto";
+
+message ColorRGB {
+  // Red channel.
+  google.protobuf.Int32Value r = 1 [(.wix.api.min) = 0, (.wix.api.max) = 255];
+  // Green channel.
+  google.protobuf.Int32Value g = 2 [(.wix.api.min) = 0, (.wix.api.max) = 255];
+  // Blue channel.
+  google.protobuf.Int32Value b = 3 [(.wix.api.min) = 0, (.wix.api.max) = 255];
+}
+
+message Color {
+  // HEX color.
+  google.protobuf.StringValue hex = 1 [(.wix.api.format) = COLOR_HEX];
+  // RGB color.
+  ColorRGB rgb = 2;
+}
+
+message Colors {
+  // Main color of the image.
+  Color prominent = 1;
+  // Color palette of the image. 
+  repeated Color palette = 2 [(.wix.api.maxSize) = 100];
+}
+
+// Using this object you can crop images while centering on faces
+//------------------------
+//|                      |
+//|    x,y               |
+//|    *--------         |
+//|    |  .  . |         |
+//|    |   |   | height  |
+//|    |  \ /  |         |
+//|    |       |         |
+//|    ---------         |
+//|     width            |
+//|                      |
+//|______________________|
+message FaceRecognition {
+  // The accuracy percentage of the face recognition. The likelihood that a face is detected. 
+  double confidence = 1;
+  // Top left x pixel coordinate of the face.
+  int32 x = 2;
+  // Top left y pixel coordinate of the face.
+  int32 y = 3;
+  // Face pixel height.
+  int32 height = 4;
+  // Face pixel width.
+  int32 width = 5;
+
+}
+
+message ImageMedia {
+  // Image data.
+  //flynt-disable field-type-breaking-change
+  com.wix.media.site_media.upstream.wix.common.Image image = 1;
+
+  // Image colors.
+  Colors colors = 2;
+
+  /* Information about faces in the image. Use to crop images without cutting out faces.
+  */ 
+  repeated FaceRecognition faces = 3 [(.wix.api.maxSize) = 100];
+
+  // Information about the image preview.
+  // You can use this to display a preview for private images.
+  //flynt-disable field-type-breaking-change
+  com.wix.media.site_media.upstream.wix.common.Image preview_image = 4;
+
+  // Optional, An AI generated description of the image
+  google.protobuf.StringValue caption = 5 [(.wix.api.readOnly) = true, (.wix.api.maxLength) = 300];
+
+  // Optional, return true or false if the image has text, or empty for unknown
+  google.protobuf.BoolValue contains_text = 6 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = INTERNAL];
+  // Optional, return true or false if the image has text, or empty for unknown
+  google.protobuf.BoolValue animated = 7 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = INTERNAL];
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/media_type.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+enum MediaType {
+    UNKNOWN = 0;
+    IMAGE = 1;
+    VIDEO = 2;
+    AUDIO = 3;
+    DOCUMENT = 4;
+    VECTOR = 5;
+    ARCHIVE = 6;
+    MODEL3D = 7;
+    OTHER = 8;
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/namespace.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+
+enum Namespace {
+  NO_NAMESPACE = 0;
+  OTHERS = 1;
+  //ANY = 2;
+  WIX_VIDEO = 3; //_nsWixVideo
+  WIX_MUSIC = 4; //_nsWixMusic
+  ALBUMS_AND_ART_STORE = 5; //_nsArtStore
+  WIX_ECOM = 6; //_nsDigitalProduct
+  PHOTO_SHARE_APP = 7; //_nsPhotoShareApp
+  SHARING_APP = 8; //_nsSharingApp,
+  CHAT = 9; //engage
+  LOGO_BUILDER = 10; //logobuilder
+  ALBUMS_OLD = 11; //WixExposure
+  CHAT_MOBILE = 12; //chat-mobile-uploads
+  WIX_FORMS = 13; //_nsWixForms
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/operation_status.proto

@@ -0,0 +1,27 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+enum OperationStatus {
+
+    // File upload or processing failed
+    FAILED = 0;
+    // File is ready for consumption
+    READY = 1;
+    // File is waiting for processing or currently being processed
+    PENDING = 2;
+
+
+
+    // File is waiting for processing
+    // IN_QUEUE = 2;
+    // File is processing
+    // IN_PROGRESS = 3;
+    // File is uploading to media
+    // IN_DOWNLOAD_QUEUE = 4;
+    // Convert to failed
+    // DOWNLOADING = 4;
+    // IN_STORAGE = 5;
+    // PREVIEW_READY = 7;
+    // UPLOADING = 8;
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/other_media.proto

@@ -0,0 +1,22 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/validations.proto";
+import "wix/api/annotations.proto";
+
+message OtherMedia {
+  option (.wix.api.decomposition_minimum_fields) = {
+    field: "id"
+  };
+  // WixMedia ID. for use with Site Media APIs only
+  string id = 1 [(.wix.api.maxLength) = 200];
+  // The media type of the file: 'site_icon', 'swf', 'package', 'ufont'
+  google.protobuf.StringValue internal_media_type = 2 [(.wix.api.readOnly) = true, (.wix.api.maxLength) = 100];
+  // size in bytes. Optional.
+  google.protobuf.StringValue size_in_bytes = 3 [(.wix.api.readOnly) = true, (.wix.api.format) = DECIMAL_VALUE, (.wix.api.decimalValue) = { gte: "0", maxScale: 0 }];
+  // The file URL.
+  string url = 4 [(.wix.api.format) = WEB_URL];
+
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/root_folders.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+
+enum RootFolder {
+    // Root of all site media
+    MEDIA_ROOT = 0; // 'media-root'
+    // Root of the trash system folder
+    TRASH_ROOT = 1; // 'trash-root'
+    // Root of all visitor uploads
+    VISITOR_UPLOADS_ROOT = 2;// 'visitor-uploads'
+}

package/@wix/ambassador-media-site-media-v1-file-descriptor/src/main/proto/com/wix/media/site_media/v1/storage_info.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package com.wix.media.site_media.v1;
+import "wix/api/entity.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+
+//flynt-disable missing-entity-id-field
+message StorageInfo {
+//flynt-disable missing-extensible
+  option (.wix.api.entity) = {
+    fqdn: "wix.media.site_media.v1.storage_info"
+    segment: USERS
+    app_def_id: "ad919edb-8ae2-403c-bef4-d5083b76d9e9"
+    appendix_files: {
+      type: AUTO_VELO
+      path: "appendices/velo/storage"
+    }
+  };
+
+  reserved 1;
+  // a url pointing to the generated image
+//  string url = 2 [(.wix.api.maxLength) = 10000];
+}