@inweb/client 25.4.7 → 25.4.10

package/lib/Api/Client.d.ts

@@ -99,6 +99,13 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
      * @param token - An access token for authentication request. See {@link User.token} for more details.
      */
     signInWithToken(token: string): Promise<User>;
+    private setCurrentUser;
+    private clearCurrentUser;
+    /**
+     * Returns the current logged in user information. Returns `null` if the user is not logged
+     * in or the logged in user has deleted himself.
+     */
+    getCurrentUser(): User | null;
     /**
      * Get the list of server indentity providers.
      *
@@ -111,32 +118,45 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
      * @async
      */
     getIdentityProviders(): Promise<any>;
-    private setCurrentUser;
-    private clearCurrentUser;
     /**
-     * Returns the current logged in user information. Returns `null` if the user is not logged
-     * in or the logged in user has deleted himself.
+     * Returns the current server settings.
+     *
+     * @async
      */
-    getCurrentUser(): User | null;
+    getServerSettings(): Promise<any>;
     /**
-     * Returns a list of server users. Only admins can get a list of users, if the current logged
-     * in user does not have administrator rights, an exception will be thrown.
+     * Change server settings.
+     *
+     * Only admins can change server settings, if the current logged in user does not have
+     * administrator rights, an exception will be thrown.
+     *
+     * @async
+     */
+    updateServerSettings(settings: any): Promise<any>;
+    /**
+     * Returns a list of server users.
+     *
+     * Only admins can get a list of users, if the current logged in user does not have
+     * administrator rights, an exception will be thrown.
      *
      * @async
      */
     getUsers(): Promise<User[]>;
     /**
-     * Returns the user information. Only admins can get other users, if the current logged in
-     * user does not have administrator rights, hi can only get himself, otherwise an exception
-     * will be thrown.
+     * Returns the user information.
+     *
+     * Only admins can get other users, if the current logged in user does not have administrator
+     * rights, hi can only get himself, otherwise an exception will be thrown.
      *
      * @async
      * @param userId - User ID.
      */
     getUser(userId: string): Promise<User>;
     /**
-     * Create a new user. Only admins can create users, if the current logged in user does not
-     * have administrator rights, an exception will be thrown.
+     * Create a new user.
+     *
+     * Only admins can create users, if the current logged in user does not have administrator
+     * rights, an exception will be thrown.
      *
      * @async
      * @param email - User email. Cannot be empty.
@@ -150,7 +170,7 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
      * @param params.lastName - Last name.
      * @param params.canCreateProject - `true` if user is allowed to create a project.
      * @param params.projectsLimit - The maximum number of projects that the user can create.
-     * @param params.storageLimit - The size of the file storage available to the user.
+     * @param params.storageLimit - The size of the file storage available to the user in bytes.
      */
     createUser(email: string, password: string, params?: {
         isAdmin?: boolean;
@@ -162,8 +182,10 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
         storageLimit?: number;
     }): Promise<User>;
     /**
-     * Delete a user from the server. Only admins can delete users, if the current logged in user
-     * does not have administrator rights, an exception will be thrown.
+     * Delete a user from the server.
+     *
+     * Only admins can delete users, if the current logged in user does not have administrator
+     * rights, an exception will be thrown.
      *
      * Admins can delete themselves or other admins. An admin can only delete himself if he is
      * not the last administrator.

package/lib/Api/Job.d.ts

@@ -67,7 +67,7 @@ export declare class Job {
     get lastUpdate(): string;
     /**
      * Job type. Can be `properties`, `geomerty`, `geomertyGltf`, `validation`, `clash`, `dwg`,
-     * `obj`, `gltf`, `glb`, `vsf`, `pdf` or `3dpdf`.
+     * `obj`, `gltf`, `glb`, `vsf`, `pdf`, `3dpdf` or custom job name.
      *
      * @readonly
      */
@@ -104,7 +104,10 @@ export declare class Job {
      */
     checkout(): Promise<this>;
     /**
-     * Update job data on the server. Only admins can update job data.
+     * Update job data on the server.
+     *
+     * Only admins can update job data, if the current logged in user does not have administrator
+     * rights, an exception will be thrown.
      *
      * @async
      * @param data - Raw job data.

package/lib/Api/Model.d.ts

@@ -1,6 +1,6 @@
 import { IHttpClient } from "./IHttpClient";
-import { File } from "./File";
-import { Assembly } from "./Assembly";
+import type { File } from "./File";
+import type { Assembly } from "./Assembly";
 /**
  * The class representing the is a description of view of the file or assembly. For example,
  * for `dwg` it is a `Model` space or layout, and for `rvt` files it is a `3D` view.
@@ -103,16 +103,12 @@ export declare class Model {
     /**
      * Returns model viewpoint list.
      *
-     * _**Note**: Assemblу models do not support viewpoints_.
-     *
      * @async
      */
     getViewpoints(): Promise<any[]>;
     /**
      * Add new model viewpoint. To create a new viewpoint use `Viewer.createViewpoint()`.
      *
-     * _**Note**: Assemblу models do not support viewpoints_.
-     *
      * @async
      * @param viewpoint - Viewpoint.
      */
@@ -120,8 +116,6 @@ export declare class Model {
     /**
      * Delete model viewpoint.
      *
-     * _**Note**: Assemblу models do not support viewpoints_.
-     *
      * @async
      * @param guid - Viewpoint GUID.
      * @returns Returns the raw data of a deleted viewpoint.

package/lib/Api/User.d.ts

@@ -23,8 +23,8 @@ export declare class User {
      */
     get canCreateProject(): boolean;
     /**
-     * User account registration time (UTC) in the format specified in <a
-     * href="https://www.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a>.
+     * Account registration time (UTC) in the format specified in
+     * {@link https://www.wikipedia.org/wiki/ISO_8601 | ISO 8601}.
      *
      * @readonly
      */
@@ -85,8 +85,8 @@ export declare class User {
      */
     get isEmailConfirmed(): boolean;
     /**
-     * User last update time (UTC) in the format specified in <a
-     * href="https://www.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a>.
+     * User last update time (UTC) in the format specified in
+     * {@link https://www.wikipedia.org/wiki/ISO_8601 | ISO 8601}.
      */
     get lastModified(): string;
     /**
@@ -95,8 +95,8 @@ export declare class User {
     get lastName(): string;
     set lastName(value: string);
     /**
-     * User last sign in time (UTC) in the format specified in <a
-     * href="https://www.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a>.
+     * User last sign in time (UTC) in the format specified in
+     * {@link https://www.wikipedia.org/wiki/ISO_8601 | ISO 8601}.
      */
     get lastSignIn(): string;
     /**
@@ -105,6 +105,10 @@ export declare class User {
      * @readonly
      */
     get projectsLimit(): number;
+    /**
+     * The identity provider used to create the account. Can be `ldap`, `oauth`, `saml` or empty.
+     */
+    get providerType(): string;
     /**
      * The user's access token (API key). Use {@link Client.signInWithToken()} to log in using token.
      *
@@ -117,23 +121,27 @@ export declare class User {
     get userName(): string;
     set userName(value: string);
     /**
-     * Refresh user data. Only admins can checkout other users, if the current logged in user
-     * does not have administrator rights, hi can only checkout himself, otherwise an exception
-     * will be thrown.
+     * Refresh user data.
+     *
+     * Only admins can checkout other users, if the current logged in user does not have
+     * administrator rights, hi can only checkout himself, otherwise an exception will be thrown.
      */
     checkout(): Promise<this>;
     /**
-     * Update user data on the server. Only admins can update other users, if the current logged
-     * in user does not have administrator rights, hi can only update himself, otherwise an
-     * exception will be thrown.
+     * Update user data on the server.
+     *
+     * Only admins can update other users, if the current logged in user does not have
+     * administrator rights, hi can only update himself, otherwise an exception will be thrown.
      *
      * @async
      * @param data - Raw user data.
      */
     update(data: any): Promise<this>;
     /**
-     * Delete a user from the server. Only admins can delete users, if the current logged in user
-     * does not have administrator rights, an exception will be thrown.
+     * Delete a user from the server.
+     *
+     * Only admins can delete users, if the current logged in user does not have administrator
+     * rights, an exception will be thrown.
      *
      * Admins can delete themselves or other admins. An admin can only delete himself if he is
      * not the last administrator.
@@ -152,9 +160,10 @@ export declare class User {
      */
     save(): Promise<this>;
     /**
-     * Set or remove the user avatar. Only admins can set the avatar of other users, if the
-     * current logged in user does not have administrator rights, he can only set his own avatar,
-     * otherwise an exception will be thrown.
+     * Set or remove the user avatar.
+     *
+     * Only admins can set the avatar of other users, if the current logged in user does not have
+     * administrator rights, he can only set his own avatar, otherwise an exception will be thrown.
      *
      * @async
      * @param image - Avatar image. Can be a <a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inweb/client",
-  "version": "25.4.7",
+  "version": "25.4.10",
   "description": "JavaScript REST API client for the Open Cloud Server",
   "homepage": "https://cloud.opendesign.com/docs/index.html",
   "license": "SEE LICENSE IN LICENSE",
@@ -26,6 +26,6 @@
     "ts-docs": "typedoc"
   },
   "dependencies": {
-    "@inweb/eventemitter2": "~25.4.7"
+    "@inweb/eventemitter2": "~25.4.10"
   }
 }

package/src/Api/Client.ts

@@ -217,21 +217,6 @@ export class Client extends EventEmitter2<ClientEventMap> {
     return this.setCurrentUser(data);
   }
 
-  /**
-   * Get the list of server indentity providers.
-   *
-   * To sign in with the provider in your web application:
-   *
-   * - Open the `provider.url` link using `window.open()`.
-   * - Add a `/oauth` path (server-defined) handler to the router. In this handler, show an error
-   *   message if the `error` search parameter is present, or log in with the `token` search parameter.
-   *
-   * @async
-   */
-  getIdentityProviders(): Promise<any> {
-    return this.httpClient.get("/identity").then((response) => response.json());
-  }
-
   // Save the current logged in user information for internal use.
 
   private setCurrentUser(data: any): User {
@@ -257,8 +242,46 @@ export class Client extends EventEmitter2<ClientEventMap> {
   }
 
   /**
-   * Returns a list of server users. Only admins can get a list of users, if the current logged
-   * in user does not have administrator rights, an exception will be thrown.
+   * Get the list of server indentity providers.
+   *
+   * To sign in with the provider in your web application:
+   *
+   * - Open the `provider.url` link using `window.open()`.
+   * - Add a `/oauth` path (server-defined) handler to the router. In this handler, show an error
+   *   message if the `error` search parameter is present, or log in with the `token` search parameter.
+   *
+   * @async
+   */
+  getIdentityProviders(): Promise<any> {
+    return this.httpClient.get("/identity").then((response) => response.json());
+  }
+
+  /**
+   * Returns the current server settings.
+   *
+   * @async
+   */
+  getServerSettings(): Promise<any> {
+    return this.httpClient.get("/settings").then((response) => response.json());
+  }
+
+  /**
+   * Change server settings.
+   *
+   * Only admins can change server settings, if the current logged in user does not have
+   * administrator rights, an exception will be thrown.
+   *
+   * @async
+   */
+  updateServerSettings(settings: any): Promise<any> {
+    return this.httpClient.put("/settings", settings).then((response) => response.json());
+  }
+
+  /**
+   * Returns a list of server users.
+   *
+   * Only admins can get a list of users, if the current logged in user does not have
+   * administrator rights, an exception will be thrown.
    *
    * @async
    */
@@ -271,9 +294,10 @@ export class Client extends EventEmitter2<ClientEventMap> {
   }
 
   /**
-   * Returns the user information. Only admins can get other users, if the current logged in
-   * user does not have administrator rights, hi can only get himself, otherwise an exception
-   * will be thrown.
+   * Returns the user information.
+   *
+   * Only admins can get other users, if the current logged in user does not have administrator
+   * rights, hi can only get himself, otherwise an exception will be thrown.
    *
    * @async
    * @param userId - User ID.
@@ -295,8 +319,10 @@ export class Client extends EventEmitter2<ClientEventMap> {
   }
 
   /**
-   * Create a new user. Only admins can create users, if the current logged in user does not
-   * have administrator rights, an exception will be thrown.
+   * Create a new user.
+   *
+   * Only admins can create users, if the current logged in user does not have administrator
+   * rights, an exception will be thrown.
    *
    * @async
    * @param email - User email. Cannot be empty.
@@ -310,7 +336,7 @@ export class Client extends EventEmitter2<ClientEventMap> {
    * @param params.lastName - Last name.
    * @param params.canCreateProject - `true` if user is allowed to create a project.
    * @param params.projectsLimit - The maximum number of projects that the user can create.
-   * @param params.storageLimit - The size of the file storage available to the user.
+   * @param params.storageLimit - The size of the file storage available to the user in bytes.
    */
   createUser(
     email: string,
@@ -342,8 +368,10 @@ export class Client extends EventEmitter2<ClientEventMap> {
   }
 
   /**
-   * Delete a user from the server. Only admins can delete users, if the current logged in user
-   * does not have administrator rights, an exception will be thrown.
+   * Delete a user from the server.
+   *
+   * Only admins can delete users, if the current logged in user does not have administrator
+   * rights, an exception will be thrown.
    *
    * Admins can delete themselves or other admins. An admin can only delete himself if he is
    * not the last administrator.

package/src/Api/FetchError.ts

@@ -118,6 +118,7 @@ export class FetchError extends Error {
    */
   constructor(status: number, message?: string) {
     super(message || statusText(status));
+    this.name = "FetchError";
     this.status = status;
     this.statusText = statusText(status);
   }

package/src/Api/Job.ts

@@ -133,7 +133,7 @@ export class Job {
 
   /**
    * Job type. Can be `properties`, `geomerty`, `geomertyGltf`, `validation`, `clash`, `dwg`,
-   * `obj`, `gltf`, `glb`, `vsf`, `pdf` or `3dpdf`.
+   * `obj`, `gltf`, `glb`, `vsf`, `pdf`, `3dpdf` or custom job name.
    *
    * @readonly
    */
@@ -190,7 +190,10 @@ export class Job {
   }
 
   /**
-   * Update job data on the server. Only admins can update job data.
+   * Update job data on the server.
+   *
+   * Only admins can update job data, if the current logged in user does not have administrator
+   * rights, an exception will be thrown.
    *
    * @async
    * @param data - Raw job data.

package/src/Api/Model.ts

@@ -22,8 +22,8 @@
 ///////////////////////////////////////////////////////////////////////////////
 
 import { IHttpClient } from "./IHttpClient";
-import { File } from "./File";
-import { Assembly } from "./Assembly";
+import type { File } from "./File";
+import type { Assembly } from "./Assembly";
 
 /**
  * The class representing the is a description of view of the file or assembly. For example,
@@ -180,8 +180,6 @@ export class Model {
   /**
    * Returns model viewpoint list.
    *
-   * _**Note**: Assemblу models do not support viewpoints_.
-   *
    * @async
    */
   getViewpoints(): Promise<any[]> {
@@ -197,8 +195,6 @@ export class Model {
   /**
    * Add new model viewpoint. To create a new viewpoint use `Viewer.createViewpoint()`.
    *
-   * _**Note**: Assemblу models do not support viewpoints_.
-   *
    * @async
    * @param viewpoint - Viewpoint.
    */
@@ -212,8 +208,6 @@ export class Model {
   /**
    * Delete model viewpoint.
    *
-   * _**Note**: Assemblу models do not support viewpoints_.
-   *
    * @async
    * @param guid - Viewpoint GUID.
    * @returns Returns the raw data of a deleted viewpoint.

package/src/Api/User.ts

@@ -59,8 +59,8 @@ export class User {
   }
 
   /**
-   * User account registration time (UTC) in the format specified in <a
-   * href="https://www.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a>.
+   * Account registration time (UTC) in the format specified in
+   * {@link https://www.wikipedia.org/wiki/ISO_8601 | ISO 8601}.
    *
    * @readonly
    */
@@ -167,8 +167,8 @@ export class User {
   }
 
   /**
-   * User last update time (UTC) in the format specified in <a
-   * href="https://www.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a>.
+   * User last update time (UTC) in the format specified in
+   * {@link https://www.wikipedia.org/wiki/ISO_8601 | ISO 8601}.
    */
   get lastModified(): string {
     return this.data.lastModified;
@@ -186,8 +186,8 @@ export class User {
   }
 
   /**
-   * User last sign in time (UTC) in the format specified in <a
-   * href="https://www.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a>.
+   * User last sign in time (UTC) in the format specified in
+   * {@link https://www.wikipedia.org/wiki/ISO_8601 | ISO 8601}.
    */
   get lastSignIn(): string {
     return this.data.lastSignIn;
@@ -202,6 +202,13 @@ export class User {
     return this.data.projectsLimit;
   }
 
+  /**
+   * The identity provider used to create the account. Can be `ldap`, `oauth`, `saml` or empty.
+   */
+  get providerType(): string {
+    return this.data.providerType;
+  }
+
   /**
    * The user's access token (API key). Use {@link Client.signInWithToken()} to log in using token.
    *
@@ -223,9 +230,10 @@ export class User {
   }
 
   /**
-   * Refresh user data. Only admins can checkout other users, if the current logged in user
-   * does not have administrator rights, hi can only checkout himself, otherwise an exception
-   * will be thrown.
+   * Refresh user data.
+   *
+   * Only admins can checkout other users, if the current logged in user does not have
+   * administrator rights, hi can only checkout himself, otherwise an exception will be thrown.
    */
   async checkout(): Promise<this> {
     if (this.id === this.httpClient.signInUserId) {
@@ -241,9 +249,10 @@ export class User {
   }
 
   /**
-   * Update user data on the server. Only admins can update other users, if the current logged
-   * in user does not have administrator rights, hi can only update himself, otherwise an
-   * exception will be thrown.
+   * Update user data on the server.
+   *
+   * Only admins can update other users, if the current logged in user does not have
+   * administrator rights, hi can only update himself, otherwise an exception will be thrown.
    *
    * @async
    * @param data - Raw user data.
@@ -262,8 +271,10 @@ export class User {
   }
 
   /**
-   * Delete a user from the server. Only admins can delete users, if the current logged in user
-   * does not have administrator rights, an exception will be thrown.
+   * Delete a user from the server.
+   *
+   * Only admins can delete users, if the current logged in user does not have administrator
+   * rights, an exception will be thrown.
    *
    * Admins can delete themselves or other admins. An admin can only delete himself if he is
    * not the last administrator.
@@ -297,9 +308,10 @@ export class User {
   }
 
   /**
-   * Set or remove the user avatar. Only admins can set the avatar of other users, if the
-   * current logged in user does not have administrator rights, he can only set his own avatar,
-   * otherwise an exception will be thrown.
+   * Set or remove the user avatar.
+   *
+   * Only admins can set the avatar of other users, if the current logged in user does not have
+   * administrator rights, he can only set his own avatar, otherwise an exception will be thrown.
    *
    * @async
    * @param image - Avatar image. Can be a <a