@inweb/client 25.6.2 → 25.6.3

package/dist/client.js

@@ -1836,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.
@@ -3514,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;
@@ -3584,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) {
@@ -3606,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.
@@ -3631,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.
          *
@@ -3672,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
@@ -3706,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
          */
@@ -3728,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;
+        }
     }
 
     ///////////////////////////////////////////////////////////////////////////////
@@ -3829,7 +3858,7 @@
                 .then((data) => ({
                 ...data,
                 server: data.version,
-                client: "25.6.2",
+                client: "25.6.3",
             }));
         }
         /**
@@ -3949,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
          */
@@ -3960,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
          */
@@ -3975,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.
@@ -4003,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.
@@ -4039,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.
          *
@@ -4554,7 +4583,7 @@
     }
 
     ///////////////////////////////////////////////////////////////////////////////
-    const version = "25.6.2";
+    const version = "25.6.3";
 
     exports.Assembly = Assembly;
     exports.ClashTest = ClashTest;