@osdk/internal.foundry.ontologies 2.51.0 → 2.53.0

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.
@@ -336,8 +336,16 @@ export type Aggregation = ({
336
336
  */
337
337
  export type AggregationAccuracy = "ACCURATE" | "APPROXIMATE";
338
338
  /**
339
- * Log Safety: SAFE
340
- */
339
+ * Specifies the accuracy requirement for aggregation results.
340
+
341
+ REQUIRE_ACCURATE: Only return results if they are guaranteed to be accurate. If accuracy cannot be
342
+ guaranteed (e.g., due to a low maxGroupCount relative to distinct values), the request will fail
343
+ with an AggregationAccuracyNotSupported error.
344
+ ALLOW_APPROXIMATE: Allow approximate results when exact computation is not feasible. This is the
345
+ default behavior if not specified.
346
+ *
347
+ * Log Safety: SAFE
348
+ */
341
349
  export type AggregationAccuracyRequest = "REQUIRE_ACCURATE" | "ALLOW_APPROXIMATE";
342
350
  /**
343
351
  * Divides objects into groups according to an interval. Note that this grouping applies only on date types.
@@ -352,11 +360,13 @@ export interface AggregationDurationGrouping {
352
360
  /**
353
361
  * Divides objects into groups according to an interval. Note that this grouping applies only on date and timestamp types.
354
362
  When grouping by YEARS, QUARTERS, MONTHS, or WEEKS, the value must be set to 1.
363
+ Either field or propertyIdentifier must be supplied, but not both.
355
364
  *
356
365
  * Log Safety: UNSAFE
357
366
  */
358
367
  export interface AggregationDurationGroupingV2 {
359
- field: PropertyApiName;
368
+ field?: PropertyApiName;
369
+ propertyIdentifier?: PropertyIdentifier;
360
370
  value: number;
361
371
  unit: TimeUnit;
362
372
  }
@@ -370,12 +380,14 @@ export interface AggregationExactGrouping {
370
380
  maxGroupCount?: number;
371
381
  }
372
382
  /**
373
- * Divides objects into groups according to an exact value.
374
- *
375
- * Log Safety: UNSAFE
376
- */
383
+ * Divides objects into groups according to an exact value.
384
+ Either field or propertyIdentifier must be supplied, but not both.
385
+ *
386
+ * Log Safety: UNSAFE
387
+ */
377
388
  export interface AggregationExactGroupingV2 {
378
- field: PropertyApiName;
389
+ field?: PropertyApiName;
390
+ propertyIdentifier?: PropertyIdentifier;
379
391
  maxGroupCount?: number;
380
392
  defaultValue?: string;
381
393
  includeNullValues?: boolean;
@@ -390,12 +402,14 @@ export interface AggregationFixedWidthGrouping {
390
402
  fixedWidth: number;
391
403
  }
392
404
  /**
393
- * Divides objects into groups with the specified width.
394
- *
395
- * Log Safety: UNSAFE
396
- */
405
+ * Divides objects into groups with the specified width.
406
+ Either field or propertyIdentifier must be supplied, but not both.
407
+ *
408
+ * Log Safety: UNSAFE
409
+ */
397
410
  export interface AggregationFixedWidthGroupingV2 {
398
- field: PropertyApiName;
411
+ field?: PropertyApiName;
412
+ propertyIdentifier?: PropertyIdentifier;
399
413
  fixedWidth: number;
400
414
  }
401
415
  /**
@@ -497,12 +511,14 @@ export interface AggregationRangesGrouping {
497
511
  ranges: Array<AggregationRange>;
498
512
  }
499
513
  /**
500
- * Divides objects into groups according to specified ranges.
501
- *
502
- * Log Safety: UNSAFE
503
- */
514
+ * Divides objects into groups according to specified ranges.
515
+ Either field or propertyIdentifier must be supplied, but not both.
516
+ *
517
+ * Log Safety: UNSAFE
518
+ */
504
519
  export interface AggregationRangesGroupingV2 {
505
- field: PropertyApiName;
520
+ field?: PropertyApiName;
521
+ propertyIdentifier?: PropertyIdentifier;
506
522
  ranges: Array<AggregationRangeV2>;
507
523
  }
508
524
  /**
@@ -661,22 +677,26 @@ export interface ApproximateDistinctAggregation {
661
677
  name?: AggregationMetricName;
662
678
  }
663
679
  /**
664
- * Computes an approximate number of distinct values for the provided field.
665
- *
666
- * Log Safety: UNSAFE
667
- */
680
+ * Computes an approximate number of distinct values for the provided field.
681
+ Either field or propertyIdentifier must be supplied, but not both.
682
+ *
683
+ * Log Safety: UNSAFE
684
+ */
668
685
  export interface ApproximateDistinctAggregationV2 {
669
- field: PropertyApiName;
686
+ field?: PropertyApiName;
687
+ propertyIdentifier?: PropertyIdentifier;
670
688
  name?: AggregationMetricName;
671
689
  direction?: OrderByDirection;
672
690
  }
673
691
  /**
674
- * Computes the approximate percentile value for the provided field. Requires Object Storage V2.
675
- *
676
- * Log Safety: UNSAFE
677
- */
692
+ * Computes the approximate percentile value for the provided field. Requires Object Storage V2.
693
+ Either field or propertyIdentifier must be supplied, but not both.
694
+ *
695
+ * Log Safety: UNSAFE
696
+ */
678
697
  export interface ApproximatePercentileAggregationV2 {
679
- field: PropertyApiName;
698
+ field?: PropertyApiName;
699
+ propertyIdentifier?: PropertyIdentifier;
680
700
  name?: AggregationMetricName;
681
701
  approximatePercentile: number;
682
702
  direction?: OrderByDirection;
@@ -828,12 +848,14 @@ export interface AvgAggregation {
828
848
  name?: AggregationMetricName;
829
849
  }
830
850
  /**
831
- * Computes the average value for the provided field.
832
- *
833
- * Log Safety: UNSAFE
834
- */
851
+ * Computes the average value for the provided field.
852
+ Either field or propertyIdentifier must be supplied, but not both.
853
+ *
854
+ * Log Safety: UNSAFE
855
+ */
835
856
  export interface AvgAggregationV2 {
836
- field: PropertyApiName;
857
+ field?: PropertyApiName;
858
+ propertyIdentifier?: PropertyIdentifier;
837
859
  name?: AggregationMetricName;
838
860
  direction?: OrderByDirection;
839
861
  }
@@ -1600,12 +1622,15 @@ export interface ErrorComputingSecurity {
1600
1622
  */
1601
1623
  export type ErrorName = LooselyBrandedString<"ErrorName">;
1602
1624
  /**
1603
- * Computes an exact number of distinct values for the provided field. May be slower than an approximate distinct aggregation. Requires Object Storage V2.
1604
- *
1605
- * Log Safety: UNSAFE
1606
- */
1625
+ * Computes an exact number of distinct values for the provided field. May be slower than an approximate
1626
+ distinct aggregation. Requires Object Storage V2.
1627
+ Either field or propertyIdentifier must be supplied, but not both.
1628
+ *
1629
+ * Log Safety: UNSAFE
1630
+ */
1607
1631
  export interface ExactDistinctAggregationV2 {
1608
- field: PropertyApiName;
1632
+ field?: PropertyApiName;
1633
+ propertyIdentifier?: PropertyIdentifier;
1609
1634
  name?: AggregationMetricName;
1610
1635
  direction?: OrderByDirection;
1611
1636
  }
@@ -2729,12 +2754,14 @@ export interface MaxAggregation {
2729
2754
  name?: AggregationMetricName;
2730
2755
  }
2731
2756
  /**
2732
- * Computes the maximum value for the provided field.
2733
- *
2734
- * Log Safety: UNSAFE
2735
- */
2757
+ * Computes the maximum value for the provided field.
2758
+ Either field or propertyIdentifier must be supplied, but not both.
2759
+ *
2760
+ * Log Safety: UNSAFE
2761
+ */
2736
2762
  export interface MaxAggregationV2 {
2737
- field: PropertyApiName;
2763
+ field?: PropertyApiName;
2764
+ propertyIdentifier?: PropertyIdentifier;
2738
2765
  name?: AggregationMetricName;
2739
2766
  direction?: OrderByDirection;
2740
2767
  }
@@ -2764,12 +2791,14 @@ export interface MinAggregation {
2764
2791
  name?: AggregationMetricName;
2765
2792
  }
2766
2793
  /**
2767
- * Computes the minimum value for the provided field.
2768
- *
2769
- * Log Safety: UNSAFE
2770
- */
2794
+ * Computes the minimum value for the provided field.
2795
+ Either field or propertyIdentifier must be supplied, but not both.
2796
+ *
2797
+ * Log Safety: UNSAFE
2798
+ */
2771
2799
  export interface MinAggregationV2 {
2772
- field: PropertyApiName;
2800
+ field?: PropertyApiName;
2801
+ propertyIdentifier?: PropertyIdentifier;
2773
2802
  name?: AggregationMetricName;
2774
2803
  direction?: OrderByDirection;
2775
2804
  }
@@ -4648,7 +4677,27 @@ export interface RegexConstraint {
4648
4677
  }
4649
4678
  /**
4650
4679
  * Returns objects where the specified field matches the regex pattern provided. This applies to the non-analyzed
4651
- form of text fields and supports standard regex syntax of dot (.), star(*) and question mark(?).
4680
+ form of text fields. Supported operators:
4681
+
4682
+ . matches any character.
4683
+ ? repeats the previous character 0 or 1 times.
4684
+ + repeats the previous character 1 or more times.
4685
+ * repeats the previous character 0 or more times.
4686
+ {} defines the minimum and maximum number of times the preceding character can repeat. {2} means the
4687
+ previous character must repeat only twice, {2,} means the previous character must repeat at least twice,
4688
+ and {2,4} means the previous character must repeat between 2-4 times.
4689
+ | is the OR operator.
4690
+ () forms a group within an expression such that the group can be treated as a single character.
4691
+ [] matches a single one of the characters contained inside the brackets, meaning [abc] matches a, b or
4692
+ c. Unless - is the first character or escaped with \ (in which case it is treated as a normal character),
4693
+ - can be used inside the bracket to create a range of characters, meaning [a-c] matches a, b, or c.
4694
+ If the character sequence inside the brackets begins with ^, the set of characters is negated, meaning
4695
+ [^abc] does not match a, b, or c. Otherwise, ^ is treated as a normal character.
4696
+ " creates groups of string literals.
4697
+ \ is used as an escape character. However, \d and \D match digit and non-digit characters respectively, \s
4698
+ and \S match whitespace and non whitespace characters respectively, and \w and \W match word and non word
4699
+ characters respectively.
4700
+
4652
4701
  Either field or propertyIdentifier can be supplied, but not both.
4653
4702
  *
4654
4703
  * Log Safety: UNSAFE
@@ -5472,12 +5521,14 @@ export interface SumAggregation {
5472
5521
  name?: AggregationMetricName;
5473
5522
  }
5474
5523
  /**
5475
- * Computes the sum of values for the provided field.
5476
- *
5477
- * Log Safety: UNSAFE
5478
- */
5524
+ * Computes the sum of values for the provided field.
5525
+ Either field or propertyIdentifier must be supplied, but not both.
5526
+ *
5527
+ * Log Safety: UNSAFE
5528
+ */
5479
5529
  export interface SumAggregationV2 {
5480
- field: PropertyApiName;
5530
+ field?: PropertyApiName;
5531
+ propertyIdentifier?: PropertyIdentifier;
5481
5532
  name?: AggregationMetricName;
5482
5533
  direction?: OrderByDirection;
5483
5534
  }