@thatopen/services 0.17.0 → 0.19.0

package/dist/index.es.js

@@ -77,7 +77,7 @@ const At = (n) => {
     default:
       return n instanceof ArrayBuffer ? n : n.buffer;
   }
-}, ot = "", $t = (n, e) => {
+}, ot = "", Rt = (n, e) => {
   const t = n.length, s = new Array(t);
   let r = 0;
   n.forEach((i, o) => {
@@ -85,7 +85,7 @@ const At = (n) => {
       s[o] = h, ++r === t && e(s.join(ot));
     });
   });
-}, Rt = (n, e) => {
+}, Ct = (n, e) => {
   const t = n.split(ot), s = [];
   for (let r = 0; r < t.length; r++) {
     const i = Fe(t[r], e);
@@ -94,7 +94,7 @@ const At = (n) => {
   }
   return s;
 };
-function Ct() {
+function $t() {
   return new TransformStream({
     transform(n, e) {
       kt(n, (t) => {
@@ -413,7 +413,7 @@ class Ht extends Me {
         return this.onClose({ description: "transport closed by the server" }), !1;
       this.onPacket(s);
     };
-    Rt(e, this.socket.binaryType).forEach(t), this.readyState !== "closed" && (this._polling = !1, this.emitReserved("pollComplete"), this.readyState === "open" && this._poll());
+    Ct(e, this.socket.binaryType).forEach(t), this.readyState !== "closed" && (this._polling = !1, this.emitReserved("pollComplete"), this.readyState === "open" && this._poll());
   }
   /**
    * For polling, send a close packet.
@@ -433,7 +433,7 @@ class Ht extends Me {
    * @protected
    */
   write(e) {
-    this.writable = !1, $t(e, (t) => {
+    this.writable = !1, Rt(e, (t) => {
       this.doWrite(t, () => {
         this.writable = !0, this.emitReserved("drain");
       });
@@ -721,7 +721,7 @@ class zt extends Me {
       this.onError("webtransport error", e);
     }), this._transport.ready.then(() => {
       this._transport.createBidirectionalStream().then((e) => {
-        const t = Nt(Number.MAX_SAFE_INTEGER, this.socket.binaryType), s = e.readable.pipeThrough(t).getReader(), r = Ct();
+        const t = Nt(Number.MAX_SAFE_INTEGER, this.socket.binaryType), s = e.readable.pipeThrough(t).getReader(), r = $t();
         r.readable.pipeTo(e.writable), this._writer = r.writable.getWriter();
         const i = () => {
           s.read().then(({ done: h, value: f }) => {
@@ -1094,8 +1094,8 @@ class ss extends M {
               s || this.readyState !== "closed" && (y(), this.setTransport(t), t.send([{ type: "upgrade" }]), this.emitReserved("upgrade", t), t = null, this.upgrading = !1, this.flush());
             });
           } else {
-            const R = new Error("probe error");
-            R.transport = t.name, this.emitReserved("upgradeError", R);
+            const C = new Error("probe error");
+            C.transport = t.name, this.emitReserved("upgradeError", C);
           }
       }));
     };
@@ -1103,8 +1103,8 @@ class ss extends M {
       s || (s = !0, y(), t.close(), t = null);
     }
     const o = (g) => {
-      const R = new Error("probe error: " + g);
-      R.transport = t.name, i(), this.emitReserved("upgradeError", R);
+      const C = new Error("probe error: " + g);
+      C.transport = t.name, i(), this.emitReserved("upgradeError", C);
     };
     function h() {
       o("transport closed");
@@ -1196,9 +1196,9 @@ function Oe(n, e) {
   return n;
 }
 function us(n, e) {
-  return n.data = $e(n.data, e), delete n.attachments, n;
+  return n.data = Re(n.data, e), delete n.attachments, n;
 }
-function $e(n, e) {
+function Re(n, e) {
   if (!n)
     return n;
   if (n && n._placeholder === !0) {
@@ -1207,10 +1207,10 @@ function $e(n, e) {
     throw new Error("illegal attachments");
   } else if (Array.isArray(n))
     for (let t = 0; t < n.length; t++)
-      n[t] = $e(n[t], e);
+      n[t] = Re(n[t], e);
   else if (typeof n == "object")
     for (const t in n)
-      Object.prototype.hasOwnProperty.call(n, t) && (n[t] = $e(n[t], e));
+      Object.prototype.hasOwnProperty.call(n, t) && (n[t] = Re(n[t], e));
   return n;
 }
 const ls = [
@@ -1429,7 +1429,7 @@ const ys = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     return p;
   }
 }, Symbol.toStringTag, { value: "Module" }));
-function $(n, e, t) {
+function R(n, e, t) {
   return n.on(e, t), function() {
     n.off(e, t);
   };
@@ -1477,10 +1477,10 @@ class pt extends w {
       return;
     const e = this.io;
     this.subs = [
-      $(e, "open", this.onopen.bind(this)),
-      $(e, "packet", this.onpacket.bind(this)),
-      $(e, "error", this.onerror.bind(this)),
-      $(e, "close", this.onclose.bind(this))
+      R(e, "open", this.onopen.bind(this)),
+      R(e, "packet", this.onpacket.bind(this)),
+      R(e, "error", this.onerror.bind(this)),
+      R(e, "close", this.onclose.bind(this))
     ];
   }
   /**
@@ -2058,7 +2058,7 @@ Q.prototype.setMax = function(n) {
 Q.prototype.setJitter = function(n) {
   this.jitter = n;
 };
-class Re extends w {
+class Ce extends w {
   constructor(e, t) {
     var s;
     super(), this.nsps = {}, this.subs = [], e && typeof e == "object" && (t = e, e = void 0), t = t || {}, t.path = t.path || "/socket.io", this.opts = t, me(this, t), this.reconnection(t.reconnection !== !1), this.reconnectionAttempts(t.reconnectionAttempts || 1 / 0), this.reconnectionDelay(t.reconnectionDelay || 1e3), this.reconnectionDelayMax(t.reconnectionDelayMax || 5e3), this.randomizationFactor((s = t.randomizationFactor) !== null && s !== void 0 ? s : 0.5), this.backoff = new Q({
@@ -2112,11 +2112,11 @@ class Re extends w {
     this.engine = new ns(this.uri, this.opts);
     const t = this.engine, s = this;
     this._readyState = "opening", this.skipReconnect = !1;
-    const r = $(t, "open", function() {
+    const r = R(t, "open", function() {
       s.onopen(), e && e();
     }), i = (h) => {
       this.cleanup(), this._readyState = "closed", this.emitReserved("error", h), e ? e(h) : this.maybeReconnectOnOpen();
-    }, o = $(t, "error", i);
+    }, o = R(t, "error", i);
     if (this._timeout !== !1) {
       const h = this._timeout, f = this.setTimeoutFn(() => {
         r(), i(new Error("timeout")), t.close();
@@ -2145,12 +2145,12 @@ class Re extends w {
     this.cleanup(), this._readyState = "open", this.emitReserved("open");
     const e = this.engine;
     this.subs.push(
-      $(e, "ping", this.onping.bind(this)),
-      $(e, "data", this.ondata.bind(this)),
-      $(e, "error", this.onerror.bind(this)),
-      $(e, "close", this.onclose.bind(this)),
+      R(e, "ping", this.onping.bind(this)),
+      R(e, "data", this.ondata.bind(this)),
+      R(e, "error", this.onerror.bind(this)),
+      R(e, "close", this.onclose.bind(this)),
       // @ts-ignore
-      $(this.decoder, "decoded", this.ondecoded.bind(this))
+      R(this.decoder, "decoded", this.ondecoded.bind(this))
     );
   }
   /**
@@ -2301,10 +2301,10 @@ function se(n, e) {
   typeof n == "object" && (e = n, n = void 0), e = e || {};
   const t = rs(n, e.path || "/socket.io"), s = t.source, r = t.id, i = t.path, o = Z[r] && i in Z[r].nsps, h = e.forceNew || e["force new connection"] || e.multiplex === !1 || o;
   let f;
-  return h ? f = new Re(s, e) : (Z[r] || (Z[r] = new Re(s, e)), f = Z[r]), t.query && !e.query && (e.query = t.queryKey), f.socket(t.path, e);
+  return h ? f = new Ce(s, e) : (Z[r] || (Z[r] = new Ce(s, e)), f = Z[r]), t.query && !e.query && (e.query = t.queryKey), f.socket(t.path, e);
 }
 Object.assign(se, {
-  Manager: Re,
+  Manager: Ce,
   Socket: pt,
   io: se,
   connect: se
@@ -2346,7 +2346,7 @@ class Ve extends Error {
     this.name = "RequestError", this.status = t, this.code = o.code, this.details = o.details, this.body = r, this.retryAfter = i ?? ws(o.details);
   }
 }
-const C = "item/folder", d = "item", L = "processor", _s = "npm-registry", B = "hidden", Ee = "FILE", Te = "TOOL", ve = "APP", bs = 500, et = 3e4, Es = 0.25, Ts = (n) => new Promise((e) => setTimeout(e, n));
+const $ = "item/folder", d = "item", L = "processor", _s = "npm-registry", B = "hidden", Ee = "FILE", Te = "TOOL", ve = "APP", bs = 500, et = 3e4, Es = 0.25, Ts = (n) => new Promise((e) => setTimeout(e, n));
 function vs(n) {
   var r, i;
   const e = (i = (r = n.headers) == null ? void 0 : r.get) == null ? void 0 : i.call(r, "Retry-After");
@@ -2398,7 +2398,7 @@ const Je = class Je {
     T(this, "context");
     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) {
+    if (h.charAt(h.length - 1) === "/" && (h = h.slice(0, -1)), this.apiUrl = `${h}/api`, this.accessToken = e, this.wsUrl = h, this.retries = r, this.useBearer = i, this.context = { appId: "", projectId: "", accessToken: e, apiUrl: t }, o) {
       let f = o;
       f.charAt(f.length - 1) === "/" && (f = f.slice(0, -1)), this.localServerUrl = f;
     }
@@ -2442,19 +2442,23 @@ const Je = class Je {
    * {@link initBuiltInComponent} call will use these globals automatically
    * — you no longer need to pass a `globals` argument to each one.
    *
-   * @param globals - Map of global names to module namespaces.
-   *   Common keys: `OBC`, `OBF`, `BUI`, `CUI`, `THREE`, `FRAGS`, `MARKERJS`.
+   * @param globals - Map of global names to module namespaces. The FULL set
+   *   a built-in may ask for: `OBC`, `OBF`, `BUI`, `THREE`, `FRAGS`,
+   *   `MARKERJS` (plus `CUI` only if the app still uses the deprecated
+   *   `@thatopen/ui-obc`). Only `OBC` and `BUI` are strictly required by
+   *   `setup()`; passing everything you import is the safe default, because
+   *   a built-in that needs a missing one fails at init.
    *
    * @example
    * ```ts
    * import * as OBC from "@thatopen/components";
    * import * as OBF from "@thatopen/components-front";
    * import * as BUI from "@thatopen/ui";
-   * import * as CUI from "@thatopen/ui-obc";
    * import * as THREE from "three";
    * import * as FRAGS from "@thatopen/fragments";
+   * import * as MARKERJS from "@markerjs/markerjs3";
    *
-   * client.setBuiltInGlobals({ OBC, OBF, BUI, CUI, THREE, FRAGS });
+   * client.setBuiltInGlobals({ OBC, OBF, BUI, THREE, FRAGS, MARKERJS });
    *
    * // Now just pass the component — no globals needed:
    * await client.initBuiltInComponent(AppManager, components);
@@ -2476,8 +2480,8 @@ const Je = class Je {
    */
   /**
    * Socket origin without namespace or query, for gateways other than the
-   * execution one. `wsUrl` already carries a token that may be stale when a
-   * provider is in play, so callers append their own.
+   * execution one. Callers pass their own credential in the Socket.IO auth
+   * payload, resolved at connect time so a provider-backed client is current.
    */
   get socketOrigin() {
     return this.wsUrl.split("?")[0];
@@ -2502,7 +2506,7 @@ const Je = class Je {
    */
   async listFiles(e) {
     const { folderId: t, archived: s, projectId: r } = e || {};
-    return t ? await a(this, c, l).call(this, "GET", `${C}/${t}/items`, { query: { itemType: Ee, archived: s } }) : await a(this, c, l).call(this, "GET", `${d}`, {
+    return t ? await a(this, c, l).call(this, "GET", `${$}/${t}/items`, { query: { itemType: Ee, archived: s } }) : await a(this, c, l).call(this, "GET", `${d}`, {
       query: {
         itemType: Ee,
         archived: s,
@@ -2626,7 +2630,7 @@ const Je = class Je {
    */
   async listFolders(e) {
     const { archived: t, parentFolderId: s, projectId: r } = e || {};
-    return await a(this, c, l).call(this, "GET", C, {
+    return await a(this, c, l).call(this, "GET", $, {
       query: {
         parentFolderId: s,
         archived: t,
@@ -2639,7 +2643,7 @@ const Je = class Je {
    * @param folderId - The folder's unique identifier.
    */
   async getFolder(e) {
-    return await a(this, c, l).call(this, "GET", `${C}/${e}`);
+    return await a(this, c, l).call(this, "GET", `${$}/${e}`);
   }
   /**
    * Batch variant of {@link getFolder}. Resolves a known set of folder ids in
@@ -2667,7 +2671,7 @@ const Je = class Je {
    * @returns The created folder.
    */
   async createFolder(e, t, s) {
-    return await a(this, c, l).call(this, "POST", C, {
+    return await a(this, c, l).call(this, "POST", $, {
       body: JSON.stringify({
         name: e,
         ...t && { parentId: t },
@@ -2684,7 +2688,7 @@ const Je = class Je {
    */
   async updateFolder(e, t) {
     const { name: s } = t;
-    return await a(this, c, l).call(this, "PUT", `${C}/${e}`, {
+    return await a(this, c, l).call(this, "PUT", `${$}/${e}`, {
       body: JSON.stringify({ name: s }),
       contentType: "application/json"
     });
@@ -2694,14 +2698,14 @@ const Je = class Je {
    * @param folderId - The folder's unique identifier.
    */
   async archiveFolder(e) {
-    return await a(this, c, l).call(this, "DELETE", `${C}/${e}`);
+    return await a(this, c, l).call(this, "DELETE", `${$}/${e}`);
   }
   /**
    * Recovers a previously archived folder.
    * @param folderId - The folder's unique identifier.
    */
   async recoverFolder(e) {
-    return await a(this, c, l).call(this, "PUT", `${C}/${e}/recover`);
+    return await a(this, c, l).call(this, "PUT", `${$}/${e}/recover`);
   }
   /**
    * Downloads an entire folder as a ZIP archive.
@@ -2709,7 +2713,7 @@ const Je = class Je {
    * @returns A fetch Response containing the ZIP data.
    */
   async downloadFolder(e) {
-    return await a(this, c, q).call(this, `${C}/${e}/download`);
+    return await a(this, c, q).call(this, `${$}/${e}/download`);
   }
   // ─── Components ──────────────────────────────────────────────────
   /**
@@ -2719,7 +2723,7 @@ const Je = class Je {
    */
   async listComponents(e) {
     const { folderId: t, ShowVersions: s, projectId: r } = e || {};
-    return t ? await a(this, c, l).call(this, "GET", `${C}/${t}/items`, {
+    return t ? await a(this, c, l).call(this, "GET", `${$}/${t}/items`, {
       query: {
         itemType: Te,
         ...s && { ShowVersions: s }
@@ -2903,7 +2907,7 @@ return main;`)(...h), y = (m == null ? void 0 : m.componentDefinition) ?? m;
    */
   async listApps(e) {
     const { folderId: t, ShowVersions: s, projectId: r } = e || {};
-    return t ? await a(this, c, l).call(this, "GET", `${C}/${t}/items`, {
+    return t ? await a(this, c, l).call(this, "GET", `${$}/${t}/items`, {
       query: {
         itemType: ve,
         ...s && { ShowVersions: s }
@@ -3073,8 +3077,9 @@ return main;`)(...h), y = (m == null ? void 0 : m.componentDefinition) ?? m;
    * @param onUpdateCallback - Callback invoked on each progress/result event.
    */
   async onExecutionProgress(e, t) {
-    const s = this.localServerUrl ? `${this.localServerUrl}?accessToken=${this.accessToken}` : this.wsUrl, r = await se(s, {
-      ...this.localServerUrl && { transports: ["websocket"] }
+    const s = this.localServerUrl ?? this.wsUrl, r = await se(s, {
+      auth: { accessToken: this.accessToken },
+      transports: ["websocket"]
     });
     r.on("connect", function() {
       r.emit("executionSubscription", JSON.stringify({ executionId: e })), r.on("execution", (i) => {
@@ -3329,9 +3334,9 @@ return main;`)(...h), y = (m == null ? void 0 : m.componentDefinition) ?? m;
 c = new WeakSet(), Ne = function(e) {
   return `${this.apiUrl}/${e}`;
 }, l = async function(e, t, s) {
-  const { body: r, query: i, contentType: o, retries: h, responseType: f, retryAttempt: m } = s || {}, y = a(this, c, Ne).call(this, t), g = a(this, c, yt).call(this, i), R = await this.resolveAccessToken(), Et = {
+  const { body: r, query: i, contentType: o, retries: h, responseType: f, retryAttempt: m } = s || {}, y = a(this, c, Ne).call(this, t), g = a(this, c, yt).call(this, i), C = await this.resolveAccessToken(), Et = {
     ...g,
-    ...this.useBearer ? {} : { accessToken: R }
+    ...this.useBearer ? {} : { accessToken: C }
   };
   try {
     const O = await fetch(
@@ -3341,29 +3346,29 @@ c = new WeakSet(), Ne = function(e) {
         headers: {
           Accept: "application/json",
           ...o && { "Content-Type": o },
-          ...this.useBearer && { Authorization: `Bearer ${R}` }
+          ...this.useBearer && { Authorization: `Bearer ${C}` }
         },
         ...r && { body: r }
       }
     );
     if (!O.ok) {
-      const j = await O.text().then((ie) => ie).catch(() => "");
+      const V = await O.text().then((ie) => ie).catch(() => "");
       throw new Ve(
         O.status,
         O.statusText,
-        j,
+        V,
         vs(O)
       );
     }
-    return f === "blob" ? await O.blob() : O.json().then((j) => j).catch(() => {
+    return f === "blob" ? await O.blob() : O.json().then((V) => V).catch(() => {
     });
   } catch (O) {
-    const j = h ?? this.retries;
-    if (j > 0 && ks(O)) {
+    const V = h ?? this.retries;
+    if (V > 0 && ks(O)) {
       const ie = m ?? 0;
       return await Ts(As(O, ie)), await a(this, c, l).call(this, e, t, {
         ...s,
-        retries: j - 1,
+        retries: V - 1,
         retryAttempt: ie + 1
       });
     }
@@ -3415,9 +3420,9 @@ c = new WeakSet(), Ne = function(e) {
     const g = {
       ...r && { name: r },
       ...o && { folderId: o }
-    }, R = JSON.stringify(g);
+    }, C = JSON.stringify(g);
     m = await a(this, c, l).call(this, "PUT", `${d}/${e}`, {
-      body: R,
+      body: C,
       contentType: "application/json"
     });
   }
@@ -3433,7 +3438,7 @@ c = new WeakSet(), Ne = function(e) {
     {}
   );
 };
-let Ce = Je;
+let $e = Je;
 function Ss() {
   if (typeof window > "u" || window.parent === window)
     throw new Error(
@@ -3555,7 +3560,7 @@ x = new WeakMap(), k = new WeakMap(), A = new WeakMap(), Y = new WeakMap(), W =
   u(this, Y).forEach((e) => de(e));
 };
 var z;
-class $s extends mt {
+class Rs extends mt {
   /** @internal Use `client.channel.collab()`. */
   constructor(t) {
     super(t, {
@@ -3593,7 +3598,7 @@ class $s extends mt {
 }
 z = new WeakMap();
 var U;
-class Rs extends mt {
+class Cs extends mt {
   /** @internal Use `client.channel.external(kind)`. */
   constructor(t, s) {
     super(t, {
@@ -3649,7 +3654,7 @@ function gt(n) {
     kind: n.kind
   };
 }
-function Cs(n) {
+function $s(n) {
   const e = n;
   if ((e == null ? void 0 : e.type) !== "THATOPEN_CHANNEL_MESSAGE") return null;
   const t = e.message;
@@ -3663,20 +3668,20 @@ function Cs(n) {
     kind: typeof t.kind == "string" ? t.kind : void 0
   };
 }
-var H, ne, I, D, F, b, qe, pe, wt, _t, bt, Ue;
+var j, ne, I, D, F, b, qe, pe, wt, _t, bt, Ue;
 class Ns {
   constructor(e) {
     _(this, b);
-    _(this, H);
+    _(this, j);
     _(this, ne);
     _(this, I);
     _(this, D, /* @__PURE__ */ new Map());
     _(this, F, /* @__PURE__ */ new Set());
-    E(this, H, e), E(this, ne, e.listen((t) => void a(this, b, wt).call(this, t)));
+    E(this, j, e), E(this, ne, e.listen((t) => void a(this, b, wt).call(this, t)));
   }
   /** The collaboration room for this app. Always the same instance. */
   collab() {
-    return u(this, I) ?? E(this, I, new $s(u(this, H))), u(this, I);
+    return u(this, I) ?? E(this, I, new Rs(u(this, j))), u(this, I);
   }
   /**
    * The room for commands from this account's external tools of one `kind`
@@ -3686,21 +3691,21 @@ class Ns {
   external(e) {
     const t = e ?? "";
     let s = u(this, D).get(t);
-    return s || (s = new Rs(u(this, H), e), u(this, D).set(t, s)), s;
+    return s || (s = new Cs(u(this, j), e), u(this, D).set(t, s)), s;
   }
   /** Stops listening. For tests and teardown; an app normally never calls it. */
   dispose() {
     u(this, ne).call(this);
   }
 }
-H = new WeakMap(), ne = new WeakMap(), I = new WeakMap(), D = new WeakMap(), F = new WeakMap(), b = new WeakSet(), qe = function() {
+j = new WeakMap(), ne = new WeakMap(), I = new WeakMap(), D = new WeakMap(), F = new WeakMap(), b = new WeakSet(), qe = function() {
   return [...u(this, I) ? [u(this, I)] : [], ...u(this, D).values()];
 }, pe = function(e, t) {
   if (e === "collab") return u(this, I);
   if (e === "external")
     return u(this, D).get(typeof t == "string" ? t : "");
 }, wt = async function(e) {
-  const t = Cs(e);
+  const t = $s(e);
   if (t) {
     if (t.type.startsWith(xe)) {
       a(this, b, _t).call(this, t);
@@ -3749,7 +3754,7 @@ H = new WeakMap(), ne = new WeakMap(), I = new WeakMap(), D = new WeakMap(), F =
     error: `No handler for "${e.type}".`
   });
 }, Ue = function(e, t) {
-  u(this, F).has(e) || (u(this, F).add(e), u(this, F).size > 500 && u(this, F).delete(u(this, F).values().next().value), u(this, H).post({
+  u(this, F).has(e) || (u(this, F).add(e), u(this, F).size > 500 && u(this, F).delete(u(this, F).values().next().value), u(this, j).post({
     type: "APP_CHANNEL_PUBLISH",
     message: {
       type: t.error === void 0 ? "reply" : "reply-error",
@@ -3758,9 +3763,9 @@ H = new WeakMap(), ne = new WeakMap(), I = new WeakMap(), D = new WeakMap(), F =
     }
   }));
 };
-const V = "project", J = "notifications";
+const H = "project", J = "notifications";
 var X, re;
-const Ge = class Ge extends Ce {
+const Ge = class Ge extends $e {
   /**
    * @param token - A bearer JWT, OR a function returning the current JWT
    *   (sync or async). When a function is passed, it's invoked before every
@@ -3816,12 +3821,30 @@ const Ge = class Ge extends Ce {
     return u(this, re) ?? E(this, re, new Ns(Ss())), u(this, re);
   }
   // ─── Projects (JWT-only backend routes) ──────────────────────────
+  /**
+   * Lists the caller's projects, each with their role in it. The discovery
+   * call: everything else on this surface takes a projectId, and until this
+   * method there was no way to find out which ids exist — a portfolio
+   * dashboard had to be configured by hand. `ProjectWithRole` existed as a
+   * type with no producer; this is the producer.
+   *
+   * @example
+   * ```ts
+   * const projects = await client.listProjects();
+   * for (const { project, role } of projects) {
+   *   console.log(project.title, role?.name ?? 'no role');
+   * }
+   * ```
+   */
+  async listProjects() {
+    return await this.request("GET", H);
+  }
   /**
    * Gets a project by ID. JWT-only — lives here because
    * `GET /project/:id` is guarded by `AccountActiveGuard + ProjectAccessGuard`.
    */
   async getProject(t) {
-    return await this.request("GET", `${V}/${t}`);
+    return await this.request("GET", `${H}/${t}`);
   }
   /**
    * Gets the full project data (users, roles, files, folders) for a project.
@@ -3830,7 +3853,7 @@ const Ge = class Ge extends Ce {
   async getProjectData(t) {
     return await this.request(
       "GET",
-      `${V}/${t}/data`
+      `${H}/${t}/data`
     );
   }
   // ─── Account ──────────────────────────────────────────────────────
@@ -3855,7 +3878,7 @@ const Ge = class Ge extends Ce {
   async checkPermission(t) {
     return await this.request(
       "GET",
-      `${V}/permissions/check`,
+      `${H}/permissions/check`,
       { query: t }
     );
   }
@@ -3864,7 +3887,7 @@ const Ge = class Ge extends Ce {
    * single round-trip; results come back in the same order as `checks`.
    */
   async checkPermissionBatch(t) {
-    return (await this.request("POST", `${V}/permissions/check/batch`, {
+    return (await this.request("POST", `${H}/permissions/check/batch`, {
       body: JSON.stringify({ checks: t }),
       contentType: "application/json"
     })).results;
@@ -3976,7 +3999,7 @@ const Ge = class Ge extends Ce {
   async subscribeToAutomation(t, s, r) {
     return await this.request(
       "POST",
-      `${V}/${t}/events/hooks/${s}/subscription`,
+      `${H}/${t}/events/hooks/${s}/subscription`,
       {
         body: JSON.stringify(r ?? {}),
         contentType: "application/json"
@@ -3993,7 +4016,7 @@ const Ge = class Ge extends Ce {
   async updateAutomationSubscription(t, s, r) {
     return await this.request(
       "PATCH",
-      `${V}/${t}/events/hooks/${s}/subscription`,
+      `${H}/${t}/events/hooks/${s}/subscription`,
       {
         body: JSON.stringify(r),
         contentType: "application/json"
@@ -4027,10 +4050,10 @@ const Ge = class Ge extends Ce {
    * ```
    */
   async onNotification(t) {
-    const s = await this.resolveAccessToken(), r = se(
-      `${this.socketOrigin}/notifications?accessToken=${encodeURIComponent(s)}`,
-      { transports: ["websocket"] }
-    );
+    const s = await this.resolveAccessToken(), r = se(`${this.socketOrigin}/notifications`, {
+      auth: { accessToken: s },
+      transports: ["websocket"]
+    });
     return r.on(
       "notification.created",
       (i) => t({ type: "created", id: i == null ? void 0 : i.id })
@@ -4049,24 +4072,26 @@ const xs = {
   MAX_FIELDS: 200,
   MAX_KEY_LENGTH: 50,
   MAX_VALUE_LENGTH: 50
-}, Is = { uuid: "a3f82c1d-5b74-4e9a-bc30-d7e12f894a61" }, Ls = { uuid: "2c9f4e8d-3a1b-4c5e-9d7f-0a2b6c8e1d3f" }, qs = { uuid: "b0b5e2a2-0b3a-4a6b-8b1c-0b1c4a6b8b1c" }, Us = { uuid: "3f9c1a7e-6b2d-4e18-9a5c-7d0e2f4b6c81" }, Ds = { uuid: "2c4ae432-fc24-43e9-9783-0c960c674e96" }, Fs = { uuid: "6f3a9c2e-8b1d-4e6a-9c3f-1d7b5a8e2c4f" }, Ms = { uuid: "69af63aa-19ba-4fc7-b17b-75647bac1d76" }, Hs = { uuid: "234f1416-528d-452a-9cc9-a16c5239b2eb" };
+}, Is = { uuid: "a3f82c1d-5b74-4e9a-bc30-d7e12f894a61" }, Ls = { uuid: "2c9f4e8d-3a1b-4c5e-9d7f-0a2b6c8e1d3f" }, qs = { uuid: "b0b5e2a2-0b3a-4a6b-8b1c-0b1c4a6b8b1c" }, Us = { uuid: "d8f3a1c2-6b4e-4f9a-8c1d-2e7b5a9f3c60" }, Ds = { uuid: "3f9c1a7e-6b2d-4e18-9a5c-7d0e2f4b6c81" }, Fs = { uuid: "2c4ae432-fc24-43e9-9783-0c960c674e96" }, Ms = { uuid: "6f3a9c2e-8b1d-4e6a-9c3f-1d7b5a8e2c4f" }, Hs = { uuid: "69af63aa-19ba-4fc7-b17b-75647bac1d76" }, js = { uuid: "234f1416-528d-452a-9cc9-a16c5239b2eb" };
 export {
   Is as CDEManager,
   Ns as ChannelClient,
   mt as ChannelRoom,
   Ls as ClashesManager,
-  $s as CollabRoom,
-  Ce as EngineServicesClient,
-  Rs as ExternalRoom,
+  Rs as CollabRoom,
+  $e as EngineServicesClient,
+  Cs as ExternalRoom,
   qs as FileList,
-  Us as GitHistoryManager,
-  Ds as HelloWorld,
+  Us as GISManager,
+  Ds as GitHistoryManager,
+  Fs as HelloWorld,
   xs as METADATA_LIMITS,
   tt as PlatformClient,
-  Fs as ProjectManager,
+  Ms as ProjectManager,
   Ve as RequestError,
   Ze as STORAGE_BATCH_MAX,
-  Ms as TopicsManager,
-  Hs as UIManager,
+  Hs as TopicsManager,
+  js as UIManager,
   Ss as windowTransport
 };
+//# sourceMappingURL=index.es.js.map