@wix/auto_sdk_bookings_services 1.0.63 → 1.0.64

package/build/cjs/{bookings-services-v2-service-services.universal-Cy9SqUQp.d.ts → bookings-services-v2-service-services.universal-D4FwlNie.d.ts}

@@ -1894,61 +1894,48 @@ interface PagingMetadataV2 {
 }
 interface Cursors {
     /**
-     * Cursor token for retrieving the next page of results.
-     *
-     * Use this token in subsequent requests to continue pagination forward.
-     * Value is `null` when on the last page of results.
+     * Cursor pointing to next page in the list of results.
      * @maxLength 16000
      */
     next?: string | null;
     /**
-     * Cursor token for retrieving the previous page of results.
-     *
-     * Use this token to navigate backwards through result pages.
-     * Value is `null` when on the first page of results.
+     * Cursor pointing to previous page in the list of results.
      * @maxLength 16000
      */
     prev?: string | null;
 }
 interface SearchServicesRequest {
-    /**
-     * Search criteria including filter, sort, aggregations, and paging options.
-     *
-     * Refer to the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/filtering-and-sorting)) for complete filter and sorting options.
-     */
+    /** WQL, search or aggregation expression. */
     search: CursorSearch;
 }
 interface CursorSearch extends CursorSearchPagingMethodOneOf {
     /**
-     * Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
-     * `filter`, `sort`, or `search` can't be specified.
+     * Cursor pointing to page of results.
+     * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
      */
     cursorPaging?: CursorPaging;
-    /**
-     * Filter object for narrowing search results. For example, to return only services with specific payment options: `"filter": {"payment.options.online": true, "payment.options.in_person": false}`.
-     *
-     * Learn more about the filter format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/filtering-and-sorting)).
-     */
+    /** 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) */
     filter?: Record<string, any> | null;
     /**
-     * Array of sort objects specifying result order. For example, to sort by creation date in descending order: `"sort": [{"fieldName": "createdDate", "order": "DESC"}]`.
-     *
-     * Learn more about the sort format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/filtering-and-sorting)).
+     * Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
      * @maxSize 10
      */
     sort?: Sorting[];
     /**
-     * Aggregations for grouping data into categories (facets) and providing summaries for each category.
-     * For example, use aggregations to categorize search results by service type, payment options, or locations.
+     * 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.
      * @maxSize 10
      */
     aggregations?: Aggregation[];
-    /** Free text to match in searchable fields. */
+    /** Free text to match in searchable fields */
     search?: SearchDetails;
     /**
-     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) or [ISO 8601 UTC offset format](https://en.wikipedia.org/wiki/ISO_8601#Time_offsets_from_UTC) for adjusting time fields in the specified filters and returned aggregation data. For example, `America/New_York`, `UTC`, or `+02:00`.
+     * 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
      *
-     * Default: Time zone specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     * 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"`
      * @maxLength 50
      */
     timeZone?: string | null;
@@ -1956,37 +1943,37 @@ interface CursorSearch extends CursorSearchPagingMethodOneOf {
 /** @oneof */
 interface CursorSearchPagingMethodOneOf {
     /**
-     * Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
-     * `filter`, `sort`, or `search` can't be specified.
+     * Cursor pointing to page of results.
+     * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
      */
     cursorPaging?: CursorPaging;
 }
 interface Aggregation extends AggregationKindOneOf {
-    /** Value aggregation configuration. */
+    /** Value aggregation */
     value?: ValueAggregation;
-    /** Range aggregation configuration. */
+    /** Range aggregation */
     range?: RangeAggregation;
-    /** Scalar aggregation configuration. */
+    /** Scalar aggregation */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation configuration. */
+    /** Date histogram aggregation */
     dateHistogram?: DateHistogramAggregation;
-    /** Nested aggregation configuration. */
+    /** Nested aggregation */
     nested?: NestedAggregation;
     /**
-     * User-defined name of aggregation. Must be unique and will appear in aggregation results.
+     * User-defined name of aggregation, should be unique, will appear in aggregation results
      * @maxLength 100
      */
     name?: string | null;
-    /** Type of aggregation. Client must specify matching aggregation field below. */
+    /** Type of aggregation, client must provide matching aggregation field below */
     type?: AggregationTypeWithLiterals;
     /**
-     * Path to the field to aggregate by in dot notation. For example `name` or `paymentOptions.online`.
+     * Field to aggregate by, use dot notation to specify json path
      * @maxLength 200
      */
     fieldPath?: string;
     /**
-     * Deprecated, use `nested` instead.
-     * @deprecated Deprecated, use `nested` instead.
+     * deprecated, use `nested` instead
+     * @deprecated deprecated, use `nested` instead
      * @replacedBy kind.nested
      * @targetRemovalDate 2025-01-01
      */
@@ -1994,21 +1981,21 @@ interface Aggregation extends AggregationKindOneOf {
 }
 /** @oneof */
 interface AggregationKindOneOf {
-    /** Value aggregation configuration. */
+    /** Value aggregation */
     value?: ValueAggregation;
-    /** Range aggregation configuration. */
+    /** Range aggregation */
     range?: RangeAggregation;
-    /** Scalar aggregation configuration. */
+    /** Scalar aggregation */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation configuration. */
+    /** Date histogram aggregation */
     dateHistogram?: DateHistogramAggregation;
-    /** Nested aggregation configuration. */
+    /** Nested aggregation */
     nested?: NestedAggregation;
 }
 interface RangeBucket {
-    /** Inclusive lower bound of the range. Required if `to` isn't specified. */
+    /** Inclusive lower bound of the range. Required if to is not given. */
     from?: number | null;
-    /** Exclusive upper bound of the range. Required if `from` isn't specified. */
+    /** Exclusive upper bound of the range. Required if from is not given. */
     to?: number | null;
 }
 declare enum SortType {
@@ -2031,80 +2018,58 @@ declare enum MissingValues {
 type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
 interface IncludeMissingValuesOptions {
     /**
-     * Custom bucket name for missing values.
-     *
-     * Default values:
-     * - string: `N/A`
-     * - int: `0`
-     * - bool: `false`
+     * can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
      * @maxLength 20
      */
     addToBucket?: string;
 }
 declare enum ScalarType {
     UNKNOWN_SCALAR_TYPE = "UNKNOWN_SCALAR_TYPE",
-    /** Total number of distinct values. */
     COUNT_DISTINCT = "COUNT_DISTINCT",
-    /** Minimum value. */
     MIN = "MIN",
-    /** Maximum value. */
     MAX = "MAX"
 }
 /** @enumType */
 type ScalarTypeWithLiterals = ScalarType | 'UNKNOWN_SCALAR_TYPE' | 'COUNT_DISTINCT' | 'MIN' | 'MAX';
 interface ValueAggregation extends ValueAggregationOptionsOneOf {
-    /** Options for including missing values in the aggregation results. */
+    /** options for including missing values */
     includeOptions?: IncludeMissingValuesOptions;
-    /** Whether to sort by number of matches or value of the field. */
+    /** Should sort by number of matches or value of the field */
     sortType?: SortTypeWithLiterals;
-    /** Whether to sort in ascending or descending order. */
+    /** Should sort in ascending or descending order */
     sortDirection?: SortDirectionWithLiterals;
-    /**
-     * Number of aggregations to return.
-     *
-     * Min: `1`
-     * Max: `250`
-     * Default: `10`
-     */
+    /** How many aggregations would you like to return? Can be between 1 and 250. 10 is the default. */
     limit?: number | null;
-    /**
-     * Whether missing values should be included or excluded from the aggregation results.
-     *
-     * Default: `EXCLUDE`
-     */
+    /** should missing values be included or excluded from the aggregation results. Default is EXCLUDE */
     missingValues?: MissingValuesWithLiterals;
 }
 /** @oneof */
 interface ValueAggregationOptionsOneOf {
-    /** Options for including missing values in the aggregation results. */
+    /** options for including missing values */
     includeOptions?: IncludeMissingValuesOptions;
 }
 declare enum NestedAggregationType {
     UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
-    /** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
     VALUE = "VALUE",
-    /** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
     RANGE = "RANGE",
-    /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
     SCALAR = "SCALAR",
-    /** Calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). */
     DATE_HISTOGRAM = "DATE_HISTOGRAM"
 }
 /** @enumType */
 type NestedAggregationTypeWithLiterals = NestedAggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM';
 interface RangeAggregation {
     /**
-     * List of range buckets defining the ranges for aggregation. During aggregation, each entity is placed in the first bucket where its value falls within the specified range bounds.
+     * Range buckets
      * @maxSize 50
      */
     buckets?: RangeBucket[];
 }
 interface ScalarAggregation {
-    /** Operator for the scalar aggregation, for example `COUNT_DISTINCT`, `MIN`, `MAX`. */
+    /** Define the operator for the scalar aggregation */
     type?: ScalarTypeWithLiterals;
 }
 interface DateHistogramAggregation {
-    /** Time interval for date histogram aggregation, for example `DAY`, `HOUR`, `MONTH`. */
+    /** Interval for date histogram aggregation */
     interval?: IntervalWithLiterals;
 }
 declare enum Interval {
@@ -2128,355 +2093,322 @@ declare enum Interval {
 /** @enumType */
 type IntervalWithLiterals = Interval | 'UNKNOWN_INTERVAL' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
 interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
-    /** Value aggregation configuration. Calculates the distribution of field values within the dataset. */
+    /** Value aggregation */
     value?: ValueAggregation;
-    /** Range aggregation configuration. Calculates counts within user-defined value ranges. */
+    /** Range aggregation */
     range?: RangeAggregation;
-    /** Scalar aggregation configuration. Calculates single numerical metrics like count, min, max, sum, or average. */
+    /** Scalar aggregation */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation configuration. Calculates counts within time intervals. */
+    /** Date histogram aggregation */
     dateHistogram?: DateHistogramAggregation;
     /**
-     * User-defined name of aggregation. Must be unique and will appear in aggregation results.
+     * User-defined name of aggregation, should be unique, will appear in aggregation results
      * @maxLength 100
      */
     name?: string | null;
-    /** Type of aggregation. Client must specify matching aggregation field below. */
+    /** Type of aggregation, client must provide matching aggregation field below */
     type?: NestedAggregationTypeWithLiterals;
     /**
-     * Path to the field to aggregate by in dot notation. For example `name` or `paymentOptions.online`.
+     * Field to aggregate by, use dont notation to specify json path
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface NestedAggregationItemKindOneOf {
-    /** Value aggregation configuration. Calculates the distribution of field values within the dataset. */
+    /** Value aggregation */
     value?: ValueAggregation;
-    /** Range aggregation configuration. Calculates counts within user-defined value ranges. */
+    /** Range aggregation */
     range?: RangeAggregation;
-    /** Scalar aggregation configuration. Calculates single numerical metrics like count, min, max, sum, or average. */
+    /** Scalar aggregation */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation configuration. Calculates counts within time intervals. */
+    /** Date histogram aggregation */
     dateHistogram?: DateHistogramAggregation;
 }
 declare enum AggregationType {
     UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
-    /** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
     VALUE = "VALUE",
-    /** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
     RANGE = "RANGE",
-    /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
     SCALAR = "SCALAR",
-    /** Calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). */
     DATE_HISTOGRAM = "DATE_HISTOGRAM",
-    /** Flattened list of aggregations, where each aggregation is nested within previous 1. */
     NESTED = "NESTED"
 }
 /** @enumType */
 type AggregationTypeWithLiterals = AggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM' | 'NESTED';
-/** Nested aggregation for multi-level faceted search. Allows exploring large amounts of data through multiple levels of categorization, where each subsequent aggregation is nested within the previous aggregation to create hierarchical data summaries. */
+/** nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one */
 interface NestedAggregation {
     /**
-     * Flattened list of aggregations where each next aggregation is nested within the previous 1.
+     * Flattened list of aggregations, where each next aggregation is nested within previous one
      * @minSize 2
      * @maxSize 10
      */
     nestedAggregations?: NestedAggregationItem[];
 }
 interface GroupByAggregation extends GroupByAggregationKindOneOf {
-    /** Value aggregation configuration. */
+    /** Value aggregation configuration */
     value?: ValueAggregation;
     /**
-     * User-defined name of aggregation. Must be unique and will appear in aggregation results.
+     * User-defined name of aggregation, should be unique, will appear in aggregation results
      * @maxLength 100
      */
     name?: string | null;
     /**
-     * Path to the field to aggregate by in dot notation. For example `name` or `paymentOptions.online`.
+     * Field to aggregate by
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface GroupByAggregationKindOneOf {
-    /** Value aggregation configuration. */
+    /** Value aggregation configuration */
     value?: ValueAggregation;
 }
 interface SearchDetails {
-    /** Search mode. Defines the search logic for combining multiple terms in the `expression`. */
+    /** Boolean search mode */
     mode?: ModeWithLiterals;
     /**
-     * Search term or expression.
+     * Search term or expression
      * @maxLength 200
      */
     expression?: string | null;
     /**
-     * Fields to search in. If the array is empty, all searchable fields are searched. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
+     * Fields to search in. If empty - server will search in own default fields
      * @maxSize 10
      * @maxLength 200
      */
     fields?: string[];
-    /** Whether to enable the search function to use an algorithm to automatically find results that are close to the search expression, such as typos and declensions. */
+    /** Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
     fuzzy?: boolean;
 }
 declare enum Mode {
-    /** At least 1 of the search terms must be present. */
+    /** Any */
     OR = "OR",
-    /** All search terms must be present. */
+    /** All */
     AND = "AND"
 }
 /** @enumType */
 type ModeWithLiterals = Mode | 'OR' | 'AND';
 interface SearchServicesResponse {
-    /**
-     * Retrieved services that match the search criteria specified in the request.
-     *
-     * Each service includes all standard service information including name, description,
-     * pricing details, location options, schedule information, and payment configuration.
-     */
+    /** The retrieved services. */
     services?: Service[];
-    /**
-     * Cursor-based paging metadata for navigating search results.
-     *
-     * Contains the current page's cursor information, whether there are more results available,
-     * and count details. Use the `next` cursor to retrieve subsequent pages of results.
-     */
+    /** Cursor paging metadata */
     pagingMetadata?: CursorPagingMetadata;
-    /**
-     * Aggregation results based on the aggregations specified in the search request.
-     *
-     * Provides categorized data summaries such as service counts by type, location distribution,
-     * payment method statistics, or custom aggregations. Available only when aggregations
-     * are requested in the search criteria.
-     */
+    /** Response aggregation data */
     aggregationData?: AggregationData;
 }
 interface CursorPagingMetadata {
-    /**
-     * Number of items returned in the current response page.
-     *
-     * This count reflects the actual number of items in the current result set,
-     * which may be less than the requested limit if fewer items are available.
-     */
+    /** Number of items returned in the response. */
     count?: number | null;
-    /**
-     * Navigation cursors for moving between result pages.
-     *
-     * Contains `next` and `prev` cursor tokens for pagination. Use the `next` cursor
-     * to retrieve subsequent pages and `prev` cursor to go back to previous pages.
-     * Learn more about cursor paging in the [API Query Language guide](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging).
-     */
+    /** Use these cursor to paginate between results. [Read more](https://dev.wix.com/api/rest/getting-started/api-query-language#getting-started_api-query-language_cursor-paging). */
     cursors?: Cursors;
     /**
-     * Indicates whether additional results are available beyond the current page.
-     *
-     * - `true`: More results exist and can be retrieved using the `next` cursor.
-     * - `false`: This is the final page of results.
+     * 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.
      */
     hasNext?: boolean | null;
 }
 interface AggregationData {
     /**
-     * Array of aggregation results, each containing the aggregation metadata and its calculated values for the specified search criteria.
+     * key = aggregation name (as derived from search request)
      * @maxSize 10000
      */
     results?: AggregationResults[];
 }
 interface ValueAggregationResult {
     /**
-     * Value of the field.
+     * Value of the field
      * @maxLength 100
      */
     value?: string;
-    /** Count of entities with this value. */
+    /** Count of entities with this value */
     count?: number;
 }
 interface RangeAggregationResult {
-    /** Inclusive lower bound of the range. */
+    /** Inclusive lower bound of the range */
     from?: number | null;
-    /** Exclusive upper bound of the range. */
+    /** Exclusive upper bound of the range */
     to?: number | null;
-    /** Count of entities in this range. */
+    /** Count of entities in this range */
     count?: number;
 }
 interface NestedAggregationResults extends NestedAggregationResultsResultOneOf {
-    /** Value aggregation results. */
+    /** Value aggregation results */
     values?: ValueResults;
-    /** Range aggregation results. */
+    /** Range aggregation results */
     ranges?: RangeResults;
-    /** Scalar aggregation results. */
+    /** Scalar aggregation results */
     scalar?: AggregationResultsScalarResult;
     /**
-     * User-defined name of aggregation, matches the one specified in request.
+     * User-defined name of aggregation, matches the one provided in request
      * @maxLength 100
      */
     name?: string;
-    /** Type of aggregation that matches result. */
+    /** Type of aggregation that matches result */
     type?: AggregationTypeWithLiterals;
     /**
-     * Path to the field to aggregate by in dot notation. For example `name` or `paymentOptions.online`.
+     * Field to aggregate by, matches the one provided in request
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface NestedAggregationResultsResultOneOf {
-    /** Value aggregation results. */
+    /** Value aggregation results */
     values?: ValueResults;
-    /** Range aggregation results. */
+    /** Range aggregation results */
     ranges?: RangeResults;
-    /** Scalar aggregation results. */
+    /** Scalar aggregation results */
     scalar?: AggregationResultsScalarResult;
 }
 interface ValueResults {
     /**
-     * Array of value aggregation results, each containing a field value and the count of entities with that value.
+     * List of value aggregations
      * @maxSize 250
      */
     results?: ValueAggregationResult[];
 }
 interface RangeResults {
     /**
-     * Array of range aggregation results returned in the same order as requested, each containing range bounds and count of entities within that range.
+     * List of ranges returned in same order as requested
      * @maxSize 50
      */
     results?: RangeAggregationResult[];
 }
 interface AggregationResultsScalarResult {
-    /** Type of scalar aggregation. */
+    /** Type of scalar aggregation */
     type?: ScalarTypeWithLiterals;
-    /** Value of the scalar aggregation. */
+    /** Value of the scalar aggregation */
     value?: number;
 }
 interface NestedValueAggregationResult {
     /**
-     * Value of the field.
+     * Value of the field
      * @maxLength 1000
      */
     value?: string;
-    /** Nested aggregations. */
+    /** Nested aggregations */
     nestedResults?: NestedAggregationResults;
 }
 interface ValueResult {
     /**
-     * Value of the field.
+     * Value of the field
      * @maxLength 1000
      */
     value?: string;
-    /** Count of entities with this value. */
+    /** Count of entities with this value */
     count?: number | null;
 }
 interface RangeResult {
-    /** Inclusive lower bound of the range. */
+    /** Inclusive lower bound of the range */
     from?: number | null;
-    /** Exclusive upper bound of the range. */
+    /** Exclusive upper bound of the range */
     to?: number | null;
-    /** Count of entities in this range. */
+    /** Count of entities in this range */
     count?: number | null;
 }
 interface ScalarResult {
-    /** Value of the scalar aggregation. */
+    /** Value of the scalar aggregation */
     value?: number;
 }
 interface NestedResultValue extends NestedResultValueResultOneOf {
-    /** Value aggregation result. */
+    /** Value aggregation result */
     value?: ValueResult;
-    /** Range aggregation result. */
+    /** Range aggregation result */
     range?: RangeResult;
-    /** Scalar aggregation result. */
+    /** Scalar aggregation result */
     scalar?: ScalarResult;
-    /** Date histogram aggregation result. */
+    /** Date histogram aggregation result */
     dateHistogram?: ValueResult;
 }
 /** @oneof */
 interface NestedResultValueResultOneOf {
-    /** Value aggregation result. */
+    /** Value aggregation result */
     value?: ValueResult;
-    /** Range aggregation result. */
+    /** Range aggregation result */
     range?: RangeResult;
-    /** Scalar aggregation result. */
+    /** Scalar aggregation result */
     scalar?: ScalarResult;
-    /** Date histogram aggregation result. */
+    /** Date histogram aggregation result */
     dateHistogram?: ValueResult;
 }
 interface Results {
-    /** Map of nested aggregation results, keyed by aggregation name. */
+    /** List of nested aggregations */
     results?: Record<string, NestedResultValue>;
 }
 interface DateHistogramResult {
     /**
-     * Date in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * Date in ISO 8601 format
      * @maxLength 100
      */
     value?: string;
-    /** Count of documents in the bucket. */
+    /** Count of documents in the bucket */
     count?: number;
 }
 interface GroupByValueResults {
     /**
-     * Array of nested value aggregation results, each containing a field value and the associated nested aggregation data.
+     * List of value aggregations
      * @maxSize 1000
      */
     results?: NestedValueAggregationResult[];
 }
 interface DateHistogramResults {
     /**
-     * Array of date histogram aggregation results, each containing a date bucket and its count.
+     * List of date histogram aggregations
      * @maxSize 200
      */
     results?: DateHistogramResult[];
 }
 /**
- * Results of `NESTED` aggregation type in a flattened form.
- * Aggregations in resulting array are keyed by requested aggregation `name`.
+ * results of `NESTED` aggregation type in a flattened form
+ * aggregations in resulting array are keyed by requested aggregation `name`.
  */
 interface NestedResults {
     /**
-     * Array of nested aggregation result groups, each containing multiple aggregation results.
+     * List of nested aggregations
      * @maxSize 1000
      */
     results?: Results[];
 }
 interface AggregationResults extends AggregationResultsResultOneOf {
-    /** Value aggregation results. */
+    /** Value aggregation results */
     values?: ValueResults;
-    /** Range aggregation results. */
+    /** Range aggregation results */
     ranges?: RangeResults;
-    /** Scalar aggregation results. */
+    /** Scalar aggregation results */
     scalar?: AggregationResultsScalarResult;
-    /** Group by value aggregation results. */
+    /** Group by value aggregation results */
     groupedByValue?: GroupByValueResults;
-    /** Date histogram aggregation results. */
+    /** Date histogram aggregation results */
     dateHistogram?: DateHistogramResults;
-    /** Nested aggregation results. */
+    /** Nested aggregation results */
     nested?: NestedResults;
     /**
-     * User-defined name of aggregation as derived from search request.
+     * User-defined name of aggregation as derived from search request
      * @maxLength 100
      */
     name?: string;
-    /** Type of aggregation that must match specified kind as derived from search request. */
+    /** Type of aggregation that must match provided kind as derived from search request */
     type?: AggregationTypeWithLiterals;
     /**
-     * Path to the field to aggregate by in dot notation. For example `name` or `paymentOptions.online`.
+     * Field to aggregate by as derived from search request
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface AggregationResultsResultOneOf {
-    /** Value aggregation results. */
+    /** Value aggregation results */
     values?: ValueResults;
-    /** Range aggregation results. */
+    /** Range aggregation results */
     ranges?: RangeResults;
-    /** Scalar aggregation results. */
+    /** Scalar aggregation results */
     scalar?: AggregationResultsScalarResult;
-    /** Group by value aggregation results. */
+    /** Group by value aggregation results */
     groupedByValue?: GroupByValueResults;
-    /** Date histogram aggregation results. */
+    /** Date histogram aggregation results */
     dateHistogram?: DateHistogramResults;
-    /** Nested aggregation results. */
+    /** Nested aggregation results */
     nested?: NestedResults;
 }
 interface QueryPoliciesRequest {
@@ -3789,8 +3721,8 @@ interface ServiceSearchSpec extends SearchSpec {
 type CommonSearchWithEntityContext = Search<Service, ServiceSearchSpec>;
 type ServiceSearch = {
     /**
-    Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
-    `filter`, `sort`, or `search` can't be specified.
+    Cursor pointing to page of results.
+    When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
     */
     cursorPaging?: {
         /**
@@ -3809,15 +3741,11 @@ type ServiceSearch = {
         cursor?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['cursor'] | null;
     };
     /**
-    Filter object for narrowing search results. For example, to return only services with specific payment options: `"filter": {"payment.options.online": true, "payment.options.in_person": false}`.
-  
-    Learn more about the filter format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/filtering-and-sorting)).
+    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)
     */
     filter?: CommonSearchWithEntityContext['filter'] | null;
     /**
-    Array of sort objects specifying result order. For example, to sort by creation date in descending order: `"sort": [{"fieldName": "createdDate", "order": "DESC"}]`.
-  
-    Learn more about the sort format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/filtering-and-sorting)).
+    Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
     @maxSize: 10
     */
     sort?: {
@@ -3832,81 +3760,84 @@ type ServiceSearch = {
         order?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['order'];
     }[];
     /**
-    Aggregations for grouping data into categories (facets) and providing summaries for each category.
-    For example, use aggregations to categorize search results by service type, payment options, or locations.
+    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.
     @maxSize: 10
     */
     aggregations?: {
         /**
-      Value aggregation configuration.
+      Value aggregation
       */
         value?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['value'];
         /**
-      Range aggregation configuration.
+      Range aggregation
       */
         range?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['range'];
         /**
-      Scalar aggregation configuration.
+      Scalar aggregation
       */
         scalar?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['scalar'];
         /**
-      Date histogram aggregation configuration.
+      Date histogram aggregation
       */
         dateHistogram?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['dateHistogram'];
         /**
-      Nested aggregation configuration.
+      Nested aggregation
       */
         nested?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['nested'];
         /**
-      User-defined name of aggregation. Must be unique and will appear in aggregation results.
+      User-defined name of aggregation, should be unique, will appear in aggregation results
       @maxLength: 100
       */
         name?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['name'] | null;
         /**
-      Type of aggregation. Client must specify matching aggregation field below.
+      Type of aggregation, client must provide matching aggregation field below
       */
         type?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['type'];
         /**
-      Path to the field to aggregate by in dot notation. For example `name` or `paymentOptions.online`.
+      Field to aggregate by, use dot notation to specify json path
       @maxLength: 200
       */
         fieldPath?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['fieldPath'];
         /**
-      Deprecated, use `nested` instead.
-      @deprecated: Deprecated, use `nested` instead.,
+      deprecated, use `nested` instead
+      @deprecated: deprecated, use `nested` instead,
       @replacedBy: kind.nested,
       @targetRemovalDate: 2025-01-01
       */
         groupBy?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['groupBy'];
     }[];
     /**
-    Free text to match in searchable fields.
+    Free text to match in searchable fields
     */
     search?: {
         /**
-      Search mode. Defines the search logic for combining multiple terms in the `expression`.
+      Boolean search mode
       */
         mode?: NonNullable<CommonSearchWithEntityContext['search']>['mode'];
         /**
-      Search term or expression.
+      Search term or expression
       @maxLength: 200
       */
         expression?: NonNullable<CommonSearchWithEntityContext['search']>['expression'] | null;
         /**
-      Fields to search in. If the array is empty, all searchable fields are searched. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
+      Fields to search in. If empty - server will search in own default fields
       @maxSize: 10,
       @maxLength: 200
       */
         fields?: NonNullable<CommonSearchWithEntityContext['search']>['fields'];
         /**
-      Whether to enable the search function to use an algorithm to automatically find results that are close to the search expression, such as typos and declensions.
+      Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm)
       */
         fuzzy?: NonNullable<CommonSearchWithEntityContext['search']>['fuzzy'];
     };
     /**
-    Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) or [ISO 8601 UTC offset format](https://en.wikipedia.org/wiki/ISO_8601#Time_offsets_from_UTC) for adjusting time fields in the specified filters and returned aggregation data. For example, `America/New_York`, `UTC`, or `+02:00`.
+    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
   
-    Default: Time zone specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+    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"`
     @maxLength: 50
     */
     timeZone?: CommonSearchWithEntityContext['timeZone'] | null;