@gjsify/webrtc 0.3.13 → 0.3.15

package/lib/esm/get-user-media.js

@@ -1,93 +1,108 @@
 import { Gst, ensureGstInit } from "./gst-init.js";
 import { MediaStreamTrack } from "./media-stream-track.js";
 import { MediaStream } from "./media-stream.js";
+
+//#region src/get-user-media.ts
 async function getUserMedia(constraints) {
-  ensureGstInit();
-  if (!constraints.audio && !constraints.video) {
-    throw new TypeError(
-      "Failed to execute 'getUserMedia': At least one of audio or video must be requested"
-    );
-  }
-  const tracks = [];
-  if (constraints.audio) {
-    const audioConstraints = typeof constraints.audio === "object" ? constraints.audio : {};
-    const source = _createAudioSource();
-    const pipeline = new Gst.Pipeline();
-    pipeline.add(source);
-    const capsStr = _buildAudioCaps(audioConstraints);
-    if (capsStr) {
-      const capsfilter = Gst.ElementFactory.make("capsfilter", null);
-      capsfilter.caps = Gst.Caps.from_string(capsStr);
-      pipeline.add(capsfilter);
-      source.link(capsfilter);
-    }
-    tracks.push(new MediaStreamTrack({
-      kind: "audio",
-      label: source.name ?? "audio",
-      _gst: { source, pipeline }
-    }));
-  }
-  if (constraints.video) {
-    const videoConstraints = typeof constraints.video === "object" ? constraints.video : {};
-    const source = _createVideoSource();
-    const pipeline = new Gst.Pipeline();
-    pipeline.add(source);
-    const capsStr = _buildVideoCaps(videoConstraints);
-    if (capsStr) {
-      const capsfilter = Gst.ElementFactory.make("capsfilter", null);
-      capsfilter.caps = Gst.Caps.from_string(capsStr);
-      pipeline.add(capsfilter);
-      source.link(capsfilter);
-    }
-    tracks.push(new MediaStreamTrack({
-      kind: "video",
-      label: source.name ?? "video",
-      _gst: { source, pipeline }
-    }));
-  }
-  return new MediaStream(tracks);
+	ensureGstInit();
+	if (!constraints.audio && !constraints.video) {
+		throw new TypeError("Failed to execute 'getUserMedia': At least one of audio or video must be requested");
+	}
+	const tracks = [];
+	if (constraints.audio) {
+		const audioConstraints = typeof constraints.audio === "object" ? constraints.audio : {};
+		const source = _createAudioSource();
+		const pipeline = new Gst.Pipeline();
+		pipeline.add(source);
+		const capsStr = _buildAudioCaps(audioConstraints);
+		if (capsStr) {
+			const capsfilter = Gst.ElementFactory.make("capsfilter", null);
+			capsfilter.caps = Gst.Caps.from_string(capsStr);
+			pipeline.add(capsfilter);
+			source.link(capsfilter);
+		}
+		tracks.push(new MediaStreamTrack({
+			kind: "audio",
+			label: source.name ?? "audio",
+			_gst: {
+				source,
+				pipeline
+			}
+		}));
+	}
+	if (constraints.video) {
+		const videoConstraints = typeof constraints.video === "object" ? constraints.video : {};
+		const source = _createVideoSource();
+		const pipeline = new Gst.Pipeline();
+		pipeline.add(source);
+		const capsStr = _buildVideoCaps(videoConstraints);
+		if (capsStr) {
+			const capsfilter = Gst.ElementFactory.make("capsfilter", null);
+			capsfilter.caps = Gst.Caps.from_string(capsStr);
+			pipeline.add(capsfilter);
+			source.link(capsfilter);
+		}
+		tracks.push(new MediaStreamTrack({
+			kind: "video",
+			label: source.name ?? "video",
+			_gst: {
+				source,
+				pipeline
+			}
+		}));
+	}
+	return new MediaStream(tracks);
 }
+/** Build a GStreamer caps string for audio constraints. */
 function _buildAudioCaps(c) {
-  const parts = [];
-  if (c.sampleRate != null) parts.push(`rate=${Math.trunc(c.sampleRate)}`);
-  if (c.channelCount != null) parts.push(`channels=${Math.trunc(c.channelCount)}`);
-  if (parts.length === 0) return null;
-  return `audio/x-raw,${parts.join(",")}`;
+	const parts = [];
+	if (c.sampleRate != null) parts.push(`rate=${Math.trunc(c.sampleRate)}`);
+	if (c.channelCount != null) parts.push(`channels=${Math.trunc(c.channelCount)}`);
+	if (parts.length === 0) return null;
+	return `audio/x-raw,${parts.join(",")}`;
 }
+/** Build a GStreamer caps string for video constraints. */
 function _buildVideoCaps(c) {
-  const parts = [];
-  if (c.width != null) parts.push(`width=${Math.trunc(c.width)}`);
-  if (c.height != null) parts.push(`height=${Math.trunc(c.height)}`);
-  if (c.frameRate != null) parts.push(`framerate=${Math.trunc(c.frameRate)}/1`);
-  if (parts.length === 0) return null;
-  return `video/x-raw,${parts.join(",")}`;
+	const parts = [];
+	if (c.width != null) parts.push(`width=${Math.trunc(c.width)}`);
+	if (c.height != null) parts.push(`height=${Math.trunc(c.height)}`);
+	if (c.frameRate != null) parts.push(`framerate=${Math.trunc(c.frameRate)}/1`);
+	if (parts.length === 0) return null;
+	return `video/x-raw,${parts.join(",")}`;
 }
 function _createAudioSource() {
-  for (const name of ["pipewiresrc", "pulsesrc", "autoaudiosrc"]) {
-    const el2 = Gst.ElementFactory.make(name, null);
-    if (el2) {
-      try {
-        el2.is_live = true;
-      } catch {
-      }
-      return el2;
-    }
-  }
-  const el = Gst.ElementFactory.make("audiotestsrc", null);
-  el.is_live = true;
-  el.wave = 0;
-  return el;
+	for (const name of [
+		"pipewiresrc",
+		"pulsesrc",
+		"autoaudiosrc"
+	]) {
+		const el = Gst.ElementFactory.make(name, null);
+		if (el) {
+			try {
+				el.is_live = true;
+			} catch {}
+			return el;
+		}
+	}
+	const el = Gst.ElementFactory.make("audiotestsrc", null);
+	el.is_live = true;
+	el.wave = 0;
+	return el;
 }
 function _createVideoSource() {
-  for (const name of ["pipewiresrc", "v4l2src", "autovideosrc"]) {
-    const el2 = Gst.ElementFactory.make(name, null);
-    if (el2) return el2;
-  }
-  const el = Gst.ElementFactory.make("videotestsrc", null);
-  el.is_live = true;
-  el.pattern = 0;
-  return el;
+	for (const name of [
+		"pipewiresrc",
+		"v4l2src",
+		"autovideosrc"
+	]) {
+		const el = Gst.ElementFactory.make(name, null);
+		if (el) return el;
+	}
+	const el = Gst.ElementFactory.make("videotestsrc", null);
+	el.is_live = true;
+	el.pattern = 0;
+	return el;
 }
-export {
-  getUserMedia
-};
+
+//#endregion
+export { getUserMedia };

package/lib/esm/gst-enum-maps.js

@@ -1,88 +1,84 @@
 import GstWebRTC from "gi://GstWebRTC?version=1.0";
+
+//#region src/gst-enum-maps.ts
 const SIGNALING_STATE_MAP = {
-  [GstWebRTC.WebRTCSignalingState.STABLE]: "stable",
-  [GstWebRTC.WebRTCSignalingState.CLOSED]: "closed",
-  [GstWebRTC.WebRTCSignalingState.HAVE_LOCAL_OFFER]: "have-local-offer",
-  [GstWebRTC.WebRTCSignalingState.HAVE_REMOTE_OFFER]: "have-remote-offer",
-  [GstWebRTC.WebRTCSignalingState.HAVE_LOCAL_PRANSWER]: "have-local-pranswer",
-  [GstWebRTC.WebRTCSignalingState.HAVE_REMOTE_PRANSWER]: "have-remote-pranswer"
+	[GstWebRTC.WebRTCSignalingState.STABLE]: "stable",
+	[GstWebRTC.WebRTCSignalingState.CLOSED]: "closed",
+	[GstWebRTC.WebRTCSignalingState.HAVE_LOCAL_OFFER]: "have-local-offer",
+	[GstWebRTC.WebRTCSignalingState.HAVE_REMOTE_OFFER]: "have-remote-offer",
+	[GstWebRTC.WebRTCSignalingState.HAVE_LOCAL_PRANSWER]: "have-local-pranswer",
+	[GstWebRTC.WebRTCSignalingState.HAVE_REMOTE_PRANSWER]: "have-remote-pranswer"
 };
 function gstToSignalingState(v) {
-  return SIGNALING_STATE_MAP[v] ?? "stable";
+	return SIGNALING_STATE_MAP[v] ?? "stable";
 }
 const CONNECTION_STATE_MAP = {
-  [GstWebRTC.WebRTCPeerConnectionState.NEW]: "new",
-  [GstWebRTC.WebRTCPeerConnectionState.CONNECTING]: "connecting",
-  [GstWebRTC.WebRTCPeerConnectionState.CONNECTED]: "connected",
-  [GstWebRTC.WebRTCPeerConnectionState.DISCONNECTED]: "disconnected",
-  [GstWebRTC.WebRTCPeerConnectionState.FAILED]: "failed",
-  [GstWebRTC.WebRTCPeerConnectionState.CLOSED]: "closed"
+	[GstWebRTC.WebRTCPeerConnectionState.NEW]: "new",
+	[GstWebRTC.WebRTCPeerConnectionState.CONNECTING]: "connecting",
+	[GstWebRTC.WebRTCPeerConnectionState.CONNECTED]: "connected",
+	[GstWebRTC.WebRTCPeerConnectionState.DISCONNECTED]: "disconnected",
+	[GstWebRTC.WebRTCPeerConnectionState.FAILED]: "failed",
+	[GstWebRTC.WebRTCPeerConnectionState.CLOSED]: "closed"
 };
 function gstToConnectionState(v) {
-  return CONNECTION_STATE_MAP[v] ?? "new";
+	return CONNECTION_STATE_MAP[v] ?? "new";
 }
 const ICE_CONNECTION_STATE_MAP = {
-  [GstWebRTC.WebRTCICEConnectionState.NEW]: "new",
-  [GstWebRTC.WebRTCICEConnectionState.CHECKING]: "checking",
-  [GstWebRTC.WebRTCICEConnectionState.CONNECTED]: "connected",
-  [GstWebRTC.WebRTCICEConnectionState.COMPLETED]: "completed",
-  [GstWebRTC.WebRTCICEConnectionState.FAILED]: "failed",
-  [GstWebRTC.WebRTCICEConnectionState.DISCONNECTED]: "disconnected",
-  [GstWebRTC.WebRTCICEConnectionState.CLOSED]: "closed"
+	[GstWebRTC.WebRTCICEConnectionState.NEW]: "new",
+	[GstWebRTC.WebRTCICEConnectionState.CHECKING]: "checking",
+	[GstWebRTC.WebRTCICEConnectionState.CONNECTED]: "connected",
+	[GstWebRTC.WebRTCICEConnectionState.COMPLETED]: "completed",
+	[GstWebRTC.WebRTCICEConnectionState.FAILED]: "failed",
+	[GstWebRTC.WebRTCICEConnectionState.DISCONNECTED]: "disconnected",
+	[GstWebRTC.WebRTCICEConnectionState.CLOSED]: "closed"
 };
 function gstToIceConnectionState(v) {
-  return ICE_CONNECTION_STATE_MAP[v] ?? "new";
+	return ICE_CONNECTION_STATE_MAP[v] ?? "new";
 }
 const ICE_GATHERING_STATE_MAP = {
-  [GstWebRTC.WebRTCICEGatheringState.NEW]: "new",
-  [GstWebRTC.WebRTCICEGatheringState.GATHERING]: "gathering",
-  [GstWebRTC.WebRTCICEGatheringState.COMPLETE]: "complete"
+	[GstWebRTC.WebRTCICEGatheringState.NEW]: "new",
+	[GstWebRTC.WebRTCICEGatheringState.GATHERING]: "gathering",
+	[GstWebRTC.WebRTCICEGatheringState.COMPLETE]: "complete"
 };
 function gstToIceGatheringState(v) {
-  return ICE_GATHERING_STATE_MAP[v] ?? "new";
+	return ICE_GATHERING_STATE_MAP[v] ?? "new";
 }
 const DIRECTION_GST_TO_W3C = {
-  [GstWebRTC.WebRTCRTPTransceiverDirection.SENDRECV]: "sendrecv",
-  [GstWebRTC.WebRTCRTPTransceiverDirection.SENDONLY]: "sendonly",
-  [GstWebRTC.WebRTCRTPTransceiverDirection.RECVONLY]: "recvonly"
+	[GstWebRTC.WebRTCRTPTransceiverDirection.SENDRECV]: "sendrecv",
+	[GstWebRTC.WebRTCRTPTransceiverDirection.SENDONLY]: "sendonly",
+	[GstWebRTC.WebRTCRTPTransceiverDirection.RECVONLY]: "recvonly"
 };
 const DIRECTION_W3C_TO_GST = {
-  sendrecv: GstWebRTC.WebRTCRTPTransceiverDirection.SENDRECV,
-  sendonly: GstWebRTC.WebRTCRTPTransceiverDirection.SENDONLY,
-  recvonly: GstWebRTC.WebRTCRTPTransceiverDirection.RECVONLY,
-  inactive: GstWebRTC.WebRTCRTPTransceiverDirection.NONE
+	sendrecv: GstWebRTC.WebRTCRTPTransceiverDirection.SENDRECV,
+	sendonly: GstWebRTC.WebRTCRTPTransceiverDirection.SENDONLY,
+	recvonly: GstWebRTC.WebRTCRTPTransceiverDirection.RECVONLY,
+	inactive: GstWebRTC.WebRTCRTPTransceiverDirection.NONE
 };
 function gstDirectionToW3C(v) {
-  return DIRECTION_GST_TO_W3C[v] ?? "inactive";
+	return DIRECTION_GST_TO_W3C[v] ?? "inactive";
 }
 function w3cDirectionToGst(d) {
-  return DIRECTION_W3C_TO_GST[d] ?? GstWebRTC.WebRTCRTPTransceiverDirection.NONE;
+	return DIRECTION_W3C_TO_GST[d] ?? GstWebRTC.WebRTCRTPTransceiverDirection.NONE;
 }
 const STATS_TYPE_MAP = {
-  [GstWebRTC.WebRTCStatsType.CODEC]: "codec",
-  [GstWebRTC.WebRTCStatsType.INBOUND_RTP]: "inbound-rtp",
-  [GstWebRTC.WebRTCStatsType.OUTBOUND_RTP]: "outbound-rtp",
-  [GstWebRTC.WebRTCStatsType.REMOTE_INBOUND_RTP]: "remote-inbound-rtp",
-  [GstWebRTC.WebRTCStatsType.REMOTE_OUTBOUND_RTP]: "remote-outbound-rtp",
-  [GstWebRTC.WebRTCStatsType.CSRC]: "csrc",
-  [GstWebRTC.WebRTCStatsType.PEER_CONNECTION]: "peer-connection",
-  [GstWebRTC.WebRTCStatsType.DATA_CHANNEL]: "data-channel",
-  [GstWebRTC.WebRTCStatsType.STREAM]: "stream",
-  [GstWebRTC.WebRTCStatsType.TRANSPORT]: "transport",
-  [GstWebRTC.WebRTCStatsType.CANDIDATE_PAIR]: "candidate-pair",
-  [GstWebRTC.WebRTCStatsType.LOCAL_CANDIDATE]: "local-candidate",
-  [GstWebRTC.WebRTCStatsType.REMOTE_CANDIDATE]: "remote-candidate",
-  [GstWebRTC.WebRTCStatsType.CERTIFICATE]: "certificate"
+	[GstWebRTC.WebRTCStatsType.CODEC]: "codec",
+	[GstWebRTC.WebRTCStatsType.INBOUND_RTP]: "inbound-rtp",
+	[GstWebRTC.WebRTCStatsType.OUTBOUND_RTP]: "outbound-rtp",
+	[GstWebRTC.WebRTCStatsType.REMOTE_INBOUND_RTP]: "remote-inbound-rtp",
+	[GstWebRTC.WebRTCStatsType.REMOTE_OUTBOUND_RTP]: "remote-outbound-rtp",
+	[GstWebRTC.WebRTCStatsType.CSRC]: "csrc",
+	[GstWebRTC.WebRTCStatsType.PEER_CONNECTION]: "peer-connection",
+	[GstWebRTC.WebRTCStatsType.DATA_CHANNEL]: "data-channel",
+	[GstWebRTC.WebRTCStatsType.STREAM]: "stream",
+	[GstWebRTC.WebRTCStatsType.TRANSPORT]: "transport",
+	[GstWebRTC.WebRTCStatsType.CANDIDATE_PAIR]: "candidate-pair",
+	[GstWebRTC.WebRTCStatsType.LOCAL_CANDIDATE]: "local-candidate",
+	[GstWebRTC.WebRTCStatsType.REMOTE_CANDIDATE]: "remote-candidate",
+	[GstWebRTC.WebRTCStatsType.CERTIFICATE]: "certificate"
 };
 function gstToStatsType(v) {
-  return STATS_TYPE_MAP[v];
+	return STATS_TYPE_MAP[v];
 }
-export {
-  gstDirectionToW3C,
-  gstToConnectionState,
-  gstToIceConnectionState,
-  gstToIceGatheringState,
-  gstToSignalingState,
-  gstToStatsType,
-  w3cDirectionToGst
-};
+
+//#endregion
+export { gstDirectionToW3C, gstToConnectionState, gstToIceConnectionState, gstToIceGatheringState, gstToSignalingState, gstToStatsType, w3cDirectionToGst };

package/lib/esm/gst-init.js

@@ -1,31 +1,28 @@
 import Gst from "gi://Gst?version=1.0";
 import { DOMException } from "@gjsify/dom-exception";
+
+//#region src/gst-init.ts
 let initialized = false;
 function ensureGstInit() {
-  if (initialized) return;
-  Gst.init(null);
-  initialized = true;
+	if (initialized) return;
+	Gst.init(null);
+	initialized = true;
 }
+/** Throws if the `webrtcbin` element is not registered (gst-plugins-bad missing). */
 function ensureWebrtcbinAvailable() {
-  ensureGstInit();
-  const webrtcFactory = Gst.ElementFactory.find("webrtcbin");
-  if (!webrtcFactory) {
-    throwNotSupported(
-      'GStreamer element "webrtcbin" not available. Install gst-plugins-bad:\n  Fedora:        dnf install gstreamer1-plugins-bad-free gstreamer1-plugins-bad-free-extras\n  Ubuntu/Debian: apt install gstreamer1.0-plugins-bad'
-    );
-  }
-  const niceFactory = Gst.ElementFactory.find("nicesrc");
-  if (!niceFactory) {
-    throwNotSupported(
-      'GStreamer "nice" plugin (libnice-gstreamer) not available \u2014 required by webrtcbin.\n  Fedora:        dnf install libnice-gstreamer1\n  Ubuntu/Debian: apt install gstreamer1.0-nice\n  Verify with:   gst-inspect-1.0 nicesrc'
-    );
-  }
+	ensureGstInit();
+	const webrtcFactory = Gst.ElementFactory.find("webrtcbin");
+	if (!webrtcFactory) {
+		throwNotSupported("GStreamer element \"webrtcbin\" not available. Install gst-plugins-bad:\n" + "  Fedora:        dnf install gstreamer1-plugins-bad-free gstreamer1-plugins-bad-free-extras\n" + "  Ubuntu/Debian: apt install gstreamer1.0-plugins-bad");
+	}
+	const niceFactory = Gst.ElementFactory.find("nicesrc");
+	if (!niceFactory) {
+		throwNotSupported("GStreamer \"nice\" plugin (libnice-gstreamer) not available — required by webrtcbin.\n" + "  Fedora:        dnf install libnice-gstreamer1\n" + "  Ubuntu/Debian: apt install gstreamer1.0-nice\n" + "  Verify with:   gst-inspect-1.0 nicesrc");
+	}
 }
 function throwNotSupported(message) {
-  throw new DOMException(message, "NotSupportedError");
+	throw new DOMException(message, "NotSupportedError");
 }
-export {
-  Gst,
-  ensureGstInit,
-  ensureWebrtcbinAvailable
-};
+
+//#endregion
+export { Gst, ensureGstInit, ensureWebrtcbinAvailable };

package/lib/esm/gst-stats-parser.js

@@ -1,79 +1,106 @@
 import { gstToStatsType } from "./gst-enum-maps.js";
 import { RTCStatsReport } from "./rtc-stats-report.js";
+
+//#region src/gst-stats-parser.ts
+/**
+* Convert a GStreamer snake_case field name to W3C camelCase.
+* Examples: `bytes-sent` → `bytesSent`, `packets-received` → `packetsReceived`
+*/
 function snakeToCamel(name) {
-  return name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+	return name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
 }
+/**
+* Extract all fields from a GstStructure into a plain object.
+* GJS unboxes `get_value` for boxed/simple types directly — no
+* GObject.Value wrapper is returned for primitive types.
+*/
 function extractFields(structure) {
-  const result = {};
-  const n = structure.n_fields();
-  for (let i = 0; i < n; i++) {
-    const fieldName = structure.nth_field_name(i);
-    try {
-      const value = structure.get_value(fieldName);
-      result[fieldName] = value;
-    } catch {
-    }
-  }
-  return result;
+	const result = {};
+	const n = structure.n_fields();
+	for (let i = 0; i < n; i++) {
+		const fieldName = structure.nth_field_name(i);
+		try {
+			const value = structure.get_value(fieldName);
+			result[fieldName] = value;
+		} catch {}
+	}
+	return result;
 }
+/**
+* Parse a single stats entry (nested GstStructure) into a W3C RTCStats object.
+*/
 function parseStatsEntry(structure) {
-  const raw = extractFields(structure);
-  const gstType = raw["type"];
-  if (gstType == null) return null;
-  const w3cType = gstToStatsType(Number(gstType));
-  if (!w3cType) return null;
-  const id = String(raw["id"] ?? structure.get_name() ?? "");
-  const tsRaw = raw["timestamp"];
-  const timestamp = tsRaw != null ? Number(tsRaw) / 1e6 : performance.now();
-  const stats = { type: w3cType, id, timestamp };
-  for (const [key, value] of Object.entries(raw)) {
-    if (key === "type" || key === "id" || key === "timestamp") continue;
-    const camelKey = snakeToCamel(key);
-    stats[camelKey] = value;
-  }
-  return stats;
+	const raw = extractFields(structure);
+	const gstType = raw["type"];
+	if (gstType == null) return null;
+	const w3cType = gstToStatsType(Number(gstType));
+	if (!w3cType) return null;
+	const id = String(raw["id"] ?? structure.get_name() ?? "");
+	const tsRaw = raw["timestamp"];
+	const timestamp = tsRaw != null ? Number(tsRaw) / 1e6 : performance.now();
+	const stats = {
+		type: w3cType,
+		id,
+		timestamp
+	};
+	for (const [key, value] of Object.entries(raw)) {
+		if (key === "type" || key === "id" || key === "timestamp") continue;
+		const camelKey = snakeToCamel(key);
+		stats[camelKey] = value;
+	}
+	return stats;
 }
+/**
+* Parse the top-level GstStructure returned by webrtcbin's `get-stats`
+* signal into a W3C RTCStatsReport.
+*
+* The top-level structure has one field per stats entry. Each field's value
+* is a nested GstStructure (GJS unboxes boxed types automatically).
+*/
 function parseGstStats(reply) {
-  if (!reply) return new RTCStatsReport();
-  const entries = [];
-  const n = reply.n_fields();
-  for (let i = 0; i < n; i++) {
-    const fieldName = reply.nth_field_name(i);
-    try {
-      const nested = reply.get_value(fieldName);
-      if (nested && typeof nested.n_fields === "function") {
-        const stats = parseStatsEntry(nested);
-        if (stats) {
-          entries.push([stats.id, stats]);
-        }
-      }
-    } catch {
-    }
-  }
-  return new RTCStatsReport(entries);
+	if (!reply) return new RTCStatsReport();
+	const entries = [];
+	const n = reply.n_fields();
+	for (let i = 0; i < n; i++) {
+		const fieldName = reply.nth_field_name(i);
+		try {
+			const nested = reply.get_value(fieldName);
+			if (nested && typeof nested.n_fields === "function") {
+				const stats = parseStatsEntry(nested);
+				if (stats) {
+					entries.push([stats.id, stats]);
+				}
+			}
+		} catch {}
+	}
+	return new RTCStatsReport(entries);
 }
+/**
+* Filter an RTCStatsReport to entries relevant to a specific track identifier.
+* Used by RTCRtpSender.getStats() and RTCRtpReceiver.getStats() to return
+* only the stats associated with their track.
+*/
 function filterStatsByTrackId(report, trackId) {
-  const entries = [];
-  const relatedIds = /* @__PURE__ */ new Set();
-  for (const [id, stats] of report) {
-    if (stats.trackIdentifier === trackId) {
-      entries.push([id, stats]);
-      relatedIds.add(id);
-      for (const value of Object.values(stats)) {
-        if (typeof value === "string" && report.has(value)) {
-          relatedIds.add(value);
-        }
-      }
-    }
-  }
-  for (const [id, stats] of report) {
-    if (relatedIds.has(id) && !entries.some(([entryId]) => entryId === id)) {
-      entries.push([id, stats]);
-    }
-  }
-  return new RTCStatsReport(entries);
+	const entries = [];
+	const relatedIds = new Set();
+	for (const [id, stats] of report) {
+		if (stats.trackIdentifier === trackId) {
+			entries.push([id, stats]);
+			relatedIds.add(id);
+			for (const value of Object.values(stats)) {
+				if (typeof value === "string" && report.has(value)) {
+					relatedIds.add(value);
+				}
+			}
+		}
+	}
+	for (const [id, stats] of report) {
+		if (relatedIds.has(id) && !entries.some(([entryId]) => entryId === id)) {
+			entries.push([id, stats]);
+		}
+	}
+	return new RTCStatsReport(entries);
 }
-export {
-  filterStatsByTrackId,
-  parseGstStats
-};
+
+//#endregion
+export { filterStatsByTrackId, parseGstStats };

package/lib/esm/gst-utils.js

@@ -1,16 +1,27 @@
 import { PromiseBridge } from "@gjsify/webrtc-native";
+
+//#region src/gst-utils.ts
+/**
+* Wrap a GstPromise-consuming emit into a JS Promise that resolves on the
+* main thread.
+*
+* Usage:
+*   const reply = await withGstPromise((promise) => {
+*     webrtcbin.emit('create-offer', options, promise);
+*   });
+*/
 function withGstPromise(emit) {
-  return new Promise((resolve, reject) => {
-    const bridge = new PromiseBridge();
-    bridge.connect("replied", (_b, reply) => {
-      resolve(reply);
-    });
-    bridge.connect("rejected", (_b, message) => {
-      reject(new Error(message));
-    });
-    emit(bridge.promise);
-  });
+	return new Promise((resolve, reject) => {
+		const bridge = new PromiseBridge();
+		bridge.connect("replied", (_b, reply) => {
+			resolve(reply);
+		});
+		bridge.connect("rejected", (_b, message) => {
+			reject(new Error(message));
+		});
+		emit(bridge.promise);
+	});
 }
-export {
-  withGstPromise
-};
+
+//#endregion
+export { withGstPromise };