@stinkycomputing/sesame-api-client 1.4.1-beta.5 → 1.4.1-beta.7

package/README.md

@@ -48,6 +48,8 @@ import { sesame } from '@stinkycomputing/sesame-api-client';
 | `sesame.v1.commands` | Command list items |
 | `sesame.v1.rpc` | RPC message envelope (Request/Response/Event) |
 
+For the complete type reference with every enum value, message field, and property name, see **[Protocol Reference](docs/protocol-reference.md)**.
+
 ## Wire Protocol
 
 Every websocket message is framed as:

package/dist/index.browser.mjs

@@ -8574,7 +8574,7 @@ var sesame = $root.sesame = (() => {
         RecorderClip.prototype.endTimeUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
         RecorderClip.prototype.lockedStartUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
         RecorderClip.prototype.lockedEndUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
-        RecorderClip.prototype.userTimeMs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
+        RecorderClip.prototype.userTimeUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
         RecorderClip.create = function create(properties) {
           return new RecorderClip(properties);
         };
@@ -8621,11 +8621,11 @@ var sesame = $root.sesame = (() => {
               /* id 8, wireType 0 =*/
               64
             ).int64(message.lockedEndUs);
-          if (message.userTimeMs != null && Object.hasOwnProperty.call(message, "userTimeMs"))
+          if (message.userTimeUs != null && Object.hasOwnProperty.call(message, "userTimeUs"))
             writer.uint32(
               /* id 9, wireType 0 =*/
               72
-            ).int64(message.userTimeMs);
+            ).int64(message.userTimeUs);
           return writer;
         };
         RecorderClip.encodeDelimited = function encodeDelimited(message, writer) {
@@ -8673,7 +8673,7 @@ var sesame = $root.sesame = (() => {
                 break;
               }
               case 9: {
-                message.userTimeMs = reader.int64();
+                message.userTimeUs = reader.int64();
                 break;
               }
               default:
@@ -8723,9 +8723,9 @@ var sesame = $root.sesame = (() => {
             if (!$util.isInteger(message.lockedEndUs) && !(message.lockedEndUs && $util.isInteger(message.lockedEndUs.low) && $util.isInteger(message.lockedEndUs.high)))
               return "lockedEndUs: integer|Long expected";
           }
-          if (message.userTimeMs != null && message.hasOwnProperty("userTimeMs")) {
-            if (!$util.isInteger(message.userTimeMs) && !(message.userTimeMs && $util.isInteger(message.userTimeMs.low) && $util.isInteger(message.userTimeMs.high)))
-              return "userTimeMs: integer|Long expected";
+          if (message.userTimeUs != null && message.hasOwnProperty("userTimeUs")) {
+            if (!$util.isInteger(message.userTimeUs) && !(message.userTimeUs && $util.isInteger(message.userTimeUs.low) && $util.isInteger(message.userTimeUs.high)))
+              return "userTimeUs: integer|Long expected";
           }
           return null;
         };
@@ -8797,15 +8797,15 @@ var sesame = $root.sesame = (() => {
             else if (typeof object.lockedEndUs === "object")
               message.lockedEndUs = new $util.LongBits(object.lockedEndUs.low >>> 0, object.lockedEndUs.high >>> 0).toNumber();
           }
-          if (object.userTimeMs != null) {
+          if (object.userTimeUs != null) {
             if ($util.Long)
-              (message.userTimeMs = $util.Long.fromValue(object.userTimeMs)).unsigned = false;
-            else if (typeof object.userTimeMs === "string")
-              message.userTimeMs = parseInt(object.userTimeMs, 10);
-            else if (typeof object.userTimeMs === "number")
-              message.userTimeMs = object.userTimeMs;
-            else if (typeof object.userTimeMs === "object")
-              message.userTimeMs = new $util.LongBits(object.userTimeMs.low >>> 0, object.userTimeMs.high >>> 0).toNumber();
+              (message.userTimeUs = $util.Long.fromValue(object.userTimeUs)).unsigned = false;
+            else if (typeof object.userTimeUs === "string")
+              message.userTimeUs = parseInt(object.userTimeUs, 10);
+            else if (typeof object.userTimeUs === "number")
+              message.userTimeUs = object.userTimeUs;
+            else if (typeof object.userTimeUs === "object")
+              message.userTimeUs = new $util.LongBits(object.userTimeUs.low >>> 0, object.userTimeUs.high >>> 0).toNumber();
           }
           return message;
         };
@@ -8848,9 +8848,9 @@ var sesame = $root.sesame = (() => {
               object.lockedEndUs = options.longs === String ? "0" : 0;
             if ($util.Long) {
               let long = new $util.Long(0, 0, false);
-              object.userTimeMs = options.longs === String ? long.toString() : options.longs === Number ? long.toNumber() : long;
+              object.userTimeUs = options.longs === String ? long.toString() : options.longs === Number ? long.toNumber() : long;
             } else
-              object.userTimeMs = options.longs === String ? "0" : 0;
+              object.userTimeUs = options.longs === String ? "0" : 0;
           }
           if (message.id != null && message.hasOwnProperty("id"))
             if (typeof message.id === "number")
@@ -8886,11 +8886,11 @@ var sesame = $root.sesame = (() => {
               object.lockedEndUs = options.longs === String ? String(message.lockedEndUs) : message.lockedEndUs;
             else
               object.lockedEndUs = options.longs === String ? $util.Long.prototype.toString.call(message.lockedEndUs) : options.longs === Number ? new $util.LongBits(message.lockedEndUs.low >>> 0, message.lockedEndUs.high >>> 0).toNumber() : message.lockedEndUs;
-          if (message.userTimeMs != null && message.hasOwnProperty("userTimeMs"))
-            if (typeof message.userTimeMs === "number")
-              object.userTimeMs = options.longs === String ? String(message.userTimeMs) : message.userTimeMs;
+          if (message.userTimeUs != null && message.hasOwnProperty("userTimeUs"))
+            if (typeof message.userTimeUs === "number")
+              object.userTimeUs = options.longs === String ? String(message.userTimeUs) : message.userTimeUs;
             else
-              object.userTimeMs = options.longs === String ? $util.Long.prototype.toString.call(message.userTimeMs) : options.longs === Number ? new $util.LongBits(message.userTimeMs.low >>> 0, message.userTimeMs.high >>> 0).toNumber() : message.userTimeMs;
+              object.userTimeUs = options.longs === String ? $util.Long.prototype.toString.call(message.userTimeUs) : options.longs === Number ? new $util.LongBits(message.userTimeUs.low >>> 0, message.userTimeUs.high >>> 0).toNumber() : message.userTimeUs;
           return object;
         };
         RecorderClip.prototype.toJSON = function toJSON() {
@@ -13703,7 +13703,7 @@ var sesame = $root.sesame = (() => {
         TransportEvent.prototype.durationUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
         TransportEvent.prototype.positionUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
         TransportEvent.prototype.materialPositionUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
-        TransportEvent.prototype.userTimeMs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
+        TransportEvent.prototype.userTimeUs = $util.Long ? $util.Long.fromBits(0, 0, false) : 0;
         TransportEvent.prototype.speed = 0;
         TransportEvent.prototype.userPlaylistId = "";
         TransportEvent.prototype.playlistIndex = 0;
@@ -13755,11 +13755,11 @@ var sesame = $root.sesame = (() => {
               /* id 7, wireType 0 =*/
               56
             ).int64(message.materialPositionUs);
-          if (message.userTimeMs != null && Object.hasOwnProperty.call(message, "userTimeMs"))
+          if (message.userTimeUs != null && Object.hasOwnProperty.call(message, "userTimeUs"))
             writer.uint32(
               /* id 8, wireType 0 =*/
               64
-            ).int64(message.userTimeMs);
+            ).int64(message.userTimeUs);
           if (message.speed != null && Object.hasOwnProperty.call(message, "speed"))
             writer.uint32(
               /* id 9, wireType 5 =*/
@@ -13853,7 +13853,7 @@ var sesame = $root.sesame = (() => {
                 break;
               }
               case 8: {
-                message.userTimeMs = reader.int64();
+                message.userTimeUs = reader.int64();
                 break;
               }
               case 9: {
@@ -13946,9 +13946,9 @@ var sesame = $root.sesame = (() => {
             if (!$util.isInteger(message.materialPositionUs) && !(message.materialPositionUs && $util.isInteger(message.materialPositionUs.low) && $util.isInteger(message.materialPositionUs.high)))
               return "materialPositionUs: integer|Long expected";
           }
-          if (message.userTimeMs != null && message.hasOwnProperty("userTimeMs")) {
-            if (!$util.isInteger(message.userTimeMs) && !(message.userTimeMs && $util.isInteger(message.userTimeMs.low) && $util.isInteger(message.userTimeMs.high)))
-              return "userTimeMs: integer|Long expected";
+          if (message.userTimeUs != null && message.hasOwnProperty("userTimeUs")) {
+            if (!$util.isInteger(message.userTimeUs) && !(message.userTimeUs && $util.isInteger(message.userTimeUs.low) && $util.isInteger(message.userTimeUs.high)))
+              return "userTimeUs: integer|Long expected";
           }
           if (message.speed != null && message.hasOwnProperty("speed")) {
             if (typeof message.speed !== "number")
@@ -14060,15 +14060,15 @@ var sesame = $root.sesame = (() => {
             else if (typeof object.materialPositionUs === "object")
               message.materialPositionUs = new $util.LongBits(object.materialPositionUs.low >>> 0, object.materialPositionUs.high >>> 0).toNumber();
           }
-          if (object.userTimeMs != null) {
+          if (object.userTimeUs != null) {
             if ($util.Long)
-              (message.userTimeMs = $util.Long.fromValue(object.userTimeMs)).unsigned = false;
-            else if (typeof object.userTimeMs === "string")
-              message.userTimeMs = parseInt(object.userTimeMs, 10);
-            else if (typeof object.userTimeMs === "number")
-              message.userTimeMs = object.userTimeMs;
-            else if (typeof object.userTimeMs === "object")
-              message.userTimeMs = new $util.LongBits(object.userTimeMs.low >>> 0, object.userTimeMs.high >>> 0).toNumber();
+              (message.userTimeUs = $util.Long.fromValue(object.userTimeUs)).unsigned = false;
+            else if (typeof object.userTimeUs === "string")
+              message.userTimeUs = parseInt(object.userTimeUs, 10);
+            else if (typeof object.userTimeUs === "number")
+              message.userTimeUs = object.userTimeUs;
+            else if (typeof object.userTimeUs === "object")
+              message.userTimeUs = new $util.LongBits(object.userTimeUs.low >>> 0, object.userTimeUs.high >>> 0).toNumber();
           }
           if (object.speed != null)
             message.speed = Number(object.speed);
@@ -14142,9 +14142,9 @@ var sesame = $root.sesame = (() => {
               object.materialPositionUs = options.longs === String ? "0" : 0;
             if ($util.Long) {
               let long = new $util.Long(0, 0, false);
-              object.userTimeMs = options.longs === String ? long.toString() : options.longs === Number ? long.toNumber() : long;
+              object.userTimeUs = options.longs === String ? long.toString() : options.longs === Number ? long.toNumber() : long;
             } else
-              object.userTimeMs = options.longs === String ? "0" : 0;
+              object.userTimeUs = options.longs === String ? "0" : 0;
             object.speed = 0;
             object.userPlaylistId = "";
             object.playlistIndex = 0;
@@ -14191,11 +14191,11 @@ var sesame = $root.sesame = (() => {
               object.materialPositionUs = options.longs === String ? String(message.materialPositionUs) : message.materialPositionUs;
             else
               object.materialPositionUs = options.longs === String ? $util.Long.prototype.toString.call(message.materialPositionUs) : options.longs === Number ? new $util.LongBits(message.materialPositionUs.low >>> 0, message.materialPositionUs.high >>> 0).toNumber() : message.materialPositionUs;
-          if (message.userTimeMs != null && message.hasOwnProperty("userTimeMs"))
-            if (typeof message.userTimeMs === "number")
-              object.userTimeMs = options.longs === String ? String(message.userTimeMs) : message.userTimeMs;
+          if (message.userTimeUs != null && message.hasOwnProperty("userTimeUs"))
+            if (typeof message.userTimeUs === "number")
+              object.userTimeUs = options.longs === String ? String(message.userTimeUs) : message.userTimeUs;
             else
-              object.userTimeMs = options.longs === String ? $util.Long.prototype.toString.call(message.userTimeMs) : options.longs === Number ? new $util.LongBits(message.userTimeMs.low >>> 0, message.userTimeMs.high >>> 0).toNumber() : message.userTimeMs;
+              object.userTimeUs = options.longs === String ? $util.Long.prototype.toString.call(message.userTimeUs) : options.longs === Number ? new $util.LongBits(message.userTimeUs.low >>> 0, message.userTimeUs.high >>> 0).toNumber() : message.userTimeUs;
           if (message.speed != null && message.hasOwnProperty("speed"))
             object.speed = options.json && !isFinite(message.speed) ? String(message.speed) : message.speed;
           if (message.userPlaylistId != null && message.hasOwnProperty("userPlaylistId"))
@@ -22317,8 +22317,8 @@ var RPCClient = class extends import_events.EventEmitter {
         } else {
           throw new Error("Unsupported RPC message payload");
         }
-      } catch (cause) {
-        const error = new Error("got invalid message");
+      } catch (err) {
+        const error = new Error(`Got invalid message: ${err instanceof Error ? err.message : String(err)}`);
         this.errorHandler(error);
       }
     };
@@ -22393,8 +22393,8 @@ var RPCClient = class extends import_events.EventEmitter {
         try {
           payload = type.decode(event.payload);
           object = type.toObject(payload, { longs: Number });
-        } catch (cause) {
-          const error = new Error("could not decode event payload");
+        } catch (err) {
+          const error = new Error(`Could not decode event payload: ${err instanceof Error ? err.message : String(err)}`);
           this.errorHandler(error);
           return;
         }
@@ -22549,14 +22549,29 @@ var SesameConnection = class extends import_events2.EventEmitter {
     this.socket.addEventListener("close", this.boundCloseHandler);
     this.socket.addEventListener("error", this.boundErrorHandler);
     this.socket.binaryType = "arraybuffer";
-    await new Promise((resolve) => {
-      const done = () => {
-        this.removeListener("open", done);
-        this.removeListener("close", done);
-        resolve(null);
+    await new Promise((resolve, reject) => {
+      const cleanup = () => {
+        this.removeListener("open", onOpen);
+        this.removeListener("close", onClose);
+        this.removeListener("error", onError);
       };
-      this.on("open", done);
-      this.on("close", done);
+      const onOpen = () => {
+        cleanup();
+        resolve();
+      };
+      const onError = (err) => {
+        cleanup();
+        reject(err instanceof Error ? err : new Error("WebSocket connection error"));
+      };
+      const onClose = () => {
+        if (!this.isConnected()) {
+          cleanup();
+          reject(new Error("WebSocket connection closed before opening"));
+        }
+      };
+      this.on("open", onOpen);
+      this.on("close", onClose);
+      this.on("error", onError);
     });
   }
   /**
@@ -22700,7 +22715,6 @@ var JobsApi = class {
     if (!config.filename) throw new Error("Filename is required");
     exportReq.config = {
       ...config,
-      filename: config.filename,
       videoCodec: config.videoCodec ?? sesame.v1.common.CodecId.CODEC_ID_H264,
       videoBitrateKbps: config.videoBitrateKbps ?? 1024,
       audioCodec: config.audioCodec ?? sesame.v1.jobs.AudioCodecId.AUDIO_CODEC_ID_AAC,
@@ -22709,18 +22723,18 @@ var JobsApi = class {
       audioRouting: config.audioRouting ?? [0, 1, 2, 3]
     };
     exportReq.items = playlist.clips.map((clip) => ({
-      id: clip.id,
-      recorderId: clip.recorderId,
+      ...clip,
       transitionTimeUs: clip.transitionTimeUs ?? 0,
       transitionType: clip.transitionType ?? sesame.v1.recorder.TransitionType.TRANSITION_TYPE_MIX,
       transitionFadeColor: clip.transitionFadeColor ?? { x: 0, y: 0, z: 0, w: 0 },
-      speed: clip.speed ?? 1,
-      audioRouting: clip.audioRouting,
-      startTimeUs: clip.startTimeUs,
-      endTimeUs: clip.endTimeUs
+      speed: clip.speed ?? 1
     }));
     const msg = sesame.v1.jobs.JobStartRequest.create({ exportRequest: exportReq });
-    await this.rpc.service.startJob(msg);
+    const job = await this.rpc.service.startJob(msg);
+    if (job.error) {
+      throw new Error(job.error);
+    }
+    return job;
   }
   async abortJob(jobId) {
     const msg = { jobId };