@vertexvis/api-client-node 0.17.3 → 0.20.3

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/dist/esm/api.d.ts CHANGED
@@ -671,7 +671,7 @@ export interface Color3 {
671
671
  */
672
672
  export interface ColorMaterial {
673
673
  /**
674
- * Opacity from 0 to 100.
674
+ * An opacity value from 0 to 255.
675
675
  * @type {number}
676
676
  * @memberof ColorMaterial
677
677
  */
@@ -714,7 +714,7 @@ export interface ColorMaterial {
714
714
  */
715
715
  export interface ColorMaterialNullable {
716
716
  /**
717
- * Opacity from 0 to 100.
717
+ * An opacity value from 0 to 255.
718
718
  * @type {number}
719
719
  * @memberof ColorMaterialNullable
720
720
  */
@@ -1086,7 +1086,7 @@ export interface CreatePartRequestData {
1086
1086
  * @type {CreateGeometrySetRequestDataRelationships}
1087
1087
  * @memberof CreatePartRequestData
1088
1088
  */
1089
- relationships: CreateGeometrySetRequestDataRelationships;
1089
+ relationships?: CreateGeometrySetRequestDataRelationships;
1090
1090
  }
1091
1091
  /**
1092
1092
  *
@@ -1101,17 +1101,25 @@ export interface CreatePartRequestDataAttributes {
1101
1101
  */
1102
1102
  suppliedId?: string;
1103
1103
  /**
1104
- * ID provided for correlation. For example, an existing ID from a PLM system.
1104
+ * ID provided for correlation. For example, an existing ID from a PLM system. Sending a new suppliedRevisionId combined with an existing suppliedId will create a new part revision for an existing part.
1105
1105
  * @type {string}
1106
1106
  * @memberof CreatePartRequestDataAttributes
1107
1107
  */
1108
1108
  suppliedRevisionId?: string;
1109
1109
  /**
1110
- * Whether or not to index metadata in the part file.
1110
+ * Whether or not to index metadata in the part file. To ignore metadata from the part file and add your own, pass `false` for `indexMetadata` and supply custom metadata using the `metadata` field.
1111
1111
  * @type {boolean}
1112
1112
  * @memberof CreatePartRequestDataAttributes
1113
1113
  */
1114
1114
  indexMetadata?: boolean;
1115
+ /**
1116
+ * Additional metadata about the `part` and/or `part-revision`. This metadata will take precedence over any metadata that belongs to the part file if `indexMetadata` is specified.
1117
+ * @type {{ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType; }}
1118
+ * @memberof CreatePartRequestDataAttributes
1119
+ */
1120
+ metadata?: {
1121
+ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType;
1122
+ };
1115
1123
  /**
1116
1124
  * Name to be used for the root part.
1117
1125
  * @type {string}
@@ -2577,30 +2585,54 @@ export interface Matrix4Nullable {
2577
2585
  /**
2578
2586
  *
2579
2587
  * @export
2580
- * @interface MetadataValue
2588
+ * @interface MetadataFloatType
2581
2589
  */
2582
- export interface MetadataValue {
2590
+ export interface MetadataFloatType {
2583
2591
  /**
2584
- * Metadata value.
2592
+ * Type of metadata value.
2585
2593
  * @type {string}
2586
- * @memberof MetadataValue
2594
+ * @memberof MetadataFloatType
2595
+ */
2596
+ type: string;
2597
+ /**
2598
+ * A numerical floating-point value.
2599
+ * @type {number}
2600
+ * @memberof MetadataFloatType
2587
2601
  */
2588
- value?: string;
2602
+ value: number;
2603
+ }
2604
+ /**
2605
+ *
2606
+ * @export
2607
+ * @interface MetadataNullType
2608
+ */
2609
+ export interface MetadataNullType {
2589
2610
  /**
2590
2611
  * Type of metadata value.
2591
2612
  * @type {string}
2592
- * @memberof MetadataValue
2613
+ * @memberof MetadataNullType
2593
2614
  */
2594
- type: MetadataValueTypeEnum;
2615
+ type: string;
2616
+ }
2617
+ /**
2618
+ *
2619
+ * @export
2620
+ * @interface MetadataStringType
2621
+ */
2622
+ export interface MetadataStringType {
2623
+ /**
2624
+ * Type of metadata value.
2625
+ * @type {string}
2626
+ * @memberof MetadataStringType
2627
+ */
2628
+ type: string;
2629
+ /**
2630
+ * A string value.
2631
+ * @type {string}
2632
+ * @memberof MetadataStringType
2633
+ */
2634
+ value: string;
2595
2635
  }
2596
- export declare const MetadataValueTypeEnum: {
2597
- readonly String: "string";
2598
- readonly Long: "long";
2599
- readonly Float: "float";
2600
- readonly Date: "date";
2601
- readonly Null: "null";
2602
- };
2603
- export declare type MetadataValueTypeEnum = typeof MetadataValueTypeEnum[keyof typeof MetadataValueTypeEnum];
2604
2636
  /**
2605
2637
  *
2606
2638
  * @export
@@ -2958,11 +2990,11 @@ export interface PartRevisionDataAttributes {
2958
2990
  created?: string;
2959
2991
  /**
2960
2992
  *
2961
- * @type {{ [key: string]: MetadataValue; }}
2993
+ * @type {{ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType; }}
2962
2994
  * @memberof PartRevisionDataAttributes
2963
2995
  */
2964
2996
  metadata?: {
2965
- [key: string]: MetadataValue;
2997
+ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType;
2966
2998
  };
2967
2999
  /**
2968
3000
  *
@@ -3694,11 +3726,11 @@ export interface SceneItemDataAttributes {
3694
3726
  materialOverride?: ColorMaterial;
3695
3727
  /**
3696
3728
  *
3697
- * @type {{ [key: string]: MetadataValue; }}
3729
+ * @type {{ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType; }}
3698
3730
  * @memberof SceneItemDataAttributes
3699
3731
  */
3700
3732
  metadata?: {
3701
- [key: string]: MetadataValue;
3733
+ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType;
3702
3734
  };
3703
3735
  /**
3704
3736
  *
@@ -4290,6 +4322,12 @@ export interface SceneViewStateDataAttributes {
4290
4322
  * @memberof SceneViewStateDataAttributes
4291
4323
  */
4292
4324
  featureLines?: FeatureLines;
4325
+ /**
4326
+ *
4327
+ * @type {boolean}
4328
+ * @memberof SceneViewStateDataAttributes
4329
+ */
4330
+ noDefaultLights?: boolean;
4293
4331
  }
4294
4332
  /**
4295
4333
  *
@@ -4694,7 +4732,7 @@ export interface UpdatePartRevisionRequest {
4694
4732
  data: UpdatePartRevisionRequestData;
4695
4733
  }
4696
4734
  /**
4697
- *
4735
+ * Modify existing part revisions using this endpoint. When specifying a `relationship`, the generated output from that relationship will be used to replace any relationship that is present on the revision prior to the update. For example, sending a file relationship that has geometry will replace the existing geometry on the revision with the new geometry in the given file.
4698
4736
  * @export
4699
4737
  * @interface UpdatePartRevisionRequestData
4700
4738
  */
@@ -4717,6 +4755,12 @@ export interface UpdatePartRevisionRequestData {
4717
4755
  * @memberof UpdatePartRevisionRequestData
4718
4756
  */
4719
4757
  attributes: UpdatePartRevisionRequestDataAttributes;
4758
+ /**
4759
+ *
4760
+ * @type {CreateGeometrySetRequestDataRelationships}
4761
+ * @memberof UpdatePartRevisionRequestData
4762
+ */
4763
+ relationships?: CreateGeometrySetRequestDataRelationships;
4720
4764
  }
4721
4765
  /**
4722
4766
  *
@@ -4725,13 +4769,43 @@ export interface UpdatePartRevisionRequestData {
4725
4769
  */
4726
4770
  export interface UpdatePartRevisionRequestDataAttributes {
4727
4771
  /**
4728
- * Metadata about the `part` and/or `part-revision`.
4729
- * @type {{ [key: string]: MetadataValue; }}
4772
+ * Metadata about the `part` and/or `part-revision`. This metadata will take precedence over any metadata that belongs to the part file if `indexMetadata` is specified.
4773
+ * @type {{ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType; }}
4730
4774
  * @memberof UpdatePartRevisionRequestDataAttributes
4731
4775
  */
4732
4776
  metadata?: {
4733
- [key: string]: MetadataValue;
4777
+ [key: string]: MetadataStringType | MetadataFloatType | MetadataNullType;
4734
4778
  };
4779
+ /**
4780
+ * Whether or not to index metadata in the part file when sending a file relationship - not used otherwise. To ignore metadata from the part file and add your own, pass `false` for `indexMetadata` and supply custom metadata using the `metadata` field.
4781
+ * @type {boolean}
4782
+ * @memberof UpdatePartRevisionRequestDataAttributes
4783
+ */
4784
+ indexMetadata?: boolean;
4785
+ /**
4786
+ * Name to be used for the root part. This will be used when given a file relationship - not used otherwise.
4787
+ * @type {string}
4788
+ * @memberof UpdatePartRevisionRequestDataAttributes
4789
+ */
4790
+ name?: string;
4791
+ /**
4792
+ * Metadata key used to extract an ID used for correlation. This will be used when given a file relationship - not used otherwise.
4793
+ * @type {string}
4794
+ * @memberof UpdatePartRevisionRequestDataAttributes
4795
+ */
4796
+ suppliedIdKey?: string;
4797
+ /**
4798
+ * Metadata key used to extract an ID used for correlation. This will be used when given a file relationship - not used otherwise.
4799
+ * @type {string}
4800
+ * @memberof UpdatePartRevisionRequestDataAttributes
4801
+ */
4802
+ suppliedRevisionIdKey?: string;
4803
+ /**
4804
+ * Metadata key used to extract an ID used for correlation. This will be used when given a file relationship - not used otherwise.
4805
+ * @type {string}
4806
+ * @memberof UpdatePartRevisionRequestDataAttributes
4807
+ */
4808
+ suppliedInstanceIdKey?: string;
4735
4809
  }
4736
4810
  /**
4737
4811
  *
@@ -7171,7 +7245,7 @@ export declare const PartRevisionsApiAxiosParamCreator: (configuration?: Configu
7171
7245
  */
7172
7246
  renderPartRevision: (id: string, height?: number | undefined, width?: number | undefined, cameraPosition?: Vector3 | undefined, cameraUp?: Vector3 | undefined, cameraLookAt?: Vector3 | undefined, cameraPerspectivePosition?: Vector3 | undefined, cameraPerspectiveLookAt?: Vector3 | undefined, cameraPerspectiveUp?: Vector3 | undefined, cameraOrthographicViewVector?: Vector3 | undefined, cameraOrthographicLookAt?: Vector3 | undefined, cameraOrthographicUp?: Vector3 | undefined, cameraOrthographicFovHeight?: number | undefined, options?: AxiosRequestConfig) => Promise<RequestArgs>;
7173
7247
  /**
7174
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
7248
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
7175
7249
  * @param {string} id The &#x60;part-revision&#x60; ID.
7176
7250
  * @param {UpdatePartRevisionRequest} updatePartRevisionRequest
7177
7251
  * @param {*} [options] Override http request option.
@@ -7236,7 +7310,7 @@ export declare const PartRevisionsApiFp: (configuration?: Configuration | undefi
7236
7310
  */
7237
7311
  renderPartRevision(id: string, height?: number | undefined, width?: number | undefined, cameraPosition?: Vector3 | undefined, cameraUp?: Vector3 | undefined, cameraLookAt?: Vector3 | undefined, cameraPerspectivePosition?: Vector3 | undefined, cameraPerspectiveLookAt?: Vector3 | undefined, cameraPerspectiveUp?: Vector3 | undefined, cameraOrthographicViewVector?: Vector3 | undefined, cameraOrthographicLookAt?: Vector3 | undefined, cameraOrthographicUp?: Vector3 | undefined, cameraOrthographicFovHeight?: number | undefined, options?: AxiosRequestConfig<any> | undefined): Promise<(axios?: AxiosInstance | undefined, basePath?: string | undefined) => AxiosPromise<any>>;
7238
7312
  /**
7239
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
7313
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
7240
7314
  * @param {string} id The &#x60;part-revision&#x60; ID.
7241
7315
  * @param {UpdatePartRevisionRequest} updatePartRevisionRequest
7242
7316
  * @param {*} [options] Override http request option.
@@ -7301,7 +7375,7 @@ export declare const PartRevisionsApiFactory: (configuration?: Configuration | u
7301
7375
  */
7302
7376
  renderPartRevision(id: string, height?: number | undefined, width?: number | undefined, cameraPosition?: Vector3 | undefined, cameraUp?: Vector3 | undefined, cameraLookAt?: Vector3 | undefined, cameraPerspectivePosition?: Vector3 | undefined, cameraPerspectiveLookAt?: Vector3 | undefined, cameraPerspectiveUp?: Vector3 | undefined, cameraOrthographicViewVector?: Vector3 | undefined, cameraOrthographicLookAt?: Vector3 | undefined, cameraOrthographicUp?: Vector3 | undefined, cameraOrthographicFovHeight?: number | undefined, options?: any): AxiosPromise<any>;
7303
7377
  /**
7304
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
7378
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
7305
7379
  * @param {string} id The &#x60;part-revision&#x60; ID.
7306
7380
  * @param {UpdatePartRevisionRequest} updatePartRevisionRequest
7307
7381
  * @param {*} [options] Override http request option.
@@ -7537,7 +7611,7 @@ export declare class PartRevisionsApi extends BaseAPI {
7537
7611
  */
7538
7612
  renderPartRevision(requestParameters: PartRevisionsApiRenderPartRevisionRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<any, any>>;
7539
7613
  /**
7540
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
7614
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
7541
7615
  * @param {PartRevisionsApiUpdatePartRevisionRequest} requestParameters Request parameters.
7542
7616
  * @param {*} [options] Override http request option.
7543
7617
  * @throws {RequiredError}
@@ -7551,7 +7625,7 @@ export declare class PartRevisionsApi extends BaseAPI {
7551
7625
  */
7552
7626
  export declare const PartsApiAxiosParamCreator: (configuration?: Configuration | undefined) => {
7553
7627
  /**
7554
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
7628
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
7555
7629
  * @param {CreatePartRequest} createPartRequest
7556
7630
  * @param {*} [options] Override http request option.
7557
7631
  * @throws {RequiredError}
@@ -7595,12 +7669,12 @@ export declare const PartsApiAxiosParamCreator: (configuration?: Configuration |
7595
7669
  */
7596
7670
  export declare const PartsApiFp: (configuration?: Configuration | undefined) => {
7597
7671
  /**
7598
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
7672
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
7599
7673
  * @param {CreatePartRequest} createPartRequest
7600
7674
  * @param {*} [options] Override http request option.
7601
7675
  * @throws {RequiredError}
7602
7676
  */
7603
- createPart(createPartRequest: CreatePartRequest, options?: AxiosRequestConfig<any> | undefined): Promise<(axios?: AxiosInstance | undefined, basePath?: string | undefined) => AxiosPromise<QueuedJob>>;
7677
+ createPart(createPartRequest: CreatePartRequest, options?: AxiosRequestConfig<any> | undefined): Promise<(axios?: AxiosInstance | undefined, basePath?: string | undefined) => AxiosPromise<Part>>;
7604
7678
  /**
7605
7679
  * Delete a `part`.
7606
7680
  * @param {string} id The &#x60;part&#x60; ID.
@@ -7639,12 +7713,12 @@ export declare const PartsApiFp: (configuration?: Configuration | undefined) =>
7639
7713
  */
7640
7714
  export declare const PartsApiFactory: (configuration?: Configuration | undefined, basePath?: string | undefined, axios?: AxiosInstance | undefined) => {
7641
7715
  /**
7642
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
7716
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
7643
7717
  * @param {CreatePartRequest} createPartRequest
7644
7718
  * @param {*} [options] Override http request option.
7645
7719
  * @throws {RequiredError}
7646
7720
  */
7647
- createPart(createPartRequest: CreatePartRequest, options?: any): AxiosPromise<QueuedJob>;
7721
+ createPart(createPartRequest: CreatePartRequest, options?: any): AxiosPromise<Part>;
7648
7722
  /**
7649
7723
  * Delete a `part`.
7650
7724
  * @param {string} id The &#x60;part&#x60; ID.
@@ -7768,13 +7842,13 @@ export interface PartsApiGetQueuedPartDeletionRequest {
7768
7842
  */
7769
7843
  export declare class PartsApi extends BaseAPI {
7770
7844
  /**
7771
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
7845
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
7772
7846
  * @param {PartsApiCreatePartRequest} requestParameters Request parameters.
7773
7847
  * @param {*} [options] Override http request option.
7774
7848
  * @throws {RequiredError}
7775
7849
  * @memberof PartsApi
7776
7850
  */
7777
- createPart(requestParameters: PartsApiCreatePartRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<QueuedJob, any>>;
7851
+ createPart(requestParameters: PartsApiCreatePartRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<Part, any>>;
7778
7852
  /**
7779
7853
  * Delete a `part`.
7780
7854
  * @param {PartsApiDeletePartRequest} requestParameters Request parameters.
@@ -8034,10 +8108,12 @@ export declare const SceneItemOverridesApiAxiosParamCreator: (configuration?: Co
8034
8108
  /**
8035
8109
  * Get `scene-item-overrides` for a `scene-view`.
8036
8110
  * @param {string} id The &#x60;scene-view&#x60; ID.
8111
+ * @param {string} [pageCursor] The cursor for the next page of items.
8112
+ * @param {number} [pageSize] The number of items to return.
8037
8113
  * @param {*} [options] Override http request option.
8038
8114
  * @throws {RequiredError}
8039
8115
  */
8040
- getSceneItemOverrides: (id: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
8116
+ getSceneItemOverrides: (id: string, pageCursor?: string | undefined, pageSize?: number | undefined, options?: AxiosRequestConfig) => Promise<RequestArgs>;
8041
8117
  /**
8042
8118
  * Update a `scene-item-override`.
8043
8119
  * @param {string} id The &#x60;scene-item-override&#x60; ID.
@@ -8070,10 +8146,12 @@ export declare const SceneItemOverridesApiFp: (configuration?: Configuration | u
8070
8146
  /**
8071
8147
  * Get `scene-item-overrides` for a `scene-view`.
8072
8148
  * @param {string} id The &#x60;scene-view&#x60; ID.
8149
+ * @param {string} [pageCursor] The cursor for the next page of items.
8150
+ * @param {number} [pageSize] The number of items to return.
8073
8151
  * @param {*} [options] Override http request option.
8074
8152
  * @throws {RequiredError}
8075
8153
  */
8076
- getSceneItemOverrides(id: string, options?: AxiosRequestConfig<any> | undefined): Promise<(axios?: AxiosInstance | undefined, basePath?: string | undefined) => AxiosPromise<SceneItemOverrideList>>;
8154
+ getSceneItemOverrides(id: string, pageCursor?: string | undefined, pageSize?: number | undefined, options?: AxiosRequestConfig<any> | undefined): Promise<(axios?: AxiosInstance | undefined, basePath?: string | undefined) => AxiosPromise<SceneItemOverrideList>>;
8077
8155
  /**
8078
8156
  * Update a `scene-item-override`.
8079
8157
  * @param {string} id The &#x60;scene-item-override&#x60; ID.
@@ -8106,10 +8184,12 @@ export declare const SceneItemOverridesApiFactory: (configuration?: Configuratio
8106
8184
  /**
8107
8185
  * Get `scene-item-overrides` for a `scene-view`.
8108
8186
  * @param {string} id The &#x60;scene-view&#x60; ID.
8187
+ * @param {string} [pageCursor] The cursor for the next page of items.
8188
+ * @param {number} [pageSize] The number of items to return.
8109
8189
  * @param {*} [options] Override http request option.
8110
8190
  * @throws {RequiredError}
8111
8191
  */
8112
- getSceneItemOverrides(id: string, options?: any): AxiosPromise<SceneItemOverrideList>;
8192
+ getSceneItemOverrides(id: string, pageCursor?: string | undefined, pageSize?: number | undefined, options?: any): AxiosPromise<SceneItemOverrideList>;
8113
8193
  /**
8114
8194
  * Update a `scene-item-override`.
8115
8195
  * @param {string} id The &#x60;scene-item-override&#x60; ID.
@@ -8163,6 +8243,18 @@ export interface SceneItemOverridesApiGetSceneItemOverridesRequest {
8163
8243
  * @memberof SceneItemOverridesApiGetSceneItemOverrides
8164
8244
  */
8165
8245
  readonly id: string;
8246
+ /**
8247
+ * The cursor for the next page of items.
8248
+ * @type {string}
8249
+ * @memberof SceneItemOverridesApiGetSceneItemOverrides
8250
+ */
8251
+ readonly pageCursor?: string;
8252
+ /**
8253
+ * The number of items to return.
8254
+ * @type {number}
8255
+ * @memberof SceneItemOverridesApiGetSceneItemOverrides
8256
+ */
8257
+ readonly pageSize?: number;
8166
8258
  }
8167
8259
  /**
8168
8260
  * Request parameters for updateSceneItemOverride operation in SceneItemOverridesApi.
package/dist/esm/api.js CHANGED
@@ -66,13 +66,6 @@ export const FileRelationshipDataTypeEnum = {
66
66
  export const GeometrySetRelationshipDataTypeEnum = {
67
67
  GeometrySet: 'geometry-set',
68
68
  };
69
- export const MetadataValueTypeEnum = {
70
- String: 'string',
71
- Long: 'long',
72
- Float: 'float',
73
- Date: 'date',
74
- Null: 'null',
75
- };
76
69
  export const PartDataRelationshipsPartRevisionsTypeEnum = {
77
70
  PartRevision: 'part-revision',
78
71
  };
@@ -2740,7 +2733,7 @@ export const PartRevisionsApiAxiosParamCreator = function (configuration) {
2740
2733
  };
2741
2734
  }),
2742
2735
  /**
2743
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
2736
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
2744
2737
  * @param {string} id The &#x60;part-revision&#x60; ID.
2745
2738
  * @param {UpdatePartRevisionRequest} updatePartRevisionRequest
2746
2739
  * @param {*} [options] Override http request option.
@@ -2860,7 +2853,7 @@ export const PartRevisionsApiFp = function (configuration) {
2860
2853
  });
2861
2854
  },
2862
2855
  /**
2863
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
2856
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
2864
2857
  * @param {string} id The &#x60;part-revision&#x60; ID.
2865
2858
  * @param {UpdatePartRevisionRequest} updatePartRevisionRequest
2866
2859
  * @param {*} [options] Override http request option.
@@ -2953,7 +2946,7 @@ export const PartRevisionsApiFactory = function (configuration, basePath, axios)
2953
2946
  .then((request) => request(axios, basePath));
2954
2947
  },
2955
2948
  /**
2956
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
2949
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
2957
2950
  * @param {string} id The &#x60;part-revision&#x60; ID.
2958
2951
  * @param {UpdatePartRevisionRequest} updatePartRevisionRequest
2959
2952
  * @param {*} [options] Override http request option.
@@ -3034,7 +3027,7 @@ export class PartRevisionsApi extends BaseAPI {
3034
3027
  .then((request) => request(this.axios, this.basePath));
3035
3028
  }
3036
3029
  /**
3037
- * Update a `part-revision`. Note that metadata updates are eventually consistent.
3030
+ * Update a `part-revision`. When given a `file` relationship as a payload, this will invoke a translation job, similar to the POST /parts endpoint. The response code will be a 202 and will respond with an async workflow, and return an Accepted[QueuedJob]. The geometry of the part and all of its children will be replaced with the geometry specified within the translated file given from this relationship. Some of the properties given here are only used for the translation of the file. Namely, `indexMetadata`, `name`, `suppliedIdKey`, `suppliedRevisionIdKey`, and `suppliedInstanceIdKey`. Note that geometry updates are eventually consistent and will not update existing scenes. For updates to the revision when the file relationship is not present will respond with a standard 200 ok code when successful. Note that metadata updates are eventually consistent and will not update existing scenes. To view updated metadata within a scene, a new scene must be created or the updated part-revision must be removed and re-added to an existing scene.
3038
3031
  * @param {PartRevisionsApiUpdatePartRevisionRequest} requestParameters Request parameters.
3039
3032
  * @param {*} [options] Override http request option.
3040
3033
  * @throws {RequiredError}
@@ -3053,7 +3046,7 @@ export class PartRevisionsApi extends BaseAPI {
3053
3046
  export const PartsApiAxiosParamCreator = function (configuration) {
3054
3047
  return {
3055
3048
  /**
3056
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
3049
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
3057
3050
  * @param {CreatePartRequest} createPartRequest
3058
3051
  * @param {*} [options] Override http request option.
3059
3052
  * @throws {RequiredError}
@@ -3227,7 +3220,7 @@ export const PartsApiFp = function (configuration) {
3227
3220
  const localVarAxiosParamCreator = PartsApiAxiosParamCreator(configuration);
3228
3221
  return {
3229
3222
  /**
3230
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
3223
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
3231
3224
  * @param {CreatePartRequest} createPartRequest
3232
3225
  * @param {*} [options] Override http request option.
3233
3226
  * @throws {RequiredError}
@@ -3299,7 +3292,7 @@ export const PartsApiFactory = function (configuration, basePath, axios) {
3299
3292
  const localVarFp = PartsApiFp(configuration);
3300
3293
  return {
3301
3294
  /**
3302
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
3295
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
3303
3296
  * @param {CreatePartRequest} createPartRequest
3304
3297
  * @param {*} [options] Override http request option.
3305
3298
  * @throws {RequiredError}
@@ -3366,7 +3359,7 @@ export const PartsApiFactory = function (configuration, basePath, axios) {
3366
3359
  */
3367
3360
  export class PartsApi extends BaseAPI {
3368
3361
  /**
3369
- * Create a `part`. This API is asynchronous, returning the location of a `queued-translation`. Check the status via the getQueuedTranslation API. For details, see our [Import data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guide.
3362
+ * Create a `part`. This endpoint includes multiple successful response codes: [`201`, `202`]. When not given a relationship, this endpoint will create a part with an empty part revision and return a `201` status code of the part. When given a relationship to translate, this endpoint will return a `202` status code with the location of a `queued-translation`. The status of the translation can be queried via `getQueuedTranslation`. After the translation is complete, a `part` and `part-revision` that references the translated geometry. A unique suppliedId/suppliedRevisionId combination will create a new part and new part revision. For instance, sending my-part-id/my-revision-id will create a new part and new revision with those corresponding supplied ids. To create a new revision for `my-part-id`, likewise you can invoke this endpoint with a new revision id: `my-part-id/my-new-revision-id` and a new revision will be created for the existing part. See our [Import Data](https://developer.vertexvis.com/docs/guides/import-data-with-api) guides for more information.
3370
3363
  * @param {PartsApiCreatePartRequest} requestParameters Request parameters.
3371
3364
  * @param {*} [options] Override http request option.
3372
3365
  * @throws {RequiredError}
@@ -3801,10 +3794,12 @@ export const SceneItemOverridesApiAxiosParamCreator = function (configuration) {
3801
3794
  /**
3802
3795
  * Get `scene-item-overrides` for a `scene-view`.
3803
3796
  * @param {string} id The &#x60;scene-view&#x60; ID.
3797
+ * @param {string} [pageCursor] The cursor for the next page of items.
3798
+ * @param {number} [pageSize] The number of items to return.
3804
3799
  * @param {*} [options] Override http request option.
3805
3800
  * @throws {RequiredError}
3806
3801
  */
3807
- getSceneItemOverrides: (id, options = {}) => __awaiter(this, void 0, void 0, function* () {
3802
+ getSceneItemOverrides: (id, pageCursor, pageSize, options = {}) => __awaiter(this, void 0, void 0, function* () {
3808
3803
  // verify required parameter 'id' is not null or undefined
3809
3804
  assertParamExists('getSceneItemOverrides', 'id', id);
3810
3805
  const localVarPath = `/scene-views/{id}/scene-item-overrides`.replace(`{${'id'}}`, encodeURIComponent(String(id)));
@@ -3820,6 +3815,12 @@ export const SceneItemOverridesApiAxiosParamCreator = function (configuration) {
3820
3815
  // authentication OAuth2 required
3821
3816
  // oauth required
3822
3817
  yield setOAuthToObject(localVarHeaderParameter, 'OAuth2', [], configuration);
3818
+ if (pageCursor !== undefined) {
3819
+ localVarQueryParameter['page[cursor]'] = pageCursor;
3820
+ }
3821
+ if (pageSize !== undefined) {
3822
+ localVarQueryParameter['page[size]'] = pageSize;
3823
+ }
3823
3824
  setSearchParams(localVarUrlObj, localVarQueryParameter);
3824
3825
  let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
3825
3826
  localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -3900,12 +3901,14 @@ export const SceneItemOverridesApiFp = function (configuration) {
3900
3901
  /**
3901
3902
  * Get `scene-item-overrides` for a `scene-view`.
3902
3903
  * @param {string} id The &#x60;scene-view&#x60; ID.
3904
+ * @param {string} [pageCursor] The cursor for the next page of items.
3905
+ * @param {number} [pageSize] The number of items to return.
3903
3906
  * @param {*} [options] Override http request option.
3904
3907
  * @throws {RequiredError}
3905
3908
  */
3906
- getSceneItemOverrides(id, options) {
3909
+ getSceneItemOverrides(id, pageCursor, pageSize, options) {
3907
3910
  return __awaiter(this, void 0, void 0, function* () {
3908
- const localVarAxiosArgs = yield localVarAxiosParamCreator.getSceneItemOverrides(id, options);
3911
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.getSceneItemOverrides(id, pageCursor, pageSize, options);
3909
3912
  return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
3910
3913
  });
3911
3914
  },
@@ -3957,12 +3960,14 @@ export const SceneItemOverridesApiFactory = function (configuration, basePath, a
3957
3960
  /**
3958
3961
  * Get `scene-item-overrides` for a `scene-view`.
3959
3962
  * @param {string} id The &#x60;scene-view&#x60; ID.
3963
+ * @param {string} [pageCursor] The cursor for the next page of items.
3964
+ * @param {number} [pageSize] The number of items to return.
3960
3965
  * @param {*} [options] Override http request option.
3961
3966
  * @throws {RequiredError}
3962
3967
  */
3963
- getSceneItemOverrides(id, options) {
3968
+ getSceneItemOverrides(id, pageCursor, pageSize, options) {
3964
3969
  return localVarFp
3965
- .getSceneItemOverrides(id, options)
3970
+ .getSceneItemOverrides(id, pageCursor, pageSize, options)
3966
3971
  .then((request) => request(axios, basePath));
3967
3972
  },
3968
3973
  /**
@@ -4019,7 +4024,7 @@ export class SceneItemOverridesApi extends BaseAPI {
4019
4024
  */
4020
4025
  getSceneItemOverrides(requestParameters, options) {
4021
4026
  return SceneItemOverridesApiFp(this.configuration)
4022
- .getSceneItemOverrides(requestParameters.id, options)
4027
+ .getSceneItemOverrides(requestParameters.id, requestParameters.pageCursor, requestParameters.pageSize, options)
4023
4028
  .then((request) => request(this.axios, this.basePath));
4024
4029
  }
4025
4030
  /**
@@ -1,6 +1,6 @@
1
1
  /// <reference types="node" />
2
2
  import { AxiosResponse } from 'axios';
3
- import { CreateFileRequest, CreateGeometrySetRequest, CreatePartRequest, Failure, PartData, PartRevisionData, QueuedJob } from '../../index';
3
+ import { CreateFileRequest, CreateGeometrySetRequest, CreatePartRequest, Failure, Part, PartData, PartRevisionData, QueuedJob } from '../../index';
4
4
  import { BaseReq, DeleteReq, Polling, RenderImageReq } from '../index';
5
5
  /** Create parts from file arguments. */
6
6
  export interface CreatePartFromFileReq extends BaseReq {
@@ -24,7 +24,7 @@ export interface CreatePartFromFileRes {
24
24
  }
25
25
  export interface QueuedTranslation {
26
26
  readonly req: CreatePartRequest | CreateGeometrySetRequest;
27
- readonly res?: Failure | QueuedJob;
27
+ readonly res?: Failure | QueuedJob | Part;
28
28
  }
29
29
  /** Get part revision by supplied ID arguments. */
30
30
  export interface GetPartRevisionBySuppliedIdReq extends BaseReq {
@@ -68,9 +68,10 @@ export function pollQueuedJob({ id, getQueuedJob, allow404 = false, limit, polli
68
68
  let attempts = 1;
69
69
  let pollRes = yield poll(attempts);
70
70
  /* eslint-disable no-await-in-loop */
71
- while ((allowed404(allow404, pollRes.status) ||
72
- validJob(pollRes.res) ||
73
- isClientError(pollRes.res)) &&
71
+ while (!completeJob(pollRes.res) &&
72
+ (allowed404(allow404, pollRes.status) ||
73
+ validJob(pollRes.res) ||
74
+ isClientError(pollRes.res)) &&
74
75
  attempts <= maxAttempts) {
75
76
  attempts += 1;
76
77
  yield delay(intervalMs);
@@ -79,7 +80,7 @@ export function pollQueuedJob({ id, getQueuedJob, allow404 = false, limit, polli
79
80
  /* eslint-enable no-await-in-loop */
80
81
  // At this point, the result is one of the following,
81
82
  // - An item of type `T` after being redirected to it
82
- // - A QueuedJob (after either exceeding `maxAttempts` or with `error` status)
83
+ // - A QueuedJob (after either exceeding `maxAttempts` or with `complete` or `error` status)
83
84
  // - A Failure
84
85
  return Object.assign(Object.assign({}, pollRes), { attempts, id });
85
86
  });
@@ -105,10 +106,16 @@ function allowed404(allow404, status) {
105
106
  function validJob(r) {
106
107
  return isQueuedJob(r) && !isStatusError(r);
107
108
  }
109
+ function completeJob(r) {
110
+ return isQueuedJob(r) && isStatusComplete(r);
111
+ }
108
112
  // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types, @typescript-eslint/no-explicit-any
109
113
  function isQueuedJobError(obj) {
110
114
  return isQueuedJob(obj) && isStatusError(obj);
111
115
  }
116
+ function isStatusComplete(job) {
117
+ return job.data.attributes.status === 'complete';
118
+ }
112
119
  function isStatusError(job) {
113
120
  return job.data.attributes.status === 'error';
114
121
  }