@inweb/client 25.9.3 → 25.9.5

package/dist/client.js

@@ -511,7 +511,7 @@
         /**
          * @param data - Raw test data received from the server.
          * @param basePath - The clash test API base path of the file/assembly that owns the test.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, basePath, httpClient) {
             this.httpClient = httpClient;
@@ -592,14 +592,6 @@
         /**
          * Test owner information.
          *
-         * @property {string} userId - User ID.
-         * @property {string} userName - User name.
-         * @property {string} name - First name.
-         * @property {string} lastName - Last name.
-         * @property {string} fullName - Full name.
-         * @property {string} initials - Initials.
-         * @property {string} email - User email.
-         * @property {string} avatarUrl - User avatar image URL.
          * @readonly
          */
         get owner() {
@@ -751,13 +743,13 @@
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
     /**
-     * Provides properties and methods for obtaining information about an assembly on the server
-     * and managing its data.
+     * Provides properties and methods for obtaining information about an assembly on the Open
+     * Cloud Server and managing its data.
      */
     class Assembly {
         /**
          * @param data - Raw assembly data received from the server.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server..
          */
         constructor(data, httpClient) {
             this.path = `/assemblies/${data.id}`;
@@ -868,14 +860,6 @@
         /**
          * Assembly owner information.
          *
-         * @property {string} userId - User ID.
-         * @property {string} userName - User name.
-         * @property {string} name - First name.
-         * @property {string} lastName - Last name.
-         * @property {string} fullName - Full name.
-         * @property {string} initials - Initials.
-         * @property {string} email - User email.
-         * @property {string} avatarUrl - User avatar image URL.
          * @readonly
          */
         get owner() {
@@ -1566,7 +1550,7 @@
                 },
             }));
         }
-        async downloadFileRange(relativePath, requestId, ranges, onProgress, signal) {
+        async downloadFileRange(relativePath, reserved, ranges, onProgress, signal) {
             const headers = { ...this.headers };
             headers["Range"] = "bytes=" + ranges.map((x) => `${x.begin}-${x.end}`).join(",");
             const response = await $fetch(`${this.serverUrl}${relativePath}`, { method: "GET", headers, signal });
@@ -1643,7 +1627,7 @@
         /**
          * @param data - Raw permission data received from the server.
          * @param fileId - Owner file ID.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, fileId, httpClient) {
             this.httpClient = httpClient;
@@ -1694,19 +1678,7 @@
             return this.data.id;
         }
         /**
-         * Principials are any entity that can be authenticated by the server, such as a any user or
-         * project that will get access to the file.
-         *
-         * @typedef {any} Principial
-         * @property {any} user - The user entry that get access to the file.
-         * @property {string} user.id - User ID.
-         * @property {string} user.name - User name.
-         * @property {any} project - The project entry that get access to the file.
-         * @property {string} project.id - Project ID.
-         * @property {string} project.name - Project name.
-         */
-        /**
-         * A list of principials that will get access to the file.
+         * A list of entities that will get access to the file.
          */
         get grantedTo() {
             return this.data.grantedTo;
@@ -1734,6 +1706,17 @@
         /**
          * Updates permission data on the server.
          *
+         * @example <caption>Update file permissions for the the specified project.</caption>
+         *   const myFile = client.getFile(myFileId);
+         *   const permissions = await myFile.getPermissions();
+         *   const projectPermissions = permissions.filter((permission) =>
+         *     permission.grantedTo.some((x) => x.project?.id === myProjectId)
+         *   );
+         *   const newActions = ["read", "readSourceFile", "update"];
+         *   await Promise.allSettled(
+         *     projectPermissions.map((permission) => permission.update({ newActions }))
+         *   );
+         *
          * @param data - Raw permission data.
          */
         async update(data) {
@@ -1781,12 +1764,12 @@
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
     /**
-     * Provides properties and methods for obtaining information about a job on the server.
+     * Provides properties and methods for obtaining information about a job on the Open Cloud Server.
      */
     class Job {
         /**
          * @param data - Raw job data received from the server.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, httpClient) {
             this.httpClient = httpClient;
@@ -1996,13 +1979,13 @@
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
     /**
-     * Provides properties and methods for obtaining information about a file on the server and
-     * managing its data and versions.
+     * Provides properties and methods for obtaining information about a file on the Open Cloud
+     * Server and managing its data and versions.
      */
     class File {
         /**
          * @param data - Raw file data received from the server.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, httpClient) {
             this.path = `/files/${data.id}`;
@@ -2166,14 +2149,6 @@
         /**
          * File owner information.
          *
-         * @property {string} userId - User ID.
-         * @property {string} userName - User name.
-         * @property {string} name - First name.
-         * @property {string} lastName - Last name.
-         * @property {string} fullName - Full name.
-         * @property {string} initials - Initials.
-         * @property {string} email - User email.
-         * @property {string} avatarUrl - User avatar image URL.
          * @readonly
          */
         get owner() {
@@ -2242,14 +2217,6 @@
         /**
          * Information about the user who made the last update.
          *
-         * @property {string} userId - User ID.
-         * @property {string} userName - User name.
-         * @property {string} name - First name.
-         * @property {string} lastName - Last name.
-         * @property {string} fullName - Full name.
-         * @property {string} initials - Initials.
-         * @property {string} email - User email.
-         * @property {string} avatarUrl - User avatar image URL.
          * @readonly
          */
         get updatedBy() {
@@ -2677,7 +2644,17 @@
                 .then((data) => new Permission(data, this.id, this.httpClient));
         }
         /**
-         * Creates a new file permission.
+         * Creates a new file permission for a user, project, or group.
+         *
+         * @example <caption>Grant the specified user permission to "update" the file.</caption>
+         *   const action = "update";
+         *   const grantedTo = [{ user: { id: myUser.id, email: myUser.email } }];
+         *   await file.createPermission(action, grantedTo);
+         *
+         * @example <caption>Add a file to the specified project in `read-only` mode.</caption>
+         *   const actions = ["read", "readSourceFile"];
+         *   const grantedTo = [{ project: { id: myProject.id, name: myProject.name } }];
+         *   await file.createPermission(actions, grantedTo);
          *
          * @param actions - Actions are allowed to be performed on a file with this permission:
          *
@@ -2687,7 +2664,7 @@
          *   - `readViewpoint` - The ability to read file viewpoints.
          *   - `createViewpoint` - The ability to create file viewpoints.
          *
-         * @param grantedTo - A list of principials that will get access to the file.
+         * @param grantedTo - A list of entities that will get access to the file.
          * @param _public - Specifies whether all users have access to the file or not.
          */
         createPermission(actions, grantedTo, _public) {
@@ -2868,7 +2845,7 @@
         /**
          * @param data - Raw role data received from the server.
          * @param projectId - Owner project ID.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, projectId, httpClient) {
             this.httpClient = httpClient;
@@ -2915,20 +2892,6 @@
         }
         /**
          * Role actions are allowed to be performed.
-         *
-         * @property {string[]} projectActions - Actions are allowed to be performed at the project
-         *   level: `update`, `createTopic`, `createDocument`.
-         * @property {string[]} topicActions - Actions are allowed to be performed at the topic
-         *   level: `update`, `updateBimSnippet`, `updateRelatedTopics`, `updateDocumentReferences`,
-         *   `updateFiles`, `createComment`, `createViewpoint`, `delete`.
-         * @property {string[]} commentActions - Actions are allowed to be performed at the comment
-         *   level: `update`, `delete`.
-         * @property {string[]} viewpointActions - Actions are allowed to be performed at the
-         *   viewpoint level: `delete`.
-         * @property {string[]} odaGroupActions - Actions are allowed to be performed at the members
-         *   level: `update`, `delete`.
-         * @property {string[]} odaRoleActions - Actions are allowed to be performed at the roles
-         *   level: `update`, `delete`.
          */
         get permissions() {
             return this.data.permissions;
@@ -3001,7 +2964,7 @@
         /**
          * @param data - Raw member data received from the server.
          * @param projectId - Owner project ID.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, projectId, httpClient) {
             this.httpClient = httpClient;
@@ -3040,7 +3003,8 @@
             return this.data.id;
         }
         /**
-         * Member role. See {@link Project.getRoles | Project.getRoles()} for more details.
+         * Member role name in the project. See {@link Project.getRoles | Project.getRoles()} for list
+         * of project roles.
          */
         get role() {
             return this.data.role;
@@ -3059,14 +3023,6 @@
         /**
          * User information.
          *
-         * @property {string} userId - User ID.
-         * @property {string} userName - User name.
-         * @property {string} name - First name.
-         * @property {string} lastName - Last name.
-         * @property {string} fullName - Full name.
-         * @property {string} initials - Initials.
-         * @property {string} email - User email.
-         * @property {string} avatarUrl - User avatar image URL.
          * @readonly
          */
         get user() {
@@ -3130,13 +3086,13 @@
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
     /**
-     * Provides properties and methods for obtaining information about a project on the server and
-     * managing its {@link Role | roles}, {@link Member | members} and models.
+     * Provides properties and methods for obtaining information about a project on the Open Cloud
+     * Server and managing its {@link Role | roles}, {@link Member | members} and models.
      */
     class Project {
         /**
          * @param data - Raw project data received from the server.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, httpClient) {
             this.httpClient = httpClient;
@@ -3252,14 +3208,6 @@
         /**
          * Project owner information.
          *
-         * @property {string} userId - User ID.
-         * @property {string} userName - User name.
-         * @property {string} name - First name.
-         * @property {string} lastName - Last name.
-         * @property {string} fullName - Full name.
-         * @property {string} initials - Initials.
-         * @property {string} email - User email.
-         * @property {string} avatarUrl - User avatar image URL.
          * @readonly
          */
         get owner() {
@@ -3406,8 +3354,7 @@
          *
          * @param name - Role name.
          * @param description - Role description.
-         * @param permissions - Actions are allowed to be performed. See {@link Role.permissions} for
-         *   more details.
+         * @param permissions - Actions are allowed to be performed for the role.
          */
         createRole(name, description, permissions) {
             return this.internalPost("/roles", {
@@ -3446,10 +3393,10 @@
                 .then((data) => new Member(data, this.id, this.httpClient));
         }
         /**
-         * Add a user to the project to become a member and have permission to perform actions.
+         * Adds a user to the project to become a member and have permission to perform actions.
          *
          * @param userId - User ID.
-         * @param role - Role name from the list of project roles.
+         * @param role - Role name from the list of project {@link getRoles | roles}.
          */
         addMember(userId, role) {
             return this.internalPost("/members", { userId, role })
@@ -3457,7 +3404,7 @@
                 .then((data) => new Member(data, this.id, this.httpClient));
         }
         /**
-         * Remove the specified member from a project.
+         * Removes the specified member from a project.
          *
          * @param memberId - Member ID.
          * @returns Returns the raw data of a deleted member.
@@ -3478,8 +3425,11 @@
          * @property {string} file.reference - File ID.
          */
         /**
-         * Returns a list of project files. To add a file to this list, create a `project` permission
-         * on the file using {@link File.createPermission | File.createPermission()}.
+         * Returns a list of project files.
+         *
+         * This list contains all files that the project has access to. To add a file to this list,
+         * create a {@link IGrantedTo.project | project} permission on the file using
+         * {@link File.createPermission | File.createPermission()}.
          */
         getFilesInformation() {
             return this.httpClient
@@ -3523,6 +3473,63 @@
                 return items;
             });
         }
+        /**
+         * Returns a list of project models.
+         */
+        getModels() {
+            return this.getFilesInformation()
+                .then((filesInformation) => filesInformation.map((item) => item.file.reference))
+                .then((ids) => {
+                const searchParams = new URLSearchParams();
+                searchParams.set("id", ids.join("|"));
+                return this.httpClient.get(`/files?${searchParams.toString()}`);
+            })
+                .then((response) => response.json())
+                .then((files) => files.result.map((data) => new File(data, this.httpClient)));
+        }
+        /**
+         * Adds a file to the project with specified permissions.
+         *
+         * To change file permissions for the project use {@link Permission.update | Permissions.update()}.
+         *
+         * @param fileId - File ID.
+         * @param actions - Actions are allowed to be performed on a file:
+         *
+         *   - `read` - The ability to read file description, geometry data and properties.
+         *   - `readSourceFile` - The ability to read source file.
+         *   - `write` - The ability to modify file name, description and references.
+         *   - `readViewpoint` - The ability to read file viewpoints.
+         *   - `createViewpoint` - The ability to create file viewpoints.
+         *
+         * @param _public - Specifies whether all users have access to the file or not.
+         * @returns Returns a file instance added to the project.
+         */
+        async addModel(fileId, actions, _public) {
+            const file = await this.httpClient
+                .get(`/files/${fileId}`)
+                .then((response) => response.json())
+                .then((data) => new File(data, this.httpClient));
+            const grantedTo = [{ project: { id: this.id, name: this.name } }];
+            await file.createPermission(actions, grantedTo, _public);
+            return file;
+        }
+        /**
+         * Removes the specified file from a project.
+         *
+         * @param fileId - File ID.
+         * @returns Returns a file instance removed from the project.
+         */
+        async removeModel(fileId) {
+            const file = await this.httpClient
+                .get(`/files/${fileId}`)
+                .then((response) => response.json())
+                .then((data) => new File(data, this.httpClient));
+            const permissions = await file.getPermissions();
+            await Promise.allSettled(permissions
+                .filter((permission) => permission.grantedTo.some((x) => { var _a; return ((_a = x.project) === null || _a === void 0 ? void 0 : _a.id) === this.id; }))
+                .map((permission) => permission.delete()));
+            return file;
+        }
     }
 
     ///////////////////////////////////////////////////////////////////////////////
@@ -3548,12 +3555,13 @@
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
     /**
-     * Provides properties and methods for obtaining information about a server user and manage its data.
+     * Provides properties and methods for obtaining information about a Open Cloud Server user and
+     * manage its data.
      */
     class User {
         /**
          * @param data - Raw user data received from the server.
-         * @param httpClient - HTTP client instance used to send REST API requests to the server.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
          */
         constructor(data, httpClient) {
             this.httpClient = httpClient;
@@ -3957,7 +3965,8 @@
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
     /**
-     * Provides methods for managing server resources such as users, files, assemblies, jobs, projects, etc.
+     * Provides methods for managing Open Cloud Server resources such as users, files, assemblies,
+     * jobs, projects, etc.
      */
     class Client extends EventEmitter2 {
         /**
@@ -3974,7 +3983,7 @@
             this.configure(params);
         }
         /**
-         * Open Cloud Server REST API base URL. Use {@link configure | configure()} to change server URL.
+         * Open Cloud REST API server base URL. Use {@link configure | configure()} to change server URL.
          *
          * @readonly
          */
@@ -3982,7 +3991,7 @@
             return this._serverUrl;
         }
         /**
-         * HTTP client instance used to send REST API requests and receive responses from the server.
+         * HTTP client instance used to send requests to the REST API server.
          *
          * @readonly
          */
@@ -4062,7 +4071,7 @@
                 .then((data) => ({
                 ...data,
                 server: data.version,
-                client: "25.9.3",
+                client: "25.9.5",
             }));
         }
         /**
@@ -4777,7 +4786,7 @@
     // By use of this software, its documentation or related materials, you
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
-    const version = "25.9.3";
+    const version = "25.9.5";
 
     exports.Assembly = Assembly;
     exports.ClashTest = ClashTest;