@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.
@@ -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 {@link User | users}, or project {@link Member | member}.
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 entities that will get access to the file.
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
- * @example <caption>Update file permissions for the the specified project.</caption>
62
- * const myFile = client.getFile(myFileId);
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
  /**
@@ -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<any>;
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.update | Permissions.update()}.
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.6",
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.6"
29
+ "@inweb/eventemitter2": "~25.9.7"
30
30
  }
31
31
  }
@@ -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
- * @param httpClient - HTTP client instance used to send requests to the REST API server..
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
- * Raw assembly data received from the server.
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: IModelTransformMatrix): Promise<this> {
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 the raw data of a deleted viewpoint.
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: any, bitmapGuid: any): Promise<string> {
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());
@@ -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 report with the clash detection results for this test.
275
+ * Returns a list of detected clashes for this test.
271
276
  */
272
- getReport(): Promise<any> {
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<any> {
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<any> {
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 {string} sortField - Allows to specify sort field.
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