@osdk/internal.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/internal.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/internal.foundry.core@2.43.0
13
+ - @osdk/internal.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/internal.foundry.core@2.42.0
25
+ - @osdk/internal.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;
@@ -3219,7 +3301,19 @@ export interface OntologyObject {
3219
3301
  */
3220
3302
  export interface OntologyObjectArrayType {
3221
3303
  subType: ObjectPropertyType;
3304
+ reducers: Array<OntologyObjectArrayTypeReducer>;
3222
3305
  }
3306
+ /**
3307
+ * Log Safety: UNSAFE
3308
+ */
3309
+ export interface OntologyObjectArrayTypeReducer {
3310
+ direction: OntologyObjectArrayTypeReducerSortDirection;
3311
+ field?: StructFieldApiName;
3312
+ }
3313
+ /**
3314
+ * Log Safety: SAFE
3315
+ */
3316
+ export type OntologyObjectArrayTypeReducerSortDirection = "ASCENDING_NULLS_LAST" | "DESCENDING_NULLS_LAST";
3223
3317
  /**
3224
3318
  * Log Safety: UNSAFE
3225
3319
  */
@@ -3580,7 +3674,15 @@ export type PropertyIdentifier = ({
3580
3674
  type: "property";
3581
3675
  } & PropertyApiNameSelector) | ({
3582
3676
  type: "structField";
3583
- } & StructFieldSelector);
3677
+ } & StructFieldSelector) | ({
3678
+ type: "propertyWithLoadLevel";
3679
+ } & PropertyWithLoadLevelSelector);
3680
+ /**
3681
+ * Log Safety: UNSAFE
3682
+ */
3683
+ export interface PropertyImplementation {
3684
+ propertyApiName: PropertyApiName;
3685
+ }
3584
3686
  /**
3585
3687
  * Formatting configuration for known Foundry types.
3586
3688
  *
@@ -3589,6 +3691,22 @@ export type PropertyIdentifier = ({
3589
3691
  export interface PropertyKnownTypeFormattingRule {
3590
3692
  knownType: KnownType;
3591
3693
  }
3694
+ /**
3695
+ * The load level of the property:
3696
+
3697
+ APPLY_REDUCERS: Returns a single value of an array as configured in the ontology.
3698
+ EXTRACT_MAIN_VALUE: Returns the main value of a struct as configured in the ontology.
3699
+ APPLY_REDUCERS_AND_EXTRACT_MAIN_VALUE: Performs both to return the reduced main value.
3700
+ *
3701
+ * Log Safety: UNSAFE
3702
+ */
3703
+ export type PropertyLoadLevel = ({
3704
+ type: "applyReducersAndExtractMainValue";
3705
+ } & ApplyReducersAndExtractMainValueLoadLevel) | ({
3706
+ type: "applyReducers";
3707
+ } & ApplyReducersLoadLevel) | ({
3708
+ type: "extractMainValue";
3709
+ } & ExtractMainValueLoadLevel);
3592
3710
  /**
3593
3711
  * Wrapper for numeric formatting options.
3594
3712
  *
@@ -3619,6 +3737,14 @@ export type PropertyNumberFormattingRuleType = ({
3619
3737
  } & NumberFormatCustomUnit) | ({
3620
3738
  type: "ratio";
3621
3739
  } & NumberFormatRatio);
3740
+ /**
3741
+ * Log Safety: UNSAFE
3742
+ */
3743
+ export type PropertyOrStructFieldOfPropertyImplementation = ({
3744
+ type: "structFieldOfProperty";
3745
+ } & StructFieldOfPropertyImplementation) | ({
3746
+ type: "property";
3747
+ } & PropertyImplementation);
3622
3748
  /**
3623
3749
  * Formatting configuration for timestamp property values.
3624
3750
  *
@@ -3743,6 +3869,17 @@ export type PropertyValueFormattingRule = ({
3743
3869
  } & PropertyKnownTypeFormattingRule) | ({
3744
3870
  type: "timestamp";
3745
3871
  } & PropertyTimestampFormattingRule);
3872
+ /**
3873
+ * A combination of a property API name and the load level to apply to the property. You can select a reduced value
3874
+ for arrays and the main value for structs. If the provided load level cannot be applied to the property type,
3875
+ then it will be ignored. This selector is experimental and may not work in filters or sorts.
3876
+ *
3877
+ * Log Safety: UNSAFE
3878
+ */
3879
+ export interface PropertyWithLoadLevelSelector {
3880
+ propertyIdentifier: PropertyIdentifier;
3881
+ loadLevel: PropertyLoadLevel;
3882
+ }
3746
3883
  /**
3747
3884
  * An error indicating that the subscribe request should be attempted on a different node.
3748
3885
  *
@@ -4059,6 +4196,40 @@ export interface RegexQuery {
4059
4196
  propertyIdentifier?: PropertyIdentifier;
4060
4197
  value: string;
4061
4198
  }
4199
+ /**
4200
+ * Specifies a bound for a relative date range query.
4201
+ *
4202
+ * Log Safety: UNSAFE
4203
+ */
4204
+ export type RelativeDateRangeBound = {
4205
+ type: "relativePoint";
4206
+ } & RelativePointInTime;
4207
+ /**
4208
+ * Returns objects where the specified date or timestamp property falls within a relative date range.
4209
+ The bounds are calculated relative to query execution time and rounded to midnight in the specified timezone.
4210
+ Examples:
4211
+
4212
+ Last 7 days: relativeStartTime = {value: -7, timeUnit: DAY}, relativeEndTime = {value: 0, timeUnit: DAY}
4213
+ This month: relativeStartTime = {value: 0, timeUnit: MONTH}, relativeEndTime = {value: 1, timeUnit: MONTH}
4214
+ *
4215
+ * Log Safety: UNSAFE
4216
+ */
4217
+ export interface RelativeDateRangeQuery {
4218
+ field?: PropertyApiName;
4219
+ propertyIdentifier?: PropertyIdentifier;
4220
+ relativeStartTime?: RelativeDateRangeBound;
4221
+ relativeEndTime?: RelativeDateRangeBound;
4222
+ timeZoneId: string;
4223
+ }
4224
+ /**
4225
+ * A point in time specified relative to query execution time.
4226
+ *
4227
+ * Log Safety: UNSAFE
4228
+ */
4229
+ export interface RelativePointInTime {
4230
+ value: number;
4231
+ timeUnit: RelativeTimeUnit;
4232
+ }
4062
4233
  /**
4063
4234
  * A relative time, such as "3 days before" or "2 hours after" the current moment.
4064
4235
  *
@@ -4086,6 +4257,12 @@ export type RelativeTimeRelation = "BEFORE" | "AFTER";
4086
4257
  * Log Safety: SAFE
4087
4258
  */
4088
4259
  export type RelativeTimeSeriesTimeUnit = "MILLISECONDS" | "SECONDS" | "MINUTES" | "HOURS" | "DAYS" | "WEEKS" | "MONTHS" | "YEARS";
4260
+ /**
4261
+ * Units for relative time calculations.
4262
+ *
4263
+ * Log Safety: SAFE
4264
+ */
4265
+ export type RelativeTimeUnit = "DAY" | "WEEK" | "MONTH" | "YEAR";
4089
4266
  /**
4090
4267
  * Unique request id
4091
4268
  *
@@ -4105,6 +4282,7 @@ export interface ResolvedInterfacePropertyType {
4105
4282
  description?: string;
4106
4283
  dataType: ObjectPropertyType;
4107
4284
  valueTypeApiName?: ValueTypeApiName;
4285
+ valueFormatting?: PropertyValueFormattingRule;
4108
4286
  requireImplementation: boolean;
4109
4287
  }
4110
4288
  /**
@@ -4178,6 +4356,8 @@ export type SearchJsonQueryV2 = ({
4178
4356
  } & LtQueryV2) | ({
4179
4357
  type: "doesNotIntersectBoundingBox";
4180
4358
  } & DoesNotIntersectBoundingBoxQuery) | ({
4359
+ type: "relativeDateRange";
4360
+ } & RelativeDateRangeQuery) | ({
4181
4361
  type: "wildcard";
4182
4362
  } & WildcardQuery) | ({
4183
4363
  type: "withinDistanceOf";
@@ -4232,7 +4412,9 @@ export interface SearchObjectsForInterfaceRequest {
4232
4412
  orderBy?: SearchOrderByV2;
4233
4413
  augmentedProperties: Record<ObjectTypeApiName, Array<PropertyApiName>>;
4234
4414
  augmentedSharedPropertyTypes: Record<InterfaceTypeApiName, Array<SharedPropertyTypeApiName>>;
4415
+ augmentedInterfacePropertyTypes: Record<InterfaceTypeApiName, Array<InterfacePropertyApiName>>;
4235
4416
  selectedSharedPropertyTypes: Array<SharedPropertyTypeApiName>;
4417
+ selectedInterfacePropertyTypes: Array<InterfacePropertyApiName>;
4236
4418
  selectedObjectTypes: Array<ObjectTypeApiName>;
4237
4419
  otherInterfaceTypes: Array<InterfaceTypeApiName>;
4238
4420
  pageSize?: _Core.PageSize;
@@ -4257,6 +4439,7 @@ export interface SearchObjectsRequestV2 {
4257
4439
  pageSize?: _Core.PageSize;
4258
4440
  pageToken?: _Core.PageToken;
4259
4441
  select: Array<PropertyApiName>;
4442
+ selectV2: Array<PropertyIdentifier>;
4260
4443
  excludeRid?: boolean;
4261
4444
  snapshot?: boolean;
4262
4445
  }
@@ -4652,10 +4835,16 @@ export interface StructFieldEvaluationResult {
4652
4835
  required: boolean;
4653
4836
  }
4654
4837
  /**
4655
- * A combination of a property API name and a struct field API name used to select struct fields. Note that you can
4656
- still select struct properties with only a 'PropertyApiNameSelector'; the queries will then become 'OR' queries
4657
- across the fields of the struct property, and derived property expressions will operate on the whole struct
4658
- where applicable.
4838
+ * Log Safety: UNSAFE
4839
+ */
4840
+ export interface StructFieldOfPropertyImplementation {
4841
+ propertyApiName: PropertyApiName;
4842
+ structFieldApiName: StructFieldApiName;
4843
+ }
4844
+ /**
4845
+ * A combination of a property identifier and the load level to apply to the property. You can select a reduced
4846
+ value for arrays and the main value for structs. If the provided load level cannot be applied to the property
4847
+ type, then it will be ignored. This selector is experimental and may not work in filters or sorts.
4659
4848
  *
4660
4849
  * Log Safety: UNSAFE
4661
4850
  */
@@ -4706,6 +4895,14 @@ export interface StructParameterFieldArgument {
4706
4895
  */
4707
4896
  export interface StructType {
4708
4897
  structFieldTypes: Array<StructFieldType>;
4898
+ mainValue?: StructTypeMainValue;
4899
+ }
4900
+ /**
4901
+ * Log Safety: UNSAFE
4902
+ */
4903
+ export interface StructTypeMainValue {
4904
+ mainValueType: ObjectPropertyType;
4905
+ fields: Array<StructFieldApiName>;
4709
4906
  }
4710
4907
  /**
4711
4908
  * Contains the status of the submission criteria.