@stream-io/video-client 1.37.3 → 1.38.0

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from './src/devices';
 export * from './src/store';
 export * from './src/sorting';
 export * from './src/helpers/client-details';
+export * from './src/helpers/humanize';
 export * from './src/helpers/DynascaleManager';
 export * from './src/helpers/ViewportTracker';
 export * from './src/helpers/sound-detector';

package/dist/index.es.js

@@ -6001,7 +6001,7 @@ const getSdkVersion = (sdk) => {
     return sdk ? `${sdk.major}.${sdk.minor}.${sdk.patch}` : '0.0.0-development';
 };
 
-const version = "1.37.3";
+const version = "1.38.0";
 const [major, minor, patch] = version.split('.');
 let sdkInfo = {
     type: SdkType.PLAIN_JAVASCRIPT,
@@ -6271,17 +6271,26 @@ const createStatsReporter = ({ subscriber, publisher, state, datacenter, polling
             getRawStatsForTrack('subscriber'),
             publisher ? getRawStatsForTrack('publisher') : undefined,
         ]);
-        const process = (report, kind) => aggregate(transform(report, { kind, trackKind: 'video', publisher }));
-        const subscriberStats = subscriberRawStats
+        const process = (report, kind) => {
+            const videoStats = aggregate(transform(report, { kind, trackKind: 'video', publisher }));
+            const audioStats = aggregateAudio(transform(report, { kind, trackKind: 'audio', publisher }));
+            return {
+                videoStats,
+                audioStats,
+            };
+        };
+        const subscriberResult = subscriberRawStats
             ? process(subscriberRawStats, 'subscriber')
-            : getEmptyStats();
-        const publisherStats = publisherRawStats
+            : { videoStats: getEmptyVideoStats(), audioStats: getEmptyAudioStats() };
+        const publisherResult = publisherRawStats
             ? process(publisherRawStats, 'publisher')
-            : getEmptyStats();
+            : { videoStats: getEmptyVideoStats(), audioStats: getEmptyAudioStats() };
         state.setCallStatsReport({
             datacenter,
-            publisherStats,
-            subscriberStats,
+            publisherStats: publisherResult.videoStats,
+            publisherAudioStats: publisherResult.audioStats,
+            subscriberStats: subscriberResult.videoStats,
+            subscriberAudioStats: subscriberResult.audioStats,
             subscriberRawStats,
             publisherRawStats,
             participants: participantStats,
@@ -6339,6 +6348,11 @@ const transform = (report, opts) => {
             roundTripTime = candidatePair?.currentRoundTripTime;
         }
         let trackType;
+        let audioLevel;
+        let concealedSamples;
+        let concealmentEvents;
+        let packetsReceived;
+        let packetsLost;
         if (kind === 'publisher' && publisher) {
             const firefox = isFirefox();
             const mediaSource = stats.find((s) => s.type === 'media-source' &&
@@ -6346,7 +6360,22 @@ const transform = (report, opts) => {
                 (firefox ? true : s.id === rtcStreamStats.mediaSourceId));
             if (mediaSource) {
                 trackType = publisher.getTrackType(mediaSource.trackIdentifier);
+                if (trackKind === 'audio' &&
+                    typeof mediaSource.audioLevel === 'number') {
+                    audioLevel = mediaSource.audioLevel;
+                }
+            }
+        }
+        else if (kind === 'subscriber' && trackKind === 'audio') {
+            const inboundStats = rtcStreamStats;
+            const inboundLevel = inboundStats.audioLevel;
+            if (typeof inboundLevel === 'number') {
+                audioLevel = inboundLevel;
             }
+            concealedSamples = inboundStats.concealedSamples;
+            concealmentEvents = inboundStats.concealmentEvents;
+            packetsReceived = inboundStats.packetsReceived;
+            packetsLost = inboundStats.packetsLost;
         }
         return {
             bytesSent: rtcStreamStats.bytesSent,
@@ -6363,6 +6392,11 @@ const transform = (report, opts) => {
             rid: rtcStreamStats.rid,
             ssrc: rtcStreamStats.ssrc,
             trackType,
+            audioLevel,
+            concealedSamples,
+            concealmentEvents,
+            packetsReceived,
+            packetsLost,
         };
     });
     return {
@@ -6371,7 +6405,7 @@ const transform = (report, opts) => {
         timestamp: Date.now(),
     };
 };
-const getEmptyStats = (stats) => {
+const getEmptyVideoStats = (stats) => {
     return {
         rawReport: stats ?? { streams: [], timestamp: Date.now() },
         totalBytesSent: 0,
@@ -6387,13 +6421,28 @@ const getEmptyStats = (stats) => {
         timestamp: Date.now(),
     };
 };
+const getEmptyAudioStats = () => {
+    return {
+        totalBytesSent: 0,
+        totalBytesReceived: 0,
+        averageJitterInMs: 0,
+        averageRoundTripTimeInMs: 0,
+        codec: '',
+        codecPerTrackType: {},
+        timestamp: Date.now(),
+        totalConcealedSamples: 0,
+        totalConcealmentEvents: 0,
+        totalPacketsReceived: 0,
+        totalPacketsLost: 0,
+    };
+};
 /**
  * Aggregates generic stats.
  *
  * @param stats the stats to aggregate.
  */
 const aggregate = (stats) => {
-    const aggregatedStats = getEmptyStats(stats);
+    const aggregatedStats = getEmptyVideoStats(stats);
     let maxArea = -1;
     const area = (w, h) => w * h;
     const qualityLimitationReasons = new Set();
@@ -6438,6 +6487,39 @@ const aggregate = (stats) => {
     }
     return report;
 };
+/**
+ * Aggregates audio stats from a stats report.
+ *
+ * @param stats the stats report containing audio streams.
+ * @returns aggregated audio stats.
+ */
+const aggregateAudio = (stats) => {
+    const streams = stats.streams;
+    const audioStats = getEmptyAudioStats();
+    const report = streams.reduce((acc, stream) => {
+        acc.totalBytesSent += stream.bytesSent || 0;
+        acc.totalBytesReceived += stream.bytesReceived || 0;
+        acc.averageJitterInMs += stream.jitter || 0;
+        acc.averageRoundTripTimeInMs += stream.currentRoundTripTime || 0;
+        acc.totalConcealedSamples += stream.concealedSamples || 0;
+        acc.totalConcealmentEvents += stream.concealmentEvents || 0;
+        acc.totalPacketsReceived += stream.packetsReceived || 0;
+        acc.totalPacketsLost += stream.packetsLost || 0;
+        return acc;
+    }, audioStats);
+    if (streams.length > 0) {
+        report.averageJitterInMs = Math.round((report.averageJitterInMs / streams.length) * 1000);
+        report.averageRoundTripTimeInMs = Math.round((report.averageRoundTripTimeInMs / streams.length) * 1000);
+        report.codec = streams[0].codec || '';
+        report.codecPerTrackType = streams.reduce((acc, stream) => {
+            if (stream.trackType) {
+                acc[stream.trackType] = stream.codec || '';
+            }
+            return acc;
+        }, {});
+    }
+    return report;
+};
 
 class SfuStatsReporter {
     constructor(sfuClient, { options, clientDetails, subscriber, publisher, microphone, camera, state, tracer, unifiedSessionId, }) {
@@ -10321,7 +10403,6 @@ class DeviceManager {
         }
     }
     async applySettingsToStream() {
-        console.log('applySettingsToStream ');
         await withCancellation(this.statusChangeConcurrencyTag, async (signal) => {
             if (this.enabled) {
                 try {
@@ -14917,7 +14998,7 @@ class StreamClient {
         this.getUserAgent = () => {
             if (!this.cachedUserAgent) {
                 const { clientAppIdentifier = {} } = this.options;
-                const { sdkName = 'js', sdkVersion = "1.37.3", ...extras } = clientAppIdentifier;
+                const { sdkName = 'js', sdkVersion = "1.38.0", ...extras } = clientAppIdentifier;
                 this.cachedUserAgent = [
                     `stream-video-${sdkName}-v${sdkVersion}`,
                     ...Object.entries(extras).map(([key, value]) => `${key}=${value}`),
@@ -15509,5 +15590,27 @@ class StreamVideoClient {
 }
 StreamVideoClient._instances = new Map();
 
-export { AudioSettingsRequestDefaultDeviceEnum, AudioSettingsResponseDefaultDeviceEnum, browsers as Browsers, Call, CallState, CallType, CallTypes, CallingState, CameraManager, CameraManagerState, CreateDeviceRequestPushProviderEnum, DebounceType, DeviceManager, DeviceManagerState, DynascaleManager, ErrorFromResponse, FrameRecordingSettingsRequestModeEnum, FrameRecordingSettingsRequestQualityEnum, FrameRecordingSettingsResponseModeEnum, IngressAudioEncodingOptionsRequestChannelsEnum, IngressSourceRequestFpsEnum, IngressVideoLayerRequestCodecEnum, LayoutSettingsRequestNameEnum, MicrophoneManager, MicrophoneManagerState, NoiseCancellationSettingsModeEnum, OwnCapability, RNSpeechDetector, RTMPBroadcastRequestQualityEnum, RTMPSettingsRequestQualityEnum, RecordSettingsRequestModeEnum, RecordSettingsRequestQualityEnum, rxUtils as RxUtils, ScreenShareManager, ScreenShareState, events as SfuEvents, models as SfuModels, SpeakerManager, SpeakerState, StartClosedCaptionsRequestLanguageEnum, StartTranscriptionRequestLanguageEnum, StreamSfuClient, StreamVideoClient, StreamVideoReadOnlyStateStore, StreamVideoWriteableStateStore, TranscriptionSettingsRequestClosedCaptionModeEnum, TranscriptionSettingsRequestLanguageEnum, TranscriptionSettingsRequestModeEnum, TranscriptionSettingsResponseClosedCaptionModeEnum, TranscriptionSettingsResponseLanguageEnum, TranscriptionSettingsResponseModeEnum, VideoSettingsRequestCameraFacingEnum, VideoSettingsResponseCameraFacingEnum, ViewportTracker, VisibilityState, checkIfAudioOutputChangeSupported, combineComparators, conditional, createSoundDetector, defaultSortPreset, descending, deviceIds$, disposeOfMediaStream, dominantSpeaker, getAudioBrowserPermission, getAudioDevices, getAudioOutputDevices, getAudioStream, getClientDetails, getDeviceState, getScreenShareStream, getSdkInfo, getVideoBrowserPermission, getVideoDevices, getVideoStream, getWebRTCInfo, hasAudio, hasPausedTrack, hasScreenShare, hasScreenShareAudio, hasVideo, isPinned, livestreamOrAudioRoomSortPreset, logToConsole, name, noopComparator, paginatedLayoutSortPreset, pinned, publishingAudio, publishingVideo, reactionType, resolveDeviceId, role, screenSharing, setDeviceInfo, setOSInfo, setPowerState, setSdkInfo, setThermalState, setWebRTCInfo, speakerLayoutSortPreset, speaking, videoLoggerSystem, withParticipantSource };
+/**
+ * Formats large numbers into a compact, human-friendly form: 1k, 1.5k, 2M, etc.
+ */
+const humanize = (n) => {
+    if (n < 1000)
+        return String(n);
+    const units = [
+        { value: 1000000000, suffix: 'B' },
+        { value: 1000000, suffix: 'M' },
+        { value: 1000, suffix: 'k' },
+    ];
+    for (const { value, suffix } of units) {
+        if (n >= value) {
+            const num = n / value;
+            const precision = num < 100 ? 1 : 0; // show one decimal only for small leading numbers
+            const formatted = num.toFixed(precision).replace(/\.0$/g, '');
+            return `${formatted}${suffix}`;
+        }
+    }
+    return String(n);
+};
+
+export { AudioSettingsRequestDefaultDeviceEnum, AudioSettingsResponseDefaultDeviceEnum, browsers as Browsers, Call, CallState, CallType, CallTypes, CallingState, CameraManager, CameraManagerState, CreateDeviceRequestPushProviderEnum, DebounceType, DeviceManager, DeviceManagerState, DynascaleManager, ErrorFromResponse, FrameRecordingSettingsRequestModeEnum, FrameRecordingSettingsRequestQualityEnum, FrameRecordingSettingsResponseModeEnum, IngressAudioEncodingOptionsRequestChannelsEnum, IngressSourceRequestFpsEnum, IngressVideoLayerRequestCodecEnum, LayoutSettingsRequestNameEnum, MicrophoneManager, MicrophoneManagerState, NoiseCancellationSettingsModeEnum, OwnCapability, RNSpeechDetector, RTMPBroadcastRequestQualityEnum, RTMPSettingsRequestQualityEnum, RecordSettingsRequestModeEnum, RecordSettingsRequestQualityEnum, rxUtils as RxUtils, ScreenShareManager, ScreenShareState, events as SfuEvents, models as SfuModels, SpeakerManager, SpeakerState, StartClosedCaptionsRequestLanguageEnum, StartTranscriptionRequestLanguageEnum, StreamSfuClient, StreamVideoClient, StreamVideoReadOnlyStateStore, StreamVideoWriteableStateStore, TranscriptionSettingsRequestClosedCaptionModeEnum, TranscriptionSettingsRequestLanguageEnum, TranscriptionSettingsRequestModeEnum, TranscriptionSettingsResponseClosedCaptionModeEnum, TranscriptionSettingsResponseLanguageEnum, TranscriptionSettingsResponseModeEnum, VideoSettingsRequestCameraFacingEnum, VideoSettingsResponseCameraFacingEnum, ViewportTracker, VisibilityState, checkIfAudioOutputChangeSupported, combineComparators, conditional, createSoundDetector, defaultSortPreset, descending, deviceIds$, disposeOfMediaStream, dominantSpeaker, getAudioBrowserPermission, getAudioDevices, getAudioOutputDevices, getAudioStream, getClientDetails, getDeviceState, getScreenShareStream, getSdkInfo, getVideoBrowserPermission, getVideoDevices, getVideoStream, getWebRTCInfo, hasAudio, hasPausedTrack, hasScreenShare, hasScreenShareAudio, hasVideo, humanize, isPinned, livestreamOrAudioRoomSortPreset, logToConsole, name, noopComparator, paginatedLayoutSortPreset, pinned, publishingAudio, publishingVideo, reactionType, resolveDeviceId, role, screenSharing, setDeviceInfo, setOSInfo, setPowerState, setSdkInfo, setThermalState, setWebRTCInfo, speakerLayoutSortPreset, speaking, videoLoggerSystem, withParticipantSource };
 //# sourceMappingURL=index.es.js.map