@wix/auto_sdk_bookings_resources 1.0.27 → 1.0.28

package/build/cjs/{bookings-resources-v2-resource-resources.universal-RnzqwcCV.d.ts → bookings-resources-v2-resource-resources.universal-D9QXPtmj.d.ts}

@@ -323,43 +323,26 @@ interface ListDeletedResourcesResponse {
     pagingMetadata?: CursorPagingMetadata;
 }
 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).
-     */
+    /** Cursor strings that point to the next page, previous page, or both. */
     cursors?: Cursors;
     /**
-     * Indicates whether additional results are available beyond the current page.
+     * Whether there are more pages to retrieve following the current page.
      *
-     * - `true`: More results exist and can be retrieved using the `next` cursor.
-     * - `false`: This is the final page of results.
+     * + `true`: Another page of results can be retrieved.
+     * + `false`: This is the last page.
      */
     hasNext?: boolean | null;
 }
 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 string pointing to the 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 the previous page in the list of results.
      * @maxLength 16000
      */
     prev?: string | null;
@@ -443,43 +426,40 @@ interface BulkDeleteResourcesResponse {
 }
 interface SearchResourcesRequest {
     /**
-     * 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/resources/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/filtering-and-sorting)) for complete filter and sorting options.
+     * Search condition. Refer to the *supported filters article*
+     * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/filtering-and-sorting))
+     * for a complete list of supported filters and sorting options.
      */
     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 resources available at specific business locations: `"filter": {"single_resource.location_options.specific_location_options.business_locations.location_id": {"$in": ["location-id-1", "location-id-2"]}}`.
-     *
-     * Learn more about the filter format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-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 resource name in ascending order: `"sort": [{"fieldName": "name", "order": "ASC"}]`.
-     *
-     * Learn more about the sort format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-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 resource type, management type, or location availability.
+     * 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;
@@ -487,8 +467,8 @@ 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;
 }
@@ -508,31 +488,31 @@ declare enum SortOrder {
 /** @enumType */
 type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
 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;
     /**
-     * Aggregation name, returned in `aggregations.results.name`.
+     * 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;
     /**
-     * Field to aggregate by. Use dot notation to specify a JSON path. For example `name` or `locationOptions.businessLocations.locationId`.
+     * 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 2024-03-30
      */
@@ -540,123 +520,108 @@ 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 {
-    /** Number of matches in the results. */
+    /** Should sort by number of matches */
     COUNT = "COUNT",
-    /** Alphabetically by the field value. */
+    /** Should sort by value of the field alphabetically */
     VALUE = "VALUE"
 }
 /** @enumType */
 type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
 declare enum SortDirection {
-    /** Descending order. */
+    /** Should sort in descending order */
     DESC = "DESC",
-    /** Ascending order. */
+    /** Should sort in ascending order */
     ASC = "ASC"
 }
 /** @enumType */
 type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
 declare enum MissingValues {
-    /** Exclude missing values from the aggregation results. */
+    /** Should missing values be excluded from the aggregation results */
     EXCLUDE = "EXCLUDE",
-    /** Include missing values in the aggregation results. */
+    /** Should missing values be included in the aggregation results */
     INCLUDE = "INCLUDE"
 }
 /** @enumType */
 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 of distinct values */
     COUNT_DISTINCT = "COUNT_DISTINCT",
-    /** Minimum value. */
+    /** Minimum value */
     MIN = "MIN",
-    /** Maximum value. */
+    /** 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. */
+    /** An aggregation where result buckets are dynamically built - one per unique value */
     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. */
+    /** An aggregation, where user can define set of ranges - each representing a bucket */
     RANGE = "RANGE",
-    /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
+    /** A single-value metric aggregation - e.g. min, max, sum, avg */
     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.). */
+    /** An aggregation, where result buckets are dynamically built - one per time interval (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.
+     * 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
      * @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 {
@@ -679,331 +644,315 @@ 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 `locationOptions.businessLocations.locationId`.
+     * 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. */
+    /** An aggregation where result buckets are dynamically built - one per unique value */
     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. */
+    /** An aggregation, where user can define set of ranges - each representing a bucket */
     RANGE = "RANGE",
-    /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
+    /** A single-value metric aggregation - e.g. min, max, sum, avg */
     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.). */
+    /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
     DATE_HISTOGRAM = "DATE_HISTOGRAM",
-    /** Flattened list of aggregations, where each aggregation is nested within previous 1. */
+    /** Multi-level aggregation, where each next aggregation is nested within previous one */
     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 3
      */
     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 `locationOptions.businessLocations.locationId`.
+     * 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`. */
+    /** Defines how separate search terms in `expression` are combined */
     mode?: ModeWithLiterals;
     /**
-     * Search term or expression.
+     * Search term or expression
      * @maxLength 100
      */
     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, `locationOptions.availableInAllLocations`.
+     * Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path
      * @maxLength 200
      * @maxSize 20
      */
     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 of the search terms must be present */
     OR = "OR",
-    /** All search terms must be present. */
+    /** All search terms must be present */
     AND = "AND"
 }
 /** @enumType */
 type ModeWithLiterals = Mode | 'OR' | 'AND';
 interface SearchResourcesResponse {
-    /**
-     * Retrieved resources that match the search criteria specified in the request.
-     *
-     * Each resource includes all available information such as name, type, management details,
-     * location options, working hour schedules, and availability configurations.
-     */
+    /** Retrieved resources. */
     resources?: Resource[];
-    /**
-     * Cursor-based paging metadata for navigating through search results.
-     *
-     * Contains navigation information including the current page cursor, whether additional
-     * results are available, and result counts. Use the `next` cursor to fetch subsequent pages.
-     */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
-    /**
-     * Aggregation results derived from the aggregations specified in the search request.
-     *
-     * Provides analytical summaries such as resource counts by type, location distribution,
-     * management type statistics, or custom groupings. Only populated when aggregations
-     * are included in the search criteria.
-     */
+    /** Aggregation results. */
     aggregationData?: AggregationData;
 }
 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 `locationOptions.businessLocations.locationId`.
+     * 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 result data. */
+    /** 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`.
+ * 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 `locationOptions.businessLocations.locationId`.
+     * 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 QueryResourcesRequest {
@@ -1394,8 +1343,8 @@ interface ResourceSearchSpec extends SearchSpec {
 type CommonSearchWithEntityContext = Search<Resource, ResourceSearchSpec>;
 type ResourceSearch = {
     /**
-    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?: {
         /**
@@ -1413,15 +1362,11 @@ type ResourceSearch = {
         cursor?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['cursor'] | null;
     };
     /**
-    Filter object for narrowing search results. For example, to return only resources available at specific business locations: `"filter": {"single_resource.location_options.specific_location_options.business_locations.location_id": {"$in": ["location-id-1", "location-id-2"]}}`.
-  
-    Learn more about the filter format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-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 resource name in ascending order: `"sort": [{"fieldName": "name", "order": "ASC"}]`.
-  
-    Learn more about the sort format in the supported filters article ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/supported-filters) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/filtering-and-sorting)).
+    Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
     @maxSize: 10
     */
     sort?: {
@@ -1436,81 +1381,84 @@ type ResourceSearch = {
         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 resource type, management type, or location availability.
+    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'];
         /**
-      Aggregation name, returned in `aggregations.results.name`.
+      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'];
         /**
-      Field to aggregate by. Use dot notation to specify a JSON path. For example `name` or `locationOptions.businessLocations.locationId`.
+      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: 2024-03-30
       */
         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`.
+      Defines how separate search terms in `expression` are combined
       */
         mode?: NonNullable<CommonSearchWithEntityContext['search']>['mode'];
         /**
-      Search term or expression.
+      Search term or expression
       @maxLength: 100
       */
         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, `locationOptions.availableInAllLocations`.
+      Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path
       @maxLength: 200,
       @maxSize: 20
       */
         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;