@inweb/client 26.10.6 → 26.12.0

package/lib/Api/Assembly.d.ts

@@ -144,7 +144,7 @@ export declare class Assembly extends Endpoint {
      * @property {string | any} * - Object property. Can be `any` for nested group properties.
      */
     /**
-     * Returns the properties for an objects in the assembly.
+     * Returns the properties for objects in the assembly.
      *
      * @param handles - Object original handle or handles array. Specify `undefined` to get properties for
      *   all objects in the assembly.
@@ -165,7 +165,7 @@ export declare class Assembly extends Endpoint {
      */
     getProperties(handles?: string | string[], group?: boolean): Promise<any[]>;
     /**
-     * Returns the list of original handles for an objects in the file that match the specified patterns.
+     * Returns the list of original handles for objects in the file that match the specified patterns.
      * Search patterns may be combined using query operators.
      *
      * @example Simple search pattern.
@@ -252,7 +252,7 @@ export declare class Assembly extends Endpoint {
      * @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
+     * @param ranges - 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 onProgress - Download progress callback.
@@ -356,7 +356,7 @@ export declare class Assembly extends Endpoint {
      *   clashes.
      * @param params.clearance - The type of the clashes that the test detects:
      *
-     *   - `true` - Сlearance clash. A clash in which the object A may or may not intersect with object B, but
+     *   - `true` - Clearance clash. A clash in which the object A may or may not intersect with object B, but
      *       comes within a distance of less than the `tolerance`.
      *   - `false` - Hard clash. A clash in which the object A intersects with object B by a distance of more
      *       than the `tolerance`.

package/lib/Api/ClashTest.d.ts

@@ -17,7 +17,7 @@ export declare class ClashTest extends Endpoint {
     /**
      * The type of the clashes that the test detects:
      *
-     * - `true` - Сlearance clash. A clash in which the object A may or may not intersect with object B, but
+     * - `true` - Clearance clash. A clash in which the object A may or may not intersect with object B, but
      *   comes within a distance of less than the {@link tolerance}.
      * - `false` - Hard clash. A clash in which the object A intersects with object B by a distance of more
      *   than the {@link tolerance}.

package/lib/Api/Client.d.ts

@@ -116,12 +116,12 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
     private clearCurrentUser;
     /**
      * Returns the current logged in user. Returns `null` if the user is not logged in or the logged in
-     * user has deleted themself.
+     * user has deleted themselves.
      */
     getCurrentUser(): User | null;
     /**
-     * Returns the list of server enabled indentity providers. No authorization is required to obtain a
-     * list of providers.
+     * Returns the list of server enabled identity providers. No authorization is required to obtain a list
+     * of providers.
      */
     getIdentityProviders(): Promise<{
         name: string;
@@ -254,7 +254,7 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
      * exception will be thrown.
      *
      * Administrators can delete themselves or other administrators. An administrator can only delete
-     * themself if they is not the last administrator.
+     * themselves if they are not the last administrator.
      *
      * You need to re-login after deleting the current logged in user.
      *
@@ -313,14 +313,14 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
      *   object returned as a result of a user selecting files using the HTML `<input>` element.
      * @param params - An object containing upload parameters.
      * @param params.geometry - Run File Converter job to convert geometry data after uploading the file.
-     *   Can be:
+     *   Can be one of:
      *
      *   - `true` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
      *   - `vsfx` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
      *   - `gltf` - Convert file geometry data to `glTF` format for opening in `Three.js` 3D viewer.
      *
      * @param params.properties - Run File Converter job to extract properties after uploading the file.
-     * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify aditional
+     * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify additional
      *   parameters for retrieving the geometry and properties of uploaded file. Can be given as command
      *   line arguments in form `--arg=value`.
      * @param params.waitForDone - Wait for geometry and properties jobs to complete.
@@ -401,10 +401,10 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
      */
     getJob(jobId: string): Promise<Job>;
     /**
-     * Runs a new job on the server for the sepecified file.
+     * Runs a new job on the server for the specified file.
      *
      * @param fileId - File ID.
-     * @param outputFormat - The job type. Can be:
+     * @param outputFormat - The job type. Can be one of:
      *
      *   - `geometry` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
      *   - `geometryGltf` - Convert file geometry data to `glTF` format for opening in `Three.js` 3D viewer.
@@ -467,7 +467,7 @@ export declare class Client extends EventEmitter2<ClientEventMap> {
      * @param files - List of file IDs.
      * @param name - Assembly name.
      * @param params - Additional assembly creating parameters.
-     * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify aditional
+     * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify additional
      *   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.

package/lib/Api/File.d.ts

@@ -49,10 +49,7 @@ export declare class File extends Endpoint {
      * Returns a list of file formats in which the active version of the file was exported.
      *
      * To export file to one of the supported formats run the File Converter job using
-     * {@link createJob | createJob()}. To download exported file use
-     * {@link downloadResource | downloadResource()}.
-     *
-     * For an example of exporting files to other formats, see the {@link downloadResource} help.
+     * {@link createJob | createJob()}. For an example, see the {@link downloadResource} help.
      *
      * @readonly
      */
@@ -64,7 +61,7 @@ export declare class File extends Endpoint {
      * - `gltf` - `glTF` format, file can be opened in `Three.js` 3D viewer.
      *
      * Returns an empty string if geometry data has not yet been converted. A files without geometry data
-     * can be exported to other formas, but cannot be opened in viewer.
+     * can be exported to other formats, but cannot be opened in viewer.
      */
     get geometryType(): string;
     /**
@@ -224,7 +221,7 @@ export declare class File extends Endpoint {
      * @property {string | any} * - Object property. Can be `any` for nested group properties.
      */
     /**
-     * Returns the properties for an objects in the active version of the file.
+     * Returns the properties for objects in the active version of the file.
      *
      * @param handles - Object original handle or handles array. Specify `undefined` to get properties for
      *   all objects in the file.
@@ -267,7 +264,7 @@ export declare class File extends Endpoint {
      *   operator.
      */
     /**
-     * Returns the list of original handles for an objects in the active version of the file that match the
+     * Returns the list of original handles for objects in the active version of the file that match the
      * specified patterns. Search patterns may be combined using query operators.
      *
      * @example Simple search pattern.
@@ -295,7 +292,7 @@ export declare class File extends Endpoint {
      * };
      * ```
      *
-     * @param {SeacrhPattern | QueryOperator} searchPattern - Search pattern or combination of the
+     * @param {SearchPattern | QueryOperator} searchPattern - Search pattern or combination of the
      *   patterns, see example below.
      * @returns {Promise<Properties[]>}
      */
@@ -358,9 +355,8 @@ export declare class File extends Endpoint {
      * await job.waitForDone();
      * const pdfResourceName = file.exports.find((x) => x.endsWith(".pdf"));
      * const arrayBuffer = await file.downloadResource(pdfResourceName);
-     * const blob = new Blob([arrayBuffer]);
      * const fileName = file.name + ".pdf";
-     * FileSaver.saveAs(blob, fileName);
+     * FileSaver.saveAs(new Blob([arrayBuffer]), fileName);
      * ```
      *
      * @param dataId - Resource file name.
@@ -377,7 +373,7 @@ export declare class File extends Endpoint {
      * @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
+     * @param ranges - 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 onProgress - Download progress callback.
@@ -424,7 +420,7 @@ export declare class File extends Endpoint {
     /**
      * Runs a new job on the server for the active version of the file.
      *
-     * @param outputFormat - The job type. Can be:
+     * @param outputFormat - The job type. Can be one of:
      *
      *   - `geometry` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
      *   - `geometryGltf` - Convert file geometry data to `glTF` format for opening in `Three.js` 3D viewer.

package/lib/Api/IHttpClient.d.ts

@@ -89,7 +89,7 @@ export interface IHttpClient {
      *
      * @param relativePath - Download endpoint relative path.
      * @param reserved - Reserved, do not use.
-     * @param ranges - A ranges of resource file contents to download. See
+     * @param ranges - 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 onProgress - Download progress callback.

package/lib/Api/Job.d.ts

@@ -64,7 +64,7 @@ export declare class Job extends Endpoint {
      */
     get lastUpdate(): string;
     /**
-     * Job type. Can be:
+     * Job type. Can be one of:
      *
      * - `geometry` - Convert file geometry data to `VSFX` format.
      * - `geometryGltf` - Convert file geometry data to `glTF` format.

package/lib/Api/Model.d.ts

@@ -148,7 +148,7 @@ export declare class Model extends Endpoint {
      * @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
+     * @param ranges - 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 onProgress - Download progress callback.

package/lib/Api/User.d.ts

@@ -163,7 +163,7 @@ export declare class User extends Endpoint {
      * Updates user data on the server.
      *
      * 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.
+     * they can only update themselves, otherwise an exception will be thrown.
      *
      * @param data - Raw user data. For more information, see
      *   {@link https://cloud.opendesign.com/docs//pages/server/api.html#Users | Open Cloud Users API}.
@@ -176,7 +176,7 @@ export declare class User extends Endpoint {
      * exception will be thrown.
      *
      * Administrators can delete themselves or other administrators. An administrator can only delete
-     * themself if they is not the last administrator.
+     * themselves if they are not the last administrator.
      *
      * You need to re-login after deleting the current logged in user.
      *

package/lib/Api/Utils.d.ts

@@ -1,3 +1,5 @@
+export declare function normalizeParam(param: any, separator?: string): string;
+export declare function delay(ms: number, signal: AbortSignal): Promise<boolean>;
 export declare function waitFor(func: (params: any) => Promise<boolean>, params?: {
     timeout?: number;
     interval?: number;

package/lib/index.d.ts

@@ -22,5 +22,5 @@ export * from "./Api/Plugin";
 export * from "./Api/SharedLink";
 export * from "./Api/SharedFile";
 export { User } from "./Api/User";
-export { parseArgs, userFullName, userInitials, waitFor } from "./Api/Utils";
+export * from "./Api/Utils";
 export declare const version = "CLIENT_JS_VERSION";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inweb/client",
-  "version": "26.10.6",
+  "version": "26.12.0",
   "description": "JavaScript REST API client for the Open Cloud Server",
   "homepage": "https://cloud.opendesign.com/docs/index.html",
   "license": "SEE LICENSE IN LICENSE",
@@ -26,7 +26,7 @@
     "docs": "typedoc"
   },
   "dependencies": {
-    "@inweb/eventemitter2": "~26.10.6"
+    "@inweb/eventemitter2": "~26.12.0"
   },
   "devDependencies": {
     "fflate": "^0.8.2"

package/src/Api/Assembly.ts

@@ -31,7 +31,7 @@ import { Model } from "./Model";
 import { ClashTest } from "./ClashTest";
 import { ISharedLinkPermissions } from "./ISharedLink";
 import { SharedLink } from "./SharedLink";
-import { waitFor, userFullName, userInitials } from "./Utils";
+import { normalizeParam, waitFor, userFullName, userInitials } from "./Utils";
 
 /**
  * Provides properties and methods for obtaining information about an assembly on the Open Cloud Server
@@ -283,7 +283,7 @@ export class Assembly extends Endpoint {
    */
 
   /**
-   * Returns the properties for an objects in the assembly.
+   * Returns the properties for objects in the assembly.
    *
    * @param handles - Object original handle or handles array. Specify `undefined` to get properties for
    *   all objects in the assembly.
@@ -318,7 +318,7 @@ export class Assembly extends Endpoint {
   }
 
   /**
-   * Returns the list of original handles for an objects in the file that match the specified patterns.
+   * Returns the list of original handles for objects in the file that match the specified patterns.
    * Search patterns may be combined using query operators.
    *
    * @example Simple search pattern.
@@ -437,7 +437,7 @@ export class Assembly extends Endpoint {
    * @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
+   * @param ranges - 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 onProgress - Download progress callback.
@@ -568,8 +568,7 @@ export class Assembly extends Endpoint {
     if (limit > 0) searchParams.set("limit", limit.toString());
     if (name) searchParams.set("name", name);
     if (ids) {
-      if (Array.isArray(ids)) ids = ids.join("|");
-      if (typeof ids === "string") ids = ids.trim();
+      ids = normalizeParam(ids);
       if (ids) searchParams.set("id", ids);
     }
     if (sortByDesc !== undefined) searchParams.set("sortBy", sortByDesc ? "desc" : "asc");
@@ -626,7 +625,7 @@ export class Assembly extends Endpoint {
    *   clashes.
    * @param params.clearance - The type of the clashes that the test detects:
    *
-   *   - `true` - Сlearance clash. A clash in which the object A may or may not intersect with object B, but
+   *   - `true` - Clearance clash. A clash in which the object A may or may not intersect with object B, but
    *       comes within a distance of less than the `tolerance`.
    *   - `false` - Hard clash. A clash in which the object A intersects with object B by a distance of more
    *       than the `tolerance`.

package/src/Api/ClashTest.ts

@@ -47,7 +47,7 @@ export class ClashTest extends Endpoint {
   /**
    * The type of the clashes that the test detects:
    *
-   * - `true` - Сlearance clash. A clash in which the object A may or may not intersect with object B, but
+   * - `true` - Clearance clash. A clash in which the object A may or may not intersect with object B, but
    *   comes within a distance of less than the {@link tolerance}.
    * - `false` - Hard clash. A clash in which the object A intersects with object B by a distance of more
    *   than the {@link tolerance}.

package/src/Api/Client.ts

@@ -37,7 +37,7 @@ import { ISharedLinkPermissions } from "./ISharedLink";
 import { SharedLink } from "./SharedLink";
 import { SharedFile } from "./SharedFile";
 import { Plugin } from "./Plugin";
-import { parseArgs } from "./Utils";
+import { normalizeParam, parseArgs } from "./Utils";
 
 /**
  * Provides methods for managing Open Cloud Server resources such as users, files, assemblies, jobs,
@@ -255,7 +255,7 @@ export class Client extends EventEmitter2<ClientEventMap> {
 
   /**
    * Returns the current logged in user. Returns `null` if the user is not logged in or the logged in
-   * user has deleted themself.
+   * user has deleted themselves.
    */
   getCurrentUser(): User | null {
     if (this._user && !this.httpClient.signInUserId) this._user = null;
@@ -263,8 +263,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
   }
 
   /**
-   * Returns the list of server enabled indentity providers. No authorization is required to obtain a
-   * list of providers.
+   * Returns the list of server enabled identity providers. No authorization is required to obtain a list
+   * of providers.
    */
   getIdentityProviders(): Promise<{ name: string; url: string }[]> {
     return this.httpClient.get("/identity").then((response) => response.json());
@@ -488,7 +488,7 @@ export class Client extends EventEmitter2<ClientEventMap> {
    * exception will be thrown.
    *
    * Administrators can delete themselves or other administrators. An administrator can only delete
-   * themself if they is not the last administrator.
+   * themselves if they are not the last administrator.
    *
    * You need to re-login after deleting the current logged in user.
    *
@@ -559,13 +559,12 @@ export class Client extends EventEmitter2<ClientEventMap> {
     if (limit > 0) searchParams.set("limit", limit.toString());
     if (name) searchParams.set("name", name);
     if (ext) {
-      if (Array.isArray(ext)) ext = ext.join("|");
-      if (typeof ext === "string") ext = ext.toLowerCase();
-      if (ext) searchParams.set("ext", ext);
+      ext = normalizeParam(ext);
+      if (ext) searchParams.set("ext", ext.toLowerCase());
     }
     if (ids) {
-      if (Array.isArray(ids)) ids = ids.join("|");
-      searchParams.set("id", ids);
+      ids = normalizeParam(ids);
+      if (ids) searchParams.set("id", ids);
     }
     if (sortByDesc !== undefined) searchParams.set("sortBy", sortByDesc ? "desc" : "asc");
     if (sortField) searchParams.set("sortField", sortField);
@@ -609,14 +608,14 @@ export class Client extends EventEmitter2<ClientEventMap> {
    *   object returned as a result of a user selecting files using the HTML `<input>` element.
    * @param params - An object containing upload parameters.
    * @param params.geometry - Run File Converter job to convert geometry data after uploading the file.
-   *   Can be:
+   *   Can be one of:
    *
    *   - `true` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
    *   - `vsfx` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
    *   - `gltf` - Convert file geometry data to `glTF` format for opening in `Three.js` 3D viewer.
    *
    * @param params.properties - Run File Converter job to extract properties after uploading the file.
-   * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify aditional
+   * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify additional
    *   parameters for retrieving the geometry and properties of uploaded file. Can be given as command
    *   line arguments in form `--arg=value`.
    * @param params.waitForDone - Wait for geometry and properties jobs to complete.
@@ -737,9 +736,8 @@ export class Client extends EventEmitter2<ClientEventMap> {
     if (start > 0) searchParams.set("start", start.toString());
     if (limit > 0) searchParams.set("limit", limit.toString());
     if (status) {
-      if (Array.isArray(status)) status = status.join("|");
-      if (typeof status === "string") status = status.trim().toLowerCase();
-      if (status) searchParams.set("status", status);
+      status = normalizeParam(status);
+      if (status) searchParams.set("status", status.toLowerCase());
     }
     if (sortByDesc !== undefined) searchParams.set("sortBy", sortByDesc ? "desc" : "asc");
     if (sortField) searchParams.set("sortField", sortField);
@@ -769,10 +767,10 @@ export class Client extends EventEmitter2<ClientEventMap> {
   }
 
   /**
-   * Runs a new job on the server for the sepecified file.
+   * Runs a new job on the server for the specified file.
    *
    * @param fileId - File ID.
-   * @param outputFormat - The job type. Can be:
+   * @param outputFormat - The job type. Can be one of:
    *
    *   - `geometry` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
    *   - `geometryGltf` - Convert file geometry data to `glTF` format for opening in `Three.js` 3D viewer.
@@ -849,8 +847,7 @@ export class Client extends EventEmitter2<ClientEventMap> {
     if (limit > 0) searchParams.set("limit", limit.toString());
     if (name) searchParams.set("name", name);
     if (ids) {
-      if (Array.isArray(ids)) ids = ids.join("|");
-      if (typeof ids === "string") ids = ids.trim();
+      ids = normalizeParam(ids);
       if (ids) searchParams.set("id", ids);
     }
     if (sortByDesc !== undefined) searchParams.set("sortBy", sortByDesc ? "desc" : "asc");
@@ -888,7 +885,7 @@ export class Client extends EventEmitter2<ClientEventMap> {
    * @param files - List of file IDs.
    * @param name - Assembly name.
    * @param params - Additional assembly creating parameters.
-   * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify aditional
+   * @param params.jobParameters - Parameters for the File Converter jobs. Use this to specify additional
    *   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.
@@ -982,8 +979,7 @@ export class Client extends EventEmitter2<ClientEventMap> {
     if (limit > 0) searchParams.set("limit", limit.toString());
     if (name) searchParams.set("name", name);
     if (ids) {
-      if (Array.isArray(ids)) ids = ids.join("|");
-      if (typeof ids === "string") ids = ids.trim();
+      ids = normalizeParam(ids);
       if (ids) searchParams.set("id", ids);
     }
     if (sortByDesc !== undefined) searchParams.set("sortBy", sortByDesc ? "desc" : "asc");

package/src/Api/File.ts

@@ -124,10 +124,7 @@ export class File extends Endpoint {
    * Returns a list of file formats in which the active version of the file was exported.
    *
    * To export file to one of the supported formats run the File Converter job using
-   * {@link createJob | createJob()}. To download exported file use
-   * {@link downloadResource | downloadResource()}.
-   *
-   * For an example of exporting files to other formats, see the {@link downloadResource} help.
+   * {@link createJob | createJob()}. For an example, see the {@link downloadResource} help.
    *
    * @readonly
    */
@@ -142,7 +139,7 @@ export class File extends Endpoint {
    * - `gltf` - `glTF` format, file can be opened in `Three.js` 3D viewer.
    *
    * Returns an empty string if geometry data has not yet been converted. A files without geometry data
-   * can be exported to other formas, but cannot be opened in viewer.
+   * can be exported to other formats, but cannot be opened in viewer.
    */
   get geometryType(): string {
     if (this.status.geometryGltf.state === "done") return "gltf";
@@ -401,7 +398,7 @@ export class File extends Endpoint {
    */
 
   /**
-   * Returns the properties for an objects in the active version of the file.
+   * Returns the properties for objects in the active version of the file.
    *
    * @param handles - Object original handle or handles array. Specify `undefined` to get properties for
    *   all objects in the file.
@@ -460,7 +457,7 @@ export class File extends Endpoint {
    */
 
   /**
-   * Returns the list of original handles for an objects in the active version of the file that match the
+   * Returns the list of original handles for objects in the active version of the file that match the
    * specified patterns. Search patterns may be combined using query operators.
    *
    * @example Simple search pattern.
@@ -488,7 +485,7 @@ export class File extends Endpoint {
    * };
    * ```
    *
-   * @param {SeacrhPattern | QueryOperator} searchPattern - Search pattern or combination of the
+   * @param {SearchPattern | QueryOperator} searchPattern - Search pattern or combination of the
    *   patterns, see example below.
    * @returns {Promise<Properties[]>}
    */
@@ -580,9 +577,8 @@ export class File extends Endpoint {
    * await job.waitForDone();
    * const pdfResourceName = file.exports.find((x) => x.endsWith(".pdf"));
    * const arrayBuffer = await file.downloadResource(pdfResourceName);
-   * const blob = new Blob([arrayBuffer]);
    * const fileName = file.name + ".pdf";
-   * FileSaver.saveAs(blob, fileName);
+   * FileSaver.saveAs(new Blob([arrayBuffer]), fileName);
    * ```
    *
    * @param dataId - Resource file name.
@@ -608,7 +604,7 @@ export class File extends Endpoint {
    * @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
+   * @param ranges - 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 onProgress - Download progress callback.
@@ -693,7 +689,7 @@ export class File extends Endpoint {
   /**
    * Runs a new job on the server for the active version of the file.
    *
-   * @param outputFormat - The job type. Can be:
+   * @param outputFormat - The job type. Can be one of:
    *
    *   - `geometry` - Convert file geometry data to `VSFX` format for opening in `VisualizeJS` 3D viewer.
    *   - `geometryGltf` - Convert file geometry data to `glTF` format for opening in `Three.js` 3D viewer.

package/src/Api/IHttpClient.ts

@@ -131,7 +131,7 @@ export interface IHttpClient {
    *
    * @param relativePath - Download endpoint relative path.
    * @param reserved - Reserved, do not use.
-   * @param ranges - A ranges of resource file contents to download. See
+   * @param ranges - 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 onProgress - Download progress callback.

package/src/Api/Job.ts

@@ -121,7 +121,7 @@ export class Job extends Endpoint {
   }
 
   /**
-   * Job type. Can be:
+   * Job type. Can be one of:
    *
    * - `geometry` - Convert file geometry data to `VSFX` format.
    * - `geometryGltf` - Convert file geometry data to `glTF` format.

package/src/Api/Model.ts

@@ -255,7 +255,7 @@ export class Model extends Endpoint {
    * @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
+   * @param ranges - 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 onProgress - Download progress callback.

package/src/Api/Project.ts

@@ -28,7 +28,7 @@ import { Role } from "./Role";
 import { IRoleActions } from "./IRole";
 import { Member } from "./Member";
 import { File } from "./File";
-import { userFullName, userInitials } from "./Utils";
+import { normalizeParam, userFullName, userInitials } from "./Utils";
 
 /**
  * Provides properties and methods for obtaining information about a project on the Open Cloud Server and
@@ -482,7 +482,7 @@ export class Project extends Endpoint {
       .then((filesInformation) => filesInformation.map((item) => item.file.reference))
       .then((ids) => {
         const files = new Endpoint("/files", this.httpClient, this.headers);
-        return files.get(`?id=${ids.join("|")}`);
+        return files.get(`?id=${normalizeParam(ids)}`);
       })
       .then((response) => response.json())
       .then((files) => files.result.map((data) => new File(data, this.httpClient)));

package/src/Api/User.ts

@@ -310,7 +310,7 @@ export class User extends Endpoint {
    * Updates user data on the server.
    *
    * 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.
+   * they can only update themselves, otherwise an exception will be thrown.
    *
    * @param data - Raw user data. For more information, see
    *   {@link https://cloud.opendesign.com/docs//pages/server/api.html#Users | Open Cloud Users API}.
@@ -337,7 +337,7 @@ export class User extends Endpoint {
    * exception will be thrown.
    *
    * Administrators can delete themselves or other administrators. An administrator can only delete
-   * themself if they is not the last administrator.
+   * themselves if they are not the last administrator.
    *
    * You need to re-login after deleting the current logged in user.
    *

package/src/Api/Utils.ts

@@ -21,7 +21,14 @@
 // acknowledge and accept the above terms.
 ///////////////////////////////////////////////////////////////////////////////
 
-function delay(ms: number, signal: AbortSignal): Promise<boolean> {
+export function normalizeParam(param: any, separator: string = "|"): string {
+  if (typeof param === "string") param = param.split(",");
+  if (Array.isArray(param)) param = param.filter((x) => x).join(separator);
+  if (typeof param === "string") param = param.trim();
+  return param.toString();
+}
+
+export function delay(ms: number, signal: AbortSignal): Promise<boolean> {
   return new Promise((resolve) => {
     let timeoutId = 0;
 

package/src/index.ts

@@ -45,6 +45,6 @@ export * from "./Api/Plugin";
 export * from "./Api/SharedLink";
 export * from "./Api/SharedFile";
 export { User } from "./Api/User";
-export { parseArgs, userFullName, userInitials, waitFor } from "./Api/Utils";
+export * from "./Api/Utils";
 
 export const version = "CLIENT_JS_VERSION";