@wix/auto_sdk_bookings_resources 1.0.28 → 1.0.30

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

@@ -323,26 +323,43 @@ interface ListDeletedResourcesResponse {
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
-    /** Number of items returned in the response. */
+    /**
+     * 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.
+     */
     count?: number | null;
-    /** Cursor strings that point to the next page, previous page, or both. */
+    /**
+     * 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).
+     */
     cursors?: Cursors;
     /**
-     * Whether there are more pages to retrieve following the current page.
+     * Indicates whether additional results are available beyond the current page.
      *
-     * + `true`: Another page of results can be retrieved.
-     * + `false`: This is the last page.
+     * - `true`: More results exist and can be retrieved using the `next` cursor.
+     * - `false`: This is the final page of results.
      */
     hasNext?: boolean | null;
 }
 interface Cursors {
     /**
-     * Cursor string pointing to the next page in the list of results.
+     * 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.
      * @maxLength 16000
      */
     next?: string | null;
     /**
-     * Cursor pointing to the previous page in the list of results.
+     * 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.
      * @maxLength 16000
      */
     prev?: string | null;
@@ -426,40 +443,43 @@ interface BulkDeleteResourcesResponse {
 }
 interface SearchResourcesRequest {
     /**
-     * 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 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?: CursorSearch;
 }
 interface CursorSearch extends CursorSearchPagingMethodOneOf {
     /**
-     * Cursor pointing to page of results.
-     * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
+     * Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
+     * `filter`, `sort`, or `search` can't be specified.
      */
     cursorPaging?: CursorPaging;
-    /** 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 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)).
+     */
     filter?: Record<string, any> | null;
     /**
-     * Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
+     * 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)).
      * @maxSize 10
      */
     sort?: Sorting[];
     /**
-     * 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.
+     * 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.
      * @maxSize 10
      */
     aggregations?: Aggregation[];
-    /** Free text to match in searchable fields */
+    /** Free text to match in searchable fields. */
     search?: SearchDetails;
     /**
-     * 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
+     * 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`.
      *
-     * 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"`
+     * Default: Time zone specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      * @maxLength 50
      */
     timeZone?: string | null;
@@ -467,8 +487,8 @@ interface CursorSearch extends CursorSearchPagingMethodOneOf {
 /** @oneof */
 interface CursorSearchPagingMethodOneOf {
     /**
-     * Cursor pointing to page of results.
-     * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
+     * Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
+     * `filter`, `sort`, or `search` can't be specified.
      */
     cursorPaging?: CursorPaging;
 }
@@ -488,31 +508,31 @@ declare enum SortOrder {
 /** @enumType */
 type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
 interface Aggregation extends AggregationKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation configuration. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation configuration. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation configuration. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation configuration. */
     dateHistogram?: DateHistogramAggregation;
-    /** Nested aggregation */
+    /** Nested aggregation configuration. */
     nested?: NestedAggregation;
     /**
-     * User-defined name of aggregation, should be unique, will appear in aggregation results
+     * Aggregation name, returned in `aggregations.results.name`.
      * @maxLength 100
      */
     name?: string | null;
-    /** Type of aggregation, client must provide matching aggregation field below */
+    /** Type of aggregation. Client must specify matching aggregation field below. */
     type?: AggregationTypeWithLiterals;
     /**
-     * Field to aggregate by, use dot notation to specify json path
+     * Field to aggregate by. Use dot notation to specify a JSON path. For example `name` or `locationOptions.businessLocations.locationId`.
      * @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
      */
@@ -520,108 +540,123 @@ interface Aggregation extends AggregationKindOneOf {
 }
 /** @oneof */
 interface AggregationKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation configuration. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation configuration. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation configuration. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation configuration. */
     dateHistogram?: DateHistogramAggregation;
-    /** Nested aggregation */
+    /** Nested aggregation configuration. */
     nested?: NestedAggregation;
 }
 interface RangeBucket {
-    /** Inclusive lower bound of the range. Required if to is not given */
+    /** Inclusive lower bound of the range. Required if `to` isn't specified. */
     from?: number | null;
-    /** Exclusive upper bound of the range. Required if from is not given */
+    /** Exclusive upper bound of the range. Required if `from` isn't specified. */
     to?: number | null;
 }
 declare enum SortType {
-    /** Should sort by number of matches */
+    /** Number of matches in the results. */
     COUNT = "COUNT",
-    /** Should sort by value of the field alphabetically */
+    /** Alphabetically by the field value. */
     VALUE = "VALUE"
 }
 /** @enumType */
 type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
 declare enum SortDirection {
-    /** Should sort in descending order */
+    /** Descending order. */
     DESC = "DESC",
-    /** Should sort in ascending order */
+    /** Ascending order. */
     ASC = "ASC"
 }
 /** @enumType */
 type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
 declare enum MissingValues {
-    /** Should missing values be excluded from the aggregation results */
+    /** Exclude missing values from the aggregation results. */
     EXCLUDE = "EXCLUDE",
-    /** Should missing values be included in the aggregation results */
+    /** Include missing values in the aggregation results. */
     INCLUDE = "INCLUDE"
 }
 /** @enumType */
 type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
 interface IncludeMissingValuesOptions {
     /**
-     * Can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
+     * Custom bucket name for missing values.
+     *
+     * Default values:
+     * - string: `N/A`
+     * - int: `0`
+     * - bool: `false`
      * @maxLength 20
      */
     addToBucket?: string;
 }
 declare enum ScalarType {
     UNKNOWN_SCALAR_TYPE = "UNKNOWN_SCALAR_TYPE",
-    /** Count of distinct values */
+    /** Total number 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 */
+    /** Options for including missing values in the aggregation results. */
     includeOptions?: IncludeMissingValuesOptions;
-    /** Should sort by number of matches or value of the field */
+    /** Whether to sort by number of matches or value of the field. */
     sortType?: SortTypeWithLiterals;
-    /** Should sort in ascending or descending order */
+    /** Whether to sort in ascending or descending order. */
     sortDirection?: SortDirectionWithLiterals;
-    /** How many aggregations would you like to return? Can be between 1 and 250. 10 is the default. */
+    /**
+     * Number of aggregations to return.
+     *
+     * Min: `1`
+     * Max: `250`
+     * Default: `10`
+     */
     limit?: number | null;
-    /** Should missing values be included or excluded from the aggregation results. Default is EXCLUDE */
+    /**
+     * Whether missing values should be included or excluded from the aggregation results.
+     *
+     * Default: `EXCLUDE`
+     */
     missingValues?: MissingValuesWithLiterals;
 }
 /** @oneof */
 interface ValueAggregationOptionsOneOf {
-    /** Options for including missing values */
+    /** Options for including missing values in the aggregation results. */
     includeOptions?: IncludeMissingValuesOptions;
 }
 declare enum NestedAggregationType {
     UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
-    /** An aggregation where result buckets are dynamically built - one per unique value */
+    /** 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",
-    /** An aggregation, where user can define set of ranges - each representing a bucket */
+    /** 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",
-    /** A single-value metric aggregation - e.g. min, max, sum, avg */
+    /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
     SCALAR = "SCALAR",
-    /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
+    /** 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, where during aggregation each entity will be placed in the first bucket where its value falls into based on provided range bounds
+     * 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.
      * @maxSize 50
      */
     buckets?: RangeBucket[];
 }
 interface ScalarAggregation {
-    /** Define the operator for the scalar aggregation */
+    /** Operator for the scalar aggregation, for example `COUNT_DISTINCT`, `MIN`, `MAX`. */
     type?: ScalarTypeWithLiterals;
 }
 interface DateHistogramAggregation {
-    /** Interval for date histogram aggregation */
+    /** Time interval for date histogram aggregation, for example `DAY`, `HOUR`, `MONTH`. */
     interval?: IntervalWithLiterals;
 }
 declare enum Interval {
@@ -644,315 +679,331 @@ declare enum Interval {
 /** @enumType */
 type IntervalWithLiterals = Interval | 'UNKNOWN_INTERVAL' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
 interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation configuration. Calculates the distribution of field values within the dataset. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation configuration. Calculates counts within user-defined value ranges. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation configuration. Calculates single numerical metrics like count, min, max, sum, or average. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation configuration. Calculates counts within time intervals. */
     dateHistogram?: DateHistogramAggregation;
     /**
-     * User-defined name of aggregation, should be unique, will appear in aggregation results
+     * User-defined name of aggregation. Must be unique and will appear in aggregation results.
      * @maxLength 100
      */
     name?: string | null;
-    /** Type of aggregation, client must provide matching aggregation field below */
+    /** Type of aggregation. Client must specify matching aggregation field below. */
     type?: NestedAggregationTypeWithLiterals;
     /**
-     * Field to aggregate by, use dont notation to specify json path
+     * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface NestedAggregationItemKindOneOf {
-    /** Value aggregation */
+    /** Value aggregation configuration. Calculates the distribution of field values within the dataset. */
     value?: ValueAggregation;
-    /** Range aggregation */
+    /** Range aggregation configuration. Calculates counts within user-defined value ranges. */
     range?: RangeAggregation;
-    /** Scalar aggregation */
+    /** Scalar aggregation configuration. Calculates single numerical metrics like count, min, max, sum, or average. */
     scalar?: ScalarAggregation;
-    /** Date histogram aggregation */
+    /** Date histogram aggregation configuration. Calculates counts within time intervals. */
     dateHistogram?: DateHistogramAggregation;
 }
 declare enum AggregationType {
     UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
-    /** An aggregation where result buckets are dynamically built - one per unique value */
+    /** 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",
-    /** An aggregation, where user can define set of ranges - each representing a bucket */
+    /** 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",
-    /** A single-value metric aggregation - e.g. min, max, sum, avg */
+    /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
     SCALAR = "SCALAR",
-    /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
+    /** 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",
-    /** Multi-level aggregation, where each next aggregation is nested within previous one */
+    /** 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 expressed through a list of aggregation where each next aggregation is nested within previous one */
+/** 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. */
 interface NestedAggregation {
     /**
-     * Flattened list of aggregations, where each next aggregation is nested within previous one
+     * Flattened list of aggregations where each next aggregation is nested within the previous 1.
      * @minSize 2
      * @maxSize 3
      */
     nestedAggregations?: NestedAggregationItem[];
 }
 interface GroupByAggregation extends GroupByAggregationKindOneOf {
-    /** Value aggregation configuration */
+    /** Value aggregation configuration. */
     value?: ValueAggregation;
     /**
-     * User-defined name of aggregation, should be unique, will appear in aggregation results
+     * User-defined name of aggregation. Must be unique and will appear in aggregation results.
      * @maxLength 100
      */
     name?: string | null;
     /**
-     * Field to aggregate by
+     * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
      * @maxLength 200
      */
     fieldPath?: string;
 }
 /** @oneof */
 interface GroupByAggregationKindOneOf {
-    /** Value aggregation configuration */
+    /** Value aggregation configuration. */
     value?: ValueAggregation;
 }
 interface SearchDetails {
-    /** Defines how separate search terms in `expression` are combined */
+    /** Search mode. Defines the search logic for combining multiple terms in the `expression`. */
     mode?: ModeWithLiterals;
     /**
-     * Search term or expression
+     * Search term or expression.
      * @maxLength 100
      */
     expression?: string | null;
     /**
-     * Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path
+     * 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`.
      * @maxLength 200
      * @maxSize 20
      */
     fields?: string[];
-    /** Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
+    /** 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. */
     fuzzy?: boolean;
 }
 declare enum Mode {
-    /** Any of the search terms must be present */
+    /** At least 1 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. */
+    /**
+     * 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.
+     */
     resources?: Resource[];
-    /** Paging metadata. */
+    /**
+     * 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.
+     */
     pagingMetadata?: CursorPagingMetadata;
-    /** Aggregation results. */
+    /**
+     * 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.
+     */
     aggregationData?: AggregationData;
 }
 interface AggregationData {
     /**
-     * key = aggregation name (as derived from search request)
+     * Array of aggregation results, each containing the aggregation metadata and its calculated values for the specified search criteria.
      * @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 provided in request
+     * User-defined name of aggregation, matches the one specified in request.
      * @maxLength 100
      */
     name?: string;
-    /** Type of aggregation that matches result */
+    /** Type of aggregation that matches result. */
     type?: AggregationTypeWithLiterals;
     /**
-     * Field to aggregate by, matches the one provided in request
+     * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
      * @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 {
     /**
-     * List of value aggregations
+     * Array of value aggregation results, each containing a field value and the count of entities with that value.
      * @maxSize 250
      */
     results?: ValueAggregationResult[];
 }
 interface RangeResults {
     /**
-     * List of ranges returned in same order as requested
+     * Array of range aggregation results returned in the same order as requested, each containing range bounds and count of entities within that range.
      * @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 result data. */
     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 {
-    /** List of nested aggregations */
+    /** Map of nested aggregation results, keyed by aggregation name. */
     results?: Record<string, NestedResultValue>;
 }
 interface DateHistogramResult {
     /**
-     * Date in ISO 8601 format
+     * Date in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
      * @maxLength 100
      */
     value?: string;
-    /** Count of documents in the bucket */
+    /** Count of documents in the bucket. */
     count?: number;
 }
 interface GroupByValueResults {
     /**
-     * List of value aggregations
+     * Array of nested value aggregation results, each containing a field value and the associated nested aggregation data.
      * @maxSize 1000
      */
     results?: NestedValueAggregationResult[];
 }
 interface DateHistogramResults {
     /**
-     * List of date histogram aggregations
+     * Array of date histogram aggregation results, each containing a date bucket and its count.
      * @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 {
     /**
-     * List of nested aggregations
+     * Array of nested aggregation result groups, each containing multiple aggregation results.
      * @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 provided kind as derived from search request */
+    /** Type of aggregation that must match specified kind as derived from search request. */
     type?: AggregationTypeWithLiterals;
     /**
-     * Field to aggregate by as derived from search request
+     * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
      * @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 {
@@ -1343,8 +1394,8 @@ interface ResourceSearchSpec extends SearchSpec {
 type CommonSearchWithEntityContext = Search<Resource, ResourceSearchSpec>;
 type ResourceSearch = {
     /**
-    Cursor pointing to page of results.
-    When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
+    Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
+    `filter`, `sort`, or `search` can't be specified.
     */
     cursorPaging?: {
         /**
@@ -1362,11 +1413,15 @@ type ResourceSearch = {
         cursor?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['cursor'] | null;
     };
     /**
-    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 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)).
     */
     filter?: CommonSearchWithEntityContext['filter'] | null;
     /**
-    Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
+    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)).
     @maxSize: 10
     */
     sort?: {
@@ -1381,84 +1436,81 @@ type ResourceSearch = {
         order?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['order'];
     }[];
     /**
-    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.
+    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.
     @maxSize: 10
     */
     aggregations?: {
         /**
-      Value aggregation
+      Value aggregation configuration.
       */
         value?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['value'];
         /**
-      Range aggregation
+      Range aggregation configuration.
       */
         range?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['range'];
         /**
-      Scalar aggregation
+      Scalar aggregation configuration.
       */
         scalar?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['scalar'];
         /**
-      Date histogram aggregation
+      Date histogram aggregation configuration.
       */
         dateHistogram?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['dateHistogram'];
         /**
-      Nested aggregation
+      Nested aggregation configuration.
       */
         nested?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['nested'];
         /**
-      User-defined name of aggregation, should be unique, will appear in aggregation results
+      Aggregation name, returned in `aggregations.results.name`.
       @maxLength: 100
       */
         name?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['name'] | null;
         /**
-      Type of aggregation, client must provide matching aggregation field below
+      Type of aggregation. Client must specify matching aggregation field below.
       */
         type?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['type'];
         /**
-      Field to aggregate by, use dot notation to specify json path
+      Field to aggregate by. Use dot notation to specify a JSON path. For example `name` or `locationOptions.businessLocations.locationId`.
       @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?: {
         /**
-      Defines how separate search terms in `expression` are combined
+      Search mode. Defines the search logic for combining multiple terms in the `expression`.
       */
         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 empty - will search in all searchable fields. Use dot notation to specify json path
+      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`.
       @maxLength: 200,
       @maxSize: 20
       */
         fields?: NonNullable<CommonSearchWithEntityContext['search']>['fields'];
         /**
-      Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm)
+      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.
       */
         fuzzy?: NonNullable<CommonSearchWithEntityContext['search']>['fuzzy'];
     };
     /**
-    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
+    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`.
   
-    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"`
+    Default: Time zone specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
     @maxLength: 50
     */
     timeZone?: CommonSearchWithEntityContext['timeZone'] | null;