@wix/bex-utils 2.109.0 → 2.111.0

package/@wix/ambassador-data-v1-external-database-connection/src/main/proto/wix/api/subscription.proto

@@ -0,0 +1,32 @@
+syntax = "proto2";
+
+package wix.api;
+
+import "google/protobuf/descriptor.proto";
+import "wix/api/callback.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "SubscriptionProto";
+option java_package = "com.wix.api";
+
+/*
+Marks a method as a topic consumer.
+service BlooperService {
+   rpc Update (BlooperUpdateNotification) returns (google.protobuf.Empty) {
+       option (wix.api.subscription) = {
+           topic: "Blooper.Update"
+       };
+   };
+}
+*/
+extend google.protobuf.MethodOptions {
+    optional Subscription subscription = 50400;
+}
+
+message Subscription {
+    optional string topic = 1;
+    optional Segment.SegmentName segment = 4; // currently defaults to "legacy", will be `required` when legacy cluster is removed
+    optional bool batch = 2 [deprecated = true];
+    optional string entity = 3;
+    optional bool dynamic = 5 [deprecated = true];
+}

package/@wix/ambassador-data-v1-external-database-connection/src/main/proto/wix/api/validations.proto

@@ -0,0 +1,147 @@
+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;
+    // By default, when the enum field is updated to a value that has no corresponding
+    // message option within the `oneof`, the framework automatically clears the `oneof`.
+    // This cleanup is achieved by programmatically adding the `oneof` field's path to the
+    // update mask. Set `skip_empty_options_handling` to `true` to disable this behavior.
+    optional bool skip_empty_options_handling = 3;
+}
+
+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-data-v1-external-database-connection/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-data-v1-external-database-connection/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-data-v1-external-database-connection/src/main/proto/wix/common/domainevents/attributeupdated.proto

@@ -0,0 +1,20 @@
+syntax = "proto3";
+import "google/protobuf/struct.proto";
+
+package wix.common.domainevents;
+
+import "wix/api/annotations.proto";
+
+option java_multiple_files = true;
+option java_package = "com.wix.common.domainevents";
+
+message AttributeUpdated {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "previous_value"
+        field: "value"
+    };
+    // previous_value should ONLY be set if you have the previous value in hand. Do NOT add additional DB calls for it unless your domain mandates it.
+    // leave next line empty so that comment will be kept internal and not confuse external parties
+    google.protobuf.Value previous_value = 4; 
+    google.protobuf.Value value = 5;
+}

package/@wix/ambassador-data-v1-external-database-connection/src/main/proto/wix/common/domainevents/domainevents.proto

@@ -0,0 +1,112 @@
+//flynt-disable renamed-field-breaking-change, missing-string-validations
+syntax = "proto3";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
+
+package wix.common.domainevents;
+
+
+option java_multiple_files = true;
+option java_package = "com.wix.common.domainevents";
+
+message EntityCreatedEvent {
+    string entity_as_json = 2 [(wix.api.pii) = true];
+
+    // Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity
+    google.protobuf.BoolValue triggered_by_undelete = 3 [(.wix.api.field_exposure) = PRIVATE];
+
+    // Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity
+    RestoreInfo restore_info = 4;
+
+    // Optional domain-specific metadata defined by the API owner, encoded as JSON.
+    google.protobuf.StringValue additional_metadata_as_json = 5 [(wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE];
+}
+
+message EntityUpdatedEvent {
+    // Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
+    // This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
+    // We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+    string current_entity_as_json = 2 [(wix.api.pii) = true];
+
+    // This field is currently part of the of the EntityUpdatedEvent msg, but scala/node libraries which implements the domain events standard
+    // wont populate it / have any reference to it in the API.
+    // The main reason for it is that fetching the old entity from the DB will have a performance hit on an update operation so unless truly needed,
+    // the developer should send only the new (current) entity.
+    // An additional reason is not wanting to send this additional entity over the wire (kafka) since in some cases it can be really big
+    //Developers that must reflect the old entity will have to implement their own domain event sender mechanism which will follow the DomainEvent proto message.
+    google.protobuf.StringValue previous_entity_as_json = 3 [(wix.api.pii) = true, deprecated = true, (.wix.api.field_exposure) = INTERNAL];
+
+    reserved 4;
+
+    // Map of fully qualified field paths to their previous values for fields that changed.
+    // For more details please see [AIP](https://dev.wix.com/docs/rnd-general/articles/p13n-guidelines-aips/guidance-aips/design-patterns/7016-events#modified-fields-format)
+    map<string, google.protobuf.Value> modified_fields = 5 [(wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE];
+
+    // Optional domain-specific metadata defined by the API owner, encoded as JSON.
+    google.protobuf.StringValue additional_metadata_as_json = 6 [(wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE];
+}
+
+message EntityDeletedEvent {
+    // Indicates if the entity is sent to trash-bin. only available when trash-bin is enabled
+    google.protobuf.BoolValue moved_to_trash = 1 [(.wix.api.field_exposure) = PRIVATE];
+
+    // Entity that was deleted.
+    google.protobuf.StringValue deleted_entity_as_json = 2 [(wix.api.pii) = true];
+
+    // Optional domain-specific metadata defined by the API owner, encoded as JSON.
+    google.protobuf.StringValue additional_metadata_as_json = 3 [(wix.api.pii) = true, (.wix.api.field_exposure) = PRIVATE];
+}
+
+message ActionEvent {
+    string body_as_json = 2 [(wix.api.pii) = true];
+}
+
+message DomainEvent {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "id"
+        field: "entity_fqdn"
+        field: "slug"
+        field: "entity_id"
+        field: "event_time"
+    };
+    // Event ID. With this ID you can easily spot duplicated events and ignore them.
+    string id = 1;
+    // Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
+    // For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
+    string entity_fqdn = 2;
+    // Event action name, placed at the top level to make it easier for users to dispatch messages.
+    // For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
+    string slug = 3;
+    // ID of the entity associated with the event.
+    string entity_id = 4;
+    oneof body {
+        EntityCreatedEvent created_event = 5;
+        EntityUpdatedEvent updated_event = 6;
+        EntityDeletedEvent deleted_event = 7;
+        ActionEvent action_event = 8;
+    }
+    reserved 12;
+    // Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`.
+    google.protobuf.Timestamp event_time = 9;
+    // Whether the event was triggered as a result of a privacy regulation application
+    // (for example, GDPR).
+    google.protobuf.BoolValue triggered_by_anonymize_request = 10;
+
+    // If present, indicates the action that triggered the event.
+    google.protobuf.StringValue originated_from = 11;
+
+    // A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
+    // You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
+    google.protobuf.Int64Value entity_event_sequence = 13;
+}
+
+// Used for batch consumers
+message DomainEvents {
+  repeated DomainEvent domain_events = 1;
+}
+
+message RestoreInfo {
+  google.protobuf.Timestamp deleted_date = 1;
+}

package/@wix/ambassador-data-v1-external-database-connection/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-v1-external-database-connection/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