@inweb/client 25.6.1 → 25.6.3

package/dist/client.js

@@ -928,6 +928,10 @@
             console.warn("Assembly does not support preview");
             return Promise.resolve(this);
         }
+        deletePreview() {
+            console.warn("Assembly does not support preview");
+            return Promise.resolve(this);
+        }
         /**
          * Returns list of assembly models.
          *
@@ -1832,8 +1836,8 @@
         /**
          * 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.
+         * Only administrators can update job data, if the current logged in user is not an
+         * administrator, an exception will be thrown.
          *
          * @async
          * @param data - Raw job data.
@@ -2056,7 +2060,7 @@
             return this.data.owner;
         }
         /**
-         * File preview image URL. Use {@link File#setPreview | setPreview()} to change preview image.
+         * File preview image URL. Use {@link File.setPreview | setPreview()} to change preview image.
          *
          * @readonly
          */
@@ -2187,17 +2191,31 @@
          * Set or remove the file preview.
          *
          * @async
-         * @param image - Preview image. Can be a <a
-         *   href="https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs"
-         *   target="_blank">Data URL</a> string, <a
-         *   href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer"
-         *   target="_blank">ArrayBuffer</a>, <a
-         *   href="https://developer.mozilla.org/docs/Web/API/Blob/Blob" target="_blank">Blob</a> or
-         *   Web API <a href="https://developer.mozilla.org/docs/Web/API/File"
-         *   target="_blank">File</a> object. Setting the `image` to `null` will remove the preview.
+         * @param image - Preview image.Can be a
+         *   {@link https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs | Data URL}
+         *   string,
+         *   {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer | ArrayBuffer},
+         *   {@link https://developer.mozilla.org/docs/Web/API/Blob/Blob | Blob} or Web API
+         *   {@link https://developer.mozilla.org/docs/Web/API/File | File} object. Setting the
+         *   `image` to `null` will remove the preview.
          */
         async setPreview(image) {
-            const response = await (image ? this.internalPost("/preview", image) : this.internalDelete("/preview"));
+            if (!image) {
+                await this.deletePreview();
+            }
+            else {
+                const response = await this.internalPost("/preview", image);
+                this.data = await response.json();
+            }
+            return this;
+        }
+        /**
+         * Remove the file preview.
+         *
+         * @async
+         */
+        async deletePreview() {
+            const response = await this.internalDelete("/preview");
             this.data = await response.json();
             return this;
         }
@@ -3108,7 +3126,7 @@
             return this.data.owner;
         }
         /**
-         * Project preview image URL. Use [setPreview()]{@link Project#setPreview} to change preview image.
+         * Project preview image URL. Use {@link Project.setPreview | setPreview()} to change preview image.
          *
          * @readonly
          */
@@ -3204,17 +3222,31 @@
          * Set or remove the project preview.
          *
          * @async
-         * @param image - Preview image. Can be a <a
-         *   href="https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs"
-         *   target="_blank">Data URL</a> string, <a
-         *   href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer"
-         *   target="_blank">ArrayBuffer</a>, <a
-         *   href="https://developer.mozilla.org/docs/Web/API/Blob/Blob" target="_blank">Blob</a> or
-         *   Web API <a href="https://developer.mozilla.org/docs/Web/API/File"
-         *   target="_blank">File</a> object. Setting the `image` to `null` will remove the preview.
+         * @param image - Preview image. Can be a
+         *   {@link https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs | Data URL}
+         *   string,
+         *   {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer | ArrayBuffer},
+         *   {@link https://developer.mozilla.org/docs/Web/API/Blob/Blob | Blob} or Web API
+         *   {@link https://developer.mozilla.org/docs/Web/API/File | File} object. Setting the
+         *   `image` to `null` will remove the preview.
          */
         async setPreview(image) {
-            const response = await (image ? this.internalPost("/preview", image) : this.internalDelete("/preview"));
+            if (!image) {
+                await this.deletePreview();
+            }
+            else {
+                const response = await this.internalPost("/preview", image);
+                this.data = await response.json();
+            }
+            return this;
+        }
+        /**
+         * Remove the project preview.
+         *
+         * @async
+         */
+        async deletePreview() {
+            const response = await this.internalDelete("/preview");
             this.data = await response.json();
             return this;
         }
@@ -3387,7 +3419,7 @@
             this.data = data;
         }
         /**
-         * User avatar image URL. Use {@link User#setAvatar | setAvatar()} to change avatar image.
+         * User avatar image URL. Use {@link User.setAvatar | setAvatar()} to change avatar image.
          *
          * @readonly
          */
@@ -3482,7 +3514,7 @@
             return this.data.initials;
         }
         /**
-         * `true` if user is has an administrator rights.
+         * `true` if user is an administrator.
          */
         get isAdmin() {
             return this.data.isAdmin;
@@ -3552,8 +3584,8 @@
         /**
          * 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.
+         * Only administrators can checkout other users, if the current logged in user is not an
+         * administrator, they can only checkout themselves, otherwise an exception will be thrown.
          */
         async checkout() {
             if (this.httpClient.signInUserIsAdmin) {
@@ -3574,8 +3606,8 @@
         /**
          * 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.
+         * Only administrators can update other users, if the current logged in user is not an
+         * administrator, they can only update themself, otherwise an exception will be thrown.
          *
          * @async
          * @param data - Raw user data.
@@ -3599,11 +3631,11 @@
         /**
          * 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.
+         * Only administrators can delete users, if the current logged in user is not an
+         * administrator, 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.
+         * Administrators can delete themselves or other administrators. An administrator can only
+         * delete themself if they is not the last administrator.
          *
          * You need to re-login to continue working after deleting the current logged in user.
          *
@@ -3640,8 +3672,8 @@
         /**
          * 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.
+         * Only administrators can set the avatar of other users, if the current logged in user is
+         * not an administrator, they can only set their avatar, otherwise an exception will be thrown.
          *
          * @async
          * @param image - Avatar image. Can be a
@@ -3674,9 +3706,8 @@
         /**
          * Remove the user avatar.
          *
-         * Only admins can remove the avatar of other users, if the current logged in user does not
-         * have administrator rights, they can only remove their own avatar, otherwise an exception
-         * will be thrown.
+         * Only administrators can remove the avatar of other users, if the current logged in user is
+         * not an administrator, they can only remove their avatar, otherwise an exception will be thrown.
          *
          * @async
          */
@@ -3696,6 +3727,36 @@
             }
             return this;
         }
+        /**
+         * Change the user password.
+         *
+         * Only administrators can change the passwords of other users, if the current logged in user
+         * is not an administrator, they can only change their password, otherwise an exception will
+         * be thrown.
+         *
+         * To change their password, non-administrator users must provide their old password.
+         *
+         * @async
+         * @param newPassword - New user password.
+         * @param oldPassword - Old user password. Only required for non-administrator users to
+         *   change their password.
+         */
+        async changePassword(newPassword, oldPassword) {
+            if (this.httpClient.signInUserIsAdmin) {
+                const response = await this.httpClient.put(`/users/${this.id}/password`, { new: newPassword });
+                const data = await response.json();
+                this.data = { id: data.id, ...data.userBrief };
+            }
+            else if (this.id === this.httpClient.signInUserId) {
+                const response = await this.httpClient.put("/user/password", { old: oldPassword, new: newPassword });
+                const data = await response.json();
+                this.data = { id: this.id, ...data };
+            }
+            else {
+                return Promise.reject(new FetchError(403));
+            }
+            return this;
+        }
     }
 
     ///////////////////////////////////////////////////////////////////////////////
@@ -3797,7 +3858,7 @@
                 .then((data) => ({
                 ...data,
                 server: data.version,
-                client: "25.6.1",
+                client: "25.6.3",
             }));
         }
         /**
@@ -3917,8 +3978,8 @@
         /**
          * 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.
+         * Only administrators can change server settings, if the current logged in user is not an
+         * administrator, an exception will be thrown.
          *
          * @async
          */
@@ -3928,8 +3989,8 @@
         /**
          * 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.
+         * Only administrators can get a list of users, if the current logged in user is not an
+         * administrator, an exception will be thrown.
          *
          * @async
          */
@@ -3943,8 +4004,8 @@
         /**
          * 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.
+         * Only administrators can get other users, if the currently logged in user is not an
+         * administrator, they can only get themselves, otherwise an exception will be thrown.
          *
          * @async
          * @param userId - User ID.
@@ -3971,8 +4032,8 @@
         /**
          * 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.
+         * Only administrators can create users, if the current logged in user is not an
+         * administrator, an exception will be thrown.
          *
          * @async
          * @param email - User email. Cannot be empty.
@@ -4007,11 +4068,11 @@
         /**
          * 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.
+         * Only administrators can delete users, if the current logged in user is not an
+         * administrator, 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.
+         * Administrators can delete themselves or other administrators. An administrator can only
+         * delete themself if they is not the last administrator.
          *
          * You need to re-login to continue working after deleting the current logged in user.
          *
@@ -4486,17 +4547,14 @@
          * @param description - Project description.
          * @param startDate - Project start date.
          * @param endDate - Project end date.
-         * @param avatarUrl - Project preview image URL. Can be
-         *   {@link https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs | Data URL}.
          */
-        createProject(name, description, startDate, endDate, avatarUrl) {
+        createProject(name, description, startDate, endDate) {
             return this.httpClient
                 .post("/projects", {
                 name,
                 description,
                 startDate: startDate instanceof Date ? startDate.toISOString() : startDate,
                 endDate: endDate instanceof Date ? endDate.toISOString() : endDate,
-                avatarUrl,
             })
                 .then((response) => response.json())
                 .then((data) => new Project(data, this.httpClient));
@@ -4525,7 +4583,7 @@
     }
 
     ///////////////////////////////////////////////////////////////////////////////
-    const version = "25.6.1";
+    const version = "25.6.3";
 
     exports.Assembly = Assembly;
     exports.ClashTest = ClashTest;