@furious.luke/argus-js 0.5.1 → 0.5.2

package/dist/index.d.cts

@@ -189,6 +189,16 @@ interface PublisherOptions {
     gatewayHandshakeTimeoutMs?: number;
     /** Deadline after the initial offer for WebRTC to reach connected. Defaults to 30 seconds. */
     peerConnectionTimeoutMs?: number;
+    /**
+     * Preferred video codecs, most-preferred first, as RTP MIME types (e.g.
+     * `"video/VP9"`, `"video/VP8"`, `"video/H264"`). Each published video track's
+     * transceiver offers these codecs ahead of the rest, so the browser sends the
+     * first one the media server also accepts. Codecs the browser supports but that
+     * are not listed keep their default order behind the preferred ones, so
+     * negotiation still falls back cleanly. Defaults to `["video/VP9"]`. Pass an
+     * empty array to leave the browser's native codec order untouched.
+     */
+    preferredVideoCodecs?: string[];
     /** How long to retry a dropped signaling connection to the selected gateway. Defaults to 20 seconds. */
     signalingReconnectTimeoutMs?: number;
     /** Callbacks for lifecycle events. */
@@ -447,6 +457,20 @@ declare class Publisher {
      * the server's outbound speech sender on the dedicated speech transceiver.
      */
     private addMicrophoneTrack;
+    /**
+     * Reorders the codecs a video sender offers so the browser prefers the
+     * configured codecs (VP9 by default). This is what actually controls the wire
+     * format: the browser is the offerer and sends its own top-of-offer codec, and
+     * the media server (Pion) answers by mirroring the offer's codec order — so the
+     * server's own registration order has no say. Floating VP9 to the front of the
+     * offer is therefore the lever. Codecs not in the preference keep their native
+     * order behind it, so anything VP9 can't satisfy still negotiates.
+     *
+     * Best-effort: browsers lacking `getCapabilities`/`setCodecPreferences` (older
+     * Safari) keep their default order, and any failure is swallowed — codec
+     * preference is an optimization, never a requirement for publishing.
+     */
+    private preferVideoCodecs;
     /** Registers one physical video track under its logical type and source stream. */
     private registerTrack;
     /** The live video tracks currently published under the given type. */

package/dist/index.d.ts

@@ -189,6 +189,16 @@ interface PublisherOptions {
     gatewayHandshakeTimeoutMs?: number;
     /** Deadline after the initial offer for WebRTC to reach connected. Defaults to 30 seconds. */
     peerConnectionTimeoutMs?: number;
+    /**
+     * Preferred video codecs, most-preferred first, as RTP MIME types (e.g.
+     * `"video/VP9"`, `"video/VP8"`, `"video/H264"`). Each published video track's
+     * transceiver offers these codecs ahead of the rest, so the browser sends the
+     * first one the media server also accepts. Codecs the browser supports but that
+     * are not listed keep their default order behind the preferred ones, so
+     * negotiation still falls back cleanly. Defaults to `["video/VP9"]`. Pass an
+     * empty array to leave the browser's native codec order untouched.
+     */
+    preferredVideoCodecs?: string[];
     /** How long to retry a dropped signaling connection to the selected gateway. Defaults to 20 seconds. */
     signalingReconnectTimeoutMs?: number;
     /** Callbacks for lifecycle events. */
@@ -447,6 +457,20 @@ declare class Publisher {
      * the server's outbound speech sender on the dedicated speech transceiver.
      */
     private addMicrophoneTrack;
+    /**
+     * Reorders the codecs a video sender offers so the browser prefers the
+     * configured codecs (VP9 by default). This is what actually controls the wire
+     * format: the browser is the offerer and sends its own top-of-offer codec, and
+     * the media server (Pion) answers by mirroring the offer's codec order — so the
+     * server's own registration order has no say. Floating VP9 to the front of the
+     * offer is therefore the lever. Codecs not in the preference keep their native
+     * order behind it, so anything VP9 can't satisfy still negotiates.
+     *
+     * Best-effort: browsers lacking `getCapabilities`/`setCodecPreferences` (older
+     * Safari) keep their default order, and any failure is swallowed — codec
+     * preference is an optimization, never a requirement for publishing.
+     */
+    private preferVideoCodecs;
     /** Registers one physical video track under its logical type and source stream. */
     private registerTrack;
     /** The live video tracks currently published under the given type. */

package/dist/index.js

@@ -341,6 +341,7 @@ var Publisher = class {
       };
       if (initialTrack) {
         const sender = initialTrack.type === "audio" ? this.addMicrophoneTrack(pc, initialTrack.track, initialTrack.stream) : pc.addTrack(initialTrack.track, initialTrack.stream);
+        if (initialTrack.type !== "audio") this.preferVideoCodecs(pc, sender);
         this.typeSenders.set(
           initialTrack.type,
           sender
@@ -1551,6 +1552,39 @@ var Publisher = class {
     this.microphoneTransceiver = transceiver;
     return transceiver.sender;
   }
+  /**
+   * Reorders the codecs a video sender offers so the browser prefers the
+   * configured codecs (VP9 by default). This is what actually controls the wire
+   * format: the browser is the offerer and sends its own top-of-offer codec, and
+   * the media server (Pion) answers by mirroring the offer's codec order — so the
+   * server's own registration order has no say. Floating VP9 to the front of the
+   * offer is therefore the lever. Codecs not in the preference keep their native
+   * order behind it, so anything VP9 can't satisfy still negotiates.
+   *
+   * Best-effort: browsers lacking `getCapabilities`/`setCodecPreferences` (older
+   * Safari) keep their default order, and any failure is swallowed — codec
+   * preference is an optimization, never a requirement for publishing.
+   */
+  preferVideoCodecs(pc, sender) {
+    const preferred = this.opts.preferredVideoCodecs ?? ["video/VP9"];
+    if (preferred.length === 0) return;
+    if (sender.track && sender.track.kind !== "video") return;
+    if (typeof RTCRtpSender === "undefined" || typeof RTCRtpSender.getCapabilities !== "function") return;
+    if (typeof pc.getTransceivers !== "function") return;
+    const caps = RTCRtpSender.getCapabilities("video");
+    if (!caps?.codecs) return;
+    const transceiver = pc.getTransceivers().find((t) => t.sender === sender);
+    if (!transceiver || typeof transceiver.setCodecPreferences !== "function") return;
+    const rank = (mimeType) => {
+      const idx = preferred.findIndex((p) => p.toLowerCase() === mimeType.toLowerCase());
+      return idx === -1 ? preferred.length : idx;
+    };
+    const ordered = caps.codecs.map((codec, index) => ({ codec, index })).sort((a, b) => rank(a.codec.mimeType) - rank(b.codec.mimeType) || a.index - b.index).map((entry) => entry.codec);
+    try {
+      transceiver.setCodecPreferences(ordered);
+    } catch {
+    }
+  }
   /** Registers one physical video track under its logical type and source stream. */
   registerTrack(track, stream, type) {
     this.published.set(track, type);
@@ -1624,6 +1658,7 @@ var Publisher = class {
         throw new SenderRestoreError(`inactive ${type} sender still has a track`);
       }
       addedSender = pc.addTrack(track, stream);
+      this.preferVideoCodecs(pc, addedSender);
       this.typeSenders.set(type, addedSender);
     }
     return {