@wix/bex-utils 1.28.0

package/@wix/ambassador-data-extensions-v1-data-extension-schema/src/main/proto/wix/common/address.proto

@@ -0,0 +1,140 @@
+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. Usually a state, region, prefecture, or province code, according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2).
+    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.
+    }
+    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.
+}
+
+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-data-extensions-v1-data-extension-schema/src/main/proto/wix/common/bulk.proto

@@ -0,0 +1,52 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/errors.proto";
+
+message BulkActionMetadata {
+    // Number of items that were successfully processed.
+    uint32 total_successes = 1;
+    // Number of items that couldn't be processed.
+    uint32 total_failures = 2;
+    // Number of failures without details because detailed failure threshold was exceeded.
+    uint32 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.
+    uint32 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-data-extensions-v1-data-extension-schema/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-data-extensions-v1-data-extension-schema/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-data-extensions-v1-data-extension-schema/src/main/proto/wix/common/media.proto

@@ -0,0 +1,225 @@
+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";
+
+message Image {
+    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];
+}
+
+// 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];
+}
+
+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];
+
+    // 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 seconds.
+    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;
+}
+
+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
+    }
+}

package/@wix/ambassador-data-extensions-v1-data-extension-schema/src/main/proto/wix/common/money.proto

@@ -0,0 +1,32 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "google/protobuf/wrappers.proto";
+
+// Common money formats.
+
+// Money.
+// Default format to use. Sufficiently compliant with majority of standards: w3c, ISO 4217, ISO 20022, ISO 8583:2003.
+message Money {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "value"
+        field: "currency"
+    };
+    // For special cases, one may use just a value without currency to represent money. But:
+    // - money MUST be a decimal string, as described below
+    // - currency MUST be provided somewhere at the top level of your object
+
+    // Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, a single (-), to indicate that the amount is negative.
+    string value = 1 [(.wix.api.format) = DECIMAL_VALUE];
+    // Currency code. Must be valid ISO 4217 currency code (e.g., USD).
+    string currency = 2 [(.wix.api.format) = CURRENCY];
+    // Monetary amount. Decimal string in local format (e.g., 1 000,30). Optionally, a single (-), to indicate that the amount is negative.
+    google.protobuf.StringValue formatted_value = 3;
+
+}

package/@wix/ambassador-data-extensions-v1-data-extension-schema/src/main/proto/wix/common/pageurl.proto

@@ -0,0 +1,32 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_outer_classname = "PageUrlProto";
+option java_package = "com.wix.common";
+
+import "wix/api/annotations.proto";
+import "google/protobuf/wrappers.proto";
+
+message PageUrl {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "base"
+        field: "path"
+    };
+    // The base URL. For premium sites, this will be the domain. For free sites, this would be site URL (e.g mysite.wixsite.com/mysite)
+    string base = 1;
+    // The path to that page - e.g /product-page/a-product
+    string path = 2;
+}
+
+message PageUrlV2 {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "relative_path"
+        field: "url"
+    };
+    // The path to that page - e.g /product-page/a-product
+    string relative_path = 1;
+    // The URL of that page. e.g https://mysite.com/product-page/a-product
+    google.protobuf.StringValue url = 2;
+}

package/@wix/ambassador-data-extensions-v1-data-extension-schema/src/main/proto/wix/common/paging.proto

@@ -0,0 +1,107 @@
+syntax = "proto3";
+
+package wix.common;
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+message Paging {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "limit"
+        field: "offset"
+    };
+    // Number of items to load.
+    google.protobuf.Int32Value limit = 1 [(.wix.api.min) = 0];
+    // Number of items to skip in the current sort order.
+    google.protobuf.Int32Value offset = 2 [(.wix.api.min) = 0];
+}
+
+message CursorPaging {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "limit"
+        field: "cursor"
+    };
+    // Number of items to load.
+    google.protobuf.Int32Value limit = 1 [(.wix.api.min) = 0, (.wix.api.max) = 100];
+    /*
+    Pointer to the next or previous page in the list of results.
+
+    You can get the relevant cursor token
+    from the `pagingMetadata` object in the previous call's response.
+    Not relevant for the first request.
+    */
+    google.protobuf.StringValue cursor = 2;
+}
+
+message PagingMetadata {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "count"
+        field: "offset"
+    };
+    // Number of items returned in the response.
+    google.protobuf.Int32Value count = 1;
+    // Offset that was requested.
+    google.protobuf.Int32Value offset = 2;
+    // Total number of items that match the query.
+    google.protobuf.Int32Value total = 3;
+    // Flag that indicates the server failed to calculate the `total` field.
+    google.protobuf.BoolValue too_many_to_count = 4;
+    // Indicates if there are more results after the current page.
+    // If `true`, another page of results can be retrieved.
+    // If `false`, this is the last page.
+    google.protobuf.BoolValue has_next = 5 [(.wix.api.field_exposure) = PRIVATE];
+}
+
+message PagingMetadataV2 {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "count"
+        field: "offset"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "count"
+        field: "cursors"
+    };
+    // Number of items returned in the response.
+    google.protobuf.Int32Value count = 1;
+    // Offset that was requested.
+    google.protobuf.Int32Value offset = 2;
+    // Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set.
+    google.protobuf.Int32Value total = 3;
+    // Flag that indicates the server failed to calculate the `total` field.
+    google.protobuf.BoolValue too_many_to_count = 4;
+    // Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used.
+    Cursors cursors = 5;
+    // Indicates if there are more results after the current page.
+    // If `true`, another page of results can be retrieved.
+    // If `false`, this is the last page.
+    google.protobuf.BoolValue has_next = 6 [(.wix.api.field_exposure) = PRIVATE];
+}
+
+
+// This is the preferred message for cursor-paging enabled services
+
+message CursorPagingMetadata {
+    option (.wix.api.decomposite_of) = "wix.common.PagingMetadataV2";
+    // Number of items returned in the response.
+    google.protobuf.Int32Value count = 1;
+    // Offset that was requested.
+    Cursors cursors = 2;
+    // Indicates if there are more results after the current page.
+    // If `true`, another page of results can be retrieved.
+    // If `false`, this is the last page.
+    google.protobuf.BoolValue has_next = 3;
+}
+
+message Cursors {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "next"
+    };
+    // Cursor pointing to next page in the list of results.
+    google.protobuf.StringValue next = 1;
+    // Cursor pointing to previous page in the list of results.
+    google.protobuf.StringValue prev = 2;
+}