@formant/data-sdk 1.81.6 → 1.81.8

package/dist/data-sdk.es.js

@@ -25597,8 +25597,21 @@ class BaseDevice extends EventEmitter {
   }
 }
 class Device extends BaseDevice {
-  constructor(t, n, r, o) {
-    super(), this.id = t, this.name = n, this.organizationId = r, this.tags = o;
+  constructor(n, r, o, s) {
+    super();
+    /**
+     * Connection monitor state.
+     *
+     * The original implementation would disconnect on the very first 1s tick if:
+     * - the connection wasn't "ready" yet, OR
+     * - RTC stats weren't available yet.
+     *
+     * On Firefox and iOS Safari, those conditions can be transient immediately after ICE reports "connected".
+     * That creates the "connect then disconnect after ~1s" pattern.
+     */
+    _e(this, "connectionMonitorStartedAtMs", 0);
+    _e(this, "connectionMonitorConsecutiveFailures", 0);
+    this.id = n, this.name = r, this.organizationId = o, this.tags = s;
   }
   async getLatestTelemetry() {
     return (await (await fetch(
@@ -25622,22 +25635,22 @@ class Device extends BaseDevice {
    * @returns {Promise<ConfigurationDocument>} A promise that resolves to the configuration document
    * @throws {Error} Throws an error if the device has no configuration or has never been turned on
    */
-  async getConfiguration(t = !1) {
-    let n = await fetch(`${FORMANT_API_URL}/v1/admin/devices/${this.id}`, {
+  async getConfiguration(n = !1) {
+    let r = await fetch(`${FORMANT_API_URL}/v1/admin/devices/${this.id}`, {
       method: "GET",
       headers: {
         "Content-Type": "application/json",
         Authorization: "Bearer " + Authentication.token
       }
     });
-    const r = await n.json();
-    if (!r.state.reportedConfiguration)
+    const o = await r.json();
+    if (!o.state.reportedConfiguration)
       throw new Error(
         "Device has no configuration, has it ever been turned on?"
       );
-    const o = t ? r.desiredConfigurationVersion : r.state.reportedConfiguration.version;
-    return n = await fetch(
-      `${FORMANT_API_URL}/v1/admin/devices/${this.id}/configurations/${o}`,
+    const s = n ? o.desiredConfigurationVersion : o.state.reportedConfiguration.version;
+    return r = await fetch(
+      `${FORMANT_API_URL}/v1/admin/devices/${this.id}/configurations/${s}`,
       {
         method: "GET",
         headers: {
@@ -25645,7 +25658,7 @@ class Device extends BaseDevice {
           Authorization: "Bearer " + Authentication.token
         }
       }
-    ), (await n.json()).document;
+    ), (await r.json()).document;
   }
   /**
    * Asynchronously retrieves the device's agent version string
@@ -25654,21 +25667,24 @@ class Device extends BaseDevice {
    * @throws {Error} Throws an error if the device info cannot be fetched
    */
   async getAgentVersion() {
-    var r;
-    const n = await (await fetch(`${FORMANT_API_URL}/v1/admin/devices/${this.id}`, {
-      method: "GET",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: "Bearer " + Authentication.token
+    var o;
+    const r = await (await fetch(
+      `${FORMANT_API_URL}/v1/admin/devices/${this.id}`,
+      {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: "Bearer " + Authentication.token
+        }
       }
-    })).json();
-    return (r = n == null ? void 0 : n.state) == null ? void 0 : r.agentVersion;
+    )).json();
+    return (o = r == null ? void 0 : r.state) == null ? void 0 : o.agentVersion;
   }
-  async getFileUrl(t) {
+  async getFileUrl(n) {
     return (await (await fetch(`${FORMANT_API_URL}/v1/admin/files/query`, {
       method: "POST",
       body: JSON.stringify({
-        fileIds: [t]
+        fileIds: [n]
       }),
       headers: {
         "Content-Type": "application/json",
@@ -25682,7 +25698,7 @@ class Device extends BaseDevice {
    * @throws `Error`  If the connection could not be established or if a connection already exists.
    * @returns {void}
    */
-  async startRealtimeConnection(t = {}) {
+  async startRealtimeConnection(n = {}) {
     if (console.debug(`${(/* @__PURE__ */ new Date()).toISOString()} :: Connection start requested`), this.rtcClient && this.connectionMonitorInterval !== void 0)
       throw new Error(
         `Already created realtime connection to device ${this.id}`
@@ -25691,102 +25707,149 @@ class Device extends BaseDevice {
       "overwriting existing rtcClient due to missing connectionMonitorInterval"
     );
     const {
-      sessionType: n,
-      deadlineMs: r = 1e4,
-      maxConnectRetries: o = 3
-    } = typeof t == "number" ? { sessionType: t } : t, c = getRtcClientPool({
-      sessionType: n
+      sessionType: r,
+      deadlineMs: o = 1e4,
+      maxConnectRetries: s = 3
+    } = typeof n == "number" ? { sessionType: n } : n, l = getRtcClientPool({
+      sessionType: r
     }).get(this.handleMessage);
-    let l = !1;
-    const u = new Promise(
-      (h, R) => setTimeout(() => {
-        l = !0, R(
+    let u = !1;
+    const d = new Promise(
+      (R, y) => setTimeout(() => {
+        u = !0, y(
           new Error(
             "Connection timed out: the connection could not be finalized in time, possibly due to network issues or misconfigured settings."
           )
         );
-      }, r)
-    ), d = async () => {
-      if ("isReady" in c)
-        for (; !c.isReady(); )
-          this.assertNotCancelled(l), await delay$1(100);
-      const h = await this.getRemoteDevicePeerId(c);
-      this.assertNotCancelled(l);
-      let R;
-      for (let Q = 0; Q < o && (R = await c.connect(h), !R); Q++)
-        delay$1(100), this.assertNotCancelled(l);
-      if (!R)
+      }, o)
+    ), h = async () => {
+      if ("isReady" in l)
+        for (; !l.isReady(); )
+          this.assertNotCancelled(u), await delay$1(100);
+      const R = await this.getRemoteDevicePeerId(l);
+      this.assertNotCancelled(u);
+      let y;
+      for (let f = 0; f < s && (y = await l.connect(R), !y); f++)
+        delay$1(100), this.assertNotCancelled(u);
+      if (!y)
         throw new Error(
-          `Session could not be created: exhausted ${o} retries`
+          `Session could not be created: exhausted ${s} retries`
         );
-      let y = 0;
-      for (; !l && c.getConnectionStatus(h) !== "connected"; )
-        await delay$1(100), y += 1;
-      return this.assertNotCancelled(l), console.debug(
-        `${(/* @__PURE__ */ new Date()).toISOString()} :: Connection completed after ${y} retries`
-      ), h;
+      let Q = 0;
+      for (; !u && l.getConnectionStatus(R) !== "connected"; )
+        await delay$1(100), Q += 1;
+      return this.assertNotCancelled(u), console.debug(
+        `${(/* @__PURE__ */ new Date()).toISOString()} :: Connection completed after ${Q} retries`
+      ), R;
     };
-    return Promise.race([d(), u]).then((h) => {
-      this.remoteDevicePeerId = h, this.initConnectionMonitoring(), this.rtcClient = c, this.emit("connect");
-    }).catch((h) => {
+    return Promise.race([h(), d]).then((R) => {
+      this.remoteDevicePeerId = R, this.rtcClient = l, this.connectionMonitorStartedAtMs = Date.now(), this.connectionMonitorConsecutiveFailures = 0, this.initConnectionMonitoring(), this.emit("connect");
+    }).catch((R) => {
       throw console.debug(
         `${(/* @__PURE__ */ new Date()).toISOString()} :: Connection failed: %o`,
-        h
-      ), this.remoteDevicePeerId = null, c.shutdown().catch((R) => {
-        console.error("rtcClient cannot shutdown: %o", R);
-      }), this.emit("connection_failed", h), h;
+        R
+      ), this.remoteDevicePeerId = null, l.shutdown().catch((y) => {
+        console.error("rtcClient cannot shutdown: %o", y);
+      }), this.emit("connection_failed", R), R;
     });
   }
-  async getRemoteDevicePeerId(t) {
-    const r = (await t.getPeers()).find((o) => o.deviceId === this.id);
-    if (!isRtcPeer(r))
+  async getRemoteDevicePeerId(n) {
+    const o = (await n.getPeers()).find((s) => s.deviceId === this.id);
+    if (!isRtcPeer(o))
       throw new Error("Cannot find peer, is the robot offline?");
-    return r.id;
+    return o.id;
   }
   initConnectionMonitoring() {
     this.connectionMonitorInterval = setInterval(async () => {
-      let t = !1;
+      let o = !1, s = !1, c = !1;
       if (this.rtcClient) {
-        const r = this.rtcClient.getConnections().find(
-          (o) => o.getRemotePeerId() === this.remoteDevicePeerId && o.isActive()
+        const h = this.rtcClient.getConnections().find(
+          (R) => R.getRemotePeerId() === this.remoteDevicePeerId && R.isActive()
         );
-        (r === void 0 || !r.isReady()) && (console.debug(`${(/* @__PURE__ */ new Date()).toISOString()} :: data channel closed`), t = !0);
+        (h === void 0 || !h.isReady()) && (console.debug(`${(/* @__PURE__ */ new Date()).toISOString()} :: data channel closed`), o = !0, s = !0);
       }
-      (!this.rtcClient || !this.remoteDevicePeerId || await this.rtcClient.getConnectionStatsInfo(
-        this.remoteDevicePeerId
-      ) === void 0 || t) && (this.emit("disconnect"), this.stopRealtimeConnection().catch((n) => {
-        console.error(n);
-      }));
+      if (!this.rtcClient || !this.remoteDevicePeerId) {
+        this.emit("disconnect"), this.stopRealtimeConnection().catch((d) => console.error(d));
+        return;
+      }
+      try {
+        c = await this.rtcClient.getConnectionStatsInfo(
+          this.remoteDevicePeerId
+        ) === void 0;
+      } catch {
+        c = !0;
+      }
+      const l = Date.now() - (this.connectionMonitorStartedAtMs || 0);
+      if (o || s) {
+        if (l < 6e3) {
+          console.debug(
+            `${(/* @__PURE__ */ new Date()).toISOString()} :: connection monitor unhealthy (grace)`,
+            {
+              elapsed: l,
+              connectionNotReady: s,
+              statsUnavailable: c,
+              dataChannelClosed: o,
+              consecutiveFailures: this.connectionMonitorConsecutiveFailures
+            }
+          );
+          return;
+        }
+        if (this.connectionMonitorConsecutiveFailures += 1, this.connectionMonitorConsecutiveFailures < 3) {
+          console.debug(
+            `${(/* @__PURE__ */ new Date()).toISOString()} :: connection monitor unhealthy (retrying)`,
+            {
+              elapsed: l,
+              connectionNotReady: s,
+              statsUnavailable: c,
+              dataChannelClosed: o,
+              consecutiveFailures: this.connectionMonitorConsecutiveFailures
+            }
+          );
+          return;
+        }
+        console.debug(
+          `${(/* @__PURE__ */ new Date()).toISOString()} :: connection monitor disconnecting`,
+          {
+            elapsed: l,
+            connectionNotReady: s,
+            statsUnavailable: c,
+            dataChannelClosed: o,
+            consecutiveFailures: this.connectionMonitorConsecutiveFailures
+          }
+        ), this.emit("disconnect"), this.stopRealtimeConnection().catch((d) => console.error(d));
+        return;
+      }
+      this.connectionMonitorConsecutiveFailures = 0;
     }, 1e3);
   }
   async getRemotePeer() {
-    const n = (await defined$1(
+    const r = (await defined$1(
       this.rtcClient,
       "Realtime connection has not been started"
-    ).getPeers()).find((r) => r.deviceId === this.id);
+    ).getPeers()).find((o) => o.deviceId === this.id);
     return defined$1(
-      n,
+      r,
       "Could not find remote peer for device " + this.id
     );
   }
   async stopRealtimeConnection() {
-    let t = !1;
+    let n = !1;
     if (this.rtcClient) {
-      this.stopConnectionMonitoring(), this.remoteDevicePeerId ? (await this.rtcClient.disconnect(this.remoteDevicePeerId), this.remoteDevicePeerId = null) : t = !0;
+      this.stopConnectionMonitoring(), this.remoteDevicePeerId ? (await this.rtcClient.disconnect(this.remoteDevicePeerId), this.remoteDevicePeerId = null) : n = !0;
       try {
         await this.rtcClient.shutdown();
       } finally {
         this.rtcClient = void 0;
       }
     }
-    if (t)
+    if (n)
       throw new Error(`Realtime connection hasn't been started for ${this.id}`);
   }
   async isInRealtimeSession() {
-    const t = await getPeers(), n = await getRealtimeSessions(), r = t.find((o) => o.deviceId === this.id);
-    return r ? n[r.id].length > 0 : !1;
+    const n = await getPeers(), r = await getRealtimeSessions(), o = n.find((s) => s.deviceId === this.id);
+    return o ? r[o.id].length > 0 : !1;
   }
-  async getAvailableCommands(t = !0) {
+  async getAvailableCommands(n = !0) {
     return (await (await fetch(
       `${FORMANT_API_URL}/v1/admin/command-templates/`,
       {
@@ -25796,32 +25859,32 @@ class Device extends BaseDevice {
           Authorization: "Bearer " + Authentication.token
         }
       }
-    )).json()).items.filter((o) => t ? !0 : o.enabled);
+    )).json()).items.filter((s) => n ? !0 : s.enabled);
   }
-  async sendCommand(t, n, r, o, s) {
-    var R;
-    const l = (await this.getAvailableCommands(!1)).find((y) => s ? y.id === s : y.name === t);
-    if (!l)
-      throw new Error(`Could not find command with name "${t}"`);
-    let u = "";
-    n === void 0 ? l.parameterEnabled && l.parameterValue && (u = l.parameterValue) : u = n;
-    let d = {
-      value: u,
-      scrubberTime: (r || /* @__PURE__ */ new Date()).toISOString(),
+  async sendCommand(n, r, o, s, c) {
+    var y;
+    const u = (await this.getAvailableCommands(!1)).find((Q) => c ? Q.id === c : Q.name === n);
+    if (!u)
+      throw new Error(`Could not find command with name "${n}"`);
+    let d = "";
+    r === void 0 ? u.parameterEnabled && u.parameterValue && (d = u.parameterValue) : d = r;
+    const h = {
+      value: d,
+      scrubberTime: (o || /* @__PURE__ */ new Date()).toISOString(),
       meta: {
-        ...l.parameterMeta,
-        ...o
+        ...u.parameterMeta,
+        ...s
       }
     };
     return await fetch(`${FORMANT_API_URL}/v1/admin/commands`, {
       method: "POST",
       body: JSON.stringify({
-        commandTemplateId: l.id,
+        commandTemplateId: u.id,
         organizationId: this.organizationId,
         deviceId: this.id,
-        command: l.command,
-        parameter: d,
-        userId: (R = Authentication.currentUser) == null ? void 0 : R.id
+        command: u.command,
+        parameter: h,
+        userId: (y = Authentication.currentUser) == null ? void 0 : y.id
       }),
       headers: {
         "Content-Type": "application/json",
@@ -25829,8 +25892,8 @@ class Device extends BaseDevice {
       }
     });
   }
-  async getCommand(t) {
-    return await fetch(`${FORMANT_API_URL}/v1/admin/commands/${t}`, {
+  async getCommand(n) {
+    return await fetch(`${FORMANT_API_URL}/v1/admin/commands/${n}`, {
       method: "GET",
       headers: {
         "Content-Type": "application/json",
@@ -25838,12 +25901,12 @@ class Device extends BaseDevice {
       }
     });
   }
-  async createCaptureStream(t) {
-    const r = await (await fetch(`${FORMANT_API_URL}/v1/admin/capture-sessions`, {
+  async createCaptureStream(n) {
+    const o = await (await fetch(`${FORMANT_API_URL}/v1/admin/capture-sessions`, {
       method: "POST",
       body: JSON.stringify({
         deviceId: this.id,
-        streamName: t,
+        streamName: n,
         tags: {}
       }),
       headers: {
@@ -25851,28 +25914,28 @@ class Device extends BaseDevice {
         Authorization: "Bearer " + Authentication.token
       }
     })).json();
-    return new CaptureStream(r);
+    return new CaptureStream(o);
   }
-  async getTelemetry(t, n, r, o, s, c, l) {
-    if (s !== void 0 || c !== void 0)
+  async getTelemetry(n, r, o, s, c, l, u) {
+    if (c !== void 0 || l !== void 0)
       throw new Error("Limit and offset are not supported in this method");
     return await getTelemetry(
       this.id,
-      t,
       n,
       r,
       o,
-      l
+      s,
+      u
     );
   }
-  async queryEvents(t) {
-    if (t.deviceIds)
+  async queryEvents(n) {
+    if (n.deviceIds)
       throw new Error("Cannot filter multiple devices via Device class");
-    return t.deviceIds = [this.id], queryEvents(t);
+    return n.deviceIds = [this.id], queryEvents(n);
   }
   async getTelemetryStreams() {
-    var l, u;
-    const t = await this.getConfiguration(), n = await fetch(
+    var u, d;
+    const n = await this.getConfiguration(), r = await fetch(
       `${FORMANT_API_URL}/v1/queries/metadata/stream-names`,
       {
         method: "POST",
@@ -25884,23 +25947,23 @@ class Device extends BaseDevice {
           Authorization: "Bearer " + Authentication.token
         }
       }
-    ), r = [], o = [];
-    return (u = (l = t.telemetry) == null ? void 0 : l.streams) == null || u.forEach((d) => {
-      d.disabled !== !0 && r.push(d.name), d.onDemand === !0 && o.push(d.name);
-    }), console.log(o), (await n.json()).items.filter((d) => !r.includes(d)).map((d) => ({ name: d, onDemand: o.includes(d) }));
+    ), o = [], s = [];
+    return (d = (u = n.telemetry) == null ? void 0 : u.streams) == null || d.forEach((h) => {
+      h.disabled !== !0 && o.push(h.name), h.onDemand === !0 && s.push(h.name);
+    }), console.log(s), (await r.json()).items.filter((h) => !o.includes(h)).map((h) => ({ name: h, onDemand: s.includes(h) }));
   }
-  async createInterventionRequest(t, n, r, o) {
+  async createInterventionRequest(n, r, o, s) {
     return await (await fetch(
       `${FORMANT_API_URL}/v1/admin/intervention-requests`,
       {
         method: "POST",
         body: JSON.stringify({
-          message: t,
-          interventionType: n,
+          message: n,
+          interventionType: r,
           time: (/* @__PURE__ */ new Date()).toISOString(),
           deviceId: this.id,
-          tags: o,
-          data: r
+          tags: s,
+          data: o
         }),
         headers: {
           "Content-Type": "application/json",
@@ -25909,15 +25972,15 @@ class Device extends BaseDevice {
       }
     )).json();
   }
-  async addInterventionResponse(t, n, r) {
+  async addInterventionResponse(n, r, o) {
     return await (await fetch(
       `${FORMANT_API_URL}/v1/admin/intervention-responses`,
       {
         method: "POST",
         body: JSON.stringify({
-          interventionId: t,
-          interventionType: n,
-          data: r
+          interventionId: n,
+          interventionType: r,
+          data: o
         }),
         headers: {
           "Content-Type": "application/json",
@@ -25926,24 +25989,24 @@ class Device extends BaseDevice {
       }
     )).json();
   }
-  async getAnnotationCount(t, n) {
-    return await getAnnotationCount({ ...t, deviceIds: [this.id] }, n);
+  async getAnnotationCount(n, r) {
+    return await getAnnotationCount({ ...n, deviceIds: [this.id] }, r);
   }
-  async getAnnotationCountByIntervals(t, n, r) {
+  async getAnnotationCountByIntervals(n, r, o) {
     return await getAnnotationCountByIntervals(
-      { ...t, deviceIds: [this.id] },
-      n,
-      r
+      { ...n, deviceIds: [this.id] },
+      r,
+      o
     );
   }
-  async eventsCounter(t, n, r, o, s) {
-    return await eventsCounter(t, n, r, o, {
-      ...s,
+  async eventsCounter(n, r, o, s, c) {
+    return await eventsCounter(n, r, o, s, {
+      ...c,
       deviceIds: [this.id]
     });
   }
-  async createShareLink(t, n) {
-    return t.scope.deviceIds = [this.id], await createShareLink(t, n);
+  async createShareLink(n, r) {
+    return n.scope.deviceIds = [this.id], await createShareLink(n, r);
   }
 }
 _e(Device, "createDevice", createDevice), _e(Device, "patchDevice", patchDevice), _e(Device, "getDevicesData", getDevicesData), _e(Device, "queryDevicesData", queryDevicesData), _e(Device, "disableDevice", disableDevice);