@fishjam-cloud/webrtc-client 0.25.2 → 0.26.0-rc.0

package/dist/index.d.mts

@@ -563,6 +563,24 @@ declare class WebRTCEndpoint extends WebRTCEndpoint_base {
      * ```
      */
     connect: (metadata: unknown) => void;
+    /**
+     * Returns the current audio level for a local audio track, if available.
+     *
+     * This method only works for local **audio** tracks that have been negotiated
+     * with the remote peer and for which an underlying `RTCRtpSender` and
+     * statistics are available.
+     *
+     * @param trackId - Identifier of the local track to query, as used when
+     * adding or managing local tracks on this endpoint.
+     * @returns A promise that resolves to `{ level: number }` when an audio
+     * level can be determined for the given track, or `null` if:
+     * - the track does not exist,
+     * - the track is not an audio track,
+     * - the track has not yet been negotiated / no sender exists
+     */
+    getLocalTrackAudioLevel(trackId: string): Promise<{
+        level: number;
+    } | null>;
     /**
      * Feeds media event received from RTC Engine to {@link WebRTCEndpoint}.
      * This function should be called whenever some media event from RTC Engine

package/dist/index.mjs

@@ -4236,6 +4236,18 @@ var LocalTrack = class {
       {}
     );
   };
+  getAudioLevel = async () => {
+    if (!this.sender) return null;
+    try {
+      const stats = await this.sender.getStats();
+      const source = [...stats.values()].find(
+        (r) => r.type === "media-source" && r.kind === "audio" && typeof r.audioLevel === "number"
+      );
+      return source ? { level: source.audioLevel } : null;
+    } catch {
+      return null;
+    }
+  };
   createTrackVariantBitratesEvent = () => {
   };
 };
@@ -4454,6 +4466,9 @@ var Local = class {
       localTrack.addTrackToConnection();
     });
   };
+  getLocalTrackAudioLevel = async (trackId) => {
+    return this.localTracks[trackId]?.getAudioLevel() ?? null;
+  };
 };
 
 // src/tracks/LocalTrackManager.ts
@@ -4785,6 +4800,24 @@ var WebRTCEndpoint = class extends EventEmitter3 {
     const connect = MediaEvent_Connect.create({ metadataJson: JSON.stringify(metadata) });
     this.sendMediaEvent({ connect });
   };
+  /**
+   * Returns the current audio level for a local audio track, if available.
+   *
+   * This method only works for local **audio** tracks that have been negotiated
+   * with the remote peer and for which an underlying `RTCRtpSender` and
+   * statistics are available.
+   *
+   * @param trackId - Identifier of the local track to query, as used when
+   * adding or managing local tracks on this endpoint.
+   * @returns A promise that resolves to `{ level: number }` when an audio
+   * level can be determined for the given track, or `null` if:
+   * - the track does not exist,
+   * - the track is not an audio track,
+   * - the track has not yet been negotiated / no sender exists
+   */
+  getLocalTrackAudioLevel(trackId) {
+    return this.local.getLocalTrackAudioLevel(trackId);
+  }
   /**
    * Feeds media event received from RTC Engine to {@link WebRTCEndpoint}.
    * This function should be called whenever some media event from RTC Engine

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishjam-cloud/webrtc-client",
-  "version": "0.25.2",
+  "version": "0.26.0-rc.0",
   "description": "Typescript client library for ExWebRTC/WebRTC endpoint in Membrane RTC Engine",
   "license": "Apache-2.0",
   "author": "Fishjam Team",
@@ -50,7 +50,7 @@
   },
   "devDependencies": {
     "@faker-js/faker": "^9.6.0",
-    "@fishjam-cloud/protobufs": "workspace:*",
+    "@fishjam-cloud/protobufs": "0.10.2",
     "@playwright/test": "^1.51.1",
     "@types/events": "^3.0.3",
     "@types/node": "^22.14.0",
@@ -76,4 +76,4 @@
       "yarn lint"
     ]
   }
-}
+}

package/dist/protobufs/fishjam/media_events/peer/peer.d.ts

@@ -1,130 +0,0 @@
-import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
-import { Candidate, Variant } from "../shared";
-export declare const protobufPackage = "fishjam.media_events.peer";
-/** Defines any type of message sent from Peer to Membrane RTC Engine */
-export interface MediaEvent {
-    connect?: MediaEvent_Connect | undefined;
-    disconnect?: MediaEvent_Disconnect | undefined;
-    updateEndpointMetadata?: MediaEvent_UpdateEndpointMetadata | undefined;
-    updateTrackMetadata?: MediaEvent_UpdateTrackMetadata | undefined;
-    renegotiateTracks?: MediaEvent_RenegotiateTracks | undefined;
-    candidate?: Candidate | undefined;
-    sdpOffer?: MediaEvent_SdpOffer | undefined;
-    trackBitrates?: MediaEvent_TrackBitrates | undefined;
-    enableTrackVariant?: MediaEvent_EnableTrackVariant | undefined;
-    disableTrackVariant?: MediaEvent_DisableTrackVariant | undefined;
-    setTargetTrackVariant?: MediaEvent_SetTargetTrackVariant | undefined;
-    unmuteTrack?: MediaEvent_UnmuteTrack | undefined;
-}
-export interface MediaEvent_VariantBitrate {
-    variant: Variant;
-    bitrate: number;
-}
-/** Sent when a peer wants to join WebRTC Endpoint. */
-export interface MediaEvent_Connect {
-    metadataJson: string;
-}
-/** Sent when a peer disconnects from WebRTC Endpoint. */
-export interface MediaEvent_Disconnect {
-}
-/** Sent when a peer wants to update its metadata */
-export interface MediaEvent_UpdateEndpointMetadata {
-    metadataJson: string;
-}
-/** Sent when a peer wants to update its track's metadata */
-export interface MediaEvent_UpdateTrackMetadata {
-    trackId: string;
-    metadataJson: string;
-}
-/** Sent when peer wants to renegotiate connection due to adding a track or removing a track */
-export interface MediaEvent_RenegotiateTracks {
-}
-/**
- * Sent as a response to `offerData` media event during renegotiation
- * Maps contain only information about current peer's `sendonly` tracks.
- * The "mid" is an identifier used to associate an RTP packet with an MLine from the SDP offer/answer.
- */
-export interface MediaEvent_SdpOffer {
-    /** The value of the `sessionDescription.sdp` */
-    sdp: string;
-    trackIdToMetadataJson: {
-        [key: string]: string;
-    };
-    /** Maps track_id to its bitrate. The track_id in the TrackBitrates message is ignored (we use the map key), so it can be omitted. */
-    trackIdToBitrates: {
-        [key: string]: MediaEvent_TrackBitrates;
-    };
-    midToTrackId: {
-        [key: string]: string;
-    };
-}
-export interface MediaEvent_SdpOffer_TrackIdToMetadataJsonEntry {
-    key: string;
-    value: string;
-}
-export interface MediaEvent_SdpOffer_TrackIdToBitratesEntry {
-    key: string;
-    value: MediaEvent_TrackBitrates | undefined;
-}
-export interface MediaEvent_SdpOffer_MidToTrackIdEntry {
-    key: string;
-    value: string;
-}
-/** Sent when Peer wants to update its track's bitrate */
-export interface MediaEvent_TrackBitrates {
-    trackId: string;
-    /** Bitrate of each variant. For non-simulcast tracks use VARIANT_UNSPECIFIED. */
-    variantBitrates: MediaEvent_VariantBitrate[];
-}
-/** Sent when client disables one of the track variants */
-export interface MediaEvent_DisableTrackVariant {
-    trackId: string;
-    variant: Variant;
-}
-/** Sent when client enables one of the track variants */
-export interface MediaEvent_EnableTrackVariant {
-    trackId: string;
-    variant: Variant;
-}
-export interface MediaEvent_SetTargetTrackVariant {
-    trackId: string;
-    variant: Variant;
-}
-export interface MediaEvent_UnmuteTrack {
-    trackId: string;
-}
-export declare const MediaEvent: MessageFns<MediaEvent>;
-export declare const MediaEvent_VariantBitrate: MessageFns<MediaEvent_VariantBitrate>;
-export declare const MediaEvent_Connect: MessageFns<MediaEvent_Connect>;
-export declare const MediaEvent_Disconnect: MessageFns<MediaEvent_Disconnect>;
-export declare const MediaEvent_UpdateEndpointMetadata: MessageFns<MediaEvent_UpdateEndpointMetadata>;
-export declare const MediaEvent_UpdateTrackMetadata: MessageFns<MediaEvent_UpdateTrackMetadata>;
-export declare const MediaEvent_RenegotiateTracks: MessageFns<MediaEvent_RenegotiateTracks>;
-export declare const MediaEvent_SdpOffer: MessageFns<MediaEvent_SdpOffer>;
-export declare const MediaEvent_SdpOffer_TrackIdToMetadataJsonEntry: MessageFns<MediaEvent_SdpOffer_TrackIdToMetadataJsonEntry>;
-export declare const MediaEvent_SdpOffer_TrackIdToBitratesEntry: MessageFns<MediaEvent_SdpOffer_TrackIdToBitratesEntry>;
-export declare const MediaEvent_SdpOffer_MidToTrackIdEntry: MessageFns<MediaEvent_SdpOffer_MidToTrackIdEntry>;
-export declare const MediaEvent_TrackBitrates: MessageFns<MediaEvent_TrackBitrates>;
-export declare const MediaEvent_DisableTrackVariant: MessageFns<MediaEvent_DisableTrackVariant>;
-export declare const MediaEvent_EnableTrackVariant: MessageFns<MediaEvent_EnableTrackVariant>;
-export declare const MediaEvent_SetTargetTrackVariant: MessageFns<MediaEvent_SetTargetTrackVariant>;
-export declare const MediaEvent_UnmuteTrack: MessageFns<MediaEvent_UnmuteTrack>;
-type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
-export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
-    [K in keyof T]?: DeepPartial<T[K]>;
-} : Partial<T>;
-type KeysOfUnion<T> = T extends T ? keyof T : never;
-export type Exact<P, I extends P> = P extends Builtin ? P : P & {
-    [K in keyof P]: Exact<P[K], I[K]>;
-} & {
-    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
-};
-export interface MessageFns<T> {
-    encode(message: T, writer?: BinaryWriter): BinaryWriter;
-    decode(input: BinaryReader | Uint8Array, length?: number): T;
-    fromJSON(object: any): T;
-    toJSON(message: T): unknown;
-    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
-    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
-}
-export {};