@osdk/foundry.ontologies 2.41.0 → 2.43.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.43.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 843a406: Bump apis
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [843a406]
12
+ - @osdk/foundry.core@2.43.0
13
+ - @osdk/foundry.geo@2.43.0
14
+
15
+ ## 2.42.0
16
+
17
+ ### Minor Changes
18
+
19
+ - a6bf99a: Regenerate Platform SDKs based on Rosetta bundle 1.1387.0
20
+
21
+ ### Patch Changes
22
+
23
+ - Updated dependencies [a6bf99a]
24
+ - @osdk/foundry.core@2.42.0
25
+ - @osdk/foundry.geo@2.42.0
26
+
3
27
  ## 2.41.0
4
28
 
5
29
  ### Minor Changes
@@ -596,6 +596,20 @@ export interface ApplyActionRequestV2 {
596
596
  */
597
597
  export interface ApplyActionResponse {
598
598
  }
599
+ /**
600
+ * Performs both apply reducers and extract main value to return the reduced main value.
601
+ *
602
+ * Log Safety: SAFE
603
+ */
604
+ export interface ApplyReducersAndExtractMainValueLoadLevel {
605
+ }
606
+ /**
607
+ * Returns a single value of an array as configured in the ontology.
608
+ *
609
+ * Log Safety: SAFE
610
+ */
611
+ export interface ApplyReducersLoadLevel {
612
+ }
599
613
  /**
600
614
  * Computes an approximate number of distinct values for the provided field.
601
615
  *
@@ -1465,6 +1479,13 @@ export interface ExperimentalPropertyTypeStatus {
1465
1479
  * Log Safety: SAFE
1466
1480
  */
1467
1481
  export type ExtractDatePart = "DAYS" | "MONTHS" | "QUARTERS" | "YEARS";
1482
+ /**
1483
+ * Returns the main value of a struct as configured in the ontology.
1484
+ *
1485
+ * Log Safety: SAFE
1486
+ */
1487
+ export interface ExtractMainValueLoadLevel {
1488
+ }
1468
1489
  /**
1469
1490
  * Extracts the specified date part from a date or timestamp.
1470
1491
  *
@@ -1733,11 +1754,28 @@ the Ontology Manager.
1733
1754
  */
1734
1755
  export type InterfacePropertyApiName = LooselyBrandedString<"InterfacePropertyApiName">;
1735
1756
  /**
1757
+ * An implementation of an interface property via a local property.
1758
+ *
1736
1759
  * Log Safety: UNSAFE
1737
1760
  */
1738
1761
  export interface InterfacePropertyLocalPropertyImplementation {
1739
1762
  propertyApiName: PropertyApiName;
1740
1763
  }
1764
+ /**
1765
+ * An implementation of an interface property via the field of a local struct property.
1766
+ *
1767
+ * Log Safety: UNSAFE
1768
+ */
1769
+ export interface InterfacePropertyStructFieldImplementation {
1770
+ structFieldOfProperty: StructFieldOfPropertyImplementation;
1771
+ }
1772
+ /**
1773
+ * An implementation of a struct interface property via a local struct property. Specifies a mapping of interface
1774
+ struct fields to local struct fields or properties.
1775
+ *
1776
+ * Log Safety: UNSAFE
1777
+ */
1778
+ export type InterfacePropertyStructImplementation = Record<StructFieldApiName, PropertyOrStructFieldOfPropertyImplementation>;
1741
1779
  /**
1742
1780
  * The definition of an interface property type on an interface. An interface property can either be backed by a
1743
1781
  shared property type or defined on the interface directly.
@@ -1750,14 +1788,17 @@ export type InterfacePropertyType = ({
1750
1788
  type: "interfaceSharedPropertyType";
1751
1789
  } & InterfaceSharedPropertyType);
1752
1790
  /**
1753
- * Describes how an object type implements an interface property type. For now this is only possible via a single
1754
- local property but this may be extended in the future.
1755
- *
1756
- * Log Safety: UNSAFE
1757
- */
1758
- export type InterfacePropertyTypeImplementation = {
1791
+ * Describes how an object type implements an interface property.
1792
+ *
1793
+ * Log Safety: UNSAFE
1794
+ */
1795
+ export type InterfacePropertyTypeImplementation = ({
1796
+ type: "structFieldImplementation";
1797
+ } & InterfacePropertyStructFieldImplementation) | ({
1798
+ type: "structImplementation";
1799
+ } & InterfacePropertyStructImplementation) | ({
1759
1800
  type: "localPropertyImplementation";
1760
- } & InterfacePropertyLocalPropertyImplementation;
1801
+ } & InterfacePropertyLocalPropertyImplementation);
1761
1802
  /**
1762
1803
  * The unique resource identifier of an interface property type, useful for interacting with other Foundry APIs.
1763
1804
  *
@@ -1926,6 +1967,17 @@ export interface LengthConstraint {
1926
1967
  export interface LinkedInterfaceTypeApiName {
1927
1968
  apiName: InterfaceTypeApiName;
1928
1969
  }
1970
+ /**
1971
+ * Does not contain information about the source object. Should be used in a nested type that provides information about source objects.
1972
+ The targetObject Ontology Object in this response will only ever have the __primaryKey and __apiName
1973
+ fields present, thus functioning as object locators rather than full objects.
1974
+ *
1975
+ * Log Safety: UNSAFE
1976
+ */
1977
+ export interface LinkedObjectLocator {
1978
+ targetObject?: OntologyObjectV2;
1979
+ linkType?: LinkTypeApiName;
1980
+ }
1929
1981
  /**
1930
1982
  * A reference to the linked object type.
1931
1983
  *
@@ -1938,6 +1990,16 @@ export interface LinkedObjectTypeApiName {
1938
1990
  * Log Safety: UNSAFE
1939
1991
  */
1940
1992
  export type LinkedObjectV2 = LooselyBrandedString<"LinkedObjectV2">;
1993
+ /**
1994
+ * The Ontology Objects in this response will only ever have the __primaryKey and __apiName
1995
+ fields present, thus functioning as object locators rather than full objects.
1996
+ *
1997
+ * Log Safety: UNSAFE
1998
+ */
1999
+ export interface LinksFromObject {
2000
+ sourceObject?: OntologyObjectV2;
2001
+ linkedObjects: Array<LinkedObjectLocator>;
2002
+ }
1941
2003
  /**
1942
2004
  * Log Safety: UNSAFE
1943
2005
  */
@@ -2139,6 +2201,23 @@ export interface ListQueryTypesResponseV2 {
2139
2201
  nextPageToken?: _Core.PageToken;
2140
2202
  data: Array<QueryTypeV2>;
2141
2203
  }
2204
+ /**
2205
+ * Log Safety: UNSAFE
2206
+ */
2207
+ export interface LoadObjectSetLinksRequestV2 {
2208
+ objectSet: ObjectSet;
2209
+ links: Array<LinkTypeApiName>;
2210
+ pageToken?: _Core.PageToken;
2211
+ includeComputeUsage?: _Core.IncludeComputeUsage;
2212
+ }
2213
+ /**
2214
+ * Log Safety: UNSAFE
2215
+ */
2216
+ export interface LoadObjectSetLinksResponseV2 {
2217
+ data: Array<LinksFromObject>;
2218
+ nextPageToken?: _Core.PageToken;
2219
+ computeUsage?: _Core.ComputeSeconds;
2220
+ }
2142
2221
  /**
2143
2222
  * Represents the API POST body when loading an ObjectSet.
2144
2223
  *
@@ -2148,6 +2227,7 @@ export interface LoadObjectSetRequestV2 {
2148
2227
  objectSet: ObjectSet;
2149
2228
  orderBy?: SearchOrderByV2;
2150
2229
  select: Array<SelectedPropertyApiName>;
2230
+ selectV2: Array<PropertyIdentifier>;
2151
2231
  pageToken?: _Core.PageToken;
2152
2232
  pageSize?: _Core.PageSize;
2153
2233
  excludeRid?: boolean;
@@ -2174,6 +2254,7 @@ export interface LoadObjectSetV2MultipleObjectTypesRequest {
2174
2254
  objectSet: ObjectSet;
2175
2255
  orderBy?: SearchOrderByV2;
2176
2256
  select: Array<SelectedPropertyApiName>;
2257
+ selectV2: Array<PropertyIdentifier>;
2177
2258
  pageToken?: _Core.PageToken;
2178
2259
  pageSize?: _Core.PageSize;
2179
2260
  excludeRid?: boolean;
@@ -2189,7 +2270,7 @@ single object set- some objects may have all their properties and some may only
2189
2270
  The interfaceToObjectTypeMappings field contains mappings from SharedPropertyTypeApiNames on the interface(s) to
2190
2271
  PropertyApiName for properties on the object(s).
2191
2272
  The interfaceToObjectTypeMappingsV2 field contains mappings from InterfacePropertyApiNames on the
2192
- interface(s) to InterfacePropertyImplementation for properties on the object(s). This therefore includes
2273
+ interface(s) to InterfacePropertyTypeImplementation for properties on the object(s). This therefore includes
2193
2274
  implementations of both properties backed by SharedPropertyTypes as well as properties defined on the interface.
2194
2275
  *
2195
2276
  * Log Safety: UNSAFE
@@ -2211,6 +2292,7 @@ export interface LoadObjectSetV2ObjectsOrInterfacesRequest {
2211
2292
  objectSet: ObjectSet;
2212
2293
  orderBy?: SearchOrderByV2;
2213
2294
  select: Array<SelectedPropertyApiName>;
2295
+ selectV2: Array<PropertyIdentifier>;
2214
2296
  pageToken?: _Core.PageToken;
2215
2297
  pageSize?: _Core.PageSize;
2216
2298
  excludeRid?: boolean;
@@ -3225,7 +3307,19 @@ export interface OntologyObject {
3225
3307
  */
3226
3308
  export interface OntologyObjectArrayType {
3227
3309
  subType: ObjectPropertyType;
3310
+ reducers: Array<OntologyObjectArrayTypeReducer>;
3228
3311
  }
3312
+ /**
3313
+ * Log Safety: UNSAFE
3314
+ */
3315
+ export interface OntologyObjectArrayTypeReducer {
3316
+ direction: OntologyObjectArrayTypeReducerSortDirection;
3317
+ field?: StructFieldApiName;
3318
+ }
3319
+ /**
3320
+ * Log Safety: SAFE
3321
+ */
3322
+ export type OntologyObjectArrayTypeReducerSortDirection = "ASCENDING_NULLS_LAST" | "DESCENDING_NULLS_LAST";
3229
3323
  /**
3230
3324
  * Log Safety: UNSAFE
3231
3325
  */
@@ -3586,7 +3680,15 @@ export type PropertyIdentifier = ({
3586
3680
  type: "property";
3587
3681
  } & PropertyApiNameSelector) | ({
3588
3682
  type: "structField";
3589
- } & StructFieldSelector);
3683
+ } & StructFieldSelector) | ({
3684
+ type: "propertyWithLoadLevel";
3685
+ } & PropertyWithLoadLevelSelector);
3686
+ /**
3687
+ * Log Safety: UNSAFE
3688
+ */
3689
+ export interface PropertyImplementation {
3690
+ propertyApiName: PropertyApiName;
3691
+ }
3590
3692
  /**
3591
3693
  * Formatting configuration for known Foundry types.
3592
3694
  *
@@ -3595,6 +3697,22 @@ export type PropertyIdentifier = ({
3595
3697
  export interface PropertyKnownTypeFormattingRule {
3596
3698
  knownType: KnownType;
3597
3699
  }
3700
+ /**
3701
+ * The load level of the property:
3702
+
3703
+ APPLY_REDUCERS: Returns a single value of an array as configured in the ontology.
3704
+ EXTRACT_MAIN_VALUE: Returns the main value of a struct as configured in the ontology.
3705
+ APPLY_REDUCERS_AND_EXTRACT_MAIN_VALUE: Performs both to return the reduced main value.
3706
+ *
3707
+ * Log Safety: UNSAFE
3708
+ */
3709
+ export type PropertyLoadLevel = ({
3710
+ type: "applyReducersAndExtractMainValue";
3711
+ } & ApplyReducersAndExtractMainValueLoadLevel) | ({
3712
+ type: "applyReducers";
3713
+ } & ApplyReducersLoadLevel) | ({
3714
+ type: "extractMainValue";
3715
+ } & ExtractMainValueLoadLevel);
3598
3716
  /**
3599
3717
  * Wrapper for numeric formatting options.
3600
3718
  *
@@ -3625,6 +3743,14 @@ export type PropertyNumberFormattingRuleType = ({
3625
3743
  } & NumberFormatCustomUnit) | ({
3626
3744
  type: "ratio";
3627
3745
  } & NumberFormatRatio);
3746
+ /**
3747
+ * Log Safety: UNSAFE
3748
+ */
3749
+ export type PropertyOrStructFieldOfPropertyImplementation = ({
3750
+ type: "structFieldOfProperty";
3751
+ } & StructFieldOfPropertyImplementation) | ({
3752
+ type: "property";
3753
+ } & PropertyImplementation);
3628
3754
  /**
3629
3755
  * Formatting configuration for timestamp property values.
3630
3756
  *
@@ -3749,6 +3875,17 @@ export type PropertyValueFormattingRule = ({
3749
3875
  } & PropertyKnownTypeFormattingRule) | ({
3750
3876
  type: "timestamp";
3751
3877
  } & PropertyTimestampFormattingRule);
3878
+ /**
3879
+ * A combination of a property identifier and the load level to apply to the property. You can select a reduced
3880
+ value for arrays and the main value for structs. If the provided load level cannot be applied to the property
3881
+ type, then it will be ignored. This selector is experimental and may not work in filters or sorts.
3882
+ *
3883
+ * Log Safety: UNSAFE
3884
+ */
3885
+ export interface PropertyWithLoadLevelSelector {
3886
+ propertyIdentifier: PropertyIdentifier;
3887
+ loadLevel: PropertyLoadLevel;
3888
+ }
3752
3889
  /**
3753
3890
  * An error indicating that the subscribe request should be attempted on a different node.
3754
3891
  *
@@ -4065,6 +4202,36 @@ export interface RegexQuery {
4065
4202
  propertyIdentifier?: PropertyIdentifier;
4066
4203
  value: string;
4067
4204
  }
4205
+ /**
4206
+ * Specifies a bound for a relative date range query.
4207
+ *
4208
+ * Log Safety: UNSAFE
4209
+ */
4210
+ export type RelativeDateRangeBound = {
4211
+ type: "relativePoint";
4212
+ } & RelativePointInTime;
4213
+ /**
4214
+ * Returns objects where the specified date or timestamp property falls within a relative date range.
4215
+ The bounds are calculated relative to query execution time and rounded to midnight in the specified timezone.
4216
+ *
4217
+ * Log Safety: UNSAFE
4218
+ */
4219
+ export interface RelativeDateRangeQuery {
4220
+ field?: PropertyApiName;
4221
+ propertyIdentifier?: PropertyIdentifier;
4222
+ relativeStartTime?: RelativeDateRangeBound;
4223
+ relativeEndTime?: RelativeDateRangeBound;
4224
+ timeZoneId: string;
4225
+ }
4226
+ /**
4227
+ * A point in time specified relative to query execution time.
4228
+ *
4229
+ * Log Safety: UNSAFE
4230
+ */
4231
+ export interface RelativePointInTime {
4232
+ value: number;
4233
+ timeUnit: RelativeTimeUnit;
4234
+ }
4068
4235
  /**
4069
4236
  * A relative time, such as "3 days before" or "2 hours after" the current moment.
4070
4237
  *
@@ -4092,6 +4259,12 @@ export type RelativeTimeRelation = "BEFORE" | "AFTER";
4092
4259
  * Log Safety: SAFE
4093
4260
  */
4094
4261
  export type RelativeTimeSeriesTimeUnit = "MILLISECONDS" | "SECONDS" | "MINUTES" | "HOURS" | "DAYS" | "WEEKS" | "MONTHS" | "YEARS";
4262
+ /**
4263
+ * Units for relative time calculations.
4264
+ *
4265
+ * Log Safety: SAFE
4266
+ */
4267
+ export type RelativeTimeUnit = "DAY" | "WEEK" | "MONTH" | "YEAR";
4095
4268
  /**
4096
4269
  * Unique request id
4097
4270
  *
@@ -4111,6 +4284,7 @@ export interface ResolvedInterfacePropertyType {
4111
4284
  description?: string;
4112
4285
  dataType: ObjectPropertyType;
4113
4286
  valueTypeApiName?: ValueTypeApiName;
4287
+ valueFormatting?: PropertyValueFormattingRule;
4114
4288
  requireImplementation: boolean;
4115
4289
  }
4116
4290
  /**
@@ -4184,6 +4358,8 @@ export type SearchJsonQueryV2 = ({
4184
4358
  } & LtQueryV2) | ({
4185
4359
  type: "doesNotIntersectBoundingBox";
4186
4360
  } & DoesNotIntersectBoundingBoxQuery) | ({
4361
+ type: "relativeDateRange";
4362
+ } & RelativeDateRangeQuery) | ({
4187
4363
  type: "wildcard";
4188
4364
  } & WildcardQuery) | ({
4189
4365
  type: "withinDistanceOf";
@@ -4238,7 +4414,9 @@ export interface SearchObjectsForInterfaceRequest {
4238
4414
  orderBy?: SearchOrderByV2;
4239
4415
  augmentedProperties: Record<ObjectTypeApiName, Array<PropertyApiName>>;
4240
4416
  augmentedSharedPropertyTypes: Record<InterfaceTypeApiName, Array<SharedPropertyTypeApiName>>;
4417
+ augmentedInterfacePropertyTypes: Record<InterfaceTypeApiName, Array<InterfacePropertyApiName>>;
4241
4418
  selectedSharedPropertyTypes: Array<SharedPropertyTypeApiName>;
4419
+ selectedInterfacePropertyTypes: Array<InterfacePropertyApiName>;
4242
4420
  selectedObjectTypes: Array<ObjectTypeApiName>;
4243
4421
  otherInterfaceTypes: Array<InterfaceTypeApiName>;
4244
4422
  pageSize?: _Core.PageSize;
@@ -4263,6 +4441,7 @@ export interface SearchObjectsRequestV2 {
4263
4441
  pageSize?: _Core.PageSize;
4264
4442
  pageToken?: _Core.PageToken;
4265
4443
  select: Array<PropertyApiName>;
4444
+ selectV2: Array<PropertyIdentifier>;
4266
4445
  excludeRid?: boolean;
4267
4446
  snapshot?: boolean;
4268
4447
  }
@@ -4658,10 +4837,16 @@ export interface StructFieldEvaluationResult {
4658
4837
  required: boolean;
4659
4838
  }
4660
4839
  /**
4661
- * A combination of a property API name and a struct field API name used to select struct fields. Note that you can
4662
- still select struct properties with only a 'PropertyApiNameSelector'; the queries will then become 'OR' queries
4663
- across the fields of the struct property, and derived property expressions will operate on the whole struct
4664
- where applicable.
4840
+ * Log Safety: UNSAFE
4841
+ */
4842
+ export interface StructFieldOfPropertyImplementation {
4843
+ propertyApiName: PropertyApiName;
4844
+ structFieldApiName: StructFieldApiName;
4845
+ }
4846
+ /**
4847
+ * A combination of a property identifier and the load level to apply to the property. You can select a reduced
4848
+ value for arrays and the main value for structs. If the provided load level cannot be applied to the property
4849
+ type, then it will be ignored. This selector is experimental and may not work in filters or sorts.
4665
4850
  *
4666
4851
  * Log Safety: UNSAFE
4667
4852
  */
@@ -4712,6 +4897,14 @@ export interface StructParameterFieldArgument {
4712
4897
  */
4713
4898
  export interface StructType {
4714
4899
  structFieldTypes: Array<StructFieldType>;
4900
+ mainValue?: StructTypeMainValue;
4901
+ }
4902
+ /**
4903
+ * Log Safety: UNSAFE
4904
+ */
4905
+ export interface StructTypeMainValue {
4906
+ mainValueType: ObjectPropertyType;
4907
+ fields: Array<StructFieldApiName>;
4715
4908
  }
4716
4909
  /**
4717
4910
  * Contains the status of the submission criteria.