@inweb/client 26.9.1 → 26.9.3

package/README.md

@@ -13,6 +13,7 @@ Core capabilities:
 - Create and manage assemblies.
 - Create projects, manage project models and members.
 - Change server settings.
+- Manage server plugins.
 
 This library is a part of [CDE SDK](https://www.opendesign.com/products/cde) by [Open Design Alliance](https://opendesign.com).
 
@@ -46,6 +47,7 @@ The `Client.js` package will be downloaded and installed. Then you're ready to i
 
 ```javascript
 import { Client } from "@inweb/client";
+
 const client = new Client({ serverUrl: "https://cloud.opendesign.com/api" });
 ```
 

package/dist/client.js

@@ -444,11 +444,11 @@
          * or geometry data.
          *
          * @param dataId - Resource file name.
+         * @param requestId - Specify a non-empty `requestId` to append the `?requestId=` search parameter to
+         *   the server request. If specified, server-side caching may not work.
          * @param ranges - A ranges of resource file contents to download. See
          *   {@link https://developer.mozilla.org/docs/Web/HTTP/Guides/Range_requests | HTTP range requests} for
          *   more details.
-         * @param requestId - Specify a non-empty `requestId` to append the `?requestId=` search parameter to
-         *   the server request. If specified, server-side caching may not work.
          * @param onProgress - Download progress callback.
          * @param signal - An
          *   {@link https://developer.mozilla.org/docs/Web/API/AbortController | AbortController} signal. Allows
@@ -545,9 +545,9 @@
         var _a, _b, _c;
         const timeout = params.timeout || 600000;
         const interval = params.interval || 3000;
-        const signal = (_a = params.signal) !== null && _a !== undefined ? _a : new AbortController().signal;
-        const abortError = (_b = params.abortError) !== null && _b !== undefined ? _b : new DOMException("Aborted", "AbortError");
-        const timeoutError = (_c = params.timeoutError) !== null && _c !== undefined ? _c : new DOMException("Timeout", "TimeoutError");
+        const signal = (_a = params.signal) !== null && _a !== void 0 ? _a : new AbortController().signal;
+        const abortError = (_b = params.abortError) !== null && _b !== void 0 ? _b : new DOMException("Aborted", "AbortError");
+        const timeoutError = (_c = params.timeoutError) !== null && _c !== void 0 ? _c : new DOMException("Timeout", "TimeoutError");
         const end = performance.now() + timeout;
         let count = timeout / interval;
         do {
@@ -578,9 +578,9 @@
     function userFullName(firstName, lastName = "", userName = "") {
         var _a;
         if (firstName && typeof firstName !== "string") {
-            return userFullName((_a = firstName.firstName) !== null && _a !== undefined ? _a : firstName.name, firstName.lastName, firstName.userName);
+            return userFullName((_a = firstName.firstName) !== null && _a !== void 0 ? _a : firstName.name, firstName.lastName, firstName.userName);
         }
-        return `${firstName !== null && firstName !== undefined ? firstName : ""} ${lastName !== null && lastName !== undefined ? lastName : ""}`.trim() || userName;
+        return `${firstName !== null && firstName !== void 0 ? firstName : ""} ${lastName !== null && lastName !== void 0 ? lastName : ""}`.trim() || userName;
     }
     function userInitials(fullName = "") {
         const names = fullName.split(" ").filter((x) => x);
@@ -812,7 +812,7 @@
             const checkDone = () => this.checkout().then((test) => {
                 var _a;
                 const ready = ["done", "failed"].includes(test.status);
-                const cancel = (_a = params === null || params === undefined ? undefined : params.onCheckout) === null || _a === undefined ? undefined : _a.call(params, test, ready);
+                const cancel = (_a = params === null || params === void 0 ? void 0 : params.onCheckout) === null || _a === void 0 ? void 0 : _a.call(params, test, ready);
                 return cancel || ready;
             });
             return waitFor(checkDone, params).then(() => this);
@@ -897,7 +897,7 @@
             this._data.owner.fullName = userFullName(this._data.owner);
             this._data.owner.initials = userInitials(this._data.owner.fullName);
             // associatedFiles since 23.12
-            (_a = (_b = this._data).associatedFiles) !== null && _a !== undefined ? _a : (_b.associatedFiles = []);
+            (_a = (_b = this._data).associatedFiles) !== null && _a !== void 0 ? _a : (_b.associatedFiles = []);
             this._data.associatedFiles.forEach((file) => (file.link = `${this.httpClient.serverUrl}/files/${file.fileId}`));
         }
         /**
@@ -1205,11 +1205,11 @@
          * descriptions, or geometry data.
          *
          * @param dataId - Resource file name.
+         * @param requestId - Specify a non-empty `requestId` to append the `?requestId=` search parameter to
+         *   the server request. If specified, server-side caching may not work.
          * @param ranges - A ranges of resource file contents to download. See
          *   {@link https://developer.mozilla.org/docs/Web/HTTP/Guides/Range_requests | HTTP range requests} for
          *   more details.
-         * @param requestId - Specify a non-empty `requestId` to append the `?requestId=` search parameter to
-         *   the server request. If specified, server-side caching may not work.
          * @param onProgress - Download progress callback.
          * @param signal - An
          *   {@link https://developer.mozilla.org/docs/Web/API/AbortController | AbortController} signal. Allows
@@ -1272,7 +1272,7 @@
             const checkDone = () => this.checkout().then((assembly) => {
                 var _a;
                 const ready = ["done", "failed"].includes(assembly.status);
-                const cancel = (_a = params === null || params === undefined ? undefined : params.onCheckout) === null || _a === undefined ? undefined : _a.call(params, assembly, ready);
+                const cancel = (_a = params === null || params === void 0 ? void 0 : params.onCheckout) === null || _a === void 0 ? void 0 : _a.call(params, assembly, ready);
                 return cancel || ready;
             });
             return waitFor(checkDone, params).then(() => this);
@@ -1372,7 +1372,7 @@
          *   can be used to abort waiting as desired.
          */
         createClashTest(name, selectionTypeA, selectionTypeB, selectionSetA, selectionSetB, params) {
-            const { tolerance, clearance, waitForDone } = params !== null && params !== undefined ? params : {};
+            const { tolerance, clearance, waitForDone } = params !== null && params !== void 0 ? params : {};
             if (!Array.isArray(selectionSetA))
                 selectionSetA = [selectionSetA];
             if (!Array.isArray(selectionSetB))
@@ -1441,7 +1441,7 @@
         }
         removeEventListener(type, listener) {
             if (this._listeners[type] === undefined) return this;
-            const listeners = this._listeners[type].filter((x => x !== listener));
+            const listeners = this._listeners[type].filter(x => x !== listener);
             if (listeners.length !== 0) this._listeners[type] = listeners; else delete this._listeners[type];
             return this;
         }
@@ -1452,7 +1452,7 @@
         emitEvent(event) {
             if (this._listeners[event.type] === undefined) return false;
             const invoke = this._listeners[event.type].slice();
-            invoke.forEach((listener => listener.call(this, event)));
+            invoke.forEach(listener => listener.call(this, event));
             return true;
         }
         on(type, listener) {
@@ -2100,7 +2100,7 @@
             const checkDone = () => this.checkout().then((job) => {
                 var _a;
                 const ready = ["done", "failed"].includes(job.status);
-                const cancel = (_a = params === null || params === undefined ? undefined : params.onCheckout) === null || _a === undefined ? undefined : _a.call(params, job, ready);
+                const cancel = (_a = params === null || params === void 0 ? void 0 : params.onCheckout) === null || _a === void 0 ? void 0 : _a.call(params, job, ready);
                 return cancel || ready;
             });
             return waitFor(checkDone, params).then(() => this);
@@ -2306,28 +2306,28 @@
             // owner since 24.8
             if (typeof this._data.owner === "string")
                 this._data.owner = { userId: this._data.owner };
-            (_a = (_p = this._data).owner) !== null && _a !== undefined ? _a : (_p.owner = {});
+            (_a = (_p = this._data).owner) !== null && _a !== void 0 ? _a : (_p.owner = {});
             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);
             // status since 24.9
-            (_b = (_q = this._data).status) !== null && _b !== undefined ? _b : (_q.status = {});
-            (_c = (_r = this._data.status).geometry) !== null && _c !== undefined ? _c : (_r.geometry = { state: (_d = this._data.geometryStatus) !== null && _d !== undefined ? _d : "none" });
-            (_e = (_s = this._data.status).properties) !== null && _e !== undefined ? _e : (_s.properties = { state: (_f = this._data.propertiesStatus) !== null && _f !== undefined ? _f : "none" });
-            (_g = (_t = this._data.status).validation) !== null && _g !== undefined ? _g : (_t.validation = { state: (_h = this._data.validationStatus) !== null && _h !== undefined ? _h : "none" });
+            (_b = (_q = this._data).status) !== null && _b !== void 0 ? _b : (_q.status = {});
+            (_c = (_r = this._data.status).geometry) !== null && _c !== void 0 ? _c : (_r.geometry = { state: (_d = this._data.geometryStatus) !== null && _d !== void 0 ? _d : "none" });
+            (_e = (_s = this._data.status).properties) !== null && _e !== void 0 ? _e : (_s.properties = { state: (_f = this._data.propertiesStatus) !== null && _f !== void 0 ? _f : "none" });
+            (_g = (_t = this._data.status).validation) !== null && _g !== void 0 ? _g : (_t.validation = { state: (_h = this._data.validationStatus) !== null && _h !== void 0 ? _h : "none" });
             // updatedBy since 24.10
-            (_j = (_u = this._data).updatedBy) !== null && _j !== undefined ? _j : (_u.updatedBy = {});
+            (_j = (_u = this._data).updatedBy) !== null && _j !== void 0 ? _j : (_u.updatedBy = {});
             this._data.updatedBy.avatarUrl = `${this.httpClient.serverUrl}/users/${this._data.updatedBy.userId}/avatar`;
             this._data.updatedBy.fullName = userFullName(this._data.updatedBy);
             this._data.updatedBy.initials = userInitials(this._data.updatedBy.fullName);
             // versions since 24.10
-            (_k = (_v = this._data).versions) !== null && _k !== undefined ? _k : (_v.versions = [{ ...value }]);
+            (_k = (_v = this._data).versions) !== null && _k !== void 0 ? _k : (_v.versions = [{ ...value }]);
             // geometryGltf status since 24.12
-            (_l = (_w = this._data.status).geometryGltf) !== null && _l !== undefined ? _l : (_w.geometryGltf = { state: "none" });
+            (_l = (_w = this._data.status).geometryGltf) !== null && _l !== void 0 ? _l : (_w.geometryGltf = { state: "none" });
             // isFileDeleted since 25.7
-            (_m = (_x = this._data).isFileDeleted) !== null && _m !== undefined ? _m : (_x.isFileDeleted = false);
+            (_m = (_x = this._data).isFileDeleted) !== null && _m !== void 0 ? _m : (_x.isFileDeleted = false);
             // sharedLinkToken since 26.0
-            (_o = (_y = this._data).sharedLinkToken) !== null && _o !== undefined ? _o : (_y.sharedLinkToken = null);
+            (_o = (_y = this._data).sharedLinkToken) !== null && _o !== void 0 ? _o : (_y.sharedLinkToken = null);
         }
         /**
          * Returns a list of file formats in which the active version of the file was exported.
@@ -2775,11 +2775,11 @@
          * contain model scene descriptions, or geometry data, or exported files.
          *
          * @param dataId - Resource file name.
+         * @param requestId - Specify a non-empty `requestId` to append the `?requestId=` search parameter to
+         *   the server request. If specified, server-side caching may not work.
          * @param ranges - A ranges of resource file contents to download. See
          *   {@link https://developer.mozilla.org/docs/Web/HTTP/Guides/Range_requests | HTTP range requests} for
          *   more details.
-         * @param requestId - Specify a non-empty `requestId` to append the `?requestId=` search parameter to
-         *   the server request. If specified, server-side caching may not work.
          * @param onProgress - Download progress callback.
          * @param signal - An
          *   {@link https://developer.mozilla.org/docs/Web/API/AbortController | AbortController} signal. Allows
@@ -2844,8 +2844,8 @@
          *       {@link downloadResource | downloadResource()} to download the exported file.
          *   - Other custom job name. Custom job must be registered in the job templates before running.
          *
-         * @param parameters - Parameters for the File Converter jobs or custom job. Can be given as command
-         *   line arguments in form `--arg=value`.
+         * @param parameters - Parameters for the File Converter jobs or custom job. Can be given as JSON
+         *   object or command line arguments in form `--arg=value`.
          */
         createJob(outputFormat, parameters) {
             const jobs = new Endpoint("/jobs", this.httpClient, this.headers);
@@ -2925,7 +2925,7 @@
                     return ["none", "done", "failed"].includes(jobStatus.state || "none");
                 });
                 const ready = waitAll ? readyJobs.length === waitJobs.length : readyJobs.length > 0;
-                const cancel = (_a = params === null || params === undefined ? undefined : params.onCheckout) === null || _a === undefined ? undefined : _a.call(params, file, ready);
+                const cancel = (_a = params === null || params === void 0 ? void 0 : params.onCheckout) === null || _a === void 0 ? void 0 : _a.call(params, file, ready);
                 return cancel || ready;
             });
             return waitFor(checkDone, params).then(() => this);
@@ -3022,7 +3022,7 @@
             waitForDone: false,
         }) {
             const result = await this.httpClient
-                .uploadFile(this.getEndpointPath("/versions"), file, (progress) => { var _a; return (_a = params.onProgress) === null || _a === undefined ? undefined : _a.call(params, progress, file); }, {
+                .uploadFile(this.getEndpointPath("/versions"), file, (progress) => { var _a; return (_a = params.onProgress) === null || _a === void 0 ? void 0 : _a.call(params, progress, file); }, {
                 headers: this.headers,
             })
                 .then((xhr) => JSON.parse(xhr.responseText))
@@ -3863,7 +3863,7 @@
                 .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 === undefined ? undefined : _a.id) === this.id; }))
+                .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;
         }
@@ -4501,6 +4501,221 @@
         }
     }
 
+    ///////////////////////////////////////////////////////////////////////////////
+    // Copyright (C) 2002-2025, Open Design Alliance (the "Alliance").
+    // All rights reserved.
+    //
+    // This software and its documentation and related materials are owned by
+    // the Alliance. The software may only be incorporated into application
+    // programs owned by members of the Alliance, subject to a signed
+    // Membership Agreement and Supplemental Software License Agreement with the
+    // Alliance. The structure and organization of this software are the valuable
+    // trade secrets of the Alliance and its suppliers. The software is also
+    // protected by copyright law and international treaty provisions. Application
+    // programs incorporating this software must include the following statement
+    // with their copyright notices:
+    //
+    //   This application incorporates Open Design Alliance software pursuant to a
+    //   license agreement with Open Design Alliance.
+    //   Open Design Alliance Copyright (C) 2002-2025 by Open Design Alliance.
+    //   All rights reserved.
+    //
+    // By use of this software, its documentation or related materials, you
+    // acknowledge and accept the above terms.
+    ///////////////////////////////////////////////////////////////////////////////
+    /**
+     * Provides properties and methods for obtaining information about a server plugin on the Open Cloud
+     * Server and managing its data.
+     */
+    class Plugin extends Endpoint {
+        /**
+         * @param data - Raw plugin data received from the server. For more information, see
+         *   {@link https://cloud.opendesign.com/docs//pages/server/api.html#Plugin | Open Cloud Plugins API}.
+         * @param httpClient - HTTP client instance used to send requests to the REST API server.
+         */
+        constructor(data, httpClient) {
+            super(`/plugins/${data.name}/${data.version}`, httpClient);
+            this.data = data;
+        }
+        /**
+         * Plugin author information. The `author` is an object with a `name` field and optionally `url` and
+         * `email`. Or it can be shorten that all into a single string.
+         *
+         * @readonly
+         */
+        get author() {
+            return this.data.author;
+        }
+        /**
+         * Raw plugin data received from the server. For more information, see
+         * {@link https://cloud.opendesign.com/docs//pages/server/api.html#Plugin | Open Cloud Plugins API}.
+         */
+        get data() {
+            return this._data;
+        }
+        set data(value) {
+            this._data = value;
+        }
+        /**
+         * Short description of the plugin.
+         *
+         * @readonly
+         */
+        get description() {
+            return this.data.description;
+        }
+        /**
+         * Plugin state.
+         *
+         * @readonly
+         */
+        get enabled() {
+            return this.data.enabled;
+        }
+        /**
+         * The URL to the plugin homepage.
+         *
+         * @readonly
+         */
+        get homepage() {
+            return this.data.homepage;
+        }
+        /**
+         * Unique plugin ID.
+         *
+         * @readonly
+         */
+        get id() {
+            return this.data.id;
+        }
+        /**
+         * A license for the plugin.
+         *
+         * @readonly
+         */
+        get license() {
+            return this.data.license;
+        }
+        /**
+         * Plugin name.
+         *
+         * @readonly
+         */
+        get name() {
+            return this.data.name;
+        }
+        /**
+         * API permissions required.
+         *
+         * @readonly
+         */
+        get permissions() {
+            return this.data.permissions;
+        }
+        /**
+         * Plugin type. Can be set of:
+         *
+         * - `app` - Viewer plugin, the client‑side web app that the server hosts and serves as static content.
+         * - `server` - Binary dll that extends server functionality.
+         * - `jobrunner` - Binary dll that adds a new Job Runner on the server.
+         *
+         * @readonly
+         */
+        get pluginType() {
+            return this.data.pluginType;
+        }
+        /**
+         * {@link https://semver.org/ | SemVer} compatible version of the plugin.
+         *
+         * @readonly
+         */
+        get version() {
+            return this.data.version;
+        }
+        /**
+         * Reloads plugin data from the server.
+         */
+        async checkout() {
+            const response = await this.get("");
+            this.data = await response.json();
+            return this;
+        }
+        /**
+         * Uninstalls and deletes a plugin from the server.
+         *
+         * @returns Returns the raw data of a deleted plugin. For more information, see
+         *   {@link https://cloud.opendesign.com/docs//pages/server/api.html#Plugin | Open Cloud Plugins API}.
+         */
+        delete() {
+            return super.delete("").then((response) => response.json());
+        }
+        /**
+         * Enables a plugin.
+         */
+        async enable() {
+            const response = await this.put("/enable");
+            this.data = await response.json();
+            return this;
+        }
+        /**
+         * Disables a plugin.
+         */
+        async disable() {
+            const response = await this.put("/disable");
+            this.data = await response.json();
+            return this;
+        }
+        /**
+         * Downloads the plugins package from the server.
+         *
+         * @param onProgress - Download progress callback.
+         * @param signal - An
+         *   {@link https://developer.mozilla.org/docs/Web/API/AbortController | AbortController} signal. Allows
+         *   to communicate with a fetch request and abort it if desired.
+         */
+        download(onProgress, signal) {
+            return this.httpClient
+                .downloadFile(this.getEndpointPath("/download"), onProgress, { signal, headers: this.headers })
+                .then((response) => response.arrayBuffer());
+        }
+        /**
+         * Returns a plugin manfest.
+         */
+        getManifest() {
+            return this.get("/manifest").then((response) => response.json());
+        }
+        /**
+         * Returns the plugin settings.
+         *
+         * @returns Returns an object with plugin settings.
+         */
+        getSettings() {
+            return this.get("/settings").then((response) => response.json());
+        }
+        /**
+         * Changes the plugin settings.
+         *
+         * @param settings - An object with the new plugin settings or part of the settings.
+         * @returns Returns an object with updated plugin settings.
+         */
+        updateSettings(settings) {
+            return this.post("/settings", settings).then((response) => response.json());
+        }
+        /**
+         * Executes a plugin command.
+         *
+         * This method executes the command for the current version of the plugin. To execute a command for the
+         * latest installed version of the plugin, use the {@link Client.executePluginCommand}.
+         *
+         * @param command - Command to execute.
+         * @param parameters - Command parameters. Command-dependent.
+         */
+        executeCommand(command, parameters) {
+            const commands = new Endpoint(`/plugins/${this.name}/commands`, this.httpClient, this.headers);
+            return commands.post(`/${command}?version=${this.version}`, parameters).then((response) => response.json());
+        }
+    }
+
     ///////////////////////////////////////////////////////////////////////////////
     // Copyright (C) 2002-2025, Open Design Alliance (the "Alliance").
     // All rights reserved.
@@ -4625,7 +4840,7 @@
                 .then((data) => ({
                 ...data,
                 server: data.version,
-                client: "26.9.1",
+                client: "26.9.3",
             }));
         }
         /**
@@ -4644,7 +4859,7 @@
                 .post("/register", {
                 email,
                 password,
-                userName: userName !== null && userName !== undefined ? userName : (email + "").split("@").at(0),
+                userName: userName !== null && userName !== void 0 ? userName : (email + "").split("@").shift(),
             })
                 .then((response) => response.json());
         }
@@ -4908,7 +5123,7 @@
                 userBrief: {
                     ...rest,
                     email,
-                    userName: userName !== null && userName !== undefined ? userName : (email + "").split("@").at(0),
+                    userName: userName !== null && userName !== void 0 ? userName : (email + "").split("@").shift(),
                 },
                 password,
             })
@@ -5064,7 +5279,7 @@
                 .uploadFile("/files", file, (progress) => {
                 var _a;
                 this.emitEvent({ type: "uploadprogress", data: progress, file });
-                (_a = params.onProgress) === null || _a === undefined ? undefined : _a.call(params, progress, file);
+                (_a = params.onProgress) === null || _a === void 0 ? void 0 : _a.call(params, progress, file);
             })
                 .then((xhr) => JSON.parse(xhr.responseText))
                 .then((data) => new File(data, this.httpClient));
@@ -5182,8 +5397,8 @@
          *   - `dwg`, `obj`, `gltf`, `glb`, `vsf`, `pdf`, `3dpdf` - Export file to the specified format.
          *   - Other custom job name. Custom job must be registered in the job templates before running.
          *
-         * @param parameters - Parameters for the File Converter jobs or custom job. Can be given as command
-         *   line arguments in form `--arg=value`.
+         * @param parameters - Parameters for the File Converter jobs or custom job. Can be given as JSON
+         *   object or command line arguments in form `--arg=value`.
          */
         createJob(fileId, outputFormat, parameters) {
             return this.httpClient
@@ -5279,8 +5494,8 @@
          * @param name - Assembly name.
          * @param params - Additional assembly creating parameters.
          * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify aditional
-         *   parameters for generating the geometry and properties of the new assembly. Can be given as command
-         *   line arguments in form `--arg=value`.
+         *   parameters for generating the geometry and properties of the new assembly. Can be given as JSON
+         *   object or command line arguments in form `--arg=value`.
          * @param params.waitForDone - Wait for assembly to be created.
          * @param params.timeout - The time, in milliseconds, that the function should wait for the assembly to
          *   be created. If the assembly is not created within this time, a TimeoutError exception will be
@@ -5500,6 +5715,108 @@
                 .then((response) => response.json())
                 .then((data) => new SharedFile(data, password, this.httpClient));
         }
+        /**
+         * Returns the list of installed plugins.
+         *
+         * Only administrators can get a list of plugins. If the current logged in user is not an
+         * administrator, an exception will be thrown.
+         */
+        getPlugins() {
+            return this.httpClient
+                .get("/plugins")
+                .then((response) => response.json())
+                .then((array) => array.map((data) => new Plugin(data, this.httpClient)));
+        }
+        /**
+         * Returns information about the specified plugin.
+         *
+         * Only administrators can get plugins. If the current logged in user is not an administrator, they can
+         * only get themselves, otherwise an exception will be thrown.
+         *
+         * @param name - Plugin name.
+         * @param version - Plugin version.
+         */
+        getPlugin(name, version) {
+            return this.httpClient
+                .get(`/plugins/${name}/${version}`)
+                .then((response) => response.json())
+                .then((data) => new Plugin(data, this.httpClient));
+        }
+        /**
+         * Uploads and install a plugin package to the server. The package must be a ZIP file and undergoes
+         * verification, scanning, and health checks during installation.
+         *
+         * Only administrators can upload plugins. If the current logged in user is not an administrator, an
+         * exception will be thrown.
+         *
+         * @param file - {@link https://developer.mozilla.org/docs/Web/API/File | Web API File} object are
+         *   generally retrieved from a {@link https://developer.mozilla.org/docs/Web/API/FileList | FileList}
+         *   object returned as a result of a user selecting files using the HTML `<input>` element.
+         * @param onProgress - Upload progress callback.
+         */
+        async uploadPlugin(file, onProgress) {
+            return await this.httpClient
+                .uploadFile("/plugins", file, (progress) => {
+                this.emitEvent({ type: "uploadprogress", data: progress, file });
+                if (onProgress)
+                    onProgress(progress, file);
+            })
+                .then((xhr) => JSON.parse(xhr.responseText))
+                .then((data) => new Plugin(data, this.httpClient));
+        }
+        /**
+         * Uninstalls and deletes the specified plugin from the server.
+         *
+         * Only administrators can delete plugins. If the current logged in user is not an administrator, an
+         * exception will be thrown.
+         *
+         * @param name - Plugin name.
+         * @param version - Plugin version.
+         */
+        deletePlugin(name, version) {
+            return this.httpClient.delete(`/plugins/${name}/${version}`).then((response) => response.json());
+        }
+        /**
+         * Downloads the specified plugin package from the server.
+         *
+         * Only administrators can download plugins. If the current logged in user is not an administrator, an
+         * exception will be thrown.
+         *
+         * @param name - Plugin name.
+         * @param version - Plugin version.
+         * @param onProgress - Download progress callback.
+         * @param signal - An
+         *   {@link https://developer.mozilla.org/docs/Web/API/AbortController | AbortController} signal. Allows
+         *   to communicate with a fetch request and abort it if desired.
+         */
+        downloadPlugin(name, version, onProgress, signal) {
+            return this.httpClient
+                .downloadFile(`/plugins/${name}/${version}/download`, onProgress, { signal })
+                .then((response) => response.arrayBuffer());
+        }
+        /**
+         * Executes a plugin command.
+         *
+         * If you have multiple versions of a plugin installed and want to run the command for the latest
+         * version of the plugin, specify `undefined` or empty string for the `version` parameter.
+         *
+         * @param name - Plugin name.
+         * @param version - Plugin version. Specify `undefined` or empty string to run the command for the
+         *   latest version of the plugin.
+         * @param command - Command to execute.
+         * @param parameters - Command parameters. Command-dependent.
+         */
+        executePluginCommand(name, version, command, parameters) {
+            const searchParams = new URLSearchParams();
+            if (version)
+                searchParams.set("version", version);
+            let queryString = searchParams.toString();
+            if (queryString)
+                queryString = "?" + queryString;
+            return this.httpClient
+                .post(`/plugins/${name}/commands/${command}${queryString}`, parameters)
+                .then((response) => response.json());
+        }
     }
 
     ///////////////////////////////////////////////////////////////////////////////
@@ -5524,7 +5841,7 @@
     // By use of this software, its documentation or related materials, you
     // acknowledge and accept the above terms.
     ///////////////////////////////////////////////////////////////////////////////
-    const version = "26.9.1";
+    const version = "26.9.3";
 
     exports.Assembly = Assembly;
     exports.ClashTest = ClashTest;
@@ -5537,6 +5854,7 @@
     exports.Model = Model;
     exports.OAuthClient = OAuthClient;
     exports.Permission = Permission;
+    exports.Plugin = Plugin;
     exports.Project = Project;
     exports.Role = Role;
     exports.SharedFile = SharedFile;