@wix/bex-utils 2.77.0 → 2.79.0

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

@@ -0,0 +1,36 @@
+syntax = "proto3";
+
+package wix.common;
+
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "google/protobuf/struct.proto";
+
+option java_multiple_files = true;
+option java_package = "com.wix.common";
+
+message Sorting {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "field_name"
+        field: "order"
+    };
+    // Name of the field to sort by.
+    string field_name = 1 [(.wix.api.maxLength) = 512];
+    // Sort order.
+    SortOrder order = 2;
+    // When `field_name` is a property of repeated field that is marked as `MATCH_ITEMS` and sort should be done by
+    // a specific element from a collection, filter can/should be provided to ensure correct sort value is picked.
+    //
+    // If multiple filters are provided, they are combined with AND operator.
+    //
+    // Example:
+    // Given we have document like {"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}
+    // and `nestedField` is marked as `MATCH_ITEMS`, to ensure that sorting is done by correct region, filter should be
+    // { fieldName: "nestedField.price", "select_items_by": [{"nestedField.region": "US"}] }
+    repeated google.protobuf.Struct select_items_by = 3 [(.wix.api.maxSize) = 10, (.wix.api.field_exposure) = PRIVATE];
+}
+
+enum SortOrder {
+    ASC = 0;
+    DESC = 1;
+}

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

@@ -0,0 +1,85 @@
+syntax = "proto3";
+
+package wix.common.spi;
+
+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 SpiBaseUri {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "base_uri"
+        field: "alternative_uris"
+    };
+    message AlternativeUri {
+        /*
+        Name of the method to create a custom URI for.  
+        
+        For `methodName`, use the name of the method in PascalCase. 
+        For example, for Get Shipping Rates use `GetShippingRates`.
+        */
+        string method_name = 1 [(.wix.api.minLength) = 3, (.wix.api.maxLength) = 128];
+        /*
+        Custom URI that Wix uses to call your server for this method. The path-suffix documented in the method will not be appended to this URI. 
+        Must be a secured endpoint beginning with `https://`. For example, `https://www.my-shipping-provider.com/my-shipping-rates`.
+        */
+        string absolute_uri = 2 [(.wix.api.minLength) = 6, (.wix.api.maxLength) = 2048];
+    }
+    /*
+    Base URI where the methods are called. Wix appends the path to the `baseUri`. 
+    For example, to call the Get Shipping Rates method at `https://my-shipping-provider.com/v1/getRates`, the base URI you provide here is `https://my-shipping-provider.com/`.
+    */
+    string base_uri = 1 [(.wix.api.minLength) = 6, (.wix.api.maxLength) = 2048];
+    // Alternate, custom URIs to replace the default URIs for specific service plugin methods.
+    repeated AlternativeUri alternative_uris = 2;
+}
+
+/**
+this message is not directly used by any service,
+it exists to describe the expected parameters that SHOULD be provided to invoked Velo methods as part of open-platform.
+e.g. SPIs, event-handlers, etc..
+NOTE: this context object MUST be provided as the last argument in each Velo method signature.
+
+Example:
+```typescript
+export function wixStores_onOrderCanceled({ event, metadata }: OrderCanceledEvent) {
+  ...
+}
+```
+ */
+message Context {
+    message IdentificationData {
+        option (.wix.api.decomposite_of) = "wix.common.IdentificationData";
+        enum IdentityType {
+            UNKNOWN = 0;
+            ANONYMOUS_VISITOR = 1;
+            MEMBER = 2;
+            WIX_USER = 3;
+            APP = 4;
+        }
+        reserved 1;
+        IdentityType identity_type = 6 [(.wix.api.readOnly) = true];
+        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];
+        }
+    }
+    google.protobuf.StringValue request_id = 1; // A unique identifier of the request. You may print this ID to your logs to help with future debugging and easier correlation with Wix's logs.
+    google.protobuf.StringValue currency = 2 [(.wix.api.format) = CURRENCY]; // [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 3-letter currency code.
+    IdentificationData identity = 3; // An object that describes the identity that triggered this request.
+    repeated string languages = 4; // A string representing a language and region in the format of `"xx-XX"`. First 2 letters represent the language code according to ISO 639-1. This is followed by a dash "-", and then a by 2 capital letters representing the region according to ISO 3166-2. For example, `"en-US"`.
+    google.protobuf.StringValue instance_id = 5 [(.wix.api.format) = GUID]; // The service provider app's instance ID.
+    google.protobuf.StringValue app_extension_id = 6 [(.wix.api.maxLength) = 256, (wix.api.field_maturity) = ALPHA]; // Extension ID in Dev Center.
+    google.protobuf.StringValue app_extension_type = 7 [(.wix.api.maxLength) = 256, (wix.api.field_maturity) = ALPHA]; // Extension type in Dev Center.
+    google.protobuf.StringValue function_name = 8 [(.wix.api.maxLength) = 256, (wix.api.field_maturity) = ALPHA]; // Invoked function.
+
+}

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

@@ -0,0 +1,55 @@
+syntax = "proto3";
+
+package wix.common.tags;
+
+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";
+/*
+  Common object for tags.
+  Should be use as in this example:
+  message Foo {
+    string id = 1;
+    // ...
+    Tags tags = 5
+  }
+
+  example of taggable entity
+  {
+    id: "123"
+    tags: {
+      tags: {
+        tag_ids:["11","22"]
+      },
+      private_tags: {
+        tag_ids: ["33", "44"]
+      }
+    }
+  }
+ */
+message Tags {
+  option (.wix.api.decomposition_minimum_fields) = {
+    field: "tags"
+  };
+
+  message TagList {
+    repeated string tag_ids = 1 [(.wix.api.referenced_entity) = "wix.os.tags.v1.tag", (.wix.api.maxSize) = 100, (.wix.api.maxLength) = 5]; // List of tag IDs
+  }
+  TagList private_tags = 1; // Tags that require an additional permission in order to access them, normally not given to site members or visitors.
+  TagList tags = 2; // Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors.
+}
+
+message PublicTags {
+  option (.wix.api.decomposite_of) = "wix.common.tags.Tags";
+  option (.wix.api.decomposition_minimum_fields) = {
+    field: "tags"
+  };
+
+  message TagList {
+    repeated string tag_ids = 1 [(.wix.api.referenced_entity) = "wix.os.tags.v1.tag", (.wix.api.maxSize) = 100, (.wix.api.maxLength) = 5]; // List of tag IDs
+  }
+  TagList tags = 2; // Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors.
+}

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

@@ -0,0 +1,203 @@
+syntax = "proto3";
+
+package wix.common;
+
+option java_multiple_files = true;
+option java_outer_classname = "WixLinkProto";
+option java_package = "com.wix.common";
+
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "google/protobuf/wrappers.proto";
+
+//The link object generated by panels in the editor and used by applications in Wix
+message WixLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "external"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "page"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "anchor"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "dynamic_page"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "document"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "email"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "phone"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "address"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "whats_app"
+    };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "tpa_page_link"
+    };
+    oneof Link {
+        ExternalLink external = 1; // External link type
+        PageLink page = 2; // Page link type
+        AnchorLink anchor = 3; // Anchor link type
+        DynamicPageLink dynamic_page = 4; // Dynamic page link type
+        DocumentLink document = 5; // Document link type
+        EmailLink email = 6; // Email link type
+        PhoneLink phone = 7; // Phone link type
+        AddressLink address = 8; // Address link type
+        WhatsAppLink whats_app = 9; // WhatsApp link type
+        TpaPageLink tpa_page = 10; // TPA link type
+    }
+}
+
+message ExternalLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "url"
+    };
+    //The url of the page
+    string url = 1 [(.wix.api.format) = WEB_URL];
+    //Where this link should open, supports _self and _blank or any name the user chooses. _self means same page, _blank means new page.
+    google.protobuf.StringValue target = 2;
+    //rel of link
+    repeated LinkRel rel = 3 [(.wix.api.maxSize) = 20, (.wix.api.field_exposure) = PRIVATE];
+}
+
+message PageLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "page_id"
+    };
+    //The page id we want from the site
+    string page_id = 1;
+    //Where this link should open, supports _self and _blank or any name the user chooses. _self means same page, _blank means new page.
+    google.protobuf.StringValue target = 2;
+    //rel of link
+    repeated LinkRel rel = 3 [(wix.api.maxSize) = 20];
+}
+
+message AnchorLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "anchor_name"
+        field: "anchor_data_id"
+        field: "page_id"
+    };
+    //The name of the anchor
+    string anchor_name = 1;
+    //The data id (from the JSON page) of the anchor that should be used
+    string anchor_data_id = 2;
+    //The page id we want from the site
+    string page_id = 3;
+    //rel of link
+    repeated LinkRel rel = 4 [(wix.api.maxSize) = 20];
+}
+
+message DynamicPageLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "router_id"
+        field: "inner_route"
+        field: "anchor_data_id"
+    };
+    //The router that handles this link
+    string router_id = 1;
+    //The path data we'd like
+    string inner_route = 2;
+    //The data id (from the JSON page) of the anchor that should be used
+    google.protobuf.StringValue anchor_data_id = 3;
+    //rel of link
+    repeated LinkRel rel = 4 [(wix.api.maxSize) = 20];
+}
+
+message DocumentLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "doc_id"
+        field: "name"
+    };
+    //The id of the document
+    string doc_id = 1;
+    //The name of the document for download purposes
+    google.protobuf.StringValue name = 2;
+    //If this document can be indexed by scrapers, default is false
+    bool indexable = 3;
+}
+
+message EmailLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "recipient"
+        field: "subject"
+        field: "body"
+    };
+    //The email we will be sending a message to
+    string recipient = 1 [(.wix.api.format) = EMAIL];
+    //The subject of the email
+    google.protobuf.StringValue subject = 2;
+    //The body of the email
+    google.protobuf.StringValue body = 3;
+}
+
+message PhoneLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "phone_number"
+    };
+    //The phone number we want to link to
+    string phone_number = 1 [(.wix.api.pii) = true, (.wix.api.format) = PHONE, (.wix.api.maxLength) = 100];
+}
+
+message AddressLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "address"
+    };
+    //An address that we can link to
+    string address = 1 [(.wix.api.pii) = true];
+}
+
+message WhatsAppLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "phone_number"
+    };
+    //The whatsApp phone number we want to connect with
+    string phone_number = 1 [(.wix.api.pii) = true, (.wix.api.format) = PHONE];
+}
+
+//Link to a TPA page
+message TpaPageLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "item_type_identifier"
+        field: "item_id"
+        field: "page_id"
+        field: "app_definition_id"
+        field: "path"
+    };
+    //Type of item (e.g. 'wix.stores.sub_pages.product')
+    string item_type_identifier = 1;
+    //Id of linked item
+    string item_id = 2;
+    //Id of linked page
+    string page_id = 3;
+    //Id of app being linked to (AppDefId)
+    string app_definition_id = 4;
+    //The relativepath of linked page
+    string path = 5;
+    //rel of link
+    repeated LinkRel rel = 6 [(wix.api.maxSize) = 20];
+}
+
+//The 'rel' attribute of the link. The rel attribute defines the relationship between a linked resource and the current document.
+//Further reading (also about different possible rel types): https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel
+//Following are the accepted 'rel' types by Wix applications.
+enum LinkRel {
+    // default (not implemented)
+    unknown_link_rel = 0 [(.wix.api.enum_maturity) = NOT_IMPLEMENTED];
+    //Indicates that the current document's original author or publisher does not endorse the referenced document.
+    nofollow = 1;
+    //Instructs the browser to navigate to the target resource without granting the new browsing context access to the document that opened it.
+    noopener = 2;
+    //No Referer header will be included. Additionally, has the same effect as noopener.
+    noreferrer = 3;
+    //Indicates a link that resulted from advertisements or paid placements.
+    sponsored = 4;
+}

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

@@ -0,0 +1,211 @@
+syntax = "proto3";
+
+package wix.dealerOfferEvents.api.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/wrappers.proto";
+import "google/protobuf/struct.proto";
+import "wix/api/entity.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "wix/common/query.proto";
+import "wix/common/paging.proto";
+
+import "wix/dealerOfferEvents/api/v1/event.proto";
+
+option java_package = "com.wix.dealerOfferEvents.api.v1";
+
+service DealerOfferEventsService {
+  option (wix.api.service_entity).message = "wix.dealerOfferEvents.api.v1.OfferEvent";
+  option (wix.api.service_exposure) = INTERNAL;
+
+  // Report an event for a Dealer Offer for a specific user identity and metasite.
+  // required fields: event.type, event.offer_id and event.real_estate_id (placementId) in addition - some of the event types require specific payload.
+  // For example MAIN_CTA_CLICK needs to be reported with main_cta_click payload that contains additional data on the event such as target_url.
+  // VIEW event does not require any additional information.
+  //
+  // Identity and metasite are taken implicitly from request by default - NO NEED TO PASS SUCH INFO.
+  // If an event is reported from metasite(BM/EDITOR), MAKE SURE request is sent with an authorization header.
+  //
+  // For some EDGE CASES - privileged apps with DEALER.OFFER_EVENTS_EXPLICIT_CONTEXT can report on behalf of user and fill identity(user_id and msid) fields.
+  rpc ReportEvent (ReportEventRequest) returns (ReportEventResponse) {
+    option (google.api.http).post = "/v1/dealer-offer-events/{event.offer_id}";
+
+    option (wix.api.required) = "ReportEventRequest.event.offer_id";
+    option (wix.api.maturity) = GA;
+  };
+
+  // return list of offer events summary for a bulk of offer ids.
+  // a summary response contains last event happened for each event type or event counts.
+  // - you have to provide field masks for all the event types you want to get for each offer.
+  // BY DEFAULT Summaries will be filtered by the implicit identity and metasite in the request.
+  //
+  // FOR SOME EDGE CASES - special permission DEALER.OFFER_EVENTS_EXPLICIT_CONTEXT is required in order to pass explicit identity and metasite filter.
+  //
+  // You can request event summary data for specific offers or specific campaigns.
+  //
+  // In case campaign level events summary requested, cumulative data is returned:
+  //      — events counters are a sum of all campaign's offer events counters
+  //      — lastEvent for campaign is the lastEvent of the "latest" offer within campaign
+  //      — etc.
+  //
+  //  If summary_filter.placement_id is set, then only offers belonging to campaign & placement is counted
+  //  for campaign level summary
+  //
+  // If offer_ids is empty — you get empty result.events_summary
+  // If campaign_ids empty — you get empty result.campaign_events_summary
+  //
+  rpc ListEventsSummary (ListEventsSummaryRequest) returns (ListEventsSummaryResponse) {
+    option (google.api.http).get = "/v1/dealer-offer-events/summary";
+    option (wix.api.required) = "ListEventsSummaryRequest.summary_filter.field_mask";
+    option (wix.api.maturity) = GA;
+  };
+
+  // ONLY SUPPORTED FOR EVENT TYPE AGENT_MARK - USER JOURNEY USE CASES
+  // Returns list of offer events for given filters.
+  // Filters: offer_id (required), event_type (required, only AGENT_MARK); siteId is taken implicitly
+  //  from aspects, so they must be server signed with siteId.
+  // Supported `paging`. Events limit by default is 200.
+  // Not supported 'sort`, `fields` and `fieldsets`. Events are sorted in descending order by creation_date.
+  //
+  // Query examples:
+  //  query: { filter: { offer_id: <uuid> }, event_type: 'AGENT_MARK'}}
+  //  query: { filter: { offer_id: { $in: [<uuid1>, <uuid2>] }, event_type: 'AGENT_MARK'}}
+  //  query: { filter: { offer_id: { $in: [<uuid1>, <uuid2>] }, event_type: 'AGENT_MARK'}, paging: { offset: 10, limit: 100 } }
+  rpc QueryEvents (QueryEventsRequest) returns (QueryEventsResponse) {
+
+    option (google.api.http).get = "/v1/dealer-offer-events/query";
+
+    option (wix.api.required) = "QueryEventsRequest.query";
+    option (wix.api.required) = "QueryEventsRequest.query.filter";
+    option (wix.api.maturity) = ALPHA;
+  };
+}
+
+
+message ReportEventRequest {
+  // Event properties container
+  OfferEvent event = 1;
+
+  // Deviant Art specific use-case: signed jwt token with uuid of deviant art user in wix bi infra
+  google.protobuf.StringValue deviant_art_user_id = 2 [(.wix.api.maxLength) = 4096];
+}
+
+message ReportEventResponse {
+}
+
+
+message ListEventsSummaryRequest {
+  // each element in response.eventsSummary is a summary of offerId
+  repeated string offer_ids = 1 [(wix.api.format) = GUID];
+
+  // each element in response.campaignEventsSummary is a summary of corresponding campaignId
+  repeated string campaign_ids = 3 [(wix.api.format) = GUID];
+
+  // applied to each requested offer or each offer within requested campaigns
+  // all fields are optional - if not passing fields mask then no summary will be returned
+  SummaryFilter summary_filter = 2;
+}
+
+message SummaryFilter {
+  // OPNIONAL - only events reported with this user id will be taken into account - supported by AGENT_MARK only
+  google.protobuf.StringValue user_id = 1 [(wix.api.format) = GUID];
+
+  // OPNIONAL - only events reported with this account id will be taken into account
+  google.protobuf.StringValue target_account_id = 2 [(wix.api.format) = GUID];
+
+  // OPNIONAL - only events reported with this site id will be taken into account
+  google.protobuf.StringValue site_id = 3 [(wix.api.format) = GUID];
+
+  reserved 4;
+
+  // which placement offers take into account in campaign scope (applicable only for campaign_ids requests)
+  google.protobuf.StringValue placement_id = 6 [(wix.api.format) = GUID];
+  // todo: add  (wix.api.referenced_entity) = "wix.dealer.v1.placement"]; when it's on BO API
+
+  // Array of strings that will determine which events will be included in EventsSummary response
+  // In the format of EventsSummary fields "<event_usecase>.<event_type>"
+  //
+  // Possible values for VIEW events:
+  //      - lastEvent.VIEW
+  //      - eventsCount.VIEW
+  // Possible values for MAIN_CTA_CLICK events:
+  //  * get last main cta click of any action type:
+  //      - lastEvent.MAIN_CTA_CLICK
+  //      - eventsCount.MAIN_CTA_CLICK
+  //
+  // Possible values for AGENT_MARK events:
+  //  * get last event of any status:
+  //      - lastEvent.AGENT_MARK
+  //
+  //
+  // For example:
+  //      "lastEvent.VIEW,lastEvent.AGENT_MARK,eventsCount.MAIN_CTA_CLICK"
+  //
+  //  will result in (if CLOSE event exists for given offer/user/metasite)
+  //      {
+  //          lastEvent: {
+  //              VIEW: {...(OfferEvent data)},
+  //              AGENT_MARK: {...(OfferEvent data)}
+  //          },
+  //          eventsCount:{ MAIN_CTA_CLICK: { totalCount: 20 }}
+  //      }
+  //
+  google.protobuf.FieldMask field_mask = 5;
+}
+
+message EventCounts {
+  // counter
+  google.protobuf.Int32Value total_count = 1;
+}
+
+message EventsSummary {
+  // If set - means this summary is about the offer
+  google.protobuf.StringValue offer_id = 1 [(wix.api.format) = GUID];
+  // todo:  add (wix.api.referenced_entity) = "wix.dealer.v1.backoffice_offer"]; when it's on BO API
+
+  // If set - means this summary is about the campaign
+  google.protobuf.StringValue campaign_id = 5 [(wix.api.format) = GUID];
+  // todo: add  (wix.api.referenced_entity) = "wix.dealer.v1.campaign"]; when it's on BO API
+
+  // Campaign summary: Last event per type among all offers within campaign (+ placement if filter specified)
+  // Offer summary: Last event per type for given offer
+  //
+  // key is a value from EventType enum
+  // OfferEvent enity eill be returned partailly dependeing on event type - see details on entity
+  map<string, OfferEvent> last_event = 3;
+
+  // Campaign summary: cumulative counters for all offer events of the same type within this campaign (+ placement if filter specified)
+  // Offer summary: event counts per type for given offer
+  //
+  // key is a value from EventType enum
+  map<string, EventCounts> events_count = 10;
+
+  reserved 2, 4;
+}
+
+message ListEventsSummaryResponse {
+  // list of event summaries for requested offer ids, will be empty if only campaign events requested
+  repeated EventsSummary events_summary = 1;
+
+  // list of event summaries for requested campaign ids, will be empty if only offer events requested
+  repeated EventsSummary campaign_events_summary = 2;
+}
+
+message QueryEventsRequest {
+  // Query examples:
+  //  query: { filter: { offer_id: <uuid> }, event_type: 'AGENT_MARK'}}
+  //  query: { filter: { offer_id: { $in: [<uuid1>, <uuid2>] }, event_type: 'AGENT_MARK'}}
+  //  query: { filter: { offer_id: { $in: [<uuid1>, <uuid2>] }, event_type: 'AGENT_MARK'}, paging: { offset: 10, limit: 100 } }
+  wix.common.Query query = 1;
+}
+
+message QueryEventsResponse {
+  // List of offer events
+  repeated OfferEvent events = 1;
+
+  // result paging status
+  wix.common.PagingMetadata paging_metadata = 2;
+}