@inweb/client 25.6.2 → 25.6.4

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.
@@ -1968,7 +1968,9 @@
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             var _m, _o, _p, _q, _r, _s, _t, _u;
             this._data = value;
-            this._data.previewUrl = value.preview ? `${this.httpClient.serverUrl}${this.path}/preview` : "";
+            this._data.previewUrl = value.preview
+                ? `${this.httpClient.serverUrl}${this.path}/preview?updated=${value.updatedAt}`
+                : "";
             // owner since 24.8
             if (typeof this._data.owner === "string")
                 this._data.owner = { userId: this._data.owner };
@@ -2060,7 +2062,8 @@
             return this.data.owner;
         }
         /**
-         * File preview image URL. Use {@link File.setPreview | setPreview()} to change preview image.
+         * File preview image URL or empty string if the file does not have a preview. Use
+         * {@link File.setPreview | setPreview()} to change preview image.
          *
          * @readonly
          */
@@ -3052,7 +3055,9 @@
         }
         set data(value) {
             this._data = value;
-            this._data.previewUrl = value.avatarUrl ? `${this.httpClient.serverUrl}/projects/${this._data.id}/preview` : "";
+            this._data.previewUrl = value.avatarUrl
+                ? `${this.httpClient.serverUrl}/projects/${this._data.id}/preview?updated=${value.updatedAt}`
+                : "";
             this._data.owner.avatarUrl = `${this.httpClient.serverUrl}/users/${this._data.owner.userId}/avatar`;
             this._data.owner.fullName = userFullName(this._data.owner);
             this._data.owner.initials = userInitials(this._data.owner.fullName);
@@ -3126,7 +3131,8 @@
             return this.data.owner;
         }
         /**
-         * Project preview image URL. Use {@link Project.setPreview | setPreview()} to change preview image.
+         * Project preview image URL or empty string if the project does not have a preview. Use
+         * {@link Project.setPreview | setPreview()} to change preview image.
          *
          * @readonly
          */
@@ -3419,7 +3425,8 @@
             this.data = data;
         }
         /**
-         * User avatar image URL. Use {@link User.setAvatar | setAvatar()} to change avatar image.
+         * User avatar image URL or empty string if the user does not have an avatar. Use
+         * {@link User.setAvatar | setAvatar()} to change avatar image.
          *
          * @readonly
          */
@@ -3462,7 +3469,9 @@
         }
         set data(value) {
             this._data = value;
-            this._data.avatarUrl = value.avatarImage ? `${this.httpClient.serverUrl}/users/${this._data.id}/avatar` : "";
+            this._data.avatarUrl = value.avatarImage
+                ? `${this.httpClient.serverUrl}/users/${this._data.id}/avatar?updated=${value.lastModified}`
+                : "";
             this._data.fullName = userFullName(this._data);
             this._data.initials = userInitials(this._data.fullName);
         }
@@ -3514,7 +3523,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 +3593,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 +3615,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 +3640,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 +3681,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 +3715,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 +3736,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 +3867,7 @@
                 .then((data) => ({
                 ...data,
                 server: data.version,
-                client: "25.6.2",
+                client: "25.6.4",
             }));
         }
         /**
@@ -3949,8 +3987,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 +3998,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 +4013,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 +4041,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 +4077,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 +4592,7 @@
     }
 
     ///////////////////////////////////////////////////////////////////////////////
-    const version = "25.6.2";
+    const version = "25.6.4";
 
     exports.Assembly = Assembly;
     exports.ClashTest = ClashTest;