@osdk/foundry.ontologies 2.15.0 → 2.17.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,29 @@
1
1
  # @osdk/foundry.ontologies
2
2
 
3
+ ## 2.17.0
4
+
5
+ ### Minor Changes
6
+
7
+ - db7ee48: Update Platform SDKs
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [db7ee48]
12
+ - @osdk/foundry.core@2.17.0
13
+ - @osdk/foundry.geo@2.17.0
14
+
15
+ ## 2.16.0
16
+
17
+ ### Minor Changes
18
+
19
+ - 45b549f: Bumping to include new flag on interface object sets.
20
+
21
+ ### Patch Changes
22
+
23
+ - Updated dependencies [45b549f]
24
+ - @osdk/foundry.core@2.16.0
25
+ - @osdk/foundry.geo@2.16.0
26
+
3
27
  ## 2.15.0
4
28
 
5
29
  ### Minor Changes
@@ -12,6 +12,14 @@ export interface AbsoluteTimeRange {
12
12
  startTime?: string;
13
13
  endTime?: string;
14
14
  }
15
+ /**
16
+ * Calculates absolute value of a numeric value.
17
+ *
18
+ * Log Safety: UNSAFE
19
+ */
20
+ export interface AbsoluteValuePropertyExpression {
21
+ property: DerivedPropertyDefinition;
22
+ }
15
23
  /**
16
24
  * Log Safety: UNSAFE
17
25
  */
@@ -70,6 +78,7 @@ export type ActionParameterType = ({
70
78
  * Log Safety: UNSAFE
71
79
  */
72
80
  export interface ActionParameterV2 {
81
+ displayName: _Core.DisplayName;
73
82
  description?: string;
74
83
  dataType: ActionParameterType;
75
84
  required: boolean;
@@ -153,6 +162,14 @@ export interface AddObject {
153
162
  primaryKey: PropertyValue;
154
163
  objectType: ObjectTypeApiName;
155
164
  }
165
+ /**
166
+ * Adds two or more numeric values.
167
+ *
168
+ * Log Safety: UNSAFE
169
+ */
170
+ export interface AddPropertyExpression {
171
+ properties: Array<DerivedPropertyDefinition>;
172
+ }
156
173
  /**
157
174
  * Log Safety: UNSAFE
158
175
  */
@@ -209,6 +226,13 @@ export interface AggregateObjectsResponseV2 {
209
226
  accuracy: AggregationAccuracy;
210
227
  data: Array<AggregateObjectsResponseItemV2>;
211
228
  }
229
+ /**
230
+ * Log Safety: UNSAFE
231
+ */
232
+ export interface AggregateTimeSeries {
233
+ method: TimeSeriesAggregationMethod;
234
+ strategy: TimeSeriesAggregationStrategy;
235
+ }
212
236
  /**
213
237
  * Specifies an aggregation function.
214
238
  *
@@ -984,9 +1008,29 @@ export type DerivedPropertyApiName = LooselyBrandedString<"DerivedPropertyApiNam
984
1008
  *
985
1009
  * Log Safety: UNSAFE
986
1010
  */
987
- export type DerivedPropertyDefinition = {
1011
+ export type DerivedPropertyDefinition = ({
1012
+ type: "add";
1013
+ } & AddPropertyExpression) | ({
1014
+ type: "absoluteValue";
1015
+ } & AbsoluteValuePropertyExpression) | ({
1016
+ type: "extract";
1017
+ } & ExtractPropertyExpression) | ({
988
1018
  type: "selection";
989
- } & SelectedPropertyDefinition;
1019
+ } & SelectedPropertyExpression) | ({
1020
+ type: "negate";
1021
+ } & NegatePropertyExpression) | ({
1022
+ type: "subtract";
1023
+ } & SubtractPropertyExpression) | ({
1024
+ type: "property";
1025
+ } & PropertyApiNameSelector) | ({
1026
+ type: "least";
1027
+ } & LeastPropertyExpression) | ({
1028
+ type: "divide";
1029
+ } & DividePropertyExpression) | ({
1030
+ type: "multiply";
1031
+ } & MultiplyPropertyExpression) | ({
1032
+ type: "greatest";
1033
+ } & GreatestPropertyExpression);
990
1034
  /**
991
1035
  * The representation of a time series property backed by a derived time series calculated with a formula.
992
1036
  *
@@ -996,6 +1040,15 @@ export interface DerivedTimeSeriesProperty {
996
1040
  templateRid: TimeseriesTemplateRid;
997
1041
  templateVersion?: TimeseriesTemplateVersion;
998
1042
  }
1043
+ /**
1044
+ * Divides the left numeric value by the right numeric value.
1045
+ *
1046
+ * Log Safety: UNSAFE
1047
+ */
1048
+ export interface DividePropertyExpression {
1049
+ left: DerivedPropertyDefinition;
1050
+ right: DerivedPropertyDefinition;
1051
+ }
999
1052
  /**
1000
1053
  * Returns objects where the specified field does not intersect the bounding box provided. Allows you to specify a
1001
1054
  property to query on by a variety of means. Either field or propertyIdentifier must be supplied, but not
@@ -1110,6 +1163,19 @@ export interface ExecuteQueryResponse {
1110
1163
  */
1111
1164
  export interface ExperimentalPropertyTypeStatus {
1112
1165
  }
1166
+ /**
1167
+ * Log Safety: SAFE
1168
+ */
1169
+ export type ExtractDatePart = "DAYS" | "MONTHS" | "QUARTERS" | "YEARS";
1170
+ /**
1171
+ * Extracts the specified date part from a date or timestamp.
1172
+ *
1173
+ * Log Safety: UNSAFE
1174
+ */
1175
+ export interface ExtractPropertyExpression {
1176
+ property: DerivedPropertyDefinition;
1177
+ part: ExtractDatePart;
1178
+ }
1113
1179
  /**
1114
1180
  * A reference to an Ontology object property with the form properties.{propertyApiName}.
1115
1181
  *
@@ -1188,6 +1254,14 @@ Use collectList or collectSet which will return a list of values in that case.
1188
1254
  export interface GetSelectedPropertyOperation {
1189
1255
  selectedPropertyApiName: PropertyApiName;
1190
1256
  }
1257
+ /**
1258
+ * Finds greatest of two or more numeric, date or timestamp values.
1259
+ *
1260
+ * Log Safety: UNSAFE
1261
+ */
1262
+ export interface GreatestPropertyExpression {
1263
+ properties: Array<DerivedPropertyDefinition>;
1264
+ }
1191
1265
  /**
1192
1266
  * The parameter value must be the user id of a member belonging to at least one of the groups defined by the constraint.
1193
1267
  *
@@ -1398,6 +1472,14 @@ export interface IsNullQueryV2 {
1398
1472
  propertyIdentifier?: PropertyIdentifier;
1399
1473
  value: boolean;
1400
1474
  }
1475
+ /**
1476
+ * Finds least of two or more numeric, date or timestamp values.
1477
+ *
1478
+ * Log Safety: UNSAFE
1479
+ */
1480
+ export interface LeastPropertyExpression {
1481
+ properties: Array<DerivedPropertyDefinition>;
1482
+ }
1401
1483
  /**
1402
1484
  * A reference to the linked interface type.
1403
1485
  *
@@ -1785,6 +1867,14 @@ export interface ModifyObject {
1785
1867
  export interface ModifyObjectRule {
1786
1868
  objectTypeApiName: ObjectTypeApiName;
1787
1869
  }
1870
+ /**
1871
+ * Multiplies two or more numeric values.
1872
+ *
1873
+ * Log Safety: UNSAFE
1874
+ */
1875
+ export interface MultiplyPropertyExpression {
1876
+ properties: Array<DerivedPropertyDefinition>;
1877
+ }
1788
1878
  /**
1789
1879
  * Queries support either a vector matching the embedding model defined on the property, or text that is
1790
1880
  automatically embedded.
@@ -1804,6 +1894,14 @@ export type NearestNeighborsQuery = ({
1804
1894
  export interface NearestNeighborsQueryText {
1805
1895
  value: string;
1806
1896
  }
1897
+ /**
1898
+ * Negates a numeric value.
1899
+ *
1900
+ * Log Safety: UNSAFE
1901
+ */
1902
+ export interface NegatePropertyExpression {
1903
+ property: DerivedPropertyDefinition;
1904
+ }
1807
1905
  /**
1808
1906
  * Log Safety: UNSAFE
1809
1907
  */
@@ -1999,6 +2097,7 @@ export interface ObjectSetFilterType {
1999
2097
  */
2000
2098
  export interface ObjectSetInterfaceBaseType {
2001
2099
  interfaceType: string;
2100
+ includeAllBaseObjectProperties?: boolean;
2002
2101
  }
2003
2102
  /**
2004
2103
  * Log Safety: UNSAFE
@@ -2546,6 +2645,21 @@ export interface PhraseQuery {
2546
2645
  export type PolygonValue = {
2547
2646
  type: "Polygon";
2548
2647
  } & _Geo.Polygon;
2648
+ /**
2649
+ * A measurement of duration.
2650
+ *
2651
+ * Log Safety: SAFE
2652
+ */
2653
+ export interface PreciseDuration {
2654
+ value: number;
2655
+ unit: PreciseTimeUnit;
2656
+ }
2657
+ /**
2658
+ * The unit of a fixed-width duration. Each day is 24 hours and each week is 7 days.
2659
+ *
2660
+ * Log Safety: SAFE
2661
+ */
2662
+ export type PreciseTimeUnit = "NANOSECONDS" | "SECONDS" | "MINUTES" | "HOURS" | "DAYS" | "WEEKS";
2549
2663
  /**
2550
2664
  * Returns objects where the specified field starts with the provided value.
2551
2665
  *
@@ -3024,6 +3138,14 @@ export type RequestId = string;
3024
3138
  * Log Safety: SAFE
3025
3139
  */
3026
3140
  export type ReturnEditsMode = "ALL" | "ALL_V2_WITH_DELETIONS" | "NONE";
3141
+ /**
3142
+ * Number of points in each window.
3143
+ *
3144
+ * Log Safety: SAFE
3145
+ */
3146
+ export interface RollingAggregateWindowPoints {
3147
+ count: number;
3148
+ }
3027
3149
  /**
3028
3150
  * Log Safety: UNSAFE
3029
3151
  */
@@ -3272,21 +3394,21 @@ export interface SelectedPropertyCollectSetAggregation {
3272
3394
  export interface SelectedPropertyCountAggregation {
3273
3395
  }
3274
3396
  /**
3275
- * Definition for a selected property over a MethodObjectSet.
3397
+ * Computes an exact number of distinct values for the provided field. May be slower than an approximate distinct aggregation.
3276
3398
  *
3277
3399
  * Log Safety: UNSAFE
3278
3400
  */
3279
- export interface SelectedPropertyDefinition {
3280
- objectSet: MethodObjectSet;
3281
- operation: SelectedPropertyOperation;
3401
+ export interface SelectedPropertyExactDistinctAggregation {
3402
+ selectedPropertyApiName: PropertyApiName;
3282
3403
  }
3283
3404
  /**
3284
- * Computes an exact number of distinct values for the provided field. May be slower than an approximate distinct aggregation.
3405
+ * Definition for a selected property over a MethodObjectSet.
3285
3406
  *
3286
3407
  * Log Safety: UNSAFE
3287
3408
  */
3288
- export interface SelectedPropertyExactDistinctAggregation {
3289
- selectedPropertyApiName: PropertyApiName;
3409
+ export interface SelectedPropertyExpression {
3410
+ objectSet: MethodObjectSet;
3411
+ operation: SelectedPropertyOperation;
3290
3412
  }
3291
3413
  /**
3292
3414
  * Computes the maximum value for the provided field.
@@ -3406,6 +3528,7 @@ export type StreamMessage = ({
3406
3528
  */
3407
3529
  export interface StreamTimeSeriesPointsRequest {
3408
3530
  range?: TimeRange;
3531
+ aggregate?: AggregateTimeSeries;
3409
3532
  }
3410
3533
  /**
3411
3534
  * Log Safety: UNSAFE
@@ -3453,9 +3576,10 @@ export interface StringRegexMatchConstraint {
3453
3576
  */
3454
3577
  export type StructFieldApiName = LooselyBrandedString<"StructFieldApiName">;
3455
3578
  /**
3456
- * A combination of a struct property api name and a struct field api name. This is used to select struct fields
3457
- to query on. Note that you can still select struct properties with only a 'PropertyApiNameSelector'; the queries
3458
- will then become 'OR' queries across the fields of the struct property.
3579
+ * A combination of a property API name and a struct field API name used to select struct fields. Note that you can
3580
+ still select struct properties with only a 'PropertyApiNameSelector'; the queries will then become 'OR' queries
3581
+ across the fields of the struct property, and derived property expressions will operate on the whole struct
3582
+ where applicable.
3459
3583
  *
3460
3584
  * Log Safety: UNSAFE
3461
3585
  */
@@ -3522,6 +3646,15 @@ export type SubscriptionId = string;
3522
3646
  export interface SubscriptionSuccess {
3523
3647
  id: SubscriptionId;
3524
3648
  }
3649
+ /**
3650
+ * Subtracts the right numeric value from the left numeric value.
3651
+ *
3652
+ * Log Safety: UNSAFE
3653
+ */
3654
+ export interface SubtractPropertyExpression {
3655
+ left: DerivedPropertyDefinition;
3656
+ right: DerivedPropertyDefinition;
3657
+ }
3525
3658
  /**
3526
3659
  * Computes the sum of values for the provided field.
3527
3660
  *
@@ -3565,6 +3698,35 @@ export type TimeRange = ({
3565
3698
  } & AbsoluteTimeRange) | ({
3566
3699
  type: "relative";
3567
3700
  } & RelativeTimeRange);
3701
+ /**
3702
+ * The aggregation function to use for aggregating time series data.
3703
+ *
3704
+ * Log Safety: SAFE
3705
+ */
3706
+ export type TimeSeriesAggregationMethod = "SUM" | "MEAN" | "STANDARD_DEVIATION" | "MAX" | "MIN" | "PERCENT_CHANGE" | "DIFFERENCE" | "PRODUCT" | "COUNT" | "FIRST" | "LAST";
3707
+ /**
3708
+ * CUMULATIVE aggregates all points up to the current point.
3709
+ ROLLING aggregates all points in a rolling window whose size is either the specified number of points or
3710
+ time duration.
3711
+ PERIODIC aggregates all points in specified time windows.
3712
+ *
3713
+ * Log Safety: UNSAFE
3714
+ */
3715
+ export type TimeSeriesAggregationStrategy = ({
3716
+ type: "rolling";
3717
+ } & TimeSeriesRollingAggregate) | ({
3718
+ type: "periodic";
3719
+ } & TimeSeriesPeriodicAggregate) | ({
3720
+ type: "cumulative";
3721
+ } & TimeSeriesCumulativeAggregate);
3722
+ /**
3723
+ * The cumulative aggregate is calculated progressively for each point in the input time series,
3724
+ considering all preceding points up to and including the current point.
3725
+ *
3726
+ * Log Safety: SAFE
3727
+ */
3728
+ export interface TimeSeriesCumulativeAggregate {
3729
+ }
3568
3730
  /**
3569
3731
  * A time and value pair.
3570
3732
  *
@@ -3574,6 +3736,22 @@ export interface TimeseriesEntry {
3574
3736
  time: string;
3575
3737
  value: any;
3576
3738
  }
3739
+ /**
3740
+ * Aggregates values over discrete, periodic windows for a given time series.
3741
+ A periodic window divides the time series into windows of fixed durations.
3742
+ For each window, an aggregate function is applied to the points within that window. The result is a time series
3743
+ with values representing the aggregate for each window. Windows with no data points are not included
3744
+ in the output.
3745
+ Periodic aggregation is useful for downsampling a continuous stream of data to larger granularities such as
3746
+ hourly, daily, monthly.
3747
+ *
3748
+ * Log Safety: SAFE
3749
+ */
3750
+ export interface TimeSeriesPeriodicAggregate {
3751
+ windowSize: PreciseDuration;
3752
+ alignmentTimestamp?: string;
3753
+ windowType: TimeSeriesWindowType;
3754
+ }
3577
3755
  /**
3578
3756
  * A time and value pair.
3579
3757
  *
@@ -3587,6 +3765,26 @@ export interface TimeSeriesPoint {
3587
3765
  * Log Safety: UNSAFE
3588
3766
  */
3589
3767
  export type TimeSeriesPropertyV2 = LooselyBrandedString<"TimeSeriesPropertyV2">;
3768
+ /**
3769
+ * Log Safety: UNSAFE
3770
+ */
3771
+ export interface TimeSeriesRollingAggregate {
3772
+ windowSize: TimeSeriesRollingAggregateWindow;
3773
+ }
3774
+ /**
3775
+ * A rolling window is a moving subset of data points that ends at the current timestamp (inclusive)
3776
+ and spans a specified duration (window size). As new data points are added, old points fall out of the
3777
+ window if they are outside the specified duration.
3778
+ Rolling windows are commonly used for smoothing data, detecting trends, and reducing noise
3779
+ in time series analysis.
3780
+ *
3781
+ * Log Safety: UNSAFE
3782
+ */
3783
+ export type TimeSeriesRollingAggregateWindow = ({
3784
+ type: "duration";
3785
+ } & PreciseDuration) | ({
3786
+ type: "pointsCount";
3787
+ } & RollingAggregateWindowPoints);
3590
3788
  /**
3591
3789
  * The RID identifying a time series sync.
3592
3790
  *
@@ -3609,6 +3807,10 @@ export type TimeseriesTemplateVersion = LooselyBrandedString<"TimeseriesTemplate
3609
3807
  * Log Safety: UNSAFE
3610
3808
  */
3611
3809
  export type TimeSeriesValueBankProperty = LooselyBrandedString<"TimeSeriesValueBankProperty">;
3810
+ /**
3811
+ * Log Safety: SAFE
3812
+ */
3813
+ export type TimeSeriesWindowType = "START" | "END";
3612
3814
  /**
3613
3815
  * Log Safety: SAFE
3614
3816
  */