@wix/bex-utils 1.37.0 → 1.38.0

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/common/query.proto

@@ -81,11 +81,11 @@ message CursorQuery {
     google.protobuf.Struct filter = 1;
     //Sort object in the following format:
     //`[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
-    repeated Sorting sort = 2;
+    repeated Sorting sort = 2 [(.wix.api.maxSize) = 5];
     reserved 3;
     reserved 4;
     reserved 5;
-    oneof pagingMethod {
+    oneof pagingMethod { 
         //Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`.
         CursorPaging cursor_paging = 6;
     }
@@ -102,190 +102,301 @@ message Search {
         field: "sort"
         field: "cursor_paging"
     };
-    //A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
+    // A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
     google.protobuf.Struct filter = 1;
-    //Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
-    repeated Sorting sort = 2;
-    //Projection on the result object - list of specific field names to return. If fieldsets are also specified, return the union of fieldsets and fields
-    repeated string fields = 3;
-    //Projection on the result object - list of named projections. E.g. "basic" will return id and name fields. Specifying multiple fieldsets will return the union of fields from all. Specifying fieldsets and fields will also return the union of fields.
-    repeated string fieldsets = 4;
-    //Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
-    repeated Aggregation aggregations = 5;
-    //free text to match in searchable fields
+    // Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
+    repeated Sorting sort = 2 [(.wix.api.maxSize) = 10];
+    // Projection on the result object - list of specific field names to return. If fieldsets are also specified, return the union of fieldsets and fields
+    repeated string fields = 3 [(.wix.api.maxLength) = 200, (.wix.api.maxSize) = 20];
+    // Projection on the result object - list of named projections. E.g. "basic" will return id and name fields. Specifying multiple fieldsets will return the union of fields from all. Specifying fieldsets and fields will also return the union of fields.
+    repeated string fieldsets = 4 [(.wix.api.maxLength) = 100, (.wix.api.maxSize) = 20];
+    // Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
+    repeated Aggregation aggregations = 5 [(.wix.api.maxSize) = 10];
+    // Free text to match in searchable fields
     SearchDetails search = 6;
     oneof paging_method {
-        //Pointer to page of results using offset. Can not be used together with 'cursor_paging'
+        // Pointer to page of results using offset. Can not be used together with 'cursor_paging'
         Paging paging = 7;
-        //Cursor pointing to page of results. Can't be used together with 'paging'. 'cursor_paging.cursor' can not be used together with 'filter' or 'sort'
+        // Cursor pointing to page of results. Can't be used together with 'paging'. 'cursor_paging.cursor' can not be used together with 'filter' or 'sort'
         CursorPaging cursor_paging = 8;
     }
+    // UTC offset or IANA time zone. Valid values are
+    // ISO 8601 UTC offsets, such as +02:00 or -06:00,
+    // and IANA time zone IDs, such as Europe/Rome
+    //
+    // Affects all filters and aggregations returned values.
+    // You may override this behavior in a specific filter by providing
+    // timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
+    google.protobuf.StringValue time_zone = 9 [(.wix.api.maxLength) = 50];
 }
 
 message CursorSearch {
     option (.wix.api.decomposite_of) = "wix.common.Search";
-    //A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
+    // A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
     google.protobuf.Struct filter = 1;
-    //Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
-    repeated Sorting sort = 2;
+    // Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
+    repeated Sorting sort = 2 [(.wix.api.maxSize) = 10];
     reserved 3;
     reserved 4;
     reserved 7;
-    //Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
-    repeated Aggregation aggregations = 5;
-    //free text to match in searchable fields
+    // Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
+    repeated Aggregation aggregations = 5 [(.wix.api.maxSize) = 10];
+    // Free text to match in searchable fields
     SearchDetails search = 6;
     oneof paging_method {
-        //Cursor pointing to page of results. Can't be used together with 'paging'. 'cursor_paging.cursor' can not be used together with 'filter' or 'sort'
+        // Cursor pointing to page of results.
+        // When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
         CursorPaging cursor_paging = 8;
     }
+    // UTC offset or IANA time zone. Valid values are
+    // ISO 8601 UTC offsets, such as +02:00 or -06:00,
+    // and IANA time zone IDs, such as Europe/Rome
+    //
+    // Affects all filters and aggregations returned values.
+    // You may override this behavior in a specific filter by providing
+    // timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
+    google.protobuf.StringValue time_zone = 9 [(.wix.api.maxLength) = 50];
 }
 
 message SearchDetails {
     enum Mode {
-        OR = 0; // any
-        AND = 1; // all
+        OR = 0; // Any of the search terms must be present
+        AND = 1; // All search terms must be present
     }
-    Mode mode = 1; // boolean search mode
-    google.protobuf.StringValue expression = 2; // search term or expression
-    repeated string fields = 3; // fields to search in. if empty - server will search in own default fields
-    bool fuzzy = 4; // flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm)
+    Mode mode = 1; // Defines how separate search terms in `expression` are combined
+    google.protobuf.StringValue expression = 2 [(.wix.api.maxLength) = 100]; // Search term or expression
+    // Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path
+    repeated string fields = 3 [(.wix.api.maxLength) = 200, (.wix.api.maxSize) = 20];
+    bool fuzzy = 4; // Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm)
 }
 
 enum AggregationType {
-    UNKNOWN_AGGREGATION_TYPE = 0;
-    VALUE = 1;
-    RANGE = 2;
-    SCALAR = 3;
+    UNKNOWN_AGGREGATION_TYPE = 0 [(.wix.api.enum_maturity) = NOT_IMPLEMENTED];
+    VALUE = 1; // An aggregation where result buckets are dynamically built - one per unique value
+    RANGE = 2; // An aggregation, where user can define set of ranges - each representing a bucket
+    SCALAR = 3; // A single-value metric aggregation - e.g. min, max, sum, avg
+    DATE_HISTOGRAM = 4; // An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.)
+    NESTED = 5; // Multi-level aggregation, where each next aggregation is nested within previous one
 }
 
 enum ScalarType {
-    UNKNOWN_SCALAR_TYPE = 0;
-    COUNT_DISTINCT = 1;
-    MIN = 2;
-    MAX = 3;
-    SUM = 4 [(.wix.api.enum_exposure) = PRIVATE];
-    AVG = 5 [(.wix.api.enum_exposure) = PRIVATE];
+    UNKNOWN_SCALAR_TYPE = 0 [(.wix.api.enum_maturity) = NOT_IMPLEMENTED];
+    COUNT_DISTINCT = 1; // Count of distinct values
+    MIN = 2; // Minimum value
+    MAX = 3; // Maximum value
+    SUM = 4 [(.wix.api.enum_exposure) = PRIVATE]; // Sum of values
+    AVG = 5 [(.wix.api.enum_exposure) = PRIVATE]; // Average of values
 }
 
 message Aggregation {
     message RangeAggregation {
         message RangeBucket {
-            google.protobuf.DoubleValue from = 1; // Inclusive lower bound of the range. Required if to is not given.
-            google.protobuf.DoubleValue to = 2; // Exclusive upper bound of the range. Required if from is not given.
+            google.protobuf.DoubleValue from = 1; // Inclusive lower bound of the range. Required if to is not given
+            google.protobuf.DoubleValue to = 2; // Exclusive upper bound of the range. Required if from is not given
         }
-        repeated RangeBucket buckets = 1;
+        // List of range buckets, where during aggregation each entity will be placed in the first bucket where its value falls into based on provided range bounds
+        repeated RangeBucket buckets = 1 [(.wix.api.maxSize) = 50];
     }
 
     message ValueAggregation {
         enum SortType {
-            COUNT = 0;
-            VALUE = 1;
+            COUNT = 0; // Should sort by number of matches
+            VALUE = 1; // Should sort by value of the field alphabetically
         }
         enum SortDirection {
-            DESC = 0;
-            ASC = 1;
+            DESC = 0; // Should sort in descending order
+            ASC = 1; // Should sort in ascending order
         }
 
         enum MissingValues {
-            EXCLUDE = 0;
-            INCLUDE = 1;
+            EXCLUDE = 0; // Should missing values be excluded from the aggregation results
+            INCLUDE = 1; // Should missing values be included in the aggregation results
         }
 
         message IncludeMissingValuesOptions {
-            string add_to_bucket = 1; // can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
+            string add_to_bucket = 1 [(.wix.api.maxLength) = 20]; // Can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
         }
 
-        SortType sort_type = 1;
-        SortDirection sort_direction = 2;
+        SortType sort_type = 1; // Should sort by number of matches or value of the field
+        SortDirection sort_direction = 2; // Should sort in ascending or descending order
         google.protobuf.Int32Value limit = 3; // How many aggregations would you like to return? Can be between 1 and 250. 10 is the default.
 
-        MissingValues missing_values = 4; // should missing values be included or excluded from the aggregation results. Default is EXCLUDE
+        MissingValues missing_values = 4; // Should missing values be included or excluded from the aggregation results. Default is EXCLUDE
         oneof options {
             option (.wix.api.aligned_with_enum).field = "missing_values";
-            IncludeMissingValuesOptions include_options = 5; // options for including missing values
+            IncludeMissingValuesOptions include_options = 5; // Options for including missing values
         }
     }
 
     message ScalarAggregation {
-        ScalarType type = 1;
+        ScalarType type = 1; // Define the operator for the scalar aggregation
     }
 
     message GroupByAggregation {
-        google.protobuf.StringValue name = 1;
-        string field_path = 3;
+        google.protobuf.StringValue name = 1 [(.wix.api.maxLength) = 100]; // User-defined name of aggregation, should be unique, will appear in aggregation results
+        string field_path = 3 [(.wix.api.maxLength) = 200]; // Field to aggregate by
         oneof kind {
-            ValueAggregation value = 4;
+            ValueAggregation value = 4; // Value aggregation configuration
         }
     }
 
-    google.protobuf.StringValue name = 1;
-    AggregationType type = 2;
-    string field_path = 3;
+    // Nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one
+    message NestedAggregation {
+        reserved 1;
+
+        enum NestedAggregationType {
+            UNKNOWN_AGGREGATION_TYPE = 0 [(.wix.api.enum_maturity) = NOT_IMPLEMENTED];
+            VALUE = 1; // An aggregation where result buckets are dynamically built - one per unique value
+            RANGE = 2; // An aggregation, where user can define set of ranges - each representing a bucket
+            SCALAR = 3; // A single-value metric aggregation - e.g. min, max, sum, avg
+            DATE_HISTOGRAM = 4; // An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.)
+        }
+
+        message NestedAggregationItem {
+            google.protobuf.StringValue name = 1 [(.wix.api.maxLength) = 100]; // User-defined name of aggregation, should be unique, will appear in aggregation results
+            NestedAggregationType type = 2; // Type of aggregation, client must provide matching aggregation field below
+            string field_path = 3 [(.wix.api.maxLength) = 200]; // Field to aggregate by, use dont notation to specify json path
+            oneof kind {
+                ValueAggregation value = 4; // Value aggregation
+                RangeAggregation range = 5; // Range aggregation
+                ScalarAggregation scalar = 6; // Scalar aggregation
+                DateHistogramAggregation date_histogram = 9; // Date histogram aggregation
+            }
+        }
+
+        // Flattened list of aggregations, where each next aggregation is nested within previous one
+        repeated NestedAggregationItem nested_aggregations = 2 [(.wix.api.minSize) = 2, (.wix.api.maxSize) = 3];
+    }
+
+    message DateHistogramAggregation {
+        enum Interval {
+            UNKNOWN_INTERVAL = 0 [(.wix.api.enum_maturity) = NOT_IMPLEMENTED];
+            YEAR = 1; // Yearly interval
+            MONTH = 2; // Monthly interval
+            WEEK = 3; // Weekly interval
+            DAY = 4; // Daily interval
+            HOUR = 5; // Hourly interval
+            MINUTE = 6; // Minute interval
+            SECOND = 7; // Second interval
+        }
+
+        Interval interval = 1; // Interval for date histogram aggregation
+    }
+
+    google.protobuf.StringValue name = 1 [(.wix.api.maxLength) = 100]; // User-defined name of aggregation, should be unique, will appear in aggregation results
+    AggregationType type = 2; // Type of aggregation, client must provide matching aggregation field below
+    string field_path = 3 [(.wix.api.maxLength) = 200]; // Field to aggregate by, use dot notation to specify json path
     oneof kind {
-        ValueAggregation value = 4;
-        RangeAggregation range = 5;
-        ScalarAggregation scalar = 6;
+        ValueAggregation value = 4; // Value aggregation
+        RangeAggregation range = 5; // Range aggregation
+        ScalarAggregation scalar = 6; // Scalar aggregation
+        DateHistogramAggregation date_histogram = 9; // Date histogram aggregation
+        NestedAggregation nested = 8; // Nested aggregation
     }
-    GroupByAggregation group_by = 7;
+
+    // deprecated, use `nested` instead
+    GroupByAggregation group_by = 7 [deprecated = true, (.wix.api.field_deprecated) = {replaced_by: "kind.nested", target_removal_date: "2024-03-30"}];
 }
 
 message AggregationData {
     message AggregationResults {
         message ValueResults {
             message ValueAggregationResult {
-                string value = 1;
-                int32 count = 2;
+                string value = 1 [(.wix.api.maxLength) = 100]; // Value of the field
+                int32 count = 2; // Count of entities with this value
             }
-            repeated ValueAggregationResult results = 1;
+            repeated ValueAggregationResult results = 1 [(.wix.api.maxSize) = 250]; // List of value aggregations
         }
 
         message RangeResults {
             message RangeAggregationResult {
-                google.protobuf.DoubleValue from = 1;
-                google.protobuf.DoubleValue to = 2;
-                int32 count = 3;
+                google.protobuf.DoubleValue from = 1; // Inclusive lower bound of the range
+                google.protobuf.DoubleValue to = 2; // Exclusive upper bound of the range
+                int32 count = 3; // Count of entities in this range
             }
-            repeated RangeAggregationResult results = 1;
+            repeated RangeAggregationResult results = 1 [(.wix.api.maxSize) = 50]; // List of ranges returned in same order as requested
         }
 
         message ScalarResult {
-            ScalarType type = 1;
-            double value = 2;
+            ScalarType type = 1; // Type of scalar aggregation
+            double value = 2; // Value of the scalar aggregation
         }
 
         message GroupByValueResults {
             message NestedValueAggregationResult {
-                string value = 1;
-                NestedAggregationResults nested_results = 2;
+                string value = 1 [(.wix.api.maxLength) = 1000]; // Value of the field
+                NestedAggregationResults nested_results = 2; // Nested aggregations
 
             }
-            repeated NestedValueAggregationResult results = 1;
+            repeated NestedValueAggregationResult results = 1 [(.wix.api.maxSize) = 1000]; // List of value aggregations
         }
 
         message NestedAggregationResults {
-            string name = 1;
-            AggregationType type = 2;
-            string field_path = 6;
+            string name = 1 [(.wix.api.maxLength) = 100]; // User-defined name of aggregation, matches the one provided in request
+            AggregationType type = 2; // Type of aggregation that matches result
+            string field_path = 6 [(.wix.api.maxLength) = 200]; // Field to aggregate by, matches the one provided in request
             oneof result {
-                ValueResults values = 3;
-                RangeResults ranges = 4;
-                ScalarResult scalar = 5;
+                ValueResults values = 3; // Value aggregation results
+                RangeResults ranges = 4; // Range aggregation results
+                ScalarResult scalar = 5; // Scalar aggregation results
             }
         }
 
-        string name = 1;
-        AggregationType type = 2;
-        string field_path = 6;
+        // Results of `NESTED` aggregation type in a flattened form
+        // aggregations in resulting array are keyed by requested aggregation `name`.
+        message NestedResults {
+            message ValueResult {
+                string value = 1 [(.wix.api.maxLength) = 1000]; // Value of the field
+                google.protobuf.Int32Value count = 2; // Count of entities with this value
+            }
+            message RangeResult {
+                google.protobuf.DoubleValue from = 1; // Inclusive lower bound of the range
+                google.protobuf.DoubleValue to = 2; // Exclusive upper bound of the range
+                google.protobuf.Int32Value count = 3; // Count of entities in this range
+            }
+
+            message ScalarResult {
+                double value = 1; // Value of the scalar aggregation
+            }
+
+            message NestedResultValue {
+                oneof result {
+                    ValueResult value = 1; // Value aggregation result
+                    RangeResult range = 2; // Range aggregation result
+                    ScalarResult scalar = 3; // Scalar aggregation result
+                    ValueResult date_histogram = 4; // Date histogram aggregation result
+                }
+            }
+
+            message Results {
+                map<string, NestedResultValue> results = 1; // List of nested aggregations
+            }
+
+            repeated Results results = 1 [(.wix.api.maxSize) = 1000]; // List of nested aggregations
+        }
+
+        message DateHistogramResults {
+            message DateHistogramResult {
+                string value = 1 [(.wix.api.maxLength) = 100]; // Date in ISO 8601 format
+                int32 count = 2; // Count of documents in the bucket
+            }
+            repeated DateHistogramResult results = 1 [(.wix.api.maxSize) = 200]; // List of date histogram aggregations
+        }
+
+        string name = 1 [(.wix.api.maxLength) = 100]; // User-defined name of aggregation as derived from search request
+        AggregationType type = 2; // Type of aggregation that must match provided kind as derived from search request
+        string field_path = 6 [(.wix.api.maxLength) = 200]; // Field to aggregate by as derived from search request
         oneof result {
-            ValueResults values = 3;
-            RangeResults ranges = 4;
-            ScalarResult scalar = 5;
-            GroupByValueResults grouped_by_value = 7;
+            ValueResults values = 3; // Value aggregation results
+            RangeResults ranges = 4; // Range aggregation results
+            ScalarResult scalar = 5; // Scalar aggregation results
+            GroupByValueResults grouped_by_value = 7; // Group by value aggregation results
+            DateHistogramResults date_histogram = 8; // Date histogram aggregation results
+            NestedResults nested = 9; // Nested aggregation results
         }
     }
 
-    repeated AggregationResults results = 1; // key = aggregation name (as derived from search request)
+    repeated AggregationResults results = 1 [(.wix.api.maxSize) = 10000]; // key = aggregation name (as derived from search request)
 }
 
 /*
@@ -530,4 +641,128 @@ message ProductSearchResponse {
     } ]
   }
 }
+
+// example of 2-level nested aggregation request:
+{
+  "filter" : {
+    "region" : "EU"
+  },
+  "aggregations" : [ {
+    "name" : "my nested",
+    "type" : "NESTED",
+    "nested" : {
+      "nestedAggregations" : [ {
+        "name" : "daily",
+        "type" : "DATE_HISTOGRAM",
+        "fieldPath" : "date_updated",
+        "dateHistogram" : {
+          "interval" : "DAY"
+        }
+      }, {
+        "name" : "inventory status",
+        "type" : "VALUE",
+        "fieldPath" : "status",
+        "value" : { }
+      }, {
+        "name" : "sum",
+        "type" : "SCALAR",
+        "fieldPath" : "price",
+        "scalar" : {
+          "type" : "SUM"
+        }
+      } ]
+    }
+  } ]
+}
+
+// example of 2-level nested aggregation response:
+{
+  "aggregations" : {
+    "results" : [ {
+      "name" : "my nested",
+      "type" : "NESTED",
+      "fieldPath" : "DUNNO WHAT TO DO WITH THIS",
+      "nested" : {
+        "results" : [ {
+          "results" : {
+            "daily" : {
+              "dateHistogram" : {
+                "value" : "2023.1.1"
+              }
+            },
+            "inventory status" : {
+              "value" : {
+                "value" : "SOLD",
+                "count" : 12
+              }
+            },
+            "sum" : {
+              "scalar" : {
+                "value" : 10.0
+              }
+            }
+          }
+        }, {
+          "results" : {
+            "daily" : {
+              "dateHistogram" : {
+                "value" : "2023.1.1"
+              }
+            },
+            "inventory status" : {
+              "value" : {
+                "value" : "NOT-SOLD",
+                "count" : 13
+              }
+            },
+            "sum" : {
+              "scalar" : {
+                "value" : 5.0
+              }
+            }
+          }
+        }, {
+          "results" : {
+            "daily" : {
+              "dateHistogram" : {
+                "value" : "2023.1.2"
+              }
+            },
+            "inventory status" : {
+              "value" : {
+                "value" : "SOLD",
+                "count" : 5
+              }
+            },
+            "sum" : {
+              "scalar" : {
+                "value" : 10.0
+              }
+            }
+          }
+        }, {
+          "results" : {
+            "daily" : {
+              "dateHistogram" : {
+                "value" : "2023.1.2"
+              }
+            },
+            "inventory status" : {
+              "value" : {
+                "value" : "NOT-SOLD",
+                "count" : 7
+              }
+            },
+            "sum" : {
+              "scalar" : {
+                "value" : 10.0
+              }
+            }
+          }
+        } ]
+      }
+    } ]
+  }
+}
+
 */

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/common/sorting.proto

@@ -4,6 +4,7 @@ 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";
@@ -14,12 +15,22 @@ message Sorting {
         field: "order"
     };
     // Name of the field to sort by.
-    string field_name = 1;
+    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-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/common/tags.proto

@@ -36,7 +36,7 @@ message Tags {
   };
 
   message TagList {
-    repeated string tag_ids = 1 [(.wix.api.maxSize) = 100, (.wix.api.format) = GUID]; // List of tag IDs
+    repeated string tag_ids = 1 [(.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.
@@ -49,7 +49,7 @@ message PublicTags {
   };
 
   message TagList {
-    repeated string tag_ids = 1 [(.wix.api.maxSize) = 100, (.wix.api.format) = GUID]; // List of tag IDs
+    repeated string tag_ids = 1 [(.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.
 }