@wix/auto_sdk_bookings_resources 1.0.27 → 1.0.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- import { z as CreateResourceRequest$1, D as CreateResourceResponse$1, F as BulkCreateResourcesRequest$1, a as BulkCreateResourcesResponse$1, O as GetResourceRequest$1, P as GetResourceResponse$1, a4 as UpdateResourceRequest$1, a5 as UpdateResourceResponse$1, a6 as BulkUpdateResourcesRequest$1, c as BulkUpdateResourcesResponse$1, a7 as DeleteResourceRequest$1, a8 as DeleteResourceResponse$1, a9 as BulkDeleteResourcesRequest$1, d as BulkDeleteResourcesResponse$1, aa as SearchResourcesRequest$1, S as SearchResourcesResponse$1, aO as QueryResourcesRequest$1, aR as QueryResourcesResponse$1, aS as CountResourcesRequest$1, g as CountResourcesResponse$1 } from './bookings-resources-v2-resource-resources.universal-RnzqwcCV.mjs';
1
+ import { z as CreateResourceRequest$1, D as CreateResourceResponse$1, F as BulkCreateResourcesRequest$1, a as BulkCreateResourcesResponse$1, O as GetResourceRequest$1, P as GetResourceResponse$1, a4 as UpdateResourceRequest$1, a5 as UpdateResourceResponse$1, a6 as BulkUpdateResourcesRequest$1, c as BulkUpdateResourcesResponse$1, a7 as DeleteResourceRequest$1, a8 as DeleteResourceResponse$1, a9 as BulkDeleteResourcesRequest$1, d as BulkDeleteResourcesResponse$1, aa as SearchResourcesRequest$1, S as SearchResourcesResponse$1, aO as QueryResourcesRequest$1, aR as QueryResourcesResponse$1, aS as CountResourcesRequest$1, g as CountResourcesResponse$1 } from './bookings-resources-v2-resource-resources.universal-D9QXPtmj.mjs';
2
2
  import '@wix/sdk-types';
3
3
 
4
4
  /**
@@ -246,43 +246,26 @@ interface CursorPaging {
246
246
  cursor?: string | null;
247
247
  }
248
248
  interface CursorPagingMetadata {
249
- /**
250
- * Number of items returned in the current response page.
251
- *
252
- * This count reflects the actual number of items in the current result set,
253
- * which may be less than the requested limit if fewer items are available.
254
- */
249
+ /** Number of items returned in the response. */
255
250
  count?: number | null;
256
- /**
257
- * Navigation cursors for moving between result pages.
258
- *
259
- * Contains `next` and `prev` cursor tokens for pagination. Use the `next` cursor
260
- * to retrieve subsequent pages and `prev` cursor to go back to previous pages.
261
- * 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).
262
- */
251
+ /** Cursor strings that point to the next page, previous page, or both. */
263
252
  cursors?: Cursors;
264
253
  /**
265
- * Indicates whether additional results are available beyond the current page.
254
+ * Whether there are more pages to retrieve following the current page.
266
255
  *
267
- * - `true`: More results exist and can be retrieved using the `next` cursor.
268
- * - `false`: This is the final page of results.
256
+ * + `true`: Another page of results can be retrieved.
257
+ * + `false`: This is the last page.
269
258
  */
270
259
  hasNext?: boolean | null;
271
260
  }
272
261
  interface Cursors {
273
262
  /**
274
- * Cursor token for retrieving the next page of results.
275
- *
276
- * Use this token in subsequent requests to continue pagination forward.
277
- * Value is `null` when on the last page of results.
263
+ * Cursor string pointing to the next page in the list of results.
278
264
  * @maxLength 16000
279
265
  */
280
266
  next?: string | null;
281
267
  /**
282
- * Cursor token for retrieving the previous page of results.
283
- *
284
- * Use this token to navigate backwards through result pages.
285
- * Value is `null` when on the first page of results.
268
+ * Cursor pointing to the previous page in the list of results.
286
269
  * @maxLength 16000
287
270
  */
288
271
  prev?: string | null;
@@ -346,43 +329,40 @@ interface BulkDeleteResourcesResponse {
346
329
  }
347
330
  interface SearchResourcesRequest {
348
331
  /**
349
- * Search criteria including filter, sort, aggregations, and paging options.
350
- *
351
- * 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.
332
+ * Search condition. Refer to the *supported filters article*
333
+ * ([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))
334
+ * for a complete list of supported filters and sorting options.
352
335
  */
353
336
  search?: CursorSearch;
354
337
  }
355
338
  interface CursorSearch extends CursorSearchPagingMethodOneOf {
356
339
  /**
357
- * Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
358
- * `filter`, `sort`, or `search` can't be specified.
340
+ * Cursor pointing to page of results.
341
+ * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
359
342
  */
360
343
  cursorPaging?: CursorPaging;
361
- /**
362
- * 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"]}}`.
363
- *
364
- * 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)).
365
- */
344
+ /** 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) */
366
345
  filter?: Record<string, any> | null;
367
346
  /**
368
- * Array of sort objects specifying result order. For example, to sort by resource name in ascending order: `"sort": [{"fieldName": "name", "order": "ASC"}]`.
369
- *
370
- * 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)).
347
+ * Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
371
348
  * @maxSize 10
372
349
  */
373
350
  sort?: Sorting[];
374
351
  /**
375
- * Aggregations for grouping data into categories (facets) and providing summaries for each category.
376
- * For example, use aggregations to categorize search results by resource type, management type, or location availability.
352
+ * 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.
377
353
  * @maxSize 10
378
354
  */
379
355
  aggregations?: Aggregation[];
380
- /** Free text to match in searchable fields. */
356
+ /** Free text to match in searchable fields */
381
357
  search?: SearchDetails;
382
358
  /**
383
- * 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`.
359
+ * UTC offset or IANA time zone. Valid values are
360
+ * ISO 8601 UTC offsets, such as +02:00 or -06:00,
361
+ * and IANA time zone IDs, such as Europe/Rome
384
362
  *
385
- * Default: Time zone specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
363
+ * Affects all filters and aggregations returned values.
364
+ * You may override this behavior in a specific filter by providing
365
+ * timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
386
366
  * @maxLength 50
387
367
  */
388
368
  timeZone?: string | null;
@@ -390,8 +370,8 @@ interface CursorSearch extends CursorSearchPagingMethodOneOf {
390
370
  /** @oneof */
391
371
  interface CursorSearchPagingMethodOneOf {
392
372
  /**
393
- * Cursor-based paging for result navigation. When requesting `cursor_paging.cursor`,
394
- * `filter`, `sort`, or `search` can't be specified.
373
+ * Cursor pointing to page of results.
374
+ * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
395
375
  */
396
376
  cursorPaging?: CursorPaging;
397
377
  }
@@ -411,31 +391,31 @@ declare enum SortOrder {
411
391
  /** @enumType */
412
392
  type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
413
393
  interface Aggregation extends AggregationKindOneOf {
414
- /** Value aggregation configuration. */
394
+ /** Value aggregation */
415
395
  value?: ValueAggregation;
416
- /** Range aggregation configuration. */
396
+ /** Range aggregation */
417
397
  range?: RangeAggregation;
418
- /** Scalar aggregation configuration. */
398
+ /** Scalar aggregation */
419
399
  scalar?: ScalarAggregation;
420
- /** Date histogram aggregation configuration. */
400
+ /** Date histogram aggregation */
421
401
  dateHistogram?: DateHistogramAggregation;
422
- /** Nested aggregation configuration. */
402
+ /** Nested aggregation */
423
403
  nested?: NestedAggregation;
424
404
  /**
425
- * Aggregation name, returned in `aggregations.results.name`.
405
+ * User-defined name of aggregation, should be unique, will appear in aggregation results
426
406
  * @maxLength 100
427
407
  */
428
408
  name?: string | null;
429
- /** Type of aggregation. Client must specify matching aggregation field below. */
409
+ /** Type of aggregation, client must provide matching aggregation field below */
430
410
  type?: AggregationTypeWithLiterals;
431
411
  /**
432
- * Field to aggregate by. Use dot notation to specify a JSON path. For example `name` or `locationOptions.businessLocations.locationId`.
412
+ * Field to aggregate by, use dot notation to specify json path
433
413
  * @maxLength 200
434
414
  */
435
415
  fieldPath?: string;
436
416
  /**
437
- * Deprecated. Use `nested` instead.
438
- * @deprecated Deprecated. Use `nested` instead.
417
+ * deprecated, use `nested` instead
418
+ * @deprecated deprecated, use `nested` instead
439
419
  * @replacedBy kind.nested
440
420
  * @targetRemovalDate 2024-03-30
441
421
  */
@@ -443,123 +423,108 @@ interface Aggregation extends AggregationKindOneOf {
443
423
  }
444
424
  /** @oneof */
445
425
  interface AggregationKindOneOf {
446
- /** Value aggregation configuration. */
426
+ /** Value aggregation */
447
427
  value?: ValueAggregation;
448
- /** Range aggregation configuration. */
428
+ /** Range aggregation */
449
429
  range?: RangeAggregation;
450
- /** Scalar aggregation configuration. */
430
+ /** Scalar aggregation */
451
431
  scalar?: ScalarAggregation;
452
- /** Date histogram aggregation configuration. */
432
+ /** Date histogram aggregation */
453
433
  dateHistogram?: DateHistogramAggregation;
454
- /** Nested aggregation configuration. */
434
+ /** Nested aggregation */
455
435
  nested?: NestedAggregation;
456
436
  }
457
437
  interface RangeBucket {
458
- /** Inclusive lower bound of the range. Required if `to` isn't specified. */
438
+ /** Inclusive lower bound of the range. Required if to is not given */
459
439
  from?: number | null;
460
- /** Exclusive upper bound of the range. Required if `from` isn't specified. */
440
+ /** Exclusive upper bound of the range. Required if from is not given */
461
441
  to?: number | null;
462
442
  }
463
443
  declare enum SortType {
464
- /** Number of matches in the results. */
444
+ /** Should sort by number of matches */
465
445
  COUNT = "COUNT",
466
- /** Alphabetically by the field value. */
446
+ /** Should sort by value of the field alphabetically */
467
447
  VALUE = "VALUE"
468
448
  }
469
449
  /** @enumType */
470
450
  type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
471
451
  declare enum SortDirection {
472
- /** Descending order. */
452
+ /** Should sort in descending order */
473
453
  DESC = "DESC",
474
- /** Ascending order. */
454
+ /** Should sort in ascending order */
475
455
  ASC = "ASC"
476
456
  }
477
457
  /** @enumType */
478
458
  type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
479
459
  declare enum MissingValues {
480
- /** Exclude missing values from the aggregation results. */
460
+ /** Should missing values be excluded from the aggregation results */
481
461
  EXCLUDE = "EXCLUDE",
482
- /** Include missing values in the aggregation results. */
462
+ /** Should missing values be included in the aggregation results */
483
463
  INCLUDE = "INCLUDE"
484
464
  }
485
465
  /** @enumType */
486
466
  type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
487
467
  interface IncludeMissingValuesOptions {
488
468
  /**
489
- * Custom bucket name for missing values.
490
- *
491
- * Default values:
492
- * - string: `N/A`
493
- * - int: `0`
494
- * - bool: `false`
469
+ * Can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
495
470
  * @maxLength 20
496
471
  */
497
472
  addToBucket?: string;
498
473
  }
499
474
  declare enum ScalarType {
500
475
  UNKNOWN_SCALAR_TYPE = "UNKNOWN_SCALAR_TYPE",
501
- /** Total number of distinct values. */
476
+ /** Count of distinct values */
502
477
  COUNT_DISTINCT = "COUNT_DISTINCT",
503
- /** Minimum value. */
478
+ /** Minimum value */
504
479
  MIN = "MIN",
505
- /** Maximum value. */
480
+ /** Maximum value */
506
481
  MAX = "MAX"
507
482
  }
508
483
  /** @enumType */
509
484
  type ScalarTypeWithLiterals = ScalarType | 'UNKNOWN_SCALAR_TYPE' | 'COUNT_DISTINCT' | 'MIN' | 'MAX';
510
485
  interface ValueAggregation extends ValueAggregationOptionsOneOf {
511
- /** Options for including missing values in the aggregation results. */
486
+ /** Options for including missing values */
512
487
  includeOptions?: IncludeMissingValuesOptions;
513
- /** Whether to sort by number of matches or value of the field. */
488
+ /** Should sort by number of matches or value of the field */
514
489
  sortType?: SortTypeWithLiterals;
515
- /** Whether to sort in ascending or descending order. */
490
+ /** Should sort in ascending or descending order */
516
491
  sortDirection?: SortDirectionWithLiterals;
517
- /**
518
- * Number of aggregations to return.
519
- *
520
- * Min: `1`
521
- * Max: `250`
522
- * Default: `10`
523
- */
492
+ /** How many aggregations would you like to return? Can be between 1 and 250. 10 is the default. */
524
493
  limit?: number | null;
525
- /**
526
- * Whether missing values should be included or excluded from the aggregation results.
527
- *
528
- * Default: `EXCLUDE`
529
- */
494
+ /** Should missing values be included or excluded from the aggregation results. Default is EXCLUDE */
530
495
  missingValues?: MissingValuesWithLiterals;
531
496
  }
532
497
  /** @oneof */
533
498
  interface ValueAggregationOptionsOneOf {
534
- /** Options for including missing values in the aggregation results. */
499
+ /** Options for including missing values */
535
500
  includeOptions?: IncludeMissingValuesOptions;
536
501
  }
537
502
  declare enum NestedAggregationType {
538
503
  UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
539
- /** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
504
+ /** An aggregation where result buckets are dynamically built - one per unique value */
540
505
  VALUE = "VALUE",
541
- /** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
506
+ /** An aggregation, where user can define set of ranges - each representing a bucket */
542
507
  RANGE = "RANGE",
543
- /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
508
+ /** A single-value metric aggregation - e.g. min, max, sum, avg */
544
509
  SCALAR = "SCALAR",
545
- /** 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.). */
510
+ /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
546
511
  DATE_HISTOGRAM = "DATE_HISTOGRAM"
547
512
  }
548
513
  /** @enumType */
549
514
  type NestedAggregationTypeWithLiterals = NestedAggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM';
550
515
  interface RangeAggregation {
551
516
  /**
552
- * 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.
517
+ * 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
553
518
  * @maxSize 50
554
519
  */
555
520
  buckets?: RangeBucket[];
556
521
  }
557
522
  interface ScalarAggregation {
558
- /** Operator for the scalar aggregation, for example `COUNT_DISTINCT`, `MIN`, `MAX`. */
523
+ /** Define the operator for the scalar aggregation */
559
524
  type?: ScalarTypeWithLiterals;
560
525
  }
561
526
  interface DateHistogramAggregation {
562
- /** Time interval for date histogram aggregation, for example `DAY`, `HOUR`, `MONTH`. */
527
+ /** Interval for date histogram aggregation */
563
528
  interval?: IntervalWithLiterals;
564
529
  }
565
530
  declare enum Interval {
@@ -582,331 +547,315 @@ declare enum Interval {
582
547
  /** @enumType */
583
548
  type IntervalWithLiterals = Interval | 'UNKNOWN_INTERVAL' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
584
549
  interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
585
- /** Value aggregation configuration. Calculates the distribution of field values within the dataset. */
550
+ /** Value aggregation */
586
551
  value?: ValueAggregation;
587
- /** Range aggregation configuration. Calculates counts within user-defined value ranges. */
552
+ /** Range aggregation */
588
553
  range?: RangeAggregation;
589
- /** Scalar aggregation configuration. Calculates single numerical metrics like count, min, max, sum, or average. */
554
+ /** Scalar aggregation */
590
555
  scalar?: ScalarAggregation;
591
- /** Date histogram aggregation configuration. Calculates counts within time intervals. */
556
+ /** Date histogram aggregation */
592
557
  dateHistogram?: DateHistogramAggregation;
593
558
  /**
594
- * User-defined name of aggregation. Must be unique and will appear in aggregation results.
559
+ * User-defined name of aggregation, should be unique, will appear in aggregation results
595
560
  * @maxLength 100
596
561
  */
597
562
  name?: string | null;
598
- /** Type of aggregation. Client must specify matching aggregation field below. */
563
+ /** Type of aggregation, client must provide matching aggregation field below */
599
564
  type?: NestedAggregationTypeWithLiterals;
600
565
  /**
601
- * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
566
+ * Field to aggregate by, use dont notation to specify json path
602
567
  * @maxLength 200
603
568
  */
604
569
  fieldPath?: string;
605
570
  }
606
571
  /** @oneof */
607
572
  interface NestedAggregationItemKindOneOf {
608
- /** Value aggregation configuration. Calculates the distribution of field values within the dataset. */
573
+ /** Value aggregation */
609
574
  value?: ValueAggregation;
610
- /** Range aggregation configuration. Calculates counts within user-defined value ranges. */
575
+ /** Range aggregation */
611
576
  range?: RangeAggregation;
612
- /** Scalar aggregation configuration. Calculates single numerical metrics like count, min, max, sum, or average. */
577
+ /** Scalar aggregation */
613
578
  scalar?: ScalarAggregation;
614
- /** Date histogram aggregation configuration. Calculates counts within time intervals. */
579
+ /** Date histogram aggregation */
615
580
  dateHistogram?: DateHistogramAggregation;
616
581
  }
617
582
  declare enum AggregationType {
618
583
  UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
619
- /** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
584
+ /** An aggregation where result buckets are dynamically built - one per unique value */
620
585
  VALUE = "VALUE",
621
- /** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
586
+ /** An aggregation, where user can define set of ranges - each representing a bucket */
622
587
  RANGE = "RANGE",
623
- /** Calculates a single numerical value from a dataset, summarizing the dataset into 1 key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
588
+ /** A single-value metric aggregation - e.g. min, max, sum, avg */
624
589
  SCALAR = "SCALAR",
625
- /** 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.). */
590
+ /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
626
591
  DATE_HISTOGRAM = "DATE_HISTOGRAM",
627
- /** Flattened list of aggregations, where each aggregation is nested within previous 1. */
592
+ /** Multi-level aggregation, where each next aggregation is nested within previous one */
628
593
  NESTED = "NESTED"
629
594
  }
630
595
  /** @enumType */
631
596
  type AggregationTypeWithLiterals = AggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM' | 'NESTED';
632
- /** 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. */
597
+ /** Nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one */
633
598
  interface NestedAggregation {
634
599
  /**
635
- * Flattened list of aggregations where each next aggregation is nested within the previous 1.
600
+ * Flattened list of aggregations, where each next aggregation is nested within previous one
636
601
  * @minSize 2
637
602
  * @maxSize 3
638
603
  */
639
604
  nestedAggregations?: NestedAggregationItem[];
640
605
  }
641
606
  interface GroupByAggregation extends GroupByAggregationKindOneOf {
642
- /** Value aggregation configuration. */
607
+ /** Value aggregation configuration */
643
608
  value?: ValueAggregation;
644
609
  /**
645
- * User-defined name of aggregation. Must be unique and will appear in aggregation results.
610
+ * User-defined name of aggregation, should be unique, will appear in aggregation results
646
611
  * @maxLength 100
647
612
  */
648
613
  name?: string | null;
649
614
  /**
650
- * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
615
+ * Field to aggregate by
651
616
  * @maxLength 200
652
617
  */
653
618
  fieldPath?: string;
654
619
  }
655
620
  /** @oneof */
656
621
  interface GroupByAggregationKindOneOf {
657
- /** Value aggregation configuration. */
622
+ /** Value aggregation configuration */
658
623
  value?: ValueAggregation;
659
624
  }
660
625
  interface SearchDetails {
661
- /** Search mode. Defines the search logic for combining multiple terms in the `expression`. */
626
+ /** Defines how separate search terms in `expression` are combined */
662
627
  mode?: ModeWithLiterals;
663
628
  /**
664
- * Search term or expression.
629
+ * Search term or expression
665
630
  * @maxLength 100
666
631
  */
667
632
  expression?: string | null;
668
633
  /**
669
- * 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`.
634
+ * Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path
670
635
  * @maxLength 200
671
636
  * @maxSize 20
672
637
  */
673
638
  fields?: string[];
674
- /** 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. */
639
+ /** Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
675
640
  fuzzy?: boolean;
676
641
  }
677
642
  declare enum Mode {
678
- /** At least 1 of the search terms must be present. */
643
+ /** Any of the search terms must be present */
679
644
  OR = "OR",
680
- /** All search terms must be present. */
645
+ /** All search terms must be present */
681
646
  AND = "AND"
682
647
  }
683
648
  /** @enumType */
684
649
  type ModeWithLiterals = Mode | 'OR' | 'AND';
685
650
  interface SearchResourcesResponse {
686
- /**
687
- * Retrieved resources that match the search criteria specified in the request.
688
- *
689
- * Each resource includes all available information such as name, type, management details,
690
- * location options, working hour schedules, and availability configurations.
691
- */
651
+ /** Retrieved resources. */
692
652
  resources?: Resource[];
693
- /**
694
- * Cursor-based paging metadata for navigating through search results.
695
- *
696
- * Contains navigation information including the current page cursor, whether additional
697
- * results are available, and result counts. Use the `next` cursor to fetch subsequent pages.
698
- */
653
+ /** Paging metadata. */
699
654
  pagingMetadata?: CursorPagingMetadata;
700
- /**
701
- * Aggregation results derived from the aggregations specified in the search request.
702
- *
703
- * Provides analytical summaries such as resource counts by type, location distribution,
704
- * management type statistics, or custom groupings. Only populated when aggregations
705
- * are included in the search criteria.
706
- */
655
+ /** Aggregation results. */
707
656
  aggregationData?: AggregationData;
708
657
  }
709
658
  interface AggregationData {
710
659
  /**
711
- * Array of aggregation results, each containing the aggregation metadata and its calculated values for the specified search criteria.
660
+ * key = aggregation name (as derived from search request)
712
661
  * @maxSize 10000
713
662
  */
714
663
  results?: AggregationResults[];
715
664
  }
716
665
  interface ValueAggregationResult {
717
666
  /**
718
- * Value of the field.
667
+ * Value of the field
719
668
  * @maxLength 100
720
669
  */
721
670
  value?: string;
722
- /** Count of entities with this value. */
671
+ /** Count of entities with this value */
723
672
  count?: number;
724
673
  }
725
674
  interface RangeAggregationResult {
726
- /** Inclusive lower bound of the range. */
675
+ /** Inclusive lower bound of the range */
727
676
  from?: number | null;
728
- /** Exclusive upper bound of the range. */
677
+ /** Exclusive upper bound of the range */
729
678
  to?: number | null;
730
- /** Count of entities in this range. */
679
+ /** Count of entities in this range */
731
680
  count?: number;
732
681
  }
733
682
  interface NestedAggregationResults extends NestedAggregationResultsResultOneOf {
734
- /** Value aggregation results. */
683
+ /** Value aggregation results */
735
684
  values?: ValueResults;
736
- /** Range aggregation results. */
685
+ /** Range aggregation results */
737
686
  ranges?: RangeResults;
738
- /** Scalar aggregation results. */
687
+ /** Scalar aggregation results */
739
688
  scalar?: AggregationResultsScalarResult;
740
689
  /**
741
- * User-defined name of aggregation, matches the one specified in request.
690
+ * User-defined name of aggregation, matches the one provided in request
742
691
  * @maxLength 100
743
692
  */
744
693
  name?: string;
745
- /** Type of aggregation that matches result. */
694
+ /** Type of aggregation that matches result */
746
695
  type?: AggregationTypeWithLiterals;
747
696
  /**
748
- * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
697
+ * Field to aggregate by, matches the one provided in request
749
698
  * @maxLength 200
750
699
  */
751
700
  fieldPath?: string;
752
701
  }
753
702
  /** @oneof */
754
703
  interface NestedAggregationResultsResultOneOf {
755
- /** Value aggregation results. */
704
+ /** Value aggregation results */
756
705
  values?: ValueResults;
757
- /** Range aggregation results. */
706
+ /** Range aggregation results */
758
707
  ranges?: RangeResults;
759
- /** Scalar aggregation results. */
708
+ /** Scalar aggregation results */
760
709
  scalar?: AggregationResultsScalarResult;
761
710
  }
762
711
  interface ValueResults {
763
712
  /**
764
- * Array of value aggregation results, each containing a field value and the count of entities with that value.
713
+ * List of value aggregations
765
714
  * @maxSize 250
766
715
  */
767
716
  results?: ValueAggregationResult[];
768
717
  }
769
718
  interface RangeResults {
770
719
  /**
771
- * Array of range aggregation results returned in the same order as requested, each containing range bounds and count of entities within that range.
720
+ * List of ranges returned in same order as requested
772
721
  * @maxSize 50
773
722
  */
774
723
  results?: RangeAggregationResult[];
775
724
  }
776
725
  interface AggregationResultsScalarResult {
777
- /** Type of scalar aggregation. */
726
+ /** Type of scalar aggregation */
778
727
  type?: ScalarTypeWithLiterals;
779
- /** Value of the scalar aggregation. */
728
+ /** Value of the scalar aggregation */
780
729
  value?: number;
781
730
  }
782
731
  interface NestedValueAggregationResult {
783
732
  /**
784
- * Value of the field.
733
+ * Value of the field
785
734
  * @maxLength 1000
786
735
  */
787
736
  value?: string;
788
- /** Nested aggregations result data. */
737
+ /** Nested aggregations */
789
738
  nestedResults?: NestedAggregationResults;
790
739
  }
791
740
  interface ValueResult {
792
741
  /**
793
- * Value of the field.
742
+ * Value of the field
794
743
  * @maxLength 1000
795
744
  */
796
745
  value?: string;
797
- /** Count of entities with this value. */
746
+ /** Count of entities with this value */
798
747
  count?: number | null;
799
748
  }
800
749
  interface RangeResult {
801
- /** Inclusive lower bound of the range. */
750
+ /** Inclusive lower bound of the range */
802
751
  from?: number | null;
803
- /** Exclusive upper bound of the range. */
752
+ /** Exclusive upper bound of the range */
804
753
  to?: number | null;
805
- /** Count of entities in this range. */
754
+ /** Count of entities in this range */
806
755
  count?: number | null;
807
756
  }
808
757
  interface ScalarResult {
809
- /** Value of the scalar aggregation. */
758
+ /** Value of the scalar aggregation */
810
759
  value?: number;
811
760
  }
812
761
  interface NestedResultValue extends NestedResultValueResultOneOf {
813
- /** Value aggregation result. */
762
+ /** Value aggregation result */
814
763
  value?: ValueResult;
815
- /** Range aggregation result. */
764
+ /** Range aggregation result */
816
765
  range?: RangeResult;
817
- /** Scalar aggregation result. */
766
+ /** Scalar aggregation result */
818
767
  scalar?: ScalarResult;
819
- /** Date histogram aggregation result. */
768
+ /** Date histogram aggregation result */
820
769
  dateHistogram?: ValueResult;
821
770
  }
822
771
  /** @oneof */
823
772
  interface NestedResultValueResultOneOf {
824
- /** Value aggregation result. */
773
+ /** Value aggregation result */
825
774
  value?: ValueResult;
826
- /** Range aggregation result. */
775
+ /** Range aggregation result */
827
776
  range?: RangeResult;
828
- /** Scalar aggregation result. */
777
+ /** Scalar aggregation result */
829
778
  scalar?: ScalarResult;
830
- /** Date histogram aggregation result. */
779
+ /** Date histogram aggregation result */
831
780
  dateHistogram?: ValueResult;
832
781
  }
833
782
  interface Results {
834
- /** Map of nested aggregation results, keyed by aggregation name. */
783
+ /** List of nested aggregations */
835
784
  results?: Record<string, NestedResultValue>;
836
785
  }
837
786
  interface DateHistogramResult {
838
787
  /**
839
- * Date in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
788
+ * Date in ISO 8601 format
840
789
  * @maxLength 100
841
790
  */
842
791
  value?: string;
843
- /** Count of documents in the bucket. */
792
+ /** Count of documents in the bucket */
844
793
  count?: number;
845
794
  }
846
795
  interface GroupByValueResults {
847
796
  /**
848
- * Array of nested value aggregation results, each containing a field value and the associated nested aggregation data.
797
+ * List of value aggregations
849
798
  * @maxSize 1000
850
799
  */
851
800
  results?: NestedValueAggregationResult[];
852
801
  }
853
802
  interface DateHistogramResults {
854
803
  /**
855
- * Array of date histogram aggregation results, each containing a date bucket and its count.
804
+ * List of date histogram aggregations
856
805
  * @maxSize 200
857
806
  */
858
807
  results?: DateHistogramResult[];
859
808
  }
860
809
  /**
861
810
  * Results of `NESTED` aggregation type in a flattened form
862
- * Aggregations in resulting array are keyed by requested aggregation `name`.
811
+ * aggregations in resulting array are keyed by requested aggregation `name`.
863
812
  */
864
813
  interface NestedResults {
865
814
  /**
866
- * Array of nested aggregation result groups, each containing multiple aggregation results.
815
+ * List of nested aggregations
867
816
  * @maxSize 1000
868
817
  */
869
818
  results?: Results[];
870
819
  }
871
820
  interface AggregationResults extends AggregationResultsResultOneOf {
872
- /** Value aggregation results. */
821
+ /** Value aggregation results */
873
822
  values?: ValueResults;
874
- /** Range aggregation results. */
823
+ /** Range aggregation results */
875
824
  ranges?: RangeResults;
876
- /** Scalar aggregation results. */
825
+ /** Scalar aggregation results */
877
826
  scalar?: AggregationResultsScalarResult;
878
- /** Group by value aggregation results. */
827
+ /** Group by value aggregation results */
879
828
  groupedByValue?: GroupByValueResults;
880
- /** Date histogram aggregation results. */
829
+ /** Date histogram aggregation results */
881
830
  dateHistogram?: DateHistogramResults;
882
- /** Nested aggregation results. */
831
+ /** Nested aggregation results */
883
832
  nested?: NestedResults;
884
833
  /**
885
- * User-defined name of aggregation as derived from search request.
834
+ * User-defined name of aggregation as derived from search request
886
835
  * @maxLength 100
887
836
  */
888
837
  name?: string;
889
- /** Type of aggregation that must match specified kind as derived from search request. */
838
+ /** Type of aggregation that must match provided kind as derived from search request */
890
839
  type?: AggregationTypeWithLiterals;
891
840
  /**
892
- * Path to the field to aggregate by in dot notation. For example `name` or `locationOptions.businessLocations.locationId`.
841
+ * Field to aggregate by as derived from search request
893
842
  * @maxLength 200
894
843
  */
895
844
  fieldPath?: string;
896
845
  }
897
846
  /** @oneof */
898
847
  interface AggregationResultsResultOneOf {
899
- /** Value aggregation results. */
848
+ /** Value aggregation results */
900
849
  values?: ValueResults;
901
- /** Range aggregation results. */
850
+ /** Range aggregation results */
902
851
  ranges?: RangeResults;
903
- /** Scalar aggregation results. */
852
+ /** Scalar aggregation results */
904
853
  scalar?: AggregationResultsScalarResult;
905
- /** Group by value aggregation results. */
854
+ /** Group by value aggregation results */
906
855
  groupedByValue?: GroupByValueResults;
907
- /** Date histogram aggregation results. */
856
+ /** Date histogram aggregation results */
908
857
  dateHistogram?: DateHistogramResults;
909
- /** Nested aggregation results. */
858
+ /** Nested aggregation results */
910
859
  nested?: NestedResults;
911
860
  }
912
861
  interface QueryResourcesRequest {