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

package/dist/index.d.mts

@@ -603,6 +603,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
@@ -1572,6 +1590,23 @@ declare class FishjamClient<PeerMetadata = GenericMetadata, ServerMetadata = Gen
      */
     disconnect(): void;
     cleanup(): void;
+    /**
+     * Returns the current audio level for a local track.
+     *
+     * The `level` represents a normalized audio level in the range 0.0–1.0,
+     * derived from WebRTC statistics for the given local audio track.
+     *
+     * This method returns `null` when the WebRTC layer is not initialized, when the track
+     * cannot be found among local tracks, or when audio statistics are not yet or no longer
+     * available for the track.
+     *
+     * @param trackId - The ID of the local track to query.
+     * @returns A promise resolving to an object containing the audio `level`, or `null`
+     *          if the track is unknown or stats are not available.
+     */
+    getLocalTrackAudioLevel(trackId: string): Promise<{
+        level: number;
+    } | null>;
 }
 
 type ReceiveLivestreamResult = {