@inweb/client 25.9.6 → 25.9.7
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/client.js +159 -88
- package/dist/client.js.map +1 -1
- package/dist/client.min.js +1 -1
- package/dist/client.module.js +2 -2
- package/dist/client.module.js.map +1 -1
- package/lib/Api/Assembly.d.ts +28 -16
- package/lib/Api/ClashTest.d.ts +11 -6
- package/lib/Api/Client.d.ts +32 -15
- package/lib/Api/File.d.ts +20 -10
- package/lib/Api/IAssembly.d.ts +26 -0
- package/lib/Api/IFile.d.ts +22 -1
- package/lib/Api/Job.d.ts +10 -5
- package/lib/Api/Member.d.ts +8 -4
- package/lib/Api/Model.d.ts +7 -5
- package/lib/Api/Permission.d.ts +24 -17
- package/lib/Api/Project.d.ts +16 -9
- package/lib/Api/Role.d.ts +8 -4
- package/lib/Api/User.d.ts +11 -4
- package/lib/index.d.ts +2 -2
- package/package.json +2 -2
- package/src/Api/Assembly.ts +29 -16
- package/src/Api/ClashTest.ts +11 -6
- package/src/Api/Client.ts +25 -16
- package/src/Api/File.ts +20 -10
- package/src/Api/IAssembly.ts +33 -0
- package/src/Api/IFile.ts +27 -1
- package/src/Api/Job.ts +10 -5
- package/src/Api/Member.ts +8 -4
- package/src/Api/Model.ts +7 -5
- package/src/Api/Permission.ts +24 -17
- package/src/Api/Project.ts +16 -9
- package/src/Api/Role.ts +8 -4
- package/src/Api/User.ts +11 -4
- package/src/index.ts +9 -2
package/lib/Api/Permission.d.ts
CHANGED
|
@@ -2,14 +2,15 @@ import { IHttpClient } from "./IHttpClient";
|
|
|
2
2
|
import { IGrantedTo } from "./IFile";
|
|
3
3
|
/**
|
|
4
4
|
* Provides properties and methods for obtaining information about {@link File | file} actions
|
|
5
|
-
* granted to a specific
|
|
5
|
+
* granted to a specific user, project, or group.
|
|
6
6
|
*/
|
|
7
7
|
export declare class Permission {
|
|
8
8
|
private _data;
|
|
9
9
|
fileId: string;
|
|
10
10
|
httpClient: IHttpClient;
|
|
11
11
|
/**
|
|
12
|
-
* @param data - Raw permission data received from the server.
|
|
12
|
+
* @param data - Raw permission data received from the server. For more information, see
|
|
13
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Permission | Open Cloud Permissions API}.
|
|
13
14
|
* @param fileId - Owner file ID.
|
|
14
15
|
* @param httpClient - HTTP client instance used to send requests to the REST API server.
|
|
15
16
|
*/
|
|
@@ -25,11 +26,26 @@ export declare class Permission {
|
|
|
25
26
|
* - `write` - The ability to modify file name, description and references.
|
|
26
27
|
* - `readViewpoint` - The ability to read file viewpoints.
|
|
27
28
|
* - `createViewpoint` - The ability to create file viewpoints.
|
|
29
|
+
*
|
|
30
|
+
* @example <caption>Change file permissions for the the specified project.</caption>
|
|
31
|
+
* const myFile = client.getFile(myFileId);
|
|
32
|
+
* const permissions = await myFile.getPermissions();
|
|
33
|
+
* const projectPermissions = permissions.filter((permission) =>
|
|
34
|
+
* permission.grantedTo.some((x) => x.project?.id === myProjectId)
|
|
35
|
+
* );
|
|
36
|
+
* const newActions = ["read", "readSourceFile", "update"];
|
|
37
|
+
* await Promise.all(
|
|
38
|
+
* projectPermissions.map((permission) => {
|
|
39
|
+
* permission.actions = newActions;
|
|
40
|
+
* return permission.save();
|
|
41
|
+
* })
|
|
42
|
+
* );
|
|
28
43
|
*/
|
|
29
44
|
get actions(): string[];
|
|
30
45
|
set actions(value: string[]);
|
|
31
46
|
/**
|
|
32
|
-
* Raw permission data received from the server.
|
|
47
|
+
* Raw permission data received from the server. For more information, see
|
|
48
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Permission | Open Cloud Permissions API}.
|
|
33
49
|
*
|
|
34
50
|
* @readonly
|
|
35
51
|
*/
|
|
@@ -42,7 +58,7 @@ export declare class Permission {
|
|
|
42
58
|
*/
|
|
43
59
|
get id(): string;
|
|
44
60
|
/**
|
|
45
|
-
* A list of
|
|
61
|
+
* A list of users, projects, or groups that will get access to the file.
|
|
46
62
|
*/
|
|
47
63
|
get grantedTo(): IGrantedTo[];
|
|
48
64
|
set grantedTo(value: IGrantedTo[]);
|
|
@@ -58,24 +74,15 @@ export declare class Permission {
|
|
|
58
74
|
/**
|
|
59
75
|
* Updates permission data on the server.
|
|
60
76
|
*
|
|
61
|
-
* @
|
|
62
|
-
*
|
|
63
|
-
* const permissions = await myFile.getPermissions();
|
|
64
|
-
* const projectPermissions = permissions.filter((permission) =>
|
|
65
|
-
* permission.grantedTo.some((x) => x.project?.id === myProjectId)
|
|
66
|
-
* );
|
|
67
|
-
* const newActions = ["read", "readSourceFile", "update"];
|
|
68
|
-
* await Promise.allSettled(
|
|
69
|
-
* projectPermissions.map((permission) => permission.update({ newActions }))
|
|
70
|
-
* );
|
|
71
|
-
*
|
|
72
|
-
* @param data - Raw permission data.
|
|
77
|
+
* @param data - Raw permission data. For more information, see
|
|
78
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Permission | Open Cloud Permissions API}.
|
|
73
79
|
*/
|
|
74
80
|
update(data: any): Promise<this>;
|
|
75
81
|
/**
|
|
76
82
|
* Removes a permission from the file.
|
|
77
83
|
*
|
|
78
|
-
* @returns Returns the raw data of a deleted permission.
|
|
84
|
+
* @returns Returns the raw data of a deleted permission. For more information, see
|
|
85
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Permission | Open Cloud Permissions API}.
|
|
79
86
|
*/
|
|
80
87
|
delete(): Promise<any>;
|
|
81
88
|
/**
|
package/lib/Api/Project.d.ts
CHANGED
|
@@ -12,7 +12,8 @@ export declare class Project {
|
|
|
12
12
|
private _data;
|
|
13
13
|
httpClient: IHttpClient;
|
|
14
14
|
/**
|
|
15
|
-
* @param data - Raw project data received from the server.
|
|
15
|
+
* @param data - Raw project data received from the server. For more information, see
|
|
16
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
16
17
|
* @param httpClient - HTTP client instance used to send requests to the REST API server.
|
|
17
18
|
*/
|
|
18
19
|
constructor(data: any, httpClient: IHttpClient);
|
|
@@ -48,7 +49,8 @@ export declare class Project {
|
|
|
48
49
|
get customFields(): any;
|
|
49
50
|
set customFields(value: any);
|
|
50
51
|
/**
|
|
51
|
-
* Raw project data received from the server.
|
|
52
|
+
* Raw project data received from the server. For more information, see
|
|
53
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
52
54
|
*
|
|
53
55
|
* @readonly
|
|
54
56
|
*/
|
|
@@ -132,13 +134,15 @@ export declare class Project {
|
|
|
132
134
|
/**
|
|
133
135
|
* Updates project data on the server.
|
|
134
136
|
*
|
|
135
|
-
* @param data - Raw project data.
|
|
137
|
+
* @param data - Raw project data. For more information, see
|
|
138
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
136
139
|
*/
|
|
137
140
|
update(data: any): Promise<this>;
|
|
138
141
|
/**
|
|
139
142
|
* Deletes a project from the server.
|
|
140
143
|
*
|
|
141
|
-
* @returns Returns the raw data of a deleted project.
|
|
144
|
+
* @returns Returns the raw data of a deleted project. For more information, see
|
|
145
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
142
146
|
*/
|
|
143
147
|
delete(): Promise<any>;
|
|
144
148
|
/**
|
|
@@ -157,7 +161,7 @@ export declare class Project {
|
|
|
157
161
|
* {@link https://developer.mozilla.org/docs/Web/API/File | Web API File} object. Setting
|
|
158
162
|
* the `image` to `null` will remove the preview.
|
|
159
163
|
*/
|
|
160
|
-
setPreview(image?: BodyInit | null): Promise<
|
|
164
|
+
setPreview(image?: BodyInit | null): Promise<this>;
|
|
161
165
|
/**
|
|
162
166
|
* Removes the project preview.
|
|
163
167
|
*/
|
|
@@ -185,7 +189,8 @@ export declare class Project {
|
|
|
185
189
|
* Deletes the specified project role.
|
|
186
190
|
*
|
|
187
191
|
* @param name - Role name.
|
|
188
|
-
* @returns Returns the raw data of a deleted role.
|
|
192
|
+
* @returns Returns the raw data of a deleted role. For more information, see
|
|
193
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
189
194
|
*/
|
|
190
195
|
deleteRole(name: string): Promise<any>;
|
|
191
196
|
/**
|
|
@@ -209,7 +214,8 @@ export declare class Project {
|
|
|
209
214
|
* Removes the specified member from a project.
|
|
210
215
|
*
|
|
211
216
|
* @param memberId - Member ID.
|
|
212
|
-
* @returns Returns the raw data of a deleted member.
|
|
217
|
+
* @returns Returns the raw data of a deleted member. For more information, see
|
|
218
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
213
219
|
*/
|
|
214
220
|
removeMember(memberId: string): Promise<any>;
|
|
215
221
|
/**
|
|
@@ -225,7 +231,8 @@ export declare class Project {
|
|
|
225
231
|
* @property {string} file.reference - File ID.
|
|
226
232
|
*/
|
|
227
233
|
/**
|
|
228
|
-
* Returns a list of project files.
|
|
234
|
+
* Returns a list of project files. For more information, see
|
|
235
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/bcf3.html#ProjectFilesInformation | Open Cloud BCF3 API}.
|
|
229
236
|
*
|
|
230
237
|
* This list contains all files that the project has access to. To add a file to this list,
|
|
231
238
|
* create a {@link IGrantedTo.project | project} permission on the file using
|
|
@@ -239,7 +246,7 @@ export declare class Project {
|
|
|
239
246
|
/**
|
|
240
247
|
* Adds a file to the project with specified permissions.
|
|
241
248
|
*
|
|
242
|
-
* To change file permissions for the project use {@link Permission.
|
|
249
|
+
* To change file permissions for the project use {@link Permission.actions}.
|
|
243
250
|
*
|
|
244
251
|
* @param fileId - File ID.
|
|
245
252
|
* @param actions - Actions are allowed to be performed on a file:
|
package/lib/Api/Role.d.ts
CHANGED
|
@@ -9,7 +9,8 @@ export declare class Role {
|
|
|
9
9
|
projectId: string;
|
|
10
10
|
httpClient: IHttpClient;
|
|
11
11
|
/**
|
|
12
|
-
* @param data - Raw role data received from the server.
|
|
12
|
+
* @param data - Raw role data received from the server. For more information, see
|
|
13
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
13
14
|
* @param projectId - Owner project ID.
|
|
14
15
|
* @param httpClient - HTTP client instance used to send requests to the REST API server.
|
|
15
16
|
*/
|
|
@@ -23,7 +24,8 @@ export declare class Role {
|
|
|
23
24
|
get description(): string;
|
|
24
25
|
set description(value: string);
|
|
25
26
|
/**
|
|
26
|
-
* Raw role data received from the server.
|
|
27
|
+
* Raw role data received from the server. For more information, see
|
|
28
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
27
29
|
*
|
|
28
30
|
* @readonly
|
|
29
31
|
*/
|
|
@@ -46,13 +48,15 @@ export declare class Role {
|
|
|
46
48
|
/**
|
|
47
49
|
* Updates role data on the server.
|
|
48
50
|
*
|
|
49
|
-
* @param data - Raw role data.
|
|
51
|
+
* @param data - Raw role data. For more information, see
|
|
52
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
50
53
|
*/
|
|
51
54
|
update(data: any): Promise<this>;
|
|
52
55
|
/**
|
|
53
56
|
* Deletes a role from the project.
|
|
54
57
|
*
|
|
55
|
-
* @returns Returns the raw data of a deleted role.
|
|
58
|
+
* @returns Returns the raw data of a deleted role. For more information, see
|
|
59
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
56
60
|
*/
|
|
57
61
|
delete(): Promise<any>;
|
|
58
62
|
/**
|
package/lib/Api/User.d.ts
CHANGED
|
@@ -7,7 +7,8 @@ export declare class User {
|
|
|
7
7
|
private _data;
|
|
8
8
|
httpClient: IHttpClient;
|
|
9
9
|
/**
|
|
10
|
-
* @param data - Raw user data received from the server.
|
|
10
|
+
* @param data - Raw user data received from the server. For more information, see
|
|
11
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Users | Open Cloud Users API}.
|
|
11
12
|
* @param httpClient - HTTP client instance used to send requests to the REST API server.
|
|
12
13
|
*/
|
|
13
14
|
constructor(data: any, httpClient: IHttpClient);
|
|
@@ -38,7 +39,8 @@ export declare class User {
|
|
|
38
39
|
get customFields(): any;
|
|
39
40
|
set customFields(value: any);
|
|
40
41
|
/**
|
|
41
|
-
* Raw user data received from the server.
|
|
42
|
+
* Raw user data received from the server. For more information, see
|
|
43
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Users | Open Cloud Users API}.
|
|
42
44
|
*
|
|
43
45
|
* @readonly
|
|
44
46
|
*/
|
|
@@ -52,6 +54,9 @@ export declare class User {
|
|
|
52
54
|
/**
|
|
53
55
|
* The user's email confirmation code, or an empty string if the email has already been confirmed.
|
|
54
56
|
*
|
|
57
|
+
* To send the confirmation code to the server, use
|
|
58
|
+
* {@link Client.confirmUserEmail | Client.confirmUserEmail()}.
|
|
59
|
+
*
|
|
55
60
|
* @readonly
|
|
56
61
|
*/
|
|
57
62
|
get emailConfirmationId(): string;
|
|
@@ -160,7 +165,8 @@ export declare class User {
|
|
|
160
165
|
* Only administrators can update other users. If the current logged in user is not an
|
|
161
166
|
* administrator, they can only update themself, otherwise an exception will be thrown.
|
|
162
167
|
*
|
|
163
|
-
* @param data - Raw user data.
|
|
168
|
+
* @param data - Raw user data. For more information, see
|
|
169
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Users | Open Cloud Users API}.
|
|
164
170
|
*/
|
|
165
171
|
update(data: any): Promise<this>;
|
|
166
172
|
/**
|
|
@@ -174,7 +180,8 @@ export declare class User {
|
|
|
174
180
|
*
|
|
175
181
|
* You need to re-login after deleting the current logged in user.
|
|
176
182
|
*
|
|
177
|
-
* @returns Returns the raw data of a deleted user.
|
|
183
|
+
* @returns Returns the raw data of a deleted user. For more information, see
|
|
184
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Users | Open Cloud Users API}.
|
|
178
185
|
*/
|
|
179
186
|
delete(): Promise<any>;
|
|
180
187
|
/**
|
package/lib/index.d.ts
CHANGED
|
@@ -6,8 +6,8 @@ export { File } from "./Api/File";
|
|
|
6
6
|
export { FetchError, statusText } from "./Api/FetchError";
|
|
7
7
|
export { Job } from "./Api/Job";
|
|
8
8
|
export { IHttpClient } from "./Api/IHttpClient";
|
|
9
|
-
export { IModelTransformMatrix } from "./Api/IAssembly";
|
|
10
|
-
export { IFileDataStatus, IFileReference, IFileReferences, IFileStatus, IGrantedTo } from "./Api/IFile";
|
|
9
|
+
export { IAssociatedFileData, IClashItem, IModelTransformMatrix } from "./Api/IAssembly";
|
|
10
|
+
export { IFileDataStatus, IFileReference, IFileReferences, IFileStatus, IFileVersionInfo, IGrantedTo, } from "./Api/IFile";
|
|
11
11
|
export { IRoleActions } from "./Api/IRole";
|
|
12
12
|
export { IShortUserDesc } from "./Api/IUser";
|
|
13
13
|
export { Member } from "./Api/Member";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@inweb/client",
|
|
3
|
-
"version": "25.9.
|
|
3
|
+
"version": "25.9.7",
|
|
4
4
|
"description": "JavaScript REST API client for the Open Cloud Server",
|
|
5
5
|
"homepage": "https://cloud.opendesign.com/docs/index.html",
|
|
6
6
|
"license": "SEE LICENSE IN LICENSE",
|
|
@@ -26,6 +26,6 @@
|
|
|
26
26
|
"docs": "typedoc"
|
|
27
27
|
},
|
|
28
28
|
"dependencies": {
|
|
29
|
-
"@inweb/eventemitter2": "~25.9.
|
|
29
|
+
"@inweb/eventemitter2": "~25.9.7"
|
|
30
30
|
}
|
|
31
31
|
}
|
package/src/Api/Assembly.ts
CHANGED
|
@@ -41,8 +41,9 @@ export class Assembly {
|
|
|
41
41
|
public path: string;
|
|
42
42
|
|
|
43
43
|
/**
|
|
44
|
-
* @param data - Raw assembly data received from the server.
|
|
45
|
-
*
|
|
44
|
+
* @param data - Raw assembly data received from the server. For more information, see
|
|
45
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
46
|
+
* @param httpClient - HTTP client instance used to send requests to the REST API server.
|
|
46
47
|
*/
|
|
47
48
|
constructor(data: any, httpClient: IHttpClient) {
|
|
48
49
|
this.path = `/assemblies/${data.id}`;
|
|
@@ -102,9 +103,8 @@ export class Assembly {
|
|
|
102
103
|
}
|
|
103
104
|
|
|
104
105
|
/**
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
* @readonly
|
|
106
|
+
* Returns the raw assembly data received from the server. For more information, see
|
|
107
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
108
108
|
*/
|
|
109
109
|
get data(): any {
|
|
110
110
|
return this._data;
|
|
@@ -232,7 +232,8 @@ export class Assembly {
|
|
|
232
232
|
/**
|
|
233
233
|
* Updates assembly data on the server.
|
|
234
234
|
*
|
|
235
|
-
* @param data - Raw assembly data.
|
|
235
|
+
* @param data - Raw assembly data. For more information, see
|
|
236
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
236
237
|
*/
|
|
237
238
|
async update(data: any): Promise<this> {
|
|
238
239
|
const response = await this.internalPut("", data);
|
|
@@ -243,7 +244,8 @@ export class Assembly {
|
|
|
243
244
|
/**
|
|
244
245
|
* Deletes an assembly from the server.
|
|
245
246
|
*
|
|
246
|
-
* @returns Returns the raw data of a deleted assembly.
|
|
247
|
+
* @returns Returns the raw data of a deleted assembly. For more information, see
|
|
248
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
247
249
|
*/
|
|
248
250
|
delete(): Promise<any> {
|
|
249
251
|
return this.internalDelete("").then((response) => response.json());
|
|
@@ -293,18 +295,25 @@ export class Assembly {
|
|
|
293
295
|
* @param handle - Model original handle.
|
|
294
296
|
* @param transform - Transformation matrix. Specify `undefined` to remove transformation.
|
|
295
297
|
*/
|
|
296
|
-
setModelTransformMatrix(handle: string, transform
|
|
298
|
+
setModelTransformMatrix(handle: string, transform?: IModelTransformMatrix): Promise<this> {
|
|
297
299
|
const obj = { ...this.data.transform };
|
|
298
300
|
obj[handle] = transform;
|
|
299
301
|
return this.update({ transform: obj });
|
|
300
302
|
}
|
|
301
303
|
|
|
304
|
+
/**
|
|
305
|
+
* Object properties.
|
|
306
|
+
*
|
|
307
|
+
* @typedef {any} Properties
|
|
308
|
+
* @property {string} handle - Object original handle.
|
|
309
|
+
* @property {string | any} * - Object property. Can be `any` for nested properties.
|
|
310
|
+
*/
|
|
311
|
+
|
|
302
312
|
/**
|
|
303
313
|
* Returns the properties for an objects in the assembly.
|
|
304
314
|
*
|
|
305
315
|
* @param handles - Object original handle or handles array. Specify `undefined` to get
|
|
306
316
|
* properties for all objects in the assembly.
|
|
307
|
-
* @returns {Promise<any>}
|
|
308
317
|
*/
|
|
309
318
|
getProperties(handles?: string | string[]): Promise<any[]> {
|
|
310
319
|
const relativePath = handles !== undefined ? `/properties?handles=${handles}` : "/properties";
|
|
@@ -348,7 +357,8 @@ export class Assembly {
|
|
|
348
357
|
}
|
|
349
358
|
|
|
350
359
|
/**
|
|
351
|
-
* Returns a list of assembly viewpoints.
|
|
360
|
+
* Returns a list of assembly viewpoints. For more information, see
|
|
361
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#AssemblyViewpoints | Open Cloud Assembly Viewpoints API}.
|
|
352
362
|
*/
|
|
353
363
|
getViewpoints(): Promise<any[]> {
|
|
354
364
|
return this.internalGet("/viewpoints")
|
|
@@ -359,7 +369,8 @@ export class Assembly {
|
|
|
359
369
|
/**
|
|
360
370
|
* Saves a new assembly viewpoint to the server. To create a viewpoint use `Viewer.createViewpoint()`.
|
|
361
371
|
*
|
|
362
|
-
* @param viewpoint - Viewpoint.
|
|
372
|
+
* @param viewpoint - Viewpoint object. For more information, see
|
|
373
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#AssemblyViewpoints | Open Cloud Assembly Viewpoints API}.
|
|
363
374
|
*/
|
|
364
375
|
saveViewpoint(viewpoint: any): Promise<any> {
|
|
365
376
|
return this.internalPost("/viewpoints", viewpoint).then((response) => response.json());
|
|
@@ -369,14 +380,15 @@ export class Assembly {
|
|
|
369
380
|
* Deletes the specified assembly viewpoint.
|
|
370
381
|
*
|
|
371
382
|
* @param guid - Viewpoint GUID.
|
|
372
|
-
* @returns Returns
|
|
383
|
+
* @returns Returns a deleted viewpoint. For more information, see
|
|
384
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#AssemblyViewpoints | Open Cloud Assembly Viewpoints API}.
|
|
373
385
|
*/
|
|
374
386
|
deleteViewpoint(guid: string): Promise<any> {
|
|
375
387
|
return this.internalDelete(`/viewpoints/${guid}`).then((response) => response.json());
|
|
376
388
|
}
|
|
377
389
|
|
|
378
390
|
/**
|
|
379
|
-
* Returns viewpoint snapshot as base64-encoded
|
|
391
|
+
* Returns the viewpoint snapshot as base64-encoded
|
|
380
392
|
* {@link https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs | Data URL}.
|
|
381
393
|
*
|
|
382
394
|
* @param guid - Viewpoint GUID.
|
|
@@ -386,12 +398,12 @@ export class Assembly {
|
|
|
386
398
|
}
|
|
387
399
|
|
|
388
400
|
/**
|
|
389
|
-
* Returns viewpoint snapshot data.
|
|
401
|
+
* Returns the viewpoint snapshot data.
|
|
390
402
|
*
|
|
391
403
|
* @param guid - Viewpoint GUID.
|
|
392
404
|
* @param bitmapGuid - Bitmap GUID.
|
|
393
405
|
*/
|
|
394
|
-
getSnapshotData(guid:
|
|
406
|
+
getSnapshotData(guid: string, bitmapGuid: string): Promise<string> {
|
|
395
407
|
return this.internalGet(`/viewpoints/${guid}/bitmaps/${bitmapGuid}`).then((response) => response.text());
|
|
396
408
|
}
|
|
397
409
|
|
|
@@ -656,7 +668,8 @@ export class Assembly {
|
|
|
656
668
|
* Deletes the specified assembly clash test.
|
|
657
669
|
*
|
|
658
670
|
* @param testId - Test ID.
|
|
659
|
-
* @returns Returns the raw data of a deleted test.
|
|
671
|
+
* @returns Returns the raw data of a deleted test. For more information, see
|
|
672
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
660
673
|
*/
|
|
661
674
|
deleteClashTest(testId: string): Promise<any> {
|
|
662
675
|
return this.internalDelete(`/clashes/${testId}`).then((response) => response.json());
|
package/src/Api/ClashTest.ts
CHANGED
|
@@ -22,6 +22,7 @@
|
|
|
22
22
|
///////////////////////////////////////////////////////////////////////////////
|
|
23
23
|
|
|
24
24
|
import { IHttpClient } from "./IHttpClient";
|
|
25
|
+
import { IClashItem } from "./IAssembly";
|
|
25
26
|
import { IShortUserDesc } from "./IUser";
|
|
26
27
|
import { waitFor, userFullName, userInitials } from "./Utils";
|
|
27
28
|
|
|
@@ -34,7 +35,8 @@ export class ClashTest {
|
|
|
34
35
|
public httpClient: IHttpClient;
|
|
35
36
|
|
|
36
37
|
/**
|
|
37
|
-
* @param data - Raw test data received from the server.
|
|
38
|
+
* @param data - Raw test data received from the server. For more information, see
|
|
39
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
38
40
|
* @param basePath - The clash test API base path of the file/assembly that owns the test.
|
|
39
41
|
* @param httpClient - HTTP client instance used to send requests to the REST API server.
|
|
40
42
|
*/
|
|
@@ -81,7 +83,8 @@ export class ClashTest {
|
|
|
81
83
|
}
|
|
82
84
|
|
|
83
85
|
/**
|
|
84
|
-
* Raw test data received from the server.
|
|
86
|
+
* Raw test data received from the server. For more information, see
|
|
87
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
85
88
|
*
|
|
86
89
|
* @readonly
|
|
87
90
|
*/
|
|
@@ -213,7 +216,8 @@ export class ClashTest {
|
|
|
213
216
|
/**
|
|
214
217
|
* Updates test data on the server.
|
|
215
218
|
*
|
|
216
|
-
* @param data - Raw test data.
|
|
219
|
+
* @param data - Raw test data. For more information, see
|
|
220
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
217
221
|
*/
|
|
218
222
|
async update(data: any): Promise<this> {
|
|
219
223
|
const response = await this.internalPut("", data);
|
|
@@ -224,7 +228,8 @@ export class ClashTest {
|
|
|
224
228
|
/**
|
|
225
229
|
* Deletes a test and its results report from the server.
|
|
226
230
|
*
|
|
227
|
-
* @returns Returns the raw data of a deleted test.
|
|
231
|
+
* @returns Returns the raw data of a deleted test. For more information, see
|
|
232
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud Assemblies API}.
|
|
228
233
|
*/
|
|
229
234
|
delete(): Promise<any> {
|
|
230
235
|
return this.internalDelete("").then((response) => response.json());
|
|
@@ -267,9 +272,9 @@ export class ClashTest {
|
|
|
267
272
|
}
|
|
268
273
|
|
|
269
274
|
/**
|
|
270
|
-
* Returns a
|
|
275
|
+
* Returns a list of detected clashes for this test.
|
|
271
276
|
*/
|
|
272
|
-
getReport(): Promise<
|
|
277
|
+
getReport(): Promise<IClashItem[]> {
|
|
273
278
|
return this.internalGet("/report").then((response) => response.json());
|
|
274
279
|
}
|
|
275
280
|
}
|
package/src/Api/Client.ts
CHANGED
|
@@ -132,18 +132,12 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
132
132
|
return this;
|
|
133
133
|
}
|
|
134
134
|
|
|
135
|
-
/**
|
|
136
|
-
* The Object represents server version information.
|
|
137
|
-
*
|
|
138
|
-
* @typedef {any} VersionResult
|
|
139
|
-
* @property {string} version - The server version.
|
|
140
|
-
* @property {string} hash - Build hash.
|
|
141
|
-
*/
|
|
142
|
-
|
|
143
135
|
/**
|
|
144
136
|
* Returns client and server versions.
|
|
137
|
+
*
|
|
138
|
+
* No login is required to obtain the version.
|
|
145
139
|
*/
|
|
146
|
-
version(): Promise<
|
|
140
|
+
version(): Promise<{ server: string; client: string; hash: string }> {
|
|
147
141
|
return this.httpClient
|
|
148
142
|
.get("/version")
|
|
149
143
|
.then((response) => response.json())
|
|
@@ -157,6 +151,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
157
151
|
/**
|
|
158
152
|
* Registers a new user on the server.
|
|
159
153
|
*
|
|
154
|
+
* No login is required to register a new user.
|
|
155
|
+
*
|
|
160
156
|
* @param email - User email. Cannot be empty. Must be unique within the server.
|
|
161
157
|
* @param password - User password. Cannot be empty. Password can only contain letters (a-z,
|
|
162
158
|
* A-Z), numbers (0-9), and special characters (~!@#$%^&*()_-+={}[]<>|/'":;.,?).
|
|
@@ -253,12 +249,15 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
253
249
|
/**
|
|
254
250
|
* Returns the list of server enabled indentity providers.
|
|
255
251
|
*/
|
|
256
|
-
getIdentityProviders(): Promise<
|
|
252
|
+
getIdentityProviders(): Promise<{ name: string; url: string }[]> {
|
|
257
253
|
return this.httpClient.get("/identity").then((response) => response.json());
|
|
258
254
|
}
|
|
259
255
|
|
|
260
256
|
/**
|
|
261
257
|
* Returns the current server settings.
|
|
258
|
+
*
|
|
259
|
+
* @returns Returns an object with server settings. For more information, see
|
|
260
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Settings | Open Cloud Settings API}.
|
|
262
261
|
*/
|
|
263
262
|
getServerSettings(): Promise<any> {
|
|
264
263
|
return this.httpClient.get("/settings").then((response) => response.json());
|
|
@@ -269,6 +268,11 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
269
268
|
*
|
|
270
269
|
* Only administrators can change server settings. If the current logged in user is not an
|
|
271
270
|
* administrator, an exception will be thrown.
|
|
271
|
+
*
|
|
272
|
+
* @param settings - An object with the new server settings or part of the settings. For more
|
|
273
|
+
* information, see
|
|
274
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Settings | Open Cloud Settings API}.
|
|
275
|
+
* @returns Returns an object with updated server settings.
|
|
272
276
|
*/
|
|
273
277
|
updateServerSettings(settings: any): Promise<any> {
|
|
274
278
|
return this.httpClient.put("/settings", settings).then((response) => response.json());
|
|
@@ -374,7 +378,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
374
378
|
* You need to re-login after deleting the current logged in user.
|
|
375
379
|
*
|
|
376
380
|
* @param userId - User ID.
|
|
377
|
-
* @returns Returns the raw data of a deleted user.
|
|
381
|
+
* @returns Returns the raw data of a deleted user. For more information, see
|
|
382
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Users | Open Cloud Users API}.
|
|
378
383
|
*/
|
|
379
384
|
deleteUser(userId: string): Promise<any> {
|
|
380
385
|
if (this.httpClient.signInUserIsAdmin) {
|
|
@@ -415,7 +420,7 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
415
420
|
* @param ids - List of file IDs to return.
|
|
416
421
|
* @param sortByDesc - Allows to specify the descending order of the result. By default,
|
|
417
422
|
* files are sorted by name in ascending order.
|
|
418
|
-
* @param
|
|
423
|
+
* @param sortField - Allows to specify sort field.
|
|
419
424
|
*/
|
|
420
425
|
getFiles(
|
|
421
426
|
start?: number,
|
|
@@ -540,7 +545,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
540
545
|
* version file use {@link File.deleteVersion | File.deleteVersion()}.
|
|
541
546
|
*
|
|
542
547
|
* @param fileId - File ID.
|
|
543
|
-
* @returns Returns the raw data of a deleted file.
|
|
548
|
+
* @returns Returns the raw data of a deleted file. For more information, see
|
|
549
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Files | Open Cloud Files API}.
|
|
544
550
|
*/
|
|
545
551
|
deleteFile(fileId: string): Promise<any> {
|
|
546
552
|
return this.httpClient.delete(`/files/${fileId}`).then((response) => response.json());
|
|
@@ -657,7 +663,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
657
663
|
* already been completed cannot be deleted.
|
|
658
664
|
*
|
|
659
665
|
* @param jobId - Job ID.
|
|
660
|
-
* @returns Returns the raw data of a deleted job.
|
|
666
|
+
* @returns Returns the raw data of a deleted job. For more information, see
|
|
667
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Jobs | Open Cloud Jobs API}.
|
|
661
668
|
*/
|
|
662
669
|
deleteJob(jobId: string): Promise<any> {
|
|
663
670
|
return this.httpClient.delete(`/jobs/${jobId}`).then((response) => response.json());
|
|
@@ -772,7 +779,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
772
779
|
* Deletes the specified assembly from the server.
|
|
773
780
|
*
|
|
774
781
|
* @param assemblyId - Assembly ID.
|
|
775
|
-
* @returns Returns the raw data of a deleted assembly.
|
|
782
|
+
* @returns Returns the raw data of a deleted assembly. For more information, see
|
|
783
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Assemblies | Open Cloud API}.
|
|
776
784
|
*/
|
|
777
785
|
deleteAssembly(assemblyId: string): Promise<any> {
|
|
778
786
|
return this.httpClient.delete(`/assemblies/${assemblyId}`).then((response) => response.json());
|
|
@@ -891,7 +899,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
|
|
|
891
899
|
* Deletes the specified project from the server.
|
|
892
900
|
*
|
|
893
901
|
* @param projectId - Project ID.
|
|
894
|
-
* @returns Returns the raw data of a deleted project.
|
|
902
|
+
* @returns Returns the raw data of a deleted project. For more information, see
|
|
903
|
+
* {@link https://cloud.opendesign.com/docs//pages/server/api.html#Project | Open Cloud Projects API}.
|
|
895
904
|
*/
|
|
896
905
|
deleteProject(projectId: string): Promise<any> {
|
|
897
906
|
return this.httpClient
|