@thatopen/services 0.0.6 → 0.1.3

package/dist/index.es.js

@@ -41,11 +41,11 @@ const Ee = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", N
 for (let n = 0; n < Ee.length; n++)
   N[Ee.charCodeAt(n)] = n;
 const He = (n) => {
-  let e = n.length * 0.75, t = n.length, s, r = 0, i, o, h, u;
+  let e = n.length * 0.75, t = n.length, s, r = 0, i, o, h, l;
   n[n.length - 1] === "=" && (e--, n[n.length - 2] === "=" && e--);
   const y = new ArrayBuffer(e), d = new Uint8Array(y);
   for (s = 0; s < t; s += 4)
-    i = N[n.charCodeAt(s)], o = N[n.charCodeAt(s + 1)], h = N[n.charCodeAt(s + 2)], u = N[n.charCodeAt(s + 3)], d[r++] = i << 2 | o >> 4, d[r++] = (o & 15) << 4 | h >> 2, d[r++] = (h & 3) << 6 | u & 63;
+    i = N[n.charCodeAt(s)], o = N[n.charCodeAt(s + 1)], h = N[n.charCodeAt(s + 2)], l = N[n.charCodeAt(s + 3)], d[r++] = i << 2 | o >> 4, d[r++] = (o & 15) << 4 | h >> 2, d[r++] = (h & 3) << 6 | l & 63;
   return y;
 }, Je = typeof ArrayBuffer == "function", le = (n, e) => {
   if (typeof n != "string")
@@ -139,17 +139,17 @@ function We(n, e) {
         if (s === 0) {
           if (P(t) < 1)
             break;
-          const u = L(t, 1);
-          i = (u[0] & 128) === 128, r = u[0] & 127, r < 126 ? s = 3 : r === 126 ? s = 1 : s = 2;
+          const l = L(t, 1);
+          i = (l[0] & 128) === 128, r = l[0] & 127, r < 126 ? s = 3 : r === 126 ? s = 1 : s = 2;
         } else if (s === 1) {
           if (P(t) < 2)
             break;
-          const u = L(t, 2);
-          r = new DataView(u.buffer, u.byteOffset, u.length).getUint16(0), s = 3;
+          const l = L(t, 2);
+          r = new DataView(l.buffer, l.byteOffset, l.length).getUint16(0), s = 3;
         } else if (s === 2) {
           if (P(t) < 8)
             break;
-          const u = L(t, 8), y = new DataView(u.buffer, u.byteOffset, u.length), d = y.getUint32(0);
+          const l = L(t, 8), y = new DataView(l.buffer, l.byteOffset, l.length), d = y.getUint32(0);
           if (d > Math.pow(2, 21) - 1) {
             h.enqueue(ee);
             break;
@@ -158,8 +158,8 @@ function We(n, e) {
         } else {
           if (P(t) < r)
             break;
-          const u = L(t, r);
-          h.enqueue(le(i ? u : W.decode(u), e)), s = 0;
+          const l = L(t, r);
+          h.enqueue(le(i ? l : W.decode(l), e)), s = 0;
         }
         if (r === 0 || r > n) {
           h.enqueue(ee);
@@ -724,8 +724,8 @@ class dt extends fe {
         const t = We(Number.MAX_SAFE_INTEGER, this.socket.binaryType), s = e.readable.pipeThrough(t).getReader(), r = Ye();
         r.readable.pipeTo(e.writable), this._writer = r.writable.getWriter();
         const i = () => {
-          s.read().then(({ done: h, value: u }) => {
-            h || (this.onPacket(u), i());
+          s.read().then(({ done: h, value: l }) => {
+            h || (this.onPacket(l), i());
           }).catch((h) => {
           });
         };
@@ -1109,16 +1109,16 @@ class bt extends C {
     function h() {
       o("transport closed");
     }
-    function u() {
+    function l() {
       o("socket closed");
     }
     function y(m) {
       t && m.name !== t.name && i();
     }
     const d = () => {
-      t.removeListener("open", r), t.removeListener("error", o), t.removeListener("close", h), this.off("close", u), this.off("upgrading", y);
+      t.removeListener("open", r), t.removeListener("error", o), t.removeListener("close", h), this.off("close", l), this.off("upgrading", y);
     };
-    t.once("open", r), t.once("error", o), t.once("close", h), this.once("close", u), this.once("upgrading", y), this._upgrades.indexOf("webtransport") !== -1 && e !== "webtransport" ? this.setTimeoutFn(() => {
+    t.once("open", r), t.once("error", o), t.once("close", h), this.once("close", l), this.once("upgrading", y), this._upgrades.indexOf("webtransport") !== -1 && e !== "webtransport" ? this.setTimeoutFn(() => {
       s || t.open();
     }, 200) : t.open();
   }
@@ -1562,8 +1562,8 @@ class qe extends g {
       const d = this.ids++, m = t.pop();
       this._registerAckCallback(d, m), o.id = d;
     }
-    const h = (r = (s = this.io.engine) === null || s === void 0 ? void 0 : s.transport) === null || r === void 0 ? void 0 : r.writable, u = this.connected && !(!((i = this.io.engine) === null || i === void 0) && i._hasPingExpired());
-    return this.flags.volatile && !h || (u ? (this.notifyOutgoingListeners(o), this.packet(o)) : this.sendBuffer.push(o)), this.flags = {}, this;
+    const h = (r = (s = this.io.engine) === null || s === void 0 ? void 0 : s.transport) === null || r === void 0 ? void 0 : r.writable, l = this.connected && !(!((i = this.io.engine) === null || i === void 0) && i._hasPingExpired());
+    return this.flags.volatile && !h || (l ? (this.notifyOutgoingListeners(o), this.packet(o)) : this.sendBuffer.push(o)), this.flags = {}, this;
   }
   /**
    * @private
@@ -2109,11 +2109,11 @@ class ie extends g {
       this.cleanup(), this._readyState = "closed", this.emitReserved("error", h), e ? e(h) : this.maybeReconnectOnOpen();
     }, o = E(t, "error", i);
     if (this._timeout !== !1) {
-      const h = this._timeout, u = this.setTimeoutFn(() => {
+      const h = this._timeout, l = this.setTimeoutFn(() => {
         r(), i(new Error("timeout")), t.close();
       }, h);
-      this.opts.autoUnref && u.unref(), this.subs.push(() => {
-        this.clearTimeoutFn(u);
+      this.opts.autoUnref && l.unref(), this.subs.push(() => {
+        this.clearTimeoutFn(l);
       });
     }
     return this.subs.push(r), this.subs.push(o), this;
@@ -2291,8 +2291,8 @@ const x = {};
 function F(n, e) {
   typeof n == "object" && (e = n, n = void 0), e = e || {};
   const t = Tt(n, e.path || "/socket.io"), s = t.source, r = t.id, i = t.path, o = x[r] && i in x[r].nsps, h = e.forceNew || e["force new connection"] || e.multiplex === !1 || o;
-  let u;
-  return h ? u = new ie(s, e) : (x[r] || (x[r] = new ie(s, e)), u = x[r]), t.query && !e.query && (e.query = t.queryKey), u.socket(t.path, e);
+  let l;
+  return h ? l = new ie(s, e) : (x[r] || (x[r] = new ie(s, e)), l = x[r]), t.query && !e.query && (e.query = t.queryKey), l.socket(t.path, e);
 }
 Object.assign(F, {
   Manager: ie,
@@ -2327,7 +2327,7 @@ class Lt extends Error {
   }
 }
 const T = "item/folder", p = "item", O = "processor", R = "hidden", X = "FILE", Q = "TOOL", Z = "APP";
-var a, ae, l, S, V, M, ce, he, Ue;
+var a, ae, u, S, V, M, ce, he, Ue;
 const ye = class ye {
   /**
    * Creates a new EngineServicesClient instance.
@@ -2359,8 +2359,8 @@ const ye = class ye {
     const { retries: r = 0, useBearer: i = !1, localServerUrl: o } = s || {};
     let h = t;
     if (h.charAt(h.length - 1) === "/" && (h = h.slice(0, -1)), this.apiUrl = `${h}/api`, this.accessToken = e, this.wsUrl = `${h}?accessToken=${e}`, this.retries = r, this.useBearer = i, this.context = { appId: "", projectId: "", accessToken: e, apiUrl: t }, o) {
-      let u = o;
-      u.charAt(u.length - 1) === "/" && (u = u.slice(0, -1)), this.localServerUrl = u;
+      let l = o;
+      l.charAt(l.length - 1) === "/" && (l = l.slice(0, -1)), this.localServerUrl = l;
     }
   }
   /**
@@ -2442,7 +2442,7 @@ const ye = class ye {
    * cleaning logic is applied identically.
    */
   async request(e, t, s) {
-    return c(this, a, l).call(this, e, t, s);
+    return c(this, a, u).call(this, e, t, s);
   }
   // ─── Files ───────────────────────────────────────────────────────
   /**
@@ -2452,7 +2452,7 @@ const ye = class ye {
    */
   async listFiles(e) {
     const { folderId: t, archived: s, projectId: r } = e || {};
-    return t ? await c(this, a, l).call(this, "GET", `${T}/${t}/items`, { query: { itemType: X, archived: s } }) : await c(this, a, l).call(this, "GET", `${p}`, {
+    return t ? await c(this, a, u).call(this, "GET", `${T}/${t}/items`, { query: { itemType: X, archived: s } }) : await c(this, a, u).call(this, "GET", `${p}`, {
       query: {
         itemType: X,
         archived: s,
@@ -2492,14 +2492,14 @@ const ye = class ye {
    * @param fileId - The file's unique identifier.
    */
   async archiveFile(e) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${e}`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${e}`);
   }
   /**
    * Recovers a previously archived file.
    * @param fileId - The file's unique identifier.
    */
   async recoverFile(e) {
-    return await c(this, a, l).call(this, "PUT", `${p}/${e}/recover`);
+    return await c(this, a, u).call(this, "PUT", `${p}/${e}/recover`);
   }
   /**
    * Downloads a file's content. Returns the raw fetch Response.
@@ -2519,7 +2519,7 @@ const ye = class ye {
    */
   async getFileVersionMetadata(e, t, s) {
     const { withDraft: r } = s || {};
-    return await c(this, a, l).call(this, "GET", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/metadata`, {
+    return await c(this, a, u).call(this, "GET", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/metadata`, {
       query: {
         ...r && { withDraft: "true" }
       }
@@ -2532,7 +2532,7 @@ const ye = class ye {
    * @param metadata - Free-JSON object (max 200 fields, 50-char keys/values).
    */
   async updateFileVersionMetadata(e, t, s) {
-    return await c(this, a, l).call(this, "PUT", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/metadata`, {
+    return await c(this, a, u).call(this, "PUT", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/metadata`, {
       body: JSON.stringify({ metadata: s }),
       contentType: "application/json"
     });
@@ -2543,7 +2543,7 @@ const ye = class ye {
    * @param versionTag - The version tag.
    */
   async deleteFileVersionMetadata(e, t) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/metadata`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/metadata`);
   }
   // ─── Folders ─────────────────────────────────────────────────────
   /**
@@ -2553,7 +2553,7 @@ const ye = class ye {
    */
   async listFolders(e) {
     const { archived: t, parentFolderId: s, projectId: r } = e || {};
-    return await c(this, a, l).call(this, "GET", T, {
+    return await c(this, a, u).call(this, "GET", T, {
       query: {
         parentFolderId: s,
         archived: t,
@@ -2566,7 +2566,7 @@ const ye = class ye {
    * @param folderId - The folder's unique identifier.
    */
   async getFolder(e) {
-    return await c(this, a, l).call(this, "GET", `${T}/${e}`);
+    return await c(this, a, u).call(this, "GET", `${T}/${e}`);
   }
   /**
    * Creates a new folder.
@@ -2575,7 +2575,7 @@ const ye = class ye {
    * @returns The created folder.
    */
   async createFolder(e, t, s) {
-    return await c(this, a, l).call(this, "POST", T, {
+    return await c(this, a, u).call(this, "POST", T, {
       body: JSON.stringify({
         name: e,
         ...t && { parentId: t },
@@ -2592,7 +2592,7 @@ const ye = class ye {
    */
   async updateFolder(e, t) {
     const { name: s } = t;
-    return await c(this, a, l).call(this, "PUT", `${T}/${e}`, {
+    return await c(this, a, u).call(this, "PUT", `${T}/${e}`, {
       body: JSON.stringify({ name: s }),
       contentType: "application/json"
     });
@@ -2602,14 +2602,14 @@ const ye = class ye {
    * @param folderId - The folder's unique identifier.
    */
   async archiveFolder(e) {
-    return await c(this, a, l).call(this, "DELETE", `${T}/${e}`);
+    return await c(this, a, u).call(this, "DELETE", `${T}/${e}`);
   }
   /**
    * Recovers a previously archived folder.
    * @param folderId - The folder's unique identifier.
    */
   async recoverFolder(e) {
-    return await c(this, a, l).call(this, "PUT", `${T}/${e}/recover`);
+    return await c(this, a, u).call(this, "PUT", `${T}/${e}/recover`);
   }
   /**
    * Downloads an entire folder as a ZIP archive.
@@ -2627,12 +2627,12 @@ const ye = class ye {
    */
   async listComponents(e) {
     const { folderId: t, ShowVersions: s, projectId: r } = e || {};
-    return t ? await c(this, a, l).call(this, "GET", `${T}/${t}/items`, {
+    return t ? await c(this, a, u).call(this, "GET", `${T}/${t}/items`, {
       query: {
         itemType: Q,
         ...s && { ShowVersions: s }
       }
-    }) : await c(this, a, l).call(this, "GET", `${p}`, {
+    }) : await c(this, a, u).call(this, "GET", `${p}`, {
       query: {
         itemType: Q,
         ...s && { ShowVersions: s },
@@ -2697,14 +2697,14 @@ const ye = class ye {
    * @param componentId - The component's unique identifier.
    */
   async archiveComponent(e) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${e}`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${e}`);
   }
   /**
    * Recovers a previously archived component.
    * @param componentId - The component's unique identifier.
    */
   async recoverComponent(e) {
-    return await c(this, a, l).call(this, "PUT", `${p}/${e}/recover`);
+    return await c(this, a, u).call(this, "PUT", `${p}/${e}/recover`);
   }
   // ─── Built-in Components ─────────────────────────────────────────
   /**
@@ -2811,12 +2811,12 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    */
   async listApps(e) {
     const { folderId: t, ShowVersions: s, projectId: r } = e || {};
-    return t ? await c(this, a, l).call(this, "GET", `${T}/${t}/items`, {
+    return t ? await c(this, a, u).call(this, "GET", `${T}/${t}/items`, {
       query: {
         itemType: Z,
         ...s && { ShowVersions: s }
       }
-    }) : await c(this, a, l).call(this, "GET", `${p}`, {
+    }) : await c(this, a, u).call(this, "GET", `${p}`, {
       query: {
         itemType: Z,
         ...s && { ShowVersions: s },
@@ -2863,7 +2863,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @param appId - The app's unique identifier.
    */
   async archiveApp(e) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${e}`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${e}`);
   }
   // ─── Execution ───────────────────────────────────────────────────
   /**
@@ -2893,7 +2893,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
       }
       return await i.json();
     }
-    return await c(this, a, l).call(this, "POST", `${O}/${e}/execute`, {
+    return await c(this, a, u).call(this, "POST", `${O}/${e}/execute`, {
       body: JSON.stringify(t),
       query: { ...s && { versionTag: s } },
       contentType: "application/json"
@@ -2912,7 +2912,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
       }
       return await s.json();
     }
-    return await c(this, a, l).call(this, "POST", `${O}/progress/${e}/abort`);
+    return await c(this, a, u).call(this, "POST", `${O}/progress/${e}/abort`);
   }
   /**
    * Lists all executions for a given component.
@@ -2938,7 +2938,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
       }
       return await i.json();
     }
-    return await c(this, a, l).call(this, "GET", `${O}/${e}/progress`, { query: { ...t && { projectId: t } } });
+    return await c(this, a, u).call(this, "GET", `${O}/${e}/progress`, { query: { ...t && { projectId: t } } });
   }
   /**
    * Gets details of a specific execution, including its messages.
@@ -2954,7 +2954,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
       }
       return await s.json();
     }
-    return await c(this, a, l).call(this, "GET", `${O}/progress/${e}`);
+    return await c(this, a, u).call(this, "GET", `${O}/progress/${e}`);
   }
   /**
    * Subscribes to real-time execution progress via WebSocket.
@@ -2983,7 +2983,23 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    */
   async createHiddenFile(e, t) {
     const s = new FormData();
-    return s.append("file", e), s.append("parentItemId", t), await c(this, a, l).call(this, "POST", `${p}/${R}`, {
+    return s.append("file", e), s.append("parentItemId", t), await c(this, a, u).call(this, "POST", `${p}/${R}`, {
+      body: s
+    });
+  }
+  /**
+   * Creates many hidden files attached to a parent item in a single request.
+   * Use this instead of many `createHiddenFile` calls when uploading large sets
+   * (e.g. 3D Tiles); upload in chunks of up to 100 files per call.
+   * @param files - The files to upload.
+   * @param parentFileId - The parent item's unique identifier.
+   * @returns One result per uploaded file, in order, each with its hidden file ID.
+   */
+  async createHiddenFilesBatch(e, t) {
+    const s = new FormData();
+    for (const r of e)
+      s.append("files", r);
+    return s.append("parentItemId", t), await c(this, a, u).call(this, "POST", `${p}/${R}/batch`, {
       body: s
     });
   }
@@ -2992,14 +3008,14 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @param hiddenId - The hidden file's unique identifier.
    */
   async deleteHiddenFile(e) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${R}/${e}`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${R}/${e}`);
   }
   /**
    * Gets metadata for a hidden file.
    * @param hiddenId - The hidden file's unique identifier.
    */
   async getHiddenFile(e) {
-    return await c(this, a, l).call(this, "GET", `${p}/${R}/${e}`);
+    return await c(this, a, u).call(this, "GET", `${p}/${R}/${e}`);
   }
   /**
    * Downloads a hidden file's content. Returns the raw fetch Response.
@@ -3014,14 +3030,14 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @returns Array of hidden file entities.
    */
   async getHiddenFilesByParent(e) {
-    return await c(this, a, l).call(this, "GET", `${p}/${e}/${R}`);
+    return await c(this, a, u).call(this, "GET", `${p}/${e}/${R}`);
   }
   /**
    * Deletes all hidden files attached to a parent item.
    * @param parentFileId - The parent item's unique identifier.
    */
   async deleteHiddenFilesByParent(e) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${e}/${R}`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${e}/${R}`);
   }
   // ─── Icons ───────────────────────────────────────────────────────
   /**
@@ -3033,7 +3049,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    */
   async uploadItemIcon(e, t) {
     const s = new FormData();
-    return s.append("icon", t), await c(this, a, l).call(this, "PUT", `${p}/${e}/icon`, { body: s });
+    return s.append("icon", t), await c(this, a, u).call(this, "PUT", `${p}/${e}/icon`, { body: s });
   }
   /**
    * Downloads the icon for an item as a binary stream.
@@ -3049,7 +3065,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @returns The updated item with icon fields removed.
    */
   async removeItemIcon(e) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${e}/icon`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${e}/icon`);
   }
   // ─── General Item Operations ─────────────────────────────────────
   /**
@@ -3059,7 +3075,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @returns The updated item.
    */
   async updateItem(e, t) {
-    return await c(this, a, l).call(this, "PUT", `${p}/${e}`, {
+    return await c(this, a, u).call(this, "PUT", `${p}/${e}`, {
       body: JSON.stringify(t),
       contentType: "application/json"
     });
@@ -3076,7 +3092,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    */
   async createVersion(e, t, s, r, i) {
     const o = new FormData();
-    return o.append("file", t), o.append("versionTag", s), r && o.append("extraProps", JSON.stringify(r)), i && o.append("metadata", JSON.stringify(i)), await c(this, a, l).call(this, "POST", `${p}/${e}/version`, { body: o });
+    return o.append("file", t), o.append("versionTag", s), r && o.append("extraProps", JSON.stringify(r)), i && o.append("metadata", JSON.stringify(i)), await c(this, a, u).call(this, "POST", `${p}/${e}/version`, { body: o });
   }
   /**
    * Lists versions of an item. Pass `archived: true` to fetch only archived
@@ -3086,7 +3102,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @returns Array of versions, sorted by creation date descending.
    */
   async listVersions(e, t = {}) {
-    return await c(this, a, l).call(this, "GET", `${p}/${encodeURIComponent(e)}/versions`, { query: t });
+    return await c(this, a, u).call(this, "GET", `${p}/${encodeURIComponent(e)}/versions`, { query: t });
   }
   /**
    * Archives a version of an item. Archived versions remain available via
@@ -3098,7 +3114,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @returns The archived version.
    */
   async archiveVersion(e, t) {
-    return await c(this, a, l).call(this, "PUT", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/archive`);
+    return await c(this, a, u).call(this, "PUT", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/archive`);
   }
   /**
    * Recovers a previously archived version, restoring it to the active list.
@@ -3107,7 +3123,7 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @returns The recovered version.
    */
   async recoverVersion(e, t) {
-    return await c(this, a, l).call(this, "PUT", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/recover`);
+    return await c(this, a, u).call(this, "PUT", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}/recover`);
   }
   /**
    * Permanently deletes a version, including its file in object storage.
@@ -3116,19 +3132,19 @@ return main;`)(...h), d = (y == null ? void 0 : y.componentDefinition) ?? y;
    * @param versionTag - The version's tag (e.g. "v2").
    */
   async deleteVersion(e, t) {
-    return await c(this, a, l).call(this, "DELETE", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}`);
+    return await c(this, a, u).call(this, "DELETE", `${p}/${encodeURIComponent(e)}/version/${encodeURIComponent(t)}`);
   }
 };
 a = new WeakSet(), ae = function(e) {
   return `${this.apiUrl}/${e}`;
-}, l = async function(e, t, s) {
-  const { body: r, query: i, contentType: o, retries: h } = s || {}, u = c(this, a, ae).call(this, t), y = c(this, a, Ue).call(this, i), d = await this.resolveAccessToken(), m = {
+}, u = async function(e, t, s) {
+  const { body: r, query: i, contentType: o, retries: h } = s || {}, l = c(this, a, ae).call(this, t), y = c(this, a, Ue).call(this, i), d = await this.resolveAccessToken(), m = {
     ...y,
     ...this.useBearer ? {} : { accessToken: d }
   };
   try {
     const w = await fetch(
-      u + "?" + new URLSearchParams(m).toString(),
+      l + "?" + new URLSearchParams(m).toString(),
       {
         method: e,
         headers: {
@@ -3152,7 +3168,7 @@ a = new WeakSet(), ae = function(e) {
   } catch (w) {
     let A = h ?? this.retries;
     if (A)
-      return A = A - 1, await c(this, a, l).call(this, e, t, {
+      return A = A - 1, await c(this, a, u).call(this, e, t, {
         ...s,
         retries: A
       });
@@ -3181,16 +3197,16 @@ a = new WeakSet(), ae = function(e) {
     }
   });
 }, M = async function(e, t, s) {
-  const { name: r, versionTag: i, parentFolderId: o, projectId: h, file: u, metadata: y } = e, d = new FormData();
-  return d.append("file", u), d.append("name", r), d.append("versionTag", i), d.append("itemType", t), o && d.append("folderId", o), h && d.append("projectId", h), s && d.append("extraProps", JSON.stringify(s)), y && d.append("metadata", JSON.stringify(y)), await c(this, a, l).call(this, "POST", p, {
+  const { name: r, versionTag: i, parentFolderId: o, projectId: h, file: l, metadata: y } = e, d = new FormData();
+  return d.append("file", l), d.append("name", r), d.append("versionTag", i), d.append("itemType", t), o && d.append("folderId", o), h && d.append("projectId", h), s && d.append("extraProps", JSON.stringify(s)), y && d.append("metadata", JSON.stringify(y)), await c(this, a, u).call(this, "POST", p, {
     body: d
   });
 }, ce = async function(e, t, s) {
-  const { name: r, versionTag: i, parentFolderId: o, file: h, metadata: u } = t;
+  const { name: r, versionTag: i, parentFolderId: o, file: h, metadata: l } = t;
   let y, d;
   if (h) {
     const m = new FormData();
-    m.append("file", h), i && m.append("versionTag", i), s && m.append("extraProps", JSON.stringify(s)), u && m.append("metadata", JSON.stringify(u)), d = await c(this, a, l).call(this, "POST", `${p}/${e}/version`, {
+    m.append("file", h), i && m.append("versionTag", i), s && m.append("extraProps", JSON.stringify(s)), l && m.append("metadata", JSON.stringify(l)), d = await c(this, a, u).call(this, "POST", `${p}/${e}/version`, {
       body: m
     });
   }
@@ -3199,7 +3215,7 @@ a = new WeakSet(), ae = function(e) {
       ...r && { name: r },
       ...o && { folderId: o }
     }, w = JSON.stringify(m);
-    y = await c(this, a, l).call(this, "PUT", `${p}/${e}`, {
+    y = await c(this, a, u).call(this, "PUT", `${p}/${e}`, {
       body: w,
       contentType: "application/json"
     });
@@ -3207,7 +3223,7 @@ a = new WeakSet(), ae = function(e) {
   return { item: y, version: d };
 }, he = async function(e, t) {
   const { showVersions: s = !1 } = t || {};
-  return await c(this, a, l).call(this, "GET", `${p}/${e}`, {
+  return await c(this, a, u).call(this, "GET", `${p}/${e}`, {
     query: { showVersions: s }
   });
 }, Ue = function(e) {

package/dist/types/files.d.ts

@@ -10,6 +10,12 @@ export type HiddenFileEntity = {
 export type CreateHiddenItemResult = {
     hiddenFileId: string;
 };
+export type CreateHiddenItemsBatchResult = {
+    results: {
+        originalName: string;
+        hiddenFileId: string;
+    }[];
+};
 export type MetadataValue = string | number | boolean | null;
 export type Metadata = Record<string, MetadataValue>;
 export declare const METADATA_LIMITS: {

package/dist/vite-env.d.ts

@@ -1 +1 @@
-/// <reference types="vite/client" />
+/// <reference types="vite/client" />

package/docs/builtin/paths.json

@@ -1,8 +1,4 @@
 [
-  {
-    "path": "src/built-in/AppManager/example.ts",
-    "description": ""
-  },
   {
     "path": "src/built-in/CDEManager/example.ts",
     "description": "CDEManager — CDEManager is the central state machine for a Common Data Environment. It holds files, folders, metadata schemas, viewer groups, and user permissions, and exposes a typed state machine that all file operations — selecting, editing, uploading, viewing — route through. It has no DOM or Three.js dependencies and can run in Node, a browser, or a server-side worker wherever `@thatopen/components` is available."
@@ -48,7 +44,27 @@
     "description": ""
   },
   {
-    "path": "src/built-in/ViewportsManager/example.ts",
-    "description": ""
+    "path": "src/built-in/UIManager/src/app/example.ts",
+    "description": "top-app — Front-end developers building BIM web apps need to coordinate several async initialization steps before the UI can be shown — loading the engine, preparing fragment workers, registering loaders — and users need visible feedback on what is happening during that wait, rather than a blank screen."
+  },
+  {
+    "path": "src/built-in/UIManager/src/app/examples/AppState/example.ts",
+    "description": "Shared reactive state with AppState — Developers building interactive BIM panels often need sibling components — a filter selector and a results table, for example — to stay in sync without a shared parent. Lifting state to a common ancestor and threading it down as props works for shallow trees but becomes unwieldy as the component tree grows."
+  },
+  {
+    "path": "src/built-in/UIManager/src/app/examples/Contexts/example.ts",
+    "description": "Consuming platform contexts in child components — Developers building custom BIM panels need access to the 3D engine, the platform API, and the current project's metadata — but threading these objects down through props across multiple component layers forces every intermediate element to know about data it doesn't use, making trees brittle and hard to refactor."
+  },
+  {
+    "path": "src/built-in/UIManager/src/app/examples/FloatingLayout/example.ts",
+    "description": "Floating layout — Developers building BIM coordination tools often want the 3D model to fill the entire window while control panels float above it — but standard grid layouts give every area equal standing, shrinking the viewer into one cell and leaving visible seams between it and the panels."
+  },
+  {
+    "path": "src/built-in/UIManager/src/app/examples/Notifications/example.ts",
+    "description": "Toasts, file drop, and cross-component notifications — Developers building BIM processing UIs need to surface status updates, errors, and file-drop feedback to users from different points in the component tree — but reaching back to the app root to trigger a notification from a deeply nested component requires threading a reference through every layer in between."
+  },
+  {
+    "path": "src/built-in/UIManager/src/app/examples/Sidebar/example.ts",
+    "description": "Sidebar navigation — Product teams building BIM apps often need multiple distinct views — a 3D model viewer, a data browser, a settings screen — but wiring a custom nav bar and managing view transitions from scratch adds complexity before any real feature work begins."
   }
 ]