@stinkycomputing/sesame-api-client 1.5.0-alpha.7 → 1.5.0

package/dist/index.cjs

@@ -3460,179 +3460,82 @@ var sesame = $root.sesame = (() => {
         };
         return CommandListItem;
       }();
-      commands.MetadataEndpoint = function() {
-        function MetadataEndpoint(properties) {
+      commands.MetadataBinding = function() {
+        function MetadataBinding(properties) {
           if (properties) {
             for (let keys = Object.keys(properties), i = 0; i < keys.length; ++i)
               if (properties[keys[i]] != null)
                 this[keys[i]] = properties[keys[i]];
           }
         }
-        MetadataEndpoint.prototype.node = "";
-        MetadataEndpoint.prototype.track = "";
-        MetadataEndpoint.prototype.metadataId = "";
-        MetadataEndpoint.create = function create(properties) {
-          return new MetadataEndpoint(properties);
+        MetadataBinding.prototype.sourceId = "";
+        MetadataBinding.prototype.metadataId = "";
+        MetadataBinding.prototype.outputId = "";
+        MetadataBinding.prototype.trackName = "";
+        MetadataBinding.prototype.targetId = "";
+        MetadataBinding.create = function create(properties) {
+          return new MetadataBinding(properties);
         };
-        MetadataEndpoint.encode = function encode(message, writer) {
+        MetadataBinding.encode = function encode(message, writer) {
           if (!writer)
             writer = $Writer.create();
-          if (message.node != null && Object.hasOwnProperty.call(message, "node"))
+          if (message.sourceId != null && Object.hasOwnProperty.call(message, "sourceId"))
             writer.uint32(
               /* id 1, wireType 2 =*/
               10
-            ).string(message.node);
-          if (message.track != null && Object.hasOwnProperty.call(message, "track"))
+            ).string(message.sourceId);
+          if (message.metadataId != null && Object.hasOwnProperty.call(message, "metadataId"))
             writer.uint32(
               /* id 2, wireType 2 =*/
               18
-            ).string(message.track);
-          if (message.metadataId != null && Object.hasOwnProperty.call(message, "metadataId"))
+            ).string(message.metadataId);
+          if (message.outputId != null && Object.hasOwnProperty.call(message, "outputId"))
             writer.uint32(
               /* id 3, wireType 2 =*/
               26
-            ).string(message.metadataId);
+            ).string(message.outputId);
+          if (message.trackName != null && Object.hasOwnProperty.call(message, "trackName"))
+            writer.uint32(
+              /* id 4, wireType 2 =*/
+              34
+            ).string(message.trackName);
+          if (message.targetId != null && Object.hasOwnProperty.call(message, "targetId"))
+            writer.uint32(
+              /* id 5, wireType 2 =*/
+              42
+            ).string(message.targetId);
           return writer;
         };
-        MetadataEndpoint.encodeDelimited = function encodeDelimited(message, writer) {
+        MetadataBinding.encodeDelimited = function encodeDelimited(message, writer) {
           return this.encode(message, writer).ldelim();
         };
-        MetadataEndpoint.decode = function decode(reader, length, error) {
+        MetadataBinding.decode = function decode(reader, length, error) {
           if (!(reader instanceof $Reader))
             reader = $Reader.create(reader);
-          let end = length === void 0 ? reader.len : reader.pos + length, message = new $root.sesame.v1.commands.MetadataEndpoint();
+          let end = length === void 0 ? reader.len : reader.pos + length, message = new $root.sesame.v1.commands.MetadataBinding();
           while (reader.pos < end) {
             let tag = reader.uint32();
             if (tag === error)
               break;
             switch (tag >>> 3) {
               case 1: {
-                message.node = reader.string();
+                message.sourceId = reader.string();
                 break;
               }
               case 2: {
-                message.track = reader.string();
+                message.metadataId = reader.string();
                 break;
               }
               case 3: {
-                message.metadataId = reader.string();
+                message.outputId = reader.string();
                 break;
               }
-              default:
-                reader.skipType(tag & 7);
-                break;
-            }
-          }
-          return message;
-        };
-        MetadataEndpoint.decodeDelimited = function decodeDelimited(reader) {
-          if (!(reader instanceof $Reader))
-            reader = new $Reader(reader);
-          return this.decode(reader, reader.uint32());
-        };
-        MetadataEndpoint.verify = function verify(message) {
-          if (typeof message !== "object" || message === null)
-            return "object expected";
-          if (message.node != null && message.hasOwnProperty("node")) {
-            if (!$util.isString(message.node))
-              return "node: string expected";
-          }
-          if (message.track != null && message.hasOwnProperty("track")) {
-            if (!$util.isString(message.track))
-              return "track: string expected";
-          }
-          if (message.metadataId != null && message.hasOwnProperty("metadataId")) {
-            if (!$util.isString(message.metadataId))
-              return "metadataId: string expected";
-          }
-          return null;
-        };
-        MetadataEndpoint.fromObject = function fromObject(object) {
-          if (object instanceof $root.sesame.v1.commands.MetadataEndpoint)
-            return object;
-          let message = new $root.sesame.v1.commands.MetadataEndpoint();
-          if (object.node != null)
-            message.node = String(object.node);
-          if (object.track != null)
-            message.track = String(object.track);
-          if (object.metadataId != null)
-            message.metadataId = String(object.metadataId);
-          return message;
-        };
-        MetadataEndpoint.toObject = function toObject(message, options) {
-          if (!options)
-            options = {};
-          let object = {};
-          if (options.defaults) {
-            object.node = "";
-            object.track = "";
-            object.metadataId = "";
-          }
-          if (message.node != null && message.hasOwnProperty("node"))
-            object.node = message.node;
-          if (message.track != null && message.hasOwnProperty("track"))
-            object.track = message.track;
-          if (message.metadataId != null && message.hasOwnProperty("metadataId"))
-            object.metadataId = message.metadataId;
-          return object;
-        };
-        MetadataEndpoint.prototype.toJSON = function toJSON() {
-          return this.constructor.toObject(this, import_minimal.default.util.toJSONOptions);
-        };
-        MetadataEndpoint.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
-          if (typeUrlPrefix === void 0) {
-            typeUrlPrefix = "type.googleapis.com";
-          }
-          return typeUrlPrefix + "/sesame.v1.commands.MetadataEndpoint";
-        };
-        return MetadataEndpoint;
-      }();
-      commands.MetadataBinding = function() {
-        function MetadataBinding(properties) {
-          if (properties) {
-            for (let keys = Object.keys(properties), i = 0; i < keys.length; ++i)
-              if (properties[keys[i]] != null)
-                this[keys[i]] = properties[keys[i]];
-          }
-        }
-        MetadataBinding.prototype.from = null;
-        MetadataBinding.prototype.to = null;
-        MetadataBinding.create = function create(properties) {
-          return new MetadataBinding(properties);
-        };
-        MetadataBinding.encode = function encode(message, writer) {
-          if (!writer)
-            writer = $Writer.create();
-          if (message.from != null && Object.hasOwnProperty.call(message, "from"))
-            $root.sesame.v1.commands.MetadataEndpoint.encode(message.from, writer.uint32(
-              /* id 1, wireType 2 =*/
-              10
-            ).fork()).ldelim();
-          if (message.to != null && Object.hasOwnProperty.call(message, "to"))
-            $root.sesame.v1.commands.MetadataEndpoint.encode(message.to, writer.uint32(
-              /* id 2, wireType 2 =*/
-              18
-            ).fork()).ldelim();
-          return writer;
-        };
-        MetadataBinding.encodeDelimited = function encodeDelimited(message, writer) {
-          return this.encode(message, writer).ldelim();
-        };
-        MetadataBinding.decode = function decode(reader, length, error) {
-          if (!(reader instanceof $Reader))
-            reader = $Reader.create(reader);
-          let end = length === void 0 ? reader.len : reader.pos + length, message = new $root.sesame.v1.commands.MetadataBinding();
-          while (reader.pos < end) {
-            let tag = reader.uint32();
-            if (tag === error)
-              break;
-            switch (tag >>> 3) {
-              case 1: {
-                message.from = $root.sesame.v1.commands.MetadataEndpoint.decode(reader, reader.uint32());
+              case 4: {
+                message.trackName = reader.string();
                 break;
               }
-              case 2: {
-                message.to = $root.sesame.v1.commands.MetadataEndpoint.decode(reader, reader.uint32());
+              case 5: {
+                message.targetId = reader.string();
                 break;
               }
               default:
@@ -3650,15 +3553,25 @@ var sesame = $root.sesame = (() => {
         MetadataBinding.verify = function verify(message) {
           if (typeof message !== "object" || message === null)
             return "object expected";
-          if (message.from != null && message.hasOwnProperty("from")) {
-            let error = $root.sesame.v1.commands.MetadataEndpoint.verify(message.from);
-            if (error)
-              return "from." + error;
+          if (message.sourceId != null && message.hasOwnProperty("sourceId")) {
+            if (!$util.isString(message.sourceId))
+              return "sourceId: string expected";
           }
-          if (message.to != null && message.hasOwnProperty("to")) {
-            let error = $root.sesame.v1.commands.MetadataEndpoint.verify(message.to);
-            if (error)
-              return "to." + error;
+          if (message.metadataId != null && message.hasOwnProperty("metadataId")) {
+            if (!$util.isString(message.metadataId))
+              return "metadataId: string expected";
+          }
+          if (message.outputId != null && message.hasOwnProperty("outputId")) {
+            if (!$util.isString(message.outputId))
+              return "outputId: string expected";
+          }
+          if (message.trackName != null && message.hasOwnProperty("trackName")) {
+            if (!$util.isString(message.trackName))
+              return "trackName: string expected";
+          }
+          if (message.targetId != null && message.hasOwnProperty("targetId")) {
+            if (!$util.isString(message.targetId))
+              return "targetId: string expected";
           }
           return null;
         };
@@ -3666,16 +3579,16 @@ var sesame = $root.sesame = (() => {
           if (object instanceof $root.sesame.v1.commands.MetadataBinding)
             return object;
           let message = new $root.sesame.v1.commands.MetadataBinding();
-          if (object.from != null) {
-            if (typeof object.from !== "object")
-              throw TypeError(".sesame.v1.commands.MetadataBinding.from: object expected");
-            message.from = $root.sesame.v1.commands.MetadataEndpoint.fromObject(object.from);
-          }
-          if (object.to != null) {
-            if (typeof object.to !== "object")
-              throw TypeError(".sesame.v1.commands.MetadataBinding.to: object expected");
-            message.to = $root.sesame.v1.commands.MetadataEndpoint.fromObject(object.to);
-          }
+          if (object.sourceId != null)
+            message.sourceId = String(object.sourceId);
+          if (object.metadataId != null)
+            message.metadataId = String(object.metadataId);
+          if (object.outputId != null)
+            message.outputId = String(object.outputId);
+          if (object.trackName != null)
+            message.trackName = String(object.trackName);
+          if (object.targetId != null)
+            message.targetId = String(object.targetId);
           return message;
         };
         MetadataBinding.toObject = function toObject(message, options) {
@@ -3683,13 +3596,22 @@ var sesame = $root.sesame = (() => {
             options = {};
           let object = {};
           if (options.defaults) {
-            object.from = null;
-            object.to = null;
+            object.sourceId = "";
+            object.metadataId = "";
+            object.outputId = "";
+            object.trackName = "";
+            object.targetId = "";
           }
-          if (message.from != null && message.hasOwnProperty("from"))
-            object.from = $root.sesame.v1.commands.MetadataEndpoint.toObject(message.from, options);
-          if (message.to != null && message.hasOwnProperty("to"))
-            object.to = $root.sesame.v1.commands.MetadataEndpoint.toObject(message.to, options);
+          if (message.sourceId != null && message.hasOwnProperty("sourceId"))
+            object.sourceId = message.sourceId;
+          if (message.metadataId != null && message.hasOwnProperty("metadataId"))
+            object.metadataId = message.metadataId;
+          if (message.outputId != null && message.hasOwnProperty("outputId"))
+            object.outputId = message.outputId;
+          if (message.trackName != null && message.hasOwnProperty("trackName"))
+            object.trackName = message.trackName;
+          if (message.targetId != null && message.hasOwnProperty("targetId"))
+            object.targetId = message.targetId;
           return object;
         };
         MetadataBinding.prototype.toJSON = function toJSON() {
@@ -23822,6 +23744,22 @@ var CommandList = class {
     };
     return this.add(item, timeOffsetMs);
   }
+  /**
+   * Replace the server's entire metadata routing table with the supplied bindings.
+   *
+   * Each binding is either **outbound** or **inbound** - not both:
+   *
+   * - **Outbound** (`IMetadataOutboundBinding`): when `publishMetadata(nodeId, metadataId)`
+   *   is called (or the server pushes periodic state), the payload is forwarded to every
+   *   `(outputId, trackName)` pair that matches `(sourceId, metadataId)`.
+   *
+   * - **Inbound** (`IMetadataInboundBinding`): when a streaming source receives a
+   *   `FRAME_TYPE_DATA` frame on `trackName`, it is routed to `targetId` and emitted
+   *   as a `MetadataEvent` on `EVENT_TOPIC_METADATA`.
+   *
+   * This command replaces the **entire** table - pass all desired bindings at once.
+   * An empty array clears all routing.
+   */
   setMetadataBindings(bindings, timeOffsetMs) {
     const item = new sesame.v1.commands.CommandListItem();
     item.setMetadataBindings = { bindings };
@@ -24580,6 +24518,21 @@ var SesameClient = class extends import_events3.EventEmitter {
       await this.rpc.service.executeCommandList(cl.getCommandListMsg());
     }
   }
+  /**
+   * Publish a data-frame payload to all outbound targets registered for
+   * `(nodeId, metadataId)` in the current MetadataRouter binding table.
+   *
+   * The server resolves the binding table entry for the given `(nodeId, metadataId)`
+   * pair and sends a `FRAME_TYPE_DATA` frame to each configured `(outputId, trackName)`
+   * target. If no outbound binding exists a warning is logged server-side and the call
+   * is a no-op.
+   *
+   * @param nodeId     ID of the publishing node (source, mixer, or other engine node).
+   * @param metadataId Routing key - must match the `metadata_id` field in the binding.
+   * @param payload    Raw frame payload bytes. For `DATA_TYPE_JSON` this must be valid
+   *                   UTF-8 encoded JSON; for `DATA_TYPE_BINARY` it is opaque bytes.
+   * @param dataType   Wire encoding of the payload (defaults to `DATA_TYPE_JSON`).
+   */
   async publishMetadata(nodeId, metadataId, payload, dataType = DataType.DATA_TYPE_JSON) {
     await this.rpc.service.publishMetadata({ nodeId, metadataId, payload, dataType });
   }