@osdk/foundry.ontologies 2.16.0 → 2.18.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.
Files changed (42) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/build/browser/_components.d.ts +264 -35
  3. package/build/browser/_components.d.ts.map +1 -1
  4. package/build/browser/_errors.d.ts +83 -0
  5. package/build/browser/_errors.d.ts.map +1 -1
  6. package/build/browser/index.d.ts +3 -2
  7. package/build/browser/index.d.ts.map +1 -1
  8. package/build/browser/index.js +1 -0
  9. package/build/browser/index.js.map +1 -1
  10. package/build/browser/public/ActionTypeV2.d.ts +14 -0
  11. package/build/browser/public/ActionTypeV2.d.ts.map +1 -1
  12. package/build/browser/public/ActionTypeV2.js +14 -0
  13. package/build/browser/public/ActionTypeV2.js.map +1 -1
  14. package/build/browser/public/CipherTextProperty.d.ts +21 -0
  15. package/build/browser/public/CipherTextProperty.d.ts.map +1 -0
  16. package/build/browser/public/CipherTextProperty.js +33 -0
  17. package/build/browser/public/CipherTextProperty.js.map +1 -0
  18. package/build/browser/public/OntologyObjectSet.d.ts +6 -0
  19. package/build/browser/public/OntologyObjectSet.d.ts.map +1 -1
  20. package/build/browser/public/OntologyObjectSet.js +6 -0
  21. package/build/browser/public/OntologyObjectSet.js.map +1 -1
  22. package/build/esm/_components.d.ts +264 -35
  23. package/build/esm/_components.d.ts.map +1 -1
  24. package/build/esm/_errors.d.ts +83 -0
  25. package/build/esm/_errors.d.ts.map +1 -1
  26. package/build/esm/index.d.ts +3 -2
  27. package/build/esm/index.d.ts.map +1 -1
  28. package/build/esm/index.js +1 -0
  29. package/build/esm/index.js.map +1 -1
  30. package/build/esm/public/ActionTypeV2.d.ts +14 -0
  31. package/build/esm/public/ActionTypeV2.d.ts.map +1 -1
  32. package/build/esm/public/ActionTypeV2.js +14 -0
  33. package/build/esm/public/ActionTypeV2.js.map +1 -1
  34. package/build/esm/public/CipherTextProperty.d.ts +21 -0
  35. package/build/esm/public/CipherTextProperty.d.ts.map +1 -0
  36. package/build/esm/public/CipherTextProperty.js +33 -0
  37. package/build/esm/public/CipherTextProperty.js.map +1 -0
  38. package/build/esm/public/OntologyObjectSet.d.ts +6 -0
  39. package/build/esm/public/OntologyObjectSet.d.ts.map +1 -1
  40. package/build/esm/public/OntologyObjectSet.js +6 -0
  41. package/build/esm/public/OntologyObjectSet.js.map +1 -1
  42. package/package.json +4 -4
package/CHANGELOG.md CHANGED
@@ -1,5 +1,29 @@
1
1
  # @osdk/foundry.ontologies
2
2
 
3
+ ## 2.18.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 98ec492: Update Platform SDKs
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [98ec492]
12
+ - @osdk/foundry.core@2.18.0
13
+ - @osdk/foundry.geo@2.18.0
14
+
15
+ ## 2.17.0
16
+
17
+ ### Minor Changes
18
+
19
+ - db7ee48: Update Platform SDKs
20
+
21
+ ### Patch Changes
22
+
23
+ - Updated dependencies [db7ee48]
24
+ - @osdk/foundry.core@2.17.0
25
+ - @osdk/foundry.geo@2.17.0
26
+
3
27
  ## 2.16.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
  */
@@ -44,6 +52,8 @@ export type ActionParameterType = ({
44
52
  } & _Core.DoubleType) | ({
45
53
  type: "integer";
46
54
  } & _Core.IntegerType) | ({
55
+ type: "geoshape";
56
+ } & _Core.GeoShapeType) | ({
47
57
  type: "long";
48
58
  } & _Core.LongType) | ({
49
59
  type: "objectType";
@@ -60,6 +70,10 @@ export type ActionParameterType = ({
60
70
  } & ActionParameterArrayType) | ({
61
71
  type: "objectSet";
62
72
  } & OntologyObjectSetType) | ({
73
+ type: "geohash";
74
+ } & _Core.GeohashType) | ({
75
+ type: "vector";
76
+ } & _Core.VectorType) | ({
63
77
  type: "object";
64
78
  } & OntologyObjectType) | ({
65
79
  type: "timestamp";
@@ -70,6 +84,7 @@ export type ActionParameterType = ({
70
84
  * Log Safety: UNSAFE
71
85
  */
72
86
  export interface ActionParameterV2 {
87
+ displayName: _Core.DisplayName;
73
88
  description?: string;
74
89
  dataType: ActionParameterType;
75
90
  required: boolean;
@@ -153,6 +168,14 @@ export interface AddObject {
153
168
  primaryKey: PropertyValue;
154
169
  objectType: ObjectTypeApiName;
155
170
  }
171
+ /**
172
+ * Adds two or more numeric values.
173
+ *
174
+ * Log Safety: UNSAFE
175
+ */
176
+ export interface AddPropertyExpression {
177
+ properties: Array<DerivedPropertyDefinition>;
178
+ }
156
179
  /**
157
180
  * Log Safety: UNSAFE
158
181
  */
@@ -209,6 +232,13 @@ export interface AggregateObjectsResponseV2 {
209
232
  accuracy: AggregationAccuracy;
210
233
  data: Array<AggregateObjectsResponseItemV2>;
211
234
  }
235
+ /**
236
+ * Log Safety: UNSAFE
237
+ */
238
+ export interface AggregateTimeSeries {
239
+ method: TimeSeriesAggregationMethod;
240
+ strategy: TimeSeriesAggregationStrategy;
241
+ }
212
242
  /**
213
243
  * Specifies an aggregation function.
214
244
  *
@@ -759,6 +789,10 @@ export interface CenterPoint {
759
789
  export type CenterPointTypes = {
760
790
  type: "Point";
761
791
  } & _Geo.GeoPoint;
792
+ /**
793
+ * Log Safety: UNSAFE
794
+ */
795
+ export type CipherTextProperty = LooselyBrandedString<"CipherTextProperty">;
762
796
  /**
763
797
  * Returns objects where the specified field contains all of the terms in the order provided,
764
798
  but they do have to be adjacent to each other.
@@ -925,6 +959,14 @@ export type CustomTypeId = LooselyBrandedString<"CustomTypeId">;
925
959
  * Log Safety: UNSAFE
926
960
  */
927
961
  export type DataValue = any;
962
+ /**
963
+ * The result of a CipherText decryption. If successful, the plaintext decrypted value will be returned. Otherwise, an error will be thrown.
964
+ *
965
+ * Log Safety: DO_NOT_LOG
966
+ */
967
+ export interface DecryptionResult {
968
+ plaintext?: Plaintext;
969
+ }
928
970
  /**
929
971
  * Log Safety: UNSAFE
930
972
  */
@@ -984,9 +1026,29 @@ export type DerivedPropertyApiName = LooselyBrandedString<"DerivedPropertyApiNam
984
1026
  *
985
1027
  * Log Safety: UNSAFE
986
1028
  */
987
- export type DerivedPropertyDefinition = {
1029
+ export type DerivedPropertyDefinition = ({
1030
+ type: "add";
1031
+ } & AddPropertyExpression) | ({
1032
+ type: "absoluteValue";
1033
+ } & AbsoluteValuePropertyExpression) | ({
1034
+ type: "extract";
1035
+ } & ExtractPropertyExpression) | ({
988
1036
  type: "selection";
989
- } & SelectedPropertyDefinition;
1037
+ } & SelectedPropertyExpression) | ({
1038
+ type: "negate";
1039
+ } & NegatePropertyExpression) | ({
1040
+ type: "subtract";
1041
+ } & SubtractPropertyExpression) | ({
1042
+ type: "property";
1043
+ } & PropertyApiNameSelector) | ({
1044
+ type: "least";
1045
+ } & LeastPropertyExpression) | ({
1046
+ type: "divide";
1047
+ } & DividePropertyExpression) | ({
1048
+ type: "multiply";
1049
+ } & MultiplyPropertyExpression) | ({
1050
+ type: "greatest";
1051
+ } & GreatestPropertyExpression);
990
1052
  /**
991
1053
  * The representation of a time series property backed by a derived time series calculated with a formula.
992
1054
  *
@@ -996,6 +1058,15 @@ export interface DerivedTimeSeriesProperty {
996
1058
  templateRid: TimeseriesTemplateRid;
997
1059
  templateVersion?: TimeseriesTemplateVersion;
998
1060
  }
1061
+ /**
1062
+ * Divides the left numeric value by the right numeric value.
1063
+ *
1064
+ * Log Safety: UNSAFE
1065
+ */
1066
+ export interface DividePropertyExpression {
1067
+ left: DerivedPropertyDefinition;
1068
+ right: DerivedPropertyDefinition;
1069
+ }
999
1070
  /**
1000
1071
  * Returns objects where the specified field does not intersect the bounding box provided. Allows you to specify a
1001
1072
  property to query on by a variety of means. Either field or propertyIdentifier must be supplied, but not
@@ -1110,6 +1181,19 @@ export interface ExecuteQueryResponse {
1110
1181
  */
1111
1182
  export interface ExperimentalPropertyTypeStatus {
1112
1183
  }
1184
+ /**
1185
+ * Log Safety: SAFE
1186
+ */
1187
+ export type ExtractDatePart = "DAYS" | "MONTHS" | "QUARTERS" | "YEARS";
1188
+ /**
1189
+ * Extracts the specified date part from a date or timestamp.
1190
+ *
1191
+ * Log Safety: UNSAFE
1192
+ */
1193
+ export interface ExtractPropertyExpression {
1194
+ property: DerivedPropertyDefinition;
1195
+ part: ExtractDatePart;
1196
+ }
1113
1197
  /**
1114
1198
  * A reference to an Ontology object property with the form properties.{propertyApiName}.
1115
1199
  *
@@ -1188,6 +1272,14 @@ Use collectList or collectSet which will return a list of values in that case.
1188
1272
  export interface GetSelectedPropertyOperation {
1189
1273
  selectedPropertyApiName: PropertyApiName;
1190
1274
  }
1275
+ /**
1276
+ * Finds greatest of two or more numeric, date or timestamp values.
1277
+ *
1278
+ * Log Safety: UNSAFE
1279
+ */
1280
+ export interface GreatestPropertyExpression {
1281
+ properties: Array<DerivedPropertyDefinition>;
1282
+ }
1191
1283
  /**
1192
1284
  * The parameter value must be the user id of a member belonging to at least one of the groups defined by the constraint.
1193
1285
  *
@@ -1398,6 +1490,14 @@ export interface IsNullQueryV2 {
1398
1490
  propertyIdentifier?: PropertyIdentifier;
1399
1491
  value: boolean;
1400
1492
  }
1493
+ /**
1494
+ * Finds least of two or more numeric, date or timestamp values.
1495
+ *
1496
+ * Log Safety: UNSAFE
1497
+ */
1498
+ export interface LeastPropertyExpression {
1499
+ properties: Array<DerivedPropertyDefinition>;
1500
+ }
1401
1501
  /**
1402
1502
  * A reference to the linked interface type.
1403
1503
  *
@@ -1785,6 +1885,14 @@ export interface ModifyObject {
1785
1885
  export interface ModifyObjectRule {
1786
1886
  objectTypeApiName: ObjectTypeApiName;
1787
1887
  }
1888
+ /**
1889
+ * Multiplies two or more numeric values.
1890
+ *
1891
+ * Log Safety: UNSAFE
1892
+ */
1893
+ export interface MultiplyPropertyExpression {
1894
+ properties: Array<DerivedPropertyDefinition>;
1895
+ }
1788
1896
  /**
1789
1897
  * Queries support either a vector matching the embedding model defined on the property, or text that is
1790
1898
  automatically embedded.
@@ -1804,6 +1912,14 @@ export type NearestNeighborsQuery = ({
1804
1912
  export interface NearestNeighborsQueryText {
1805
1913
  value: string;
1806
1914
  }
1915
+ /**
1916
+ * Negates a numeric value.
1917
+ *
1918
+ * Log Safety: UNSAFE
1919
+ */
1920
+ export interface NegatePropertyExpression {
1921
+ property: DerivedPropertyDefinition;
1922
+ }
1807
1923
  /**
1808
1924
  * Log Safety: UNSAFE
1809
1925
  */
@@ -2541,12 +2657,31 @@ export interface PhraseQuery {
2541
2657
  field: FieldNameV1;
2542
2658
  value: string;
2543
2659
  }
2660
+ /**
2661
+ * Log Safety: DO_NOT_LOG
2662
+ */
2663
+ export type Plaintext = LooselyBrandedString<"Plaintext">;
2544
2664
  /**
2545
2665
  * Log Safety: UNSAFE
2546
2666
  */
2547
2667
  export type PolygonValue = {
2548
2668
  type: "Polygon";
2549
2669
  } & _Geo.Polygon;
2670
+ /**
2671
+ * A measurement of duration.
2672
+ *
2673
+ * Log Safety: SAFE
2674
+ */
2675
+ export interface PreciseDuration {
2676
+ value: number;
2677
+ unit: PreciseTimeUnit;
2678
+ }
2679
+ /**
2680
+ * The unit of a fixed-width duration. Each day is 24 hours and each week is 7 days.
2681
+ *
2682
+ * Log Safety: SAFE
2683
+ */
2684
+ export type PreciseTimeUnit = "NANOSECONDS" | "SECONDS" | "MINUTES" | "HOURS" | "DAYS" | "WEEKS";
2550
2685
  /**
2551
2686
  * Returns objects where the specified field starts with the provided value.
2552
2687
  *
@@ -2669,28 +2804,29 @@ export interface PropertyV2 {
2669
2804
  }
2670
2805
  /**
2671
2806
  * Represents the value of a property in the following format.
2672
- | Type | JSON encoding | Example |
2673
- |---------------- |-------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
2674
- | Array | array | ["alpha", "bravo", "charlie"] |
2675
- | Attachment | JSON encoded AttachmentProperty object | {"rid":"ri.blobster.main.attachment.2f944bae-5851-4204-8615-920c969a9f2e"} |
2676
- | Boolean | boolean | true |
2677
- | Byte | number | 31 |
2678
- | CipherText | string | "CIPHER::ri.bellaso.main.cipher-channel.e414ab9e-b606-499a-a0e1-844fa296ba7e::unzjs3VifsTxuIpf1fH1CJ7OaPBr2bzMMdozPaZJtCii8vVG60yXIEmzoOJaEl9mfFFe::CIPHER" |
2807
+ | Type | JSON encoding | Example |
2808
+ |---------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
2809
+ | Array | array | ["alpha", "bravo", "charlie"] |
2810
+ | Attachment | JSON encoded AttachmentProperty object | {"rid":"ri.blobster.main.attachment.2f944bae-5851-4204-8615-920c969a9f2e"} |
2811
+ | Boolean | boolean | true |
2812
+ | Byte | number | 31 |
2813
+ | CipherText | string | "CIPHER::ri.bellaso.main.cipher-channel.e414ab9e-b606-499a-a0e1-844fa296ba7e::unzjs3VifsTxuIpf1fH1CJ7OaPBr2bzMMdozPaZJtCii8vVG60yXIEmzoOJaEl9mfFFe::CIPHER" |
2679
2814
 
2680
- | Date | ISO 8601 extended local date string | "2021-05-01" |
2681
- | Decimal | string | "2.718281828" |
2682
- | Double | number | 3.14159265 |
2683
- | Float | number | 3.14159265 |
2684
- | GeoPoint | geojson | {"type":"Point","coordinates":[102.0,0.5]} |
2685
- | GeoShape | geojson | {"type":"LineString","coordinates":[[102.0,0.0],[103.0,1.0],[104.0,0.0],[105.0,1.0]]} |
2686
- | Integer | number | 238940 |
2687
- | Long | string | "58319870951433" |
2688
- | MediaReference | JSON encoded MediaReference object | {"mimeType":"application/pdf","reference":{"type":"mediaSetViewItem","mediaSetViewItem":{"mediaSetRid":"ri.mio.main.media-set.4153d42f-ca4b-4e42-8ca5-8e6aa7edb642","mediaSetViewRid":"ri.mio.main.view.82a798ad-d637-4595-acc6-987bcf16629b","mediaItemRid":"ri.mio.main.media-item.001ec98b-1620-4814-9e17-8e9c4e536225"}}} |
2689
- | Short | number | 8739 |
2690
- | String | string | "Call me Ishmael" |
2691
- | Struct | JSON object of struct field API name -> value | {"firstName": "Alex", "lastName": "Karp"} |
2692
- | Timestamp | ISO 8601 extended offset date-time string in UTC zone | "2021-01-04T05:00:00Z" |
2693
- | Timeseries | JSON encoded TimeseriesProperty object or seriesId string | {"seriesId": "wellPressureSeriesId", "syncRid": ri.time-series-catalog.main.sync.04f5ac1f-91bf-44f9-a51f-4f34e06e42df"} or {"templateRid": "ri.codex-emu.main.template.367cac64-e53b-4653-b111-f61856a63df9", "templateVersion": "0.0.0"} or "wellPressureSeriesId"| |
2815
+ | Date | ISO 8601 extended local date string | "2021-05-01" |
2816
+ | Decimal | string | "2.718281828" |
2817
+ | Double | number | 3.14159265 |
2818
+ | Float | number | 3.14159265 |
2819
+ | GeoPoint | geojson | {"type":"Point","coordinates":[102.0,0.5]} |
2820
+ | GeoShape | geojson | {"type":"LineString","coordinates":[[102.0,0.0],[103.0,1.0],[104.0,0.0],[105.0,1.0]]} |
2821
+ | Integer | number | 238940 |
2822
+ | Long | string | "58319870951433" |
2823
+ | MediaReference| JSON encoded MediaReference object | {"mimeType":"application/pdf","reference":{"type":"mediaSetViewItem","mediaSetViewItem":{"mediaSetRid":"ri.mio.main.media-set.4153d42f-ca4b-4e42-8ca5-8e6aa7edb642","mediaSetViewRid":"ri.mio.main.view.82a798ad-d637-4595-acc6-987bcf16629b","mediaItemRid":"ri.mio.main.media-item.001ec98b-1620-4814-9e17-8e9c4e536225"}}} |
2824
+ | Short | number | 8739 |
2825
+ | String | string | "Call me Ishmael" |
2826
+ | Struct | JSON object of struct field API name -> value | {"firstName": "Alex", "lastName": "Karp"} |
2827
+ | Timestamp | ISO 8601 extended offset date-time string in UTC zone | "2021-01-04T05:00:00Z" |
2828
+ | Timeseries | JSON encoded TimeseriesProperty object or seriesId string | {"seriesId": "wellPressureSeriesId", "syncRid": ri.time-series-catalog.main.sync.04f5ac1f-91bf-44f9-a51f-4f34e06e42df"} or {"templateRid": "ri.codex-emu.main.template.367cac64-e53b-4653-b111-f61856a63df9", "templateVersion": "0.0.0"} or "wellPressureSeriesId"| |
2829
+ | Vector | array | [0.1, 0.3, 0.02, 0.05 , 0.8, 0.4] |
2694
2830
  Note that for backwards compatibility, the Boolean, Byte, Double, Float, Integer, and Short types can also be encoded as JSON strings.
2695
2831
  *
2696
2832
  * Log Safety: UNSAFE
@@ -3025,6 +3161,14 @@ export type RequestId = string;
3025
3161
  * Log Safety: SAFE
3026
3162
  */
3027
3163
  export type ReturnEditsMode = "ALL" | "ALL_V2_WITH_DELETIONS" | "NONE";
3164
+ /**
3165
+ * Number of points in each window.
3166
+ *
3167
+ * Log Safety: SAFE
3168
+ */
3169
+ export interface RollingAggregateWindowPoints {
3170
+ count: number;
3171
+ }
3028
3172
  /**
3029
3173
  * Log Safety: UNSAFE
3030
3174
  */
@@ -3198,8 +3342,13 @@ export interface SearchOrderingV2 {
3198
3342
  direction?: string;
3199
3343
  }
3200
3344
  /**
3201
- * By default, anytime an object is requested, every property belonging to that object is returned.
3202
- The response can be filtered to only include certain properties using the properties query parameter.
3345
+ * By default, whenever an object is requested, all of its properties are returned, except for properties of the
3346
+ following types:
3347
+
3348
+ Vector
3349
+
3350
+ The response can be filtered to only include certain properties using the properties query parameter. Note
3351
+ that ontology object set endpoints refer to this parameter as select.
3203
3352
  Properties to include can be specified in one of two ways.
3204
3353
 
3205
3354
  A comma delimited list as the value for the properties query parameter
@@ -3273,21 +3422,21 @@ export interface SelectedPropertyCollectSetAggregation {
3273
3422
  export interface SelectedPropertyCountAggregation {
3274
3423
  }
3275
3424
  /**
3276
- * Definition for a selected property over a MethodObjectSet.
3425
+ * Computes an exact number of distinct values for the provided field. May be slower than an approximate distinct aggregation.
3277
3426
  *
3278
3427
  * Log Safety: UNSAFE
3279
3428
  */
3280
- export interface SelectedPropertyDefinition {
3281
- objectSet: MethodObjectSet;
3282
- operation: SelectedPropertyOperation;
3429
+ export interface SelectedPropertyExactDistinctAggregation {
3430
+ selectedPropertyApiName: PropertyApiName;
3283
3431
  }
3284
3432
  /**
3285
- * Computes an exact number of distinct values for the provided field. May be slower than an approximate distinct aggregation.
3433
+ * Definition for a selected property over a MethodObjectSet.
3286
3434
  *
3287
3435
  * Log Safety: UNSAFE
3288
3436
  */
3289
- export interface SelectedPropertyExactDistinctAggregation {
3290
- selectedPropertyApiName: PropertyApiName;
3437
+ export interface SelectedPropertyExpression {
3438
+ objectSet: MethodObjectSet;
3439
+ operation: SelectedPropertyOperation;
3291
3440
  }
3292
3441
  /**
3293
3442
  * Computes the maximum value for the provided field.
@@ -3407,6 +3556,7 @@ export type StreamMessage = ({
3407
3556
  */
3408
3557
  export interface StreamTimeSeriesPointsRequest {
3409
3558
  range?: TimeRange;
3559
+ aggregate?: AggregateTimeSeries;
3410
3560
  }
3411
3561
  /**
3412
3562
  * Log Safety: UNSAFE
@@ -3454,9 +3604,10 @@ export interface StringRegexMatchConstraint {
3454
3604
  */
3455
3605
  export type StructFieldApiName = LooselyBrandedString<"StructFieldApiName">;
3456
3606
  /**
3457
- * A combination of a struct property api name and a struct field api name. This is used to select struct fields
3458
- to query on. Note that you can still select struct properties with only a 'PropertyApiNameSelector'; the queries
3459
- will then become 'OR' queries across the fields of the struct property.
3607
+ * A combination of a property API name and a struct field API name used to select struct fields. Note that you can
3608
+ still select struct properties with only a 'PropertyApiNameSelector'; the queries will then become 'OR' queries
3609
+ across the fields of the struct property, and derived property expressions will operate on the whole struct
3610
+ where applicable.
3460
3611
  *
3461
3612
  * Log Safety: UNSAFE
3462
3613
  */
@@ -3523,6 +3674,15 @@ export type SubscriptionId = string;
3523
3674
  export interface SubscriptionSuccess {
3524
3675
  id: SubscriptionId;
3525
3676
  }
3677
+ /**
3678
+ * Subtracts the right numeric value from the left numeric value.
3679
+ *
3680
+ * Log Safety: UNSAFE
3681
+ */
3682
+ export interface SubtractPropertyExpression {
3683
+ left: DerivedPropertyDefinition;
3684
+ right: DerivedPropertyDefinition;
3685
+ }
3526
3686
  /**
3527
3687
  * Computes the sum of values for the provided field.
3528
3688
  *
@@ -3566,6 +3726,35 @@ export type TimeRange = ({
3566
3726
  } & AbsoluteTimeRange) | ({
3567
3727
  type: "relative";
3568
3728
  } & RelativeTimeRange);
3729
+ /**
3730
+ * The aggregation function to use for aggregating time series data.
3731
+ *
3732
+ * Log Safety: SAFE
3733
+ */
3734
+ export type TimeSeriesAggregationMethod = "SUM" | "MEAN" | "STANDARD_DEVIATION" | "MAX" | "MIN" | "PERCENT_CHANGE" | "DIFFERENCE" | "PRODUCT" | "COUNT" | "FIRST" | "LAST";
3735
+ /**
3736
+ * CUMULATIVE aggregates all points up to the current point.
3737
+ ROLLING aggregates all points in a rolling window whose size is either the specified number of points or
3738
+ time duration.
3739
+ PERIODIC aggregates all points in specified time windows.
3740
+ *
3741
+ * Log Safety: UNSAFE
3742
+ */
3743
+ export type TimeSeriesAggregationStrategy = ({
3744
+ type: "rolling";
3745
+ } & TimeSeriesRollingAggregate) | ({
3746
+ type: "periodic";
3747
+ } & TimeSeriesPeriodicAggregate) | ({
3748
+ type: "cumulative";
3749
+ } & TimeSeriesCumulativeAggregate);
3750
+ /**
3751
+ * The cumulative aggregate is calculated progressively for each point in the input time series,
3752
+ considering all preceding points up to and including the current point.
3753
+ *
3754
+ * Log Safety: SAFE
3755
+ */
3756
+ export interface TimeSeriesCumulativeAggregate {
3757
+ }
3569
3758
  /**
3570
3759
  * A time and value pair.
3571
3760
  *
@@ -3575,6 +3764,22 @@ export interface TimeseriesEntry {
3575
3764
  time: string;
3576
3765
  value: any;
3577
3766
  }
3767
+ /**
3768
+ * Aggregates values over discrete, periodic windows for a given time series.
3769
+ A periodic window divides the time series into windows of fixed durations.
3770
+ For each window, an aggregate function is applied to the points within that window. The result is a time series
3771
+ with values representing the aggregate for each window. Windows with no data points are not included
3772
+ in the output.
3773
+ Periodic aggregation is useful for downsampling a continuous stream of data to larger granularities such as
3774
+ hourly, daily, monthly.
3775
+ *
3776
+ * Log Safety: SAFE
3777
+ */
3778
+ export interface TimeSeriesPeriodicAggregate {
3779
+ windowSize: PreciseDuration;
3780
+ alignmentTimestamp?: string;
3781
+ windowType: TimeSeriesWindowType;
3782
+ }
3578
3783
  /**
3579
3784
  * A time and value pair.
3580
3785
  *
@@ -3588,6 +3793,26 @@ export interface TimeSeriesPoint {
3588
3793
  * Log Safety: UNSAFE
3589
3794
  */
3590
3795
  export type TimeSeriesPropertyV2 = LooselyBrandedString<"TimeSeriesPropertyV2">;
3796
+ /**
3797
+ * Log Safety: UNSAFE
3798
+ */
3799
+ export interface TimeSeriesRollingAggregate {
3800
+ windowSize: TimeSeriesRollingAggregateWindow;
3801
+ }
3802
+ /**
3803
+ * A rolling window is a moving subset of data points that ends at the current timestamp (inclusive)
3804
+ and spans a specified duration (window size). As new data points are added, old points fall out of the
3805
+ window if they are outside the specified duration.
3806
+ Rolling windows are commonly used for smoothing data, detecting trends, and reducing noise
3807
+ in time series analysis.
3808
+ *
3809
+ * Log Safety: UNSAFE
3810
+ */
3811
+ export type TimeSeriesRollingAggregateWindow = ({
3812
+ type: "duration";
3813
+ } & PreciseDuration) | ({
3814
+ type: "pointsCount";
3815
+ } & RollingAggregateWindowPoints);
3591
3816
  /**
3592
3817
  * The RID identifying a time series sync.
3593
3818
  *
@@ -3610,6 +3835,10 @@ export type TimeseriesTemplateVersion = LooselyBrandedString<"TimeseriesTemplate
3610
3835
  * Log Safety: UNSAFE
3611
3836
  */
3612
3837
  export type TimeSeriesValueBankProperty = LooselyBrandedString<"TimeSeriesValueBankProperty">;
3838
+ /**
3839
+ * Log Safety: SAFE
3840
+ */
3841
+ export type TimeSeriesWindowType = "START" | "END";
3613
3842
  /**
3614
3843
  * Log Safety: SAFE
3615
3844
  */