@wix/bex-utils 2.77.0 → 2.79.0

package/@wix/ambassador-dealer-v1-offer-event/src/main/proto/wix/api/validations.proto

@@ -0,0 +1,142 @@
+syntax = "proto2";
+
+package wix.api;
+
+import "wix/api/api_errors.proto";
+import "google/protobuf/descriptor.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "ValidationsProto";
+option java_package = "com.wix.api";
+
+/**
+*  Annotation for field validation rules
+*  example usage:
+*    import "wix/api/validations.proto";
+*
+*    message User {
+*      string id = 1 [(wix.api.readOnly)=true, (wix.api.format)=GUID];
+*      double age = 2 [(wix.api.max)=120, (wix.api.min)=0];
+*      string email = 3 [(wix.api.format)=EMAIL];
+*      string username = 4 [(wix.api.minLength)=3];
+*      string phone = 5 [(wix.api.format)=PHONE];
+*    }
+*
+*    message Invoice {
+*      string id = 1 [(wix.api.readOnly)=true, (wix.api.format)=GUID];
+*      string amount_paid = 2 [(wix.api.decimalValue) = { gte: "0.01" lt: "10" maxScale: 2 }];
+*    }
+**/
+extend google.protobuf.FieldOptions {
+    // max possible value
+    optional double max = 50201;
+    // min possible value
+    optional double min = 50202;
+    // max length for strings
+    optional int32 maxLength = 50203;
+    // min length for strings
+    optional int32 minLength = 50204;
+    // exact length for strings
+    optional int32 exactLength = 50206;
+    // max size for repeated field, map
+    optional int32 maxSize = 50209;
+    // min size for repeated field, map
+    optional int32 minSize = 50210;
+    // exact size for repeated field, map
+    optional int32 exactSize = 50213;
+    // common known formats like email, URI, etc.
+    optional Format format = 50205;
+    // indicates this field cannot be set by the client. E.g. Id field assigned by the server
+    optional bool readOnly = 50208;
+    // indicates this field can be set by the client, but can never be changed or updated
+    optional bool immutable = 50212;
+    // indicates this field is input-only, it will NOT be returned in output response
+    optional bool writeOnly = 50154;
+    // decimal value format
+    optional DecimalValueOptions decimalValue = 50211;
+    // declare custom field validation for all methods
+    optional CustomValidationError custom_validation = 50214;
+}
+
+/**
+* Decimal value validation rules.
+* Based on java.math.BigDecimal, implies (wix.api.format) = DECIMAL_VALUE
+*/
+message DecimalValueOptions {
+    optional string lte = 1; // less than or equal
+    optional string gte = 2; // greater than or equal
+    optional string lt = 3; // less than
+    optional string gt = 4; // greater than
+    optional int32 maxScale = 5; // max number of fractional digits
+}
+
+/**
+* Annotation for method validation rules
+* example usage:
+* import "wix/api/validations.proto";
+* service Bloop {
+*    rpc Create (CreateBloopRequest) returns (CreateBloopResponse) {
+*       option (wix.api.required) = "CreateBloopRequest.Bloop.name";
+*    }
+* }
+**/
+extend google.protobuf.MethodOptions {
+    // Specify which fields are required in this method.
+    // Annotating a nested field as `required` does not imply that the whole path to that field is required, eg.
+    // `option (wix.api.required) = "person.pet.name";` means that if a `person` has a `pet`, then the `pet` must have
+    // a `name` set; it does not mean that `person` or `person.pet` themselves are required - these fields should be
+    // annotated individually if needed.
+    // This option can be repeated multiple times to specify multiple fields.
+    // example use:
+    //    option (wix.api.required) = "userId";
+    //    option (wix.api.required) = "userName";
+    repeated string required = 50200;
+    // Specify list of `immutable` fields which can be writable in this method.
+    // Most common in Create methods
+    // Only `immutable` AND NOT `readOnly` fields are allowed to be referenced via this annotation
+    // example use:
+    //    option (wix.api.writable) = "id"; // user-generated id is enabled
+    repeated string writable = 50213;
+
+}
+
+extend google.protobuf.OneofOptions {
+    // name of the enum field that must be aligned with this oneof (AIP 7015)
+    // ADR 038: Linking oneOf with Enum: https://github.com/wix-private/server-infra/blob/master/framework/docs/adr/adr-038-aligned-with-enum.md
+    optional AlignedWithEnum aligned_with_enum = 50800;
+}
+
+message AlignedWithEnum {
+    required string field = 1;
+    // defaults to _options if not specified
+    optional string suffix = 2;
+}
+
+enum Format {
+    EMAIL = 0;
+    HOSTNAME = 1;
+    IPV4 = 2;
+    IPV6 = 3;
+    URI = 4;
+    WEB_URL = 5; // HTTP or HTTPS
+    PHONE = 7;
+    CREDIT_CARD = 8;
+    GUID = 9;
+    COUNTRY = 10; // 2 letters ISO-3166-1
+    LANGUAGE = 11; // 2 letters ISO-639-1
+    /*
+      Use this on string or stringValue types to validate the format of that field is same as a decimal value.
+      This will ensure keeping the precision of decimal value, such as when passing monetary values.
+    */
+    DECIMAL_VALUE = 12;
+    CURRENCY = 13; // 3 letters - all available currencies
+    LANGUAGE_TAG = 14; // IETF BCP 47 language tag (e.g. en-US)
+    COLOR_HEX = 15; // hex color format as defined by the MDN https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color
+    LOCAL_DATE = 16; // ISO-8601 extended local date format (YYYY-MM-DD)
+    LOCAL_TIME = 17; // ISO-8601 extended local time format (hh:mm[:ss][.sss])
+    LOCAL_DATE_TIME = 18; // ISO-8601 extended local date-time format (YYYY-MM-DDThh:mm[:ss][.sss])
+    URL_SLUG = 19;
+    SYSTEM_SLUG = 20;
+    SECURE_WEB_URL = 21; // HTTPS only
+    SUBDIVISION = 22; // ISO-3166-2
+}

package/@wix/ambassador-dealer-v1-offer-event/src/main/proto/wix/common/address.proto

@@ -0,0 +1,148 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+
+// A common address format to use if you plan to store addresses in your service
+
+// Physical address
+message Address {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "country"
+        field: "subdivision"
+        field: "city"
+        field: "postal_code"
+        field: "street_address"
+        field: "formatted_address"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "country"
+        field: "subdivision"
+        field: "city"
+        field: "postal_code"
+        field: "address_line"
+        field: "address_line_2"
+        field: "formatted_address"
+    };
+    google.protobuf.StringValue country = 1 [(.wix.api.format) = COUNTRY]; // Country code.
+    google.protobuf.StringValue subdivision = 2; // Subdivision shorthand. Usually, a short code (2 or 3 letters) that represents a state, region, prefecture, or province. e.g. NY
+    google.protobuf.StringValue subdivision_iso_3166_2 = 14 [(.wix.api.maxLength) = 20, (.wix.api.field_exposure) = PRIVATE]; // Subdivision. Usually a state, region, prefecture, or province code, according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2), e.g. US-NY
+    google.protobuf.StringValue city = 3 [(.wix.api.pii) = true]; // City name.
+    google.protobuf.StringValue postal_code = 4 [(.wix.api.pii) = true]; // Zip/postal code.
+    oneof street {
+        StreetAddress street_address = 5; // Street name and number.
+        google.protobuf.StringValue address_line = 6 [(.wix.api.pii) = true]; // Main address line, usually street and number as free text.
+    }
+    google.protobuf.StringValue address_line_2 = 7 [(.wix.api.pii) = true]; // Free text providing more detailed address info. Usually contains Apt, Suite, and Floor.
+
+    google.protobuf.StringValue formatted_address = 8 [(.wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE]; // A string containing the full address of this location.
+    google.protobuf.StringValue hint = 9 [(.wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE]; // Free text to help find the address.
+    AddressLocation geocode = 10 [(.wix.api.field_exposure) = PRIVATE]; // Coordinates of the physical address.
+    google.protobuf.StringValue country_fullname = 11 [(.wix.api.pii) = false, (.wix.api.field_exposure) = PRIVATE]; // Country full name.
+    google.protobuf.StringValue subdivision_fullname = 13 [(.wix.api.pii) = false, (.wix.api.field_exposure) = PRIVATE]; // Subdivision full name.
+    repeated Subdivision subdivisions = 12 [(.wix.api.field_exposure) = PRIVATE, (.wix.api.maxSize) = 6]; // Multi-level subdivisions from top to bottom.
+}
+
+message Subdivision {
+    enum SubdivisionType {
+        UNKNOWN_SUBDIVISION_TYPE = 0;
+        ADMINISTRATIVE_AREA_LEVEL_1 = 1; // State
+        ADMINISTRATIVE_AREA_LEVEL_2 = 2; // County
+        ADMINISTRATIVE_AREA_LEVEL_3 = 3; // City/town
+        ADMINISTRATIVE_AREA_LEVEL_4 = 4; // Neighborhood/quarter
+        ADMINISTRATIVE_AREA_LEVEL_5 = 5; // Street/block
+        COUNTRY = 6; // ADMINISTRATIVE_AREA_LEVEL_0. Indicates the national political entity, and is typically the highest order type returned by the Geocoder.
+    }
+
+    // Subdivision Concordance values
+    message StandardDetails {
+        google.protobuf.StringValue iso_3166_2 = 1 [(.wix.api.maxLength) = 20]; // subdivision iso-3166-2 code according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2). e.g. US-NY, GB-SCT, NO-30
+    }
+
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "code"
+    };
+    string code = 1; // Short subdivision code.
+    string name = 2; // Subdivision full name.
+    SubdivisionType type = 3 [(.wix.api.field_exposure) = PRIVATE]; // Subdivision level
+    google.protobuf.StringValue type_info = 4 [(.wix.api.field_exposure) = PRIVATE]; // Free text description of subdivision type.
+    StandardDetails standard_details = 5 [(.wix.api.field_exposure) = PRIVATE]; // Standard organizations details (e.g. ISO).
+}
+
+message StreetAddress {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "number"
+        field: "name"
+    };
+    string number = 1 [(.wix.api.pii) = true]; // Street number.
+    string name = 2 [(.wix.api.pii) = true]; // Street name.
+    string apt = 3 [(.wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE]; // Apartment number.
+    google.protobuf.StringValue formatted_address_line = 4 [(.wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE]; // Optional address line 1
+}
+
+//Contact details for the address
+message AddressContactDetails {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "full_name"
+    };
+    google.protobuf.StringValue full_name = 1 [(.wix.api.pii) = true]; // Contact's full name.
+    google.protobuf.StringValue phone = 2 [(.wix.api.pii) = true, (.wix.api.format) = PHONE]; // Contact's phone number.
+    google.protobuf.StringValue company = 3; // Contact's company name.
+    google.protobuf.StringValue email = 4 [(.wix.api.pii) = true, (.wix.api.format) = EMAIL]; // Email associated with the address.
+}
+
+//Full contact details for an address
+message FullAddressContactDetails {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "first_name"
+        field: "last_name"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "full_name"
+    };
+    google.protobuf.StringValue first_name = 1 [(.wix.api.pii) = true]; // Contact's first name.
+    google.protobuf.StringValue last_name = 2 [(.wix.api.pii) = true]; // Contact's last name.
+    google.protobuf.StringValue full_name = 8 [(.wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE]; // Contact's full name.
+    google.protobuf.StringValue phone = 3 [(.wix.api.pii) = true, (.wix.api.format) = PHONE]; // Contact's phone number.
+    google.protobuf.StringValue company = 4; // Contact's company name.
+    google.protobuf.StringValue email = 5 [(.wix.api.pii) = true, (.wix.api.format) = EMAIL]; // Email associated with the address.
+    VatId vat_id = 7; // Tax info. Currently usable only in Brazil.
+}
+
+message VatId {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+        field: "type"
+    };
+    string id = 1 [(.wix.api.pii) = true]; // Customer's tax ID.
+     /*
+     Tax type.
+     
+     Supported values:
+     + `CPF`: for individual tax payers
+     + `CNPJ`: for corporations
+     */
+    VatType type = 2;
+}
+
+// tax info types
+enum VatType {
+    UNSPECIFIED = 0;
+    CPF = 1; // CPF - for individual tax payers.
+    CNPJ = 2; // CNPJ - for corporations
+}
+
+message AddressLocation {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "latitude"
+        field: "longitude"
+    };
+    google.protobuf.DoubleValue latitude = 1 [(.wix.api.pii) = true]; // Address latitude.
+    google.protobuf.DoubleValue longitude = 2 [(.wix.api.pii) = true]; // Address longitude.
+}

package/@wix/ambassador-dealer-v1-offer-event/src/main/proto/wix/common/bulk.proto

@@ -0,0 +1,53 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
+import "wix/api/errors.proto";
+
+message BulkActionMetadata {
+    // Number of items that were successfully processed.
+    int32 total_successes = 1;
+    // Number of items that couldn't be processed.
+    int32 total_failures = 2;
+    // Number of failures without details because detailed failure threshold was exceeded.
+    int32 undetailed_failures = 3;
+}
+
+message ItemMetadata {
+    // Item ID. Should always be available, unless it's impossible (for example, when failing to create an item).
+    google.protobuf.StringValue id = 1;
+    // Index of the item within the request array. Allows for correlation between request and response items.
+    int32 original_index = 2;
+    // Whether the requested action was successful for this item. When `false`, the `error` field is populated.
+    bool success = 3;
+    // Details about the error in case of failure.
+    .wix.api.ApplicationError error = 4;
+}
+
+enum BulkActionType {
+    UNKNOWN_ACTION_TYPE = 0;
+    INSERT = 1;
+    UPDATE = 2;
+    DELETE = 3;
+}
+
+/*
+
+Example for using it in your service:
+
+message BulkOrderResult {
+    ItemMetadata item_metadata = 1;
+    Order item = 2;
+}
+
+message BulkArchiveOrdersResponse {
+    repeated BulkOrderResult results = 1;
+    BulkActionMetadata bulk_action_metadata = 2;
+}
+
+*/

package/@wix/ambassador-dealer-v1-offer-event/src/main/proto/wix/common/identification.proto

@@ -0,0 +1,40 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/validations.proto";
+import "wix/api/annotations.proto";
+
+message IdentificationData {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "identity_type"
+        field: "anonymous_visitor_id"
+        field: "member_id"
+        field: "wix_user_id"
+        field: "app_id"
+    };
+    enum IdentityType {
+        UNKNOWN = 0;
+        ANONYMOUS_VISITOR = 1;
+        MEMBER = 2;
+        WIX_USER = 3;
+        APP = 4;
+    }
+    // ID of of a contact in the site's [CRM by Ascend](https://www.wix.com/ascend/crm) system.
+    google.protobuf.StringValue contact_id = 1 [(.wix.api.format) = GUID, (.wix.api.referenced_entity) = "wix.contacts.v4.contact"];
+    IdentityType identity_type = 6 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    oneof id {
+        // ID of a site visitor that has not logged in to the site.
+        string anonymous_visitor_id = 2 [(.wix.api.format) = GUID];
+        // ID of a site visitor that has logged in to the site.
+        string member_id = 3 [(.wix.api.format) = GUID, (.wix.api.referenced_entity) = "wix.members.v1.member"];
+        // ID of a Wix user (site owner, contributor, etc.).
+        string wix_user_id = 4 [(.wix.api.format) = GUID];
+        // ID of an app.
+        string app_id = 5 [(.wix.api.format) = GUID];
+    }
+}

package/@wix/ambassador-dealer-v1-offer-event/src/main/proto/wix/common/image.proto

@@ -0,0 +1,8 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+//Moved to media.proto - please update your references

package/@wix/ambassador-dealer-v1-offer-event/src/main/proto/wix/common/media.proto

@@ -0,0 +1,280 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+import "wix/api/annotations.proto";
+import "wix/common/image.proto";
+import "google/protobuf/wrappers.proto";
+import "google/protobuf/timestamp.proto";
+import "wix/api/validations.proto";
+
+// flynt-disable deleted-field-enum-reserved
+message Image {
+//    enum TextDetection{
+//        // No detection was made
+//        UNKNOWN_TEXT_DETECTION = 0;
+//        // The image contains text
+//        CONTAINS_TEXT = 1;
+//        // The image does not contain text
+//        NO_TEXT = 2;
+//    }
+//    enum AnimationDetection{
+//        // No detection was made
+//        UNKNOWN_ANIMATION_DETECTION = 0;
+//        // The image contains animation
+//        CONTAINS_ANIMATION = 1;
+//        // The image does not contain animation
+//        NO_ANIMATION = 2;
+//    }
+//    message ImageContent{
+//        // Text detection
+//        TextDetection text = 1;
+//        // Animation detection
+//        AnimationDetection animation = 2;
+//    }
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+        field: "height"
+        field: "width"
+    };
+    // WixMedia image ID.
+    string id = 1;
+    // Image URL.
+    string url = 2;
+    // Original image height.
+    int32 height = 3 [(.wix.api.readOnly) = true];
+    // Original image width.
+    int32 width = 4 [(.wix.api.readOnly) = true];
+    // Image alt text.
+    google.protobuf.StringValue alt_text = 5;
+    // Image URL expiration date (when relevant).
+    google.protobuf.Timestamp url_expiration_date = 6 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Image filename.
+    google.protobuf.StringValue filename = 7 [(.wix.api.readOnly) = true];
+    // Image size in bytes.
+    google.protobuf.StringValue size_in_bytes = 8 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE, (.wix.api.format) = DECIMAL_VALUE];
+    // Focal point of the image.
+    FocalPoint focal_point = 9 [(.wix.api.field_exposure) = PRIVATE];
+    // Details about the image content.
+//    ImageContent image_content = 10 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = INTERNAL];
+}
+
+// Deprecated - use VideoV2
+message Video {
+    option deprecated = true;
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+        field: "url"
+        field: "height"
+        field: "width"
+    };
+    // WixMedia ID
+    string id = 1;
+    // URL of video
+    string url = 2;
+    // Original image height
+    int32 height = 3 [(.wix.api.readOnly) = true];
+    // Original image width
+    int32 width = 4 [(.wix.api.readOnly) = true];
+    // Video poster
+    Image thumbnail = 5;
+}
+
+message VideoV2 {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+        field: "resolutions"
+    };
+    // WixMedia ID.
+    string id = 1;
+    // Original video URL.
+    string url = 4 [(.wix.api.field_exposure) = PRIVATE];
+    // Available resolutions for the video, starting with the optimal resolution.
+    repeated VideoResolution resolutions = 2 [(.wix.api.readOnly) = true, (.wix.api.maxSize) = 100];
+    // Video filename.
+    google.protobuf.StringValue filename = 3 [(.wix.api.readOnly) = true];
+    // Video posters.
+    repeated Image posters = 5 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Original video size in bytes.
+    google.protobuf.StringValue size_in_bytes = 6 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE, (.wix.api.format) = DECIMAL_VALUE];
+    // Video URL expiration date (when relevant).
+    google.protobuf.Timestamp url_expiration_date = 7 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Original video duration in milliseconds.
+    google.protobuf.Int32Value duration_in_milliseconds = 8 [(.wix.api.field_exposure) = PRIVATE, (.wix.api.readOnly) = true, (.wix.api.min) = 0];
+    // A short title for the video. will be used for SEO purposes.
+    google.protobuf.StringValue title = 9 [(wix.api.maxLength) = 300, (.wix.api.field_exposure) = PRIVATE];
+    // A long description for the video. will be used for SEO purposes.
+    google.protobuf.StringValue description = 10 [(wix.api.maxLength) = 2000, (.wix.api.field_exposure) = PRIVATE];
+    // Original video height.
+    google.protobuf.Int32Value height = 11 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE, (.wix.api.min) = 0];
+    // Original video width.
+    google.protobuf.Int32Value width = 12 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE, (.wix.api.min) = 0];
+}
+
+message VideoResolution {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "url"
+        field: "height"
+        field: "width"
+        field: "poster"
+        field: "format"
+    };
+    // Video URL.
+    string url = 2;
+    // Video height.
+    int32 height = 3;
+    // Video width.
+    int32 width = 4;
+    // Deprecated. Use the `posters` property in the parent entity instead.
+    Image poster = 5 [(.wix.api.field_exposure) = PRIVATE, deprecated = true];
+    // Video format for example, mp4, hls.
+    string format = 6;
+    // Deprecated. Use the `urlExpirationDate` property in the parent entity instead.
+    google.protobuf.Timestamp url_expiration_date = 7 [(.wix.api.field_exposure) = PRIVATE, deprecated = true];
+    // Deprecated. Use the `sizeInBytes` property in the parent entity instead. Size cannot be provided per resolution.
+    google.protobuf.StringValue size_in_bytes = 8 [(.wix.api.field_exposure) = PRIVATE, (.wix.api.format) = DECIMAL_VALUE, deprecated = true];
+    // Video quality. For example: 480p, 720p.
+    google.protobuf.StringValue quality = 9 [(.wix.api.field_exposure) = PRIVATE];
+    // Video filename.
+    google.protobuf.StringValue filename = 10 [(.wix.api.field_exposure) = PRIVATE];
+    // Video duration in seconds.
+    google.protobuf.Int32Value duration_in_seconds = 11 [(.wix.api.field_exposure) = PRIVATE, (.wix.api.readOnly) = true, (.wix.api.min) = 0, (.wix.api.field_deprecated) = {
+        replaced_by: "duration_in_milliseconds"
+        target_removal_date: "2024-08-01"
+    }];
+    // Video duration in milliseconds.
+    google.protobuf.Int32Value duration_in_milliseconds = 12 [(.wix.api.field_exposure) = PRIVATE, (.wix.api.readOnly) = true, (.wix.api.min) = 0];
+
+    // When true, this is a protected asset, and calling the URL will return a 403 error.
+    // In order to access private assets, make a request to:
+    // `GenerateFileDownloadUrl` with the WixMedia id and specify the asset_key in the request
+    google.protobuf.BoolValue private = 30 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Key to identify the video resolution's relationship to the original media in WixMedia.
+    // Can be used to request a download for the specific video resolution.
+    // For example: 480p.mp4, 720p.mp4, 1080p.mp4, trailer-720p.mp4, clip-720p.mp4
+    google.protobuf.StringValue asset_key = 31 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+}
+
+message Audio {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+        field: "url"
+    };
+    // WixMedia ID.
+    string id = 1;
+    // Audio URL.
+    string url = 2;
+    // Audio URL expiration date (when relevant).
+    google.protobuf.Timestamp url_expiration_date = 3 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Audio size in bytes.
+    google.protobuf.StringValue size_in_bytes = 4 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE, (.wix.api.format) = DECIMAL_VALUE];
+    // Audio filename.
+    google.protobuf.StringValue filename = 5 [(.wix.api.readOnly) = true];
+    // Audio duration in milliseconds.
+    google.protobuf.Int32Value duration = 6 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE, (.wix.api.min) = 0];
+
+    // When true, this is a protected asset, and calling the URL will return a 403 error.
+    // In order to access private assets, make a request to:
+    // `GenerateFileDownloadUrl` with the WixMedia id and specify the asset_key in the request
+    google.protobuf.BoolValue private = 30 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Key to identify the object relationship to the original media in WixMedia.
+    // Can be used to request a download for the specific asset.
+    // For example: 128-30kbs.mp3, 320kbs.mp3, 128kbs.mp3
+    google.protobuf.StringValue asset_key = 31 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Audio format.
+    google.protobuf.StringValue format = 32 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+    // Audio quality.
+    google.protobuf.StringValue quality = 33 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+}
+
+message Document {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+        field: "url"
+    };
+    // WixMedia ID.
+    string id = 1;
+    // Document URL.
+    string url = 2;
+    // Document URL expiration date (when relevant).
+    google.protobuf.Timestamp url_expiration_date = 3 [(.wix.api.field_exposure) = PRIVATE];
+    // Document size in bytes.
+    google.protobuf.StringValue size_in_bytes = 4 [(.wix.api.field_exposure) = PRIVATE, (.wix.api.format) = DECIMAL_VALUE];
+    // Document filename.
+    google.protobuf.StringValue filename = 5;
+    // Document thumbnail.
+    Image thumbnail = 6 [(.wix.api.readOnly) = true, (.wix.api.field_exposure) = PRIVATE];
+}
+
+message Model3D {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+    };
+    // WixMedia 3D ID.
+    string id = 1;
+    // 3D URL.
+    string url = 2;
+    // 3D thumbnail Image
+    Image thumbnail = 3;
+    // 3D alt text.
+    google.protobuf.StringValue alt_text = 5;
+    // 3D URL expiration date (when relevant).
+    google.protobuf.Timestamp url_expiration_date = 6 [(.wix.api.readOnly) = true];
+    // 3D filename.
+    google.protobuf.StringValue filename = 7 [(.wix.api.readOnly) = true];
+    // 3D size in bytes.
+    google.protobuf.StringValue size_in_bytes = 8 [(.wix.api.readOnly) = true, (.wix.api.format) = DECIMAL_VALUE];
+}
+
+
+message Archive {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+    };
+    // WixMedia ID.
+    string id = 1;
+    // Archive URL.
+    string url = 2;
+    // Archive URL expiration date (when relevant).
+    google.protobuf.Timestamp url_expiration_date = 3 [(.wix.api.readOnly) = true];
+    // Archive size in bytes.
+    google.protobuf.StringValue size_in_bytes = 4 [(.wix.api.format) = DECIMAL_VALUE];
+    // Archive filename.
+    google.protobuf.StringValue filename = 5;
+}
+
+
+
+
+// Deprecated - Copy this message into your service, do not reference it
+message MediaItem {
+    option deprecated = true;
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "image"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "video"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "document"
+    };
+    oneof media {
+        Image image = 1; // WixMedia image
+        Video video = 2; // WixMedia video
+        Document document = 3; // WixMedia document
+    }
+}
+
+message FocalPoint {
+    // X-coordinate of the focal point.
+    double x = 1;
+    // Y-coordinate of the focal point.
+    double y = 2;
+    // crop by height
+    google.protobuf.Int32Value height = 3;
+    // crop by width
+    google.protobuf.Int32Value width = 4;
+}