npm - @whereby.com/media - Versions diffs - 9.0.0 → 9.1.0 - Mend

@whereby.com/media 9.0.0 → 9.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.cjs CHANGED Viewed

@@ -7149,9 +7149,25 @@ function getStream(constraintOpt_1) {
         let newConstraints;
         let retryConstraintOpt;
         let stream = null;
+        const attempts = [];
         const only = (constraintOpt.audioId === false && "video") || (constraintOpt.videoId === false && "audio");
         const stopTracks = isMobile || only !== "video";
         const constraints = getConstraints(constraintOpt);
+        const attempt = (c) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            try {
+                const s = yield getUserMedia(c);
+                attempts.push({ constraints: c, outcome: { ok: true } });
+                return s;
+            }
+            catch (e) {
+                attempts.push({
+                    constraints: c,
+                    outcome: Object.assign({ ok: false, errorName: (_a = e === null || e === void 0 ? void 0 : e.name) !== null && _a !== void 0 ? _a : "UnknownError", errorMessage: (_b = e === null || e === void 0 ? void 0 : e.message) !== null && _b !== void 0 ? _b : String(e) }, ((e === null || e === void 0 ? void 0 : e.constraint) && { constraint: e.constraint })),
+                });
+                throw e;
+            }
+        });
         const addDetails = (err, orgErr) => {
             if (err) {
                 err.details = Object.assign({ constraints, constraint: err.constraint || (orgErr === null || orgErr === void 0 ? void 0 : orgErr.constraint), newConstraints,
@@ -7163,10 +7179,15 @@ function getStream(constraintOpt_1) {
                 return new Error("Unknown error");
             }
         };
+        const attachAttempts = (err) => {
+            if (err)
+                err.attempts = attempts;
+            return err;
+        };
         const getSingleStream = (e) => __awaiter(this, void 0, void 0, function* () {
             if (constraints.audio && constraints.video) {
                 try {
-                    stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { audioId: false })));
+                    stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { audioId: false })));
                 }
                 catch (e2) {
                     if ((e2 === null || e2 === void 0 ? void 0 : e2.name) !== "NotFoundError") {
@@ -7175,7 +7196,7 @@ function getStream(constraintOpt_1) {
                 }
                 try {
                     if (!stream)
-                        stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { videoId: false })));
+                        stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { videoId: false })));
                 }
                 catch (e2) {
                     addDetails(e2, e);
@@ -7185,12 +7206,12 @@ function getStream(constraintOpt_1) {
         if (stopTracks && replaceStream)
             stopStreamTracks(replaceStream, only);
         try {
-            stream = yield getUserMedia(constraints);
+            stream = yield attempt(constraints);
         }
         catch (e) {
             error = e;
             if (!fallback) {
-                throw addDetails(e);
+                throw attachAttempts(addDetails(e));
             }
             if ((e === null || e === void 0 ? void 0 : e.name) === "OverconstrainedError") {
                 const laxConstraints = {
@@ -7214,7 +7235,7 @@ function getStream(constraintOpt_1) {
                 }
                 else if (e.name !== "NotAllowedError") {
                     try {
-                        stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: true }) })));
+                        stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: true }) })));
                     }
                     catch (e2) {
                         logger.warn(`Tried getting stream again with laxer constraints, but failed: ${"" + e2}`);
@@ -7223,7 +7244,7 @@ function getStream(constraintOpt_1) {
                     const problemWith = { audio: "audioId", video: "videoId" }[((_a = /(video|audio)/.exec(errMsg)) === null || _a === void 0 ? void 0 : _a[0]) || only || ""];
                     if (!stream && problemWith) {
                         try {
-                            stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [problemWith]: null })));
+                            stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [problemWith]: null })));
                         }
                         catch (e2) {
                             logger.warn(`Re-tried ${problemWith} with no constraints, but failed: ${"" + e2}`);
@@ -7233,7 +7254,7 @@ function getStream(constraintOpt_1) {
                         const tryOnly = problemWith ? [problemWith] : ["videoId", "audioId"];
                         for (const kind of tryOnly) {
                             try {
-                                stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [kind]: false })));
+                                stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [kind]: false })));
                             }
                             catch (e2) {
                                 logger.warn(`Re-tried without ${kind}, but failed: ${"" + e2}`);
@@ -7250,16 +7271,17 @@ function getStream(constraintOpt_1) {
         }
         if (retryConstraintOpt) {
             const onlyConstraints = only ? { audio: { videoId: false }, video: { audioId: false } }[only] : {};
-            newConstraints = getConstraints(Object.assign(Object.assign(Object.assign(Object.assign({}, constraintOpt), retryConstraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: retryConstraintOpt.lax }) }), onlyConstraints));
+            const retryConstraints = getConstraints(Object.assign(Object.assign(Object.assign(Object.assign({}, constraintOpt), retryConstraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: retryConstraintOpt.lax }) }), onlyConstraints));
+            newConstraints = retryConstraints;
             try {
-                stream = yield getUserMedia(newConstraints);
+                stream = yield attempt(retryConstraints);
             }
             catch (e) {
-                throw addDetails(e, error);
+                throw attachAttempts(addDetails(e, error));
             }
         }
         if (!stream) {
-            throw addDetails(error);
+            throw attachAttempts(addDetails(error));
         }
         let replacedTracks;
         if (replaceStream) {
@@ -7268,7 +7290,7 @@ function getStream(constraintOpt_1) {
             replacedTracks = replaceTracksInStream(replaceStream, stream, only);
             stream = replaceStream;
         }
-        return { error: error && addDetails(error), stream, replacedTracks };
+        return { error: error && addDetails(error), stream, replacedTracks, attempts };
     });
 }
 function hasGetDisplayMedia() {

package/dist/index.d.cts CHANGED Viewed

@@ -604,10 +604,23 @@ interface BuildDeviceListOptions {
     busyDeviceIds: string[];
     kind: MediaDeviceKind;
 }
+type GetUserMediaAttemptOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    errorName: string;
+    errorMessage: string;
+    constraint?: string;
+};
+type GetUserMediaAttempt = {
+    constraints: MediaStreamConstraints;
+    outcome: GetUserMediaAttemptOutcome;
+};
 type GetStreamResult = {
     error?: unknown;
     replacedTracks?: MediaStreamTrack[];
     stream: MediaStream;
+    attempts: GetUserMediaAttempt[];
 };
 type UpdatedDeviceInfo = {
     deviceId?: string | null;
@@ -2017,4 +2030,4 @@ declare class VegaRtcManager implements RtcManager {
 }
 export { ADDITIONAL_SCREEN_SHARE_SETTINGS, AUDIO_SETTINGS, BandwidthTester, CAMERA_STREAM_ID, EVENTS, KNOCK_MESSAGES, KalmanFilter, Logger, MEDIA_JITTER_BUFFER_TARGET, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, RtcEventNames, RtcManagerDispatcher, SCREEN_SHARE_SETTINGS, SCREEN_SHARE_SIMULCAST_SETTINGS, STREAM_TYPES, ServerSocket, Session, SfuV2Parser, TYPES, VIDEO_SETTINGS_HD, VIDEO_SETTINGS_SD, VIDEO_SETTINGS_VP9, VIDEO_SETTINGS_VP9_LOW_BANDWIDTH, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDeviceAsync, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, issueDetectorOrMetricEnabled, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, trackAnnotations, turnServerOverride, variance };
-export type { AddCameraStreamOptions, AddSpotlightRequest, AudioEnableRequest, AudioEnableRequestedEvent, AudioEnabledEvent, BreakoutConfig, BreakoutGroupJoinedEvent, BreakoutSessionUpdatedEvent, BuildDeviceListOptions, CannotJoinUnclaimedRoomError, ChatMessage, ClearableTimeout, ClientKickedEvent, ClientLeftEvent, ClientMetadataPayload, ClientMetadataReceivedEvent, ClientRole, ClientUnableToJoinEvent, CloudRecordingStartedEvent, Codec, ConnectionStatus, Credentials, ForbiddenError, ForbiddenErrorNames, GetConstraintsOptions, GetDeviceDataResult, GetMediaConstraintsOptions, GetStreamOptions, GetStreamResult, GetUpdatedDevicesResult, HostPresenceControlsError, IdentifyDeviceRequest, InternalServerError, InvalidAssistantKeyError, IssuesAndMetricsByView, JoinRoomRequest, KnockAcceptedEvent, KnockRejectedEvent, KnockRoomRequest, KnockerLeftEvent, LiveTranscriptionStartedEvent, LiveTranscriptionStoppedEvent, MaxViewerLimitReachedError, MediaPrefs, Metric, NewClientEvent, OrganizationAssistantNotEnabledError, OrganizationAssistantNotFoundError, OrganizationPlanExhaustedError, RemoveScreenshareStreamOptions, RemoveSpotlightRequest, RoleName, RoomConcurrencyControlsError, RoomEmptyError, RoomFullError, RoomJoinPermissionDeniedError, RoomJoinedErrors, RoomJoinedEvent, RoomJoinedSuccess, RoomKnockedEvent, RoomLockedError, RoomLockedEvent, RoomMeetingTimeExhaustedError, RoomMode, RoomSessionEndedEvent, RtcClientConnectionStatusChangedPayload, RtcEventEmitter, RtcEvents, RtcLocalStreamTrackAddedPayload, RtcLocalStreamTrackRemovedPayload, RtcManager, RtcManagerCreatedPayload, RtcManagerOptions, RtcStreamAddedPayload, ScreenshareStartedEvent, ScreenshareStoppedEvent, SendClientMetadataRequest, SignalClient, SignalEvents, SignalIceCandidateMessage, SignalIceEndOfCandidatesMessage, SignalIceServer, SignalKnocker, SignalMediaServerConfig, SignalRTCSessionDescription, SignalReadyToReceiveOfferMessage, SignalRequests, SignalRoom, SignalSDPMessage, SignalSFUServer, SignalTurnServer, SocketConf, SocketManager, Spotlight, SpotlightAddedEvent, SpotlightRemovedEvent, StatsMonitorOptions, StatsMonitorState, StatsSubscription, TurnTransportProtocol, UniqueRoleAlreadyInRoomError, UpdatedDeviceInfo, UpdatedDevicesInfo, VegaConnectionOptions, VegaRtcManagerOptions, VideoEnableRequest, VideoEnableRequestedEvent, VideoEnabledEvent, WebRTCProvider };
+export type { AddCameraStreamOptions, AddSpotlightRequest, AudioEnableRequest, AudioEnableRequestedEvent, AudioEnabledEvent, BreakoutConfig, BreakoutGroupJoinedEvent, BreakoutSessionUpdatedEvent, BuildDeviceListOptions, CannotJoinUnclaimedRoomError, ChatMessage, ClearableTimeout, ClientKickedEvent, ClientLeftEvent, ClientMetadataPayload, ClientMetadataReceivedEvent, ClientRole, ClientUnableToJoinEvent, CloudRecordingStartedEvent, Codec, ConnectionStatus, Credentials, ForbiddenError, ForbiddenErrorNames, GetConstraintsOptions, GetDeviceDataResult, GetMediaConstraintsOptions, GetStreamOptions, GetStreamResult, GetUpdatedDevicesResult, GetUserMediaAttempt, GetUserMediaAttemptOutcome, HostPresenceControlsError, IdentifyDeviceRequest, InternalServerError, InvalidAssistantKeyError, IssuesAndMetricsByView, JoinRoomRequest, KnockAcceptedEvent, KnockRejectedEvent, KnockRoomRequest, KnockerLeftEvent, LiveTranscriptionStartedEvent, LiveTranscriptionStoppedEvent, MaxViewerLimitReachedError, MediaPrefs, Metric, NewClientEvent, OrganizationAssistantNotEnabledError, OrganizationAssistantNotFoundError, OrganizationPlanExhaustedError, RemoveScreenshareStreamOptions, RemoveSpotlightRequest, RoleName, RoomConcurrencyControlsError, RoomEmptyError, RoomFullError, RoomJoinPermissionDeniedError, RoomJoinedErrors, RoomJoinedEvent, RoomJoinedSuccess, RoomKnockedEvent, RoomLockedError, RoomLockedEvent, RoomMeetingTimeExhaustedError, RoomMode, RoomSessionEndedEvent, RtcClientConnectionStatusChangedPayload, RtcEventEmitter, RtcEvents, RtcLocalStreamTrackAddedPayload, RtcLocalStreamTrackRemovedPayload, RtcManager, RtcManagerCreatedPayload, RtcManagerOptions, RtcStreamAddedPayload, ScreenshareStartedEvent, ScreenshareStoppedEvent, SendClientMetadataRequest, SignalClient, SignalEvents, SignalIceCandidateMessage, SignalIceEndOfCandidatesMessage, SignalIceServer, SignalKnocker, SignalMediaServerConfig, SignalRTCSessionDescription, SignalReadyToReceiveOfferMessage, SignalRequests, SignalRoom, SignalSDPMessage, SignalSFUServer, SignalTurnServer, SocketConf, SocketManager, Spotlight, SpotlightAddedEvent, SpotlightRemovedEvent, StatsMonitorOptions, StatsMonitorState, StatsSubscription, TurnTransportProtocol, UniqueRoleAlreadyInRoomError, UpdatedDeviceInfo, UpdatedDevicesInfo, VegaConnectionOptions, VegaRtcManagerOptions, VideoEnableRequest, VideoEnableRequestedEvent, VideoEnabledEvent, WebRTCProvider };

package/dist/index.d.mts CHANGED Viewed

@@ -604,10 +604,23 @@ interface BuildDeviceListOptions {
     busyDeviceIds: string[];
     kind: MediaDeviceKind;
 }
+type GetUserMediaAttemptOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    errorName: string;
+    errorMessage: string;
+    constraint?: string;
+};
+type GetUserMediaAttempt = {
+    constraints: MediaStreamConstraints;
+    outcome: GetUserMediaAttemptOutcome;
+};
 type GetStreamResult = {
     error?: unknown;
     replacedTracks?: MediaStreamTrack[];
     stream: MediaStream;
+    attempts: GetUserMediaAttempt[];
 };
 type UpdatedDeviceInfo = {
     deviceId?: string | null;
@@ -2017,4 +2030,4 @@ declare class VegaRtcManager implements RtcManager {
 }
 export { ADDITIONAL_SCREEN_SHARE_SETTINGS, AUDIO_SETTINGS, BandwidthTester, CAMERA_STREAM_ID, EVENTS, KNOCK_MESSAGES, KalmanFilter, Logger, MEDIA_JITTER_BUFFER_TARGET, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, RtcEventNames, RtcManagerDispatcher, SCREEN_SHARE_SETTINGS, SCREEN_SHARE_SIMULCAST_SETTINGS, STREAM_TYPES, ServerSocket, Session, SfuV2Parser, TYPES, VIDEO_SETTINGS_HD, VIDEO_SETTINGS_SD, VIDEO_SETTINGS_VP9, VIDEO_SETTINGS_VP9_LOW_BANDWIDTH, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDeviceAsync, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, issueDetectorOrMetricEnabled, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, trackAnnotations, turnServerOverride, variance };
-export type { AddCameraStreamOptions, AddSpotlightRequest, AudioEnableRequest, AudioEnableRequestedEvent, AudioEnabledEvent, BreakoutConfig, BreakoutGroupJoinedEvent, BreakoutSessionUpdatedEvent, BuildDeviceListOptions, CannotJoinUnclaimedRoomError, ChatMessage, ClearableTimeout, ClientKickedEvent, ClientLeftEvent, ClientMetadataPayload, ClientMetadataReceivedEvent, ClientRole, ClientUnableToJoinEvent, CloudRecordingStartedEvent, Codec, ConnectionStatus, Credentials, ForbiddenError, ForbiddenErrorNames, GetConstraintsOptions, GetDeviceDataResult, GetMediaConstraintsOptions, GetStreamOptions, GetStreamResult, GetUpdatedDevicesResult, HostPresenceControlsError, IdentifyDeviceRequest, InternalServerError, InvalidAssistantKeyError, IssuesAndMetricsByView, JoinRoomRequest, KnockAcceptedEvent, KnockRejectedEvent, KnockRoomRequest, KnockerLeftEvent, LiveTranscriptionStartedEvent, LiveTranscriptionStoppedEvent, MaxViewerLimitReachedError, MediaPrefs, Metric, NewClientEvent, OrganizationAssistantNotEnabledError, OrganizationAssistantNotFoundError, OrganizationPlanExhaustedError, RemoveScreenshareStreamOptions, RemoveSpotlightRequest, RoleName, RoomConcurrencyControlsError, RoomEmptyError, RoomFullError, RoomJoinPermissionDeniedError, RoomJoinedErrors, RoomJoinedEvent, RoomJoinedSuccess, RoomKnockedEvent, RoomLockedError, RoomLockedEvent, RoomMeetingTimeExhaustedError, RoomMode, RoomSessionEndedEvent, RtcClientConnectionStatusChangedPayload, RtcEventEmitter, RtcEvents, RtcLocalStreamTrackAddedPayload, RtcLocalStreamTrackRemovedPayload, RtcManager, RtcManagerCreatedPayload, RtcManagerOptions, RtcStreamAddedPayload, ScreenshareStartedEvent, ScreenshareStoppedEvent, SendClientMetadataRequest, SignalClient, SignalEvents, SignalIceCandidateMessage, SignalIceEndOfCandidatesMessage, SignalIceServer, SignalKnocker, SignalMediaServerConfig, SignalRTCSessionDescription, SignalReadyToReceiveOfferMessage, SignalRequests, SignalRoom, SignalSDPMessage, SignalSFUServer, SignalTurnServer, SocketConf, SocketManager, Spotlight, SpotlightAddedEvent, SpotlightRemovedEvent, StatsMonitorOptions, StatsMonitorState, StatsSubscription, TurnTransportProtocol, UniqueRoleAlreadyInRoomError, UpdatedDeviceInfo, UpdatedDevicesInfo, VegaConnectionOptions, VegaRtcManagerOptions, VideoEnableRequest, VideoEnableRequestedEvent, VideoEnabledEvent, WebRTCProvider };
+export type { AddCameraStreamOptions, AddSpotlightRequest, AudioEnableRequest, AudioEnableRequestedEvent, AudioEnabledEvent, BreakoutConfig, BreakoutGroupJoinedEvent, BreakoutSessionUpdatedEvent, BuildDeviceListOptions, CannotJoinUnclaimedRoomError, ChatMessage, ClearableTimeout, ClientKickedEvent, ClientLeftEvent, ClientMetadataPayload, ClientMetadataReceivedEvent, ClientRole, ClientUnableToJoinEvent, CloudRecordingStartedEvent, Codec, ConnectionStatus, Credentials, ForbiddenError, ForbiddenErrorNames, GetConstraintsOptions, GetDeviceDataResult, GetMediaConstraintsOptions, GetStreamOptions, GetStreamResult, GetUpdatedDevicesResult, GetUserMediaAttempt, GetUserMediaAttemptOutcome, HostPresenceControlsError, IdentifyDeviceRequest, InternalServerError, InvalidAssistantKeyError, IssuesAndMetricsByView, JoinRoomRequest, KnockAcceptedEvent, KnockRejectedEvent, KnockRoomRequest, KnockerLeftEvent, LiveTranscriptionStartedEvent, LiveTranscriptionStoppedEvent, MaxViewerLimitReachedError, MediaPrefs, Metric, NewClientEvent, OrganizationAssistantNotEnabledError, OrganizationAssistantNotFoundError, OrganizationPlanExhaustedError, RemoveScreenshareStreamOptions, RemoveSpotlightRequest, RoleName, RoomConcurrencyControlsError, RoomEmptyError, RoomFullError, RoomJoinPermissionDeniedError, RoomJoinedErrors, RoomJoinedEvent, RoomJoinedSuccess, RoomKnockedEvent, RoomLockedError, RoomLockedEvent, RoomMeetingTimeExhaustedError, RoomMode, RoomSessionEndedEvent, RtcClientConnectionStatusChangedPayload, RtcEventEmitter, RtcEvents, RtcLocalStreamTrackAddedPayload, RtcLocalStreamTrackRemovedPayload, RtcManager, RtcManagerCreatedPayload, RtcManagerOptions, RtcStreamAddedPayload, ScreenshareStartedEvent, ScreenshareStoppedEvent, SendClientMetadataRequest, SignalClient, SignalEvents, SignalIceCandidateMessage, SignalIceEndOfCandidatesMessage, SignalIceServer, SignalKnocker, SignalMediaServerConfig, SignalRTCSessionDescription, SignalReadyToReceiveOfferMessage, SignalRequests, SignalRoom, SignalSDPMessage, SignalSFUServer, SignalTurnServer, SocketConf, SocketManager, Spotlight, SpotlightAddedEvent, SpotlightRemovedEvent, StatsMonitorOptions, StatsMonitorState, StatsSubscription, TurnTransportProtocol, UniqueRoleAlreadyInRoomError, UpdatedDeviceInfo, UpdatedDevicesInfo, VegaConnectionOptions, VegaRtcManagerOptions, VideoEnableRequest, VideoEnableRequestedEvent, VideoEnabledEvent, WebRTCProvider };

package/dist/index.d.ts CHANGED Viewed

@@ -604,10 +604,23 @@ interface BuildDeviceListOptions {
     busyDeviceIds: string[];
     kind: MediaDeviceKind;
 }
+type GetUserMediaAttemptOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    errorName: string;
+    errorMessage: string;
+    constraint?: string;
+};
+type GetUserMediaAttempt = {
+    constraints: MediaStreamConstraints;
+    outcome: GetUserMediaAttemptOutcome;
+};
 type GetStreamResult = {
     error?: unknown;
     replacedTracks?: MediaStreamTrack[];
     stream: MediaStream;
+    attempts: GetUserMediaAttempt[];
 };
 type UpdatedDeviceInfo = {
     deviceId?: string | null;
@@ -2017,4 +2030,4 @@ declare class VegaRtcManager implements RtcManager {
 }
 export { ADDITIONAL_SCREEN_SHARE_SETTINGS, AUDIO_SETTINGS, BandwidthTester, CAMERA_STREAM_ID, EVENTS, KNOCK_MESSAGES, KalmanFilter, Logger, MEDIA_JITTER_BUFFER_TARGET, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, RtcEventNames, RtcManagerDispatcher, SCREEN_SHARE_SETTINGS, SCREEN_SHARE_SIMULCAST_SETTINGS, STREAM_TYPES, ServerSocket, Session, SfuV2Parser, TYPES, VIDEO_SETTINGS_HD, VIDEO_SETTINGS_SD, VIDEO_SETTINGS_VP9, VIDEO_SETTINGS_VP9_LOW_BANDWIDTH, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDeviceAsync, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, issueDetectorOrMetricEnabled, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, trackAnnotations, turnServerOverride, variance };
-export type { AddCameraStreamOptions, AddSpotlightRequest, AudioEnableRequest, AudioEnableRequestedEvent, AudioEnabledEvent, BreakoutConfig, BreakoutGroupJoinedEvent, BreakoutSessionUpdatedEvent, BuildDeviceListOptions, CannotJoinUnclaimedRoomError, ChatMessage, ClearableTimeout, ClientKickedEvent, ClientLeftEvent, ClientMetadataPayload, ClientMetadataReceivedEvent, ClientRole, ClientUnableToJoinEvent, CloudRecordingStartedEvent, Codec, ConnectionStatus, Credentials, ForbiddenError, ForbiddenErrorNames, GetConstraintsOptions, GetDeviceDataResult, GetMediaConstraintsOptions, GetStreamOptions, GetStreamResult, GetUpdatedDevicesResult, HostPresenceControlsError, IdentifyDeviceRequest, InternalServerError, InvalidAssistantKeyError, IssuesAndMetricsByView, JoinRoomRequest, KnockAcceptedEvent, KnockRejectedEvent, KnockRoomRequest, KnockerLeftEvent, LiveTranscriptionStartedEvent, LiveTranscriptionStoppedEvent, MaxViewerLimitReachedError, MediaPrefs, Metric, NewClientEvent, OrganizationAssistantNotEnabledError, OrganizationAssistantNotFoundError, OrganizationPlanExhaustedError, RemoveScreenshareStreamOptions, RemoveSpotlightRequest, RoleName, RoomConcurrencyControlsError, RoomEmptyError, RoomFullError, RoomJoinPermissionDeniedError, RoomJoinedErrors, RoomJoinedEvent, RoomJoinedSuccess, RoomKnockedEvent, RoomLockedError, RoomLockedEvent, RoomMeetingTimeExhaustedError, RoomMode, RoomSessionEndedEvent, RtcClientConnectionStatusChangedPayload, RtcEventEmitter, RtcEvents, RtcLocalStreamTrackAddedPayload, RtcLocalStreamTrackRemovedPayload, RtcManager, RtcManagerCreatedPayload, RtcManagerOptions, RtcStreamAddedPayload, ScreenshareStartedEvent, ScreenshareStoppedEvent, SendClientMetadataRequest, SignalClient, SignalEvents, SignalIceCandidateMessage, SignalIceEndOfCandidatesMessage, SignalIceServer, SignalKnocker, SignalMediaServerConfig, SignalRTCSessionDescription, SignalReadyToReceiveOfferMessage, SignalRequests, SignalRoom, SignalSDPMessage, SignalSFUServer, SignalTurnServer, SocketConf, SocketManager, Spotlight, SpotlightAddedEvent, SpotlightRemovedEvent, StatsMonitorOptions, StatsMonitorState, StatsSubscription, TurnTransportProtocol, UniqueRoleAlreadyInRoomError, UpdatedDeviceInfo, UpdatedDevicesInfo, VegaConnectionOptions, VegaRtcManagerOptions, VideoEnableRequest, VideoEnableRequestedEvent, VideoEnabledEvent, WebRTCProvider };
+export type { AddCameraStreamOptions, AddSpotlightRequest, AudioEnableRequest, AudioEnableRequestedEvent, AudioEnabledEvent, BreakoutConfig, BreakoutGroupJoinedEvent, BreakoutSessionUpdatedEvent, BuildDeviceListOptions, CannotJoinUnclaimedRoomError, ChatMessage, ClearableTimeout, ClientKickedEvent, ClientLeftEvent, ClientMetadataPayload, ClientMetadataReceivedEvent, ClientRole, ClientUnableToJoinEvent, CloudRecordingStartedEvent, Codec, ConnectionStatus, Credentials, ForbiddenError, ForbiddenErrorNames, GetConstraintsOptions, GetDeviceDataResult, GetMediaConstraintsOptions, GetStreamOptions, GetStreamResult, GetUpdatedDevicesResult, GetUserMediaAttempt, GetUserMediaAttemptOutcome, HostPresenceControlsError, IdentifyDeviceRequest, InternalServerError, InvalidAssistantKeyError, IssuesAndMetricsByView, JoinRoomRequest, KnockAcceptedEvent, KnockRejectedEvent, KnockRoomRequest, KnockerLeftEvent, LiveTranscriptionStartedEvent, LiveTranscriptionStoppedEvent, MaxViewerLimitReachedError, MediaPrefs, Metric, NewClientEvent, OrganizationAssistantNotEnabledError, OrganizationAssistantNotFoundError, OrganizationPlanExhaustedError, RemoveScreenshareStreamOptions, RemoveSpotlightRequest, RoleName, RoomConcurrencyControlsError, RoomEmptyError, RoomFullError, RoomJoinPermissionDeniedError, RoomJoinedErrors, RoomJoinedEvent, RoomJoinedSuccess, RoomKnockedEvent, RoomLockedError, RoomLockedEvent, RoomMeetingTimeExhaustedError, RoomMode, RoomSessionEndedEvent, RtcClientConnectionStatusChangedPayload, RtcEventEmitter, RtcEvents, RtcLocalStreamTrackAddedPayload, RtcLocalStreamTrackRemovedPayload, RtcManager, RtcManagerCreatedPayload, RtcManagerOptions, RtcStreamAddedPayload, ScreenshareStartedEvent, ScreenshareStoppedEvent, SendClientMetadataRequest, SignalClient, SignalEvents, SignalIceCandidateMessage, SignalIceEndOfCandidatesMessage, SignalIceServer, SignalKnocker, SignalMediaServerConfig, SignalRTCSessionDescription, SignalReadyToReceiveOfferMessage, SignalRequests, SignalRoom, SignalSDPMessage, SignalSFUServer, SignalTurnServer, SocketConf, SocketManager, Spotlight, SpotlightAddedEvent, SpotlightRemovedEvent, StatsMonitorOptions, StatsMonitorState, StatsSubscription, TurnTransportProtocol, UniqueRoleAlreadyInRoomError, UpdatedDeviceInfo, UpdatedDevicesInfo, VegaConnectionOptions, VegaRtcManagerOptions, VideoEnableRequest, VideoEnableRequestedEvent, VideoEnabledEvent, WebRTCProvider };

package/dist/index.mjs CHANGED Viewed

@@ -7128,9 +7128,25 @@ function getStream(constraintOpt_1) {
         let newConstraints;
         let retryConstraintOpt;
         let stream = null;
+        const attempts = [];
         const only = (constraintOpt.audioId === false && "video") || (constraintOpt.videoId === false && "audio");
         const stopTracks = isMobile || only !== "video";
         const constraints = getConstraints(constraintOpt);
+        const attempt = (c) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            try {
+                const s = yield getUserMedia(c);
+                attempts.push({ constraints: c, outcome: { ok: true } });
+                return s;
+            }
+            catch (e) {
+                attempts.push({
+                    constraints: c,
+                    outcome: Object.assign({ ok: false, errorName: (_a = e === null || e === void 0 ? void 0 : e.name) !== null && _a !== void 0 ? _a : "UnknownError", errorMessage: (_b = e === null || e === void 0 ? void 0 : e.message) !== null && _b !== void 0 ? _b : String(e) }, ((e === null || e === void 0 ? void 0 : e.constraint) && { constraint: e.constraint })),
+                });
+                throw e;
+            }
+        });
         const addDetails = (err, orgErr) => {
             if (err) {
                 err.details = Object.assign({ constraints, constraint: err.constraint || (orgErr === null || orgErr === void 0 ? void 0 : orgErr.constraint), newConstraints,
@@ -7142,10 +7158,15 @@ function getStream(constraintOpt_1) {
                 return new Error("Unknown error");
             }
         };
+        const attachAttempts = (err) => {
+            if (err)
+                err.attempts = attempts;
+            return err;
+        };
         const getSingleStream = (e) => __awaiter(this, void 0, void 0, function* () {
             if (constraints.audio && constraints.video) {
                 try {
-                    stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { audioId: false })));
+                    stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { audioId: false })));
                 }
                 catch (e2) {
                     if ((e2 === null || e2 === void 0 ? void 0 : e2.name) !== "NotFoundError") {
@@ -7154,7 +7175,7 @@ function getStream(constraintOpt_1) {
                 }
                 try {
                     if (!stream)
-                        stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { videoId: false })));
+                        stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { videoId: false })));
                 }
                 catch (e2) {
                     addDetails(e2, e);
@@ -7164,12 +7185,12 @@ function getStream(constraintOpt_1) {
         if (stopTracks && replaceStream)
             stopStreamTracks(replaceStream, only);
         try {
-            stream = yield getUserMedia(constraints);
+            stream = yield attempt(constraints);
         }
         catch (e) {
             error = e;
             if (!fallback) {
-                throw addDetails(e);
+                throw attachAttempts(addDetails(e));
             }
             if ((e === null || e === void 0 ? void 0 : e.name) === "OverconstrainedError") {
                 const laxConstraints = {
@@ -7193,7 +7214,7 @@ function getStream(constraintOpt_1) {
                 }
                 else if (e.name !== "NotAllowedError") {
                     try {
-                        stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: true }) })));
+                        stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: true }) })));
                     }
                     catch (e2) {
                         logger.warn(`Tried getting stream again with laxer constraints, but failed: ${"" + e2}`);
@@ -7202,7 +7223,7 @@ function getStream(constraintOpt_1) {
                     const problemWith = { audio: "audioId", video: "videoId" }[((_a = /(video|audio)/.exec(errMsg)) === null || _a === void 0 ? void 0 : _a[0]) || only || ""];
                     if (!stream && problemWith) {
                         try {
-                            stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [problemWith]: null })));
+                            stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [problemWith]: null })));
                         }
                         catch (e2) {
                             logger.warn(`Re-tried ${problemWith} with no constraints, but failed: ${"" + e2}`);
@@ -7212,7 +7233,7 @@ function getStream(constraintOpt_1) {
                         const tryOnly = problemWith ? [problemWith] : ["videoId", "audioId"];
                         for (const kind of tryOnly) {
                             try {
-                                stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [kind]: false })));
+                                stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [kind]: false })));
                             }
                             catch (e2) {
                                 logger.warn(`Re-tried without ${kind}, but failed: ${"" + e2}`);
@@ -7229,16 +7250,17 @@ function getStream(constraintOpt_1) {
         }
         if (retryConstraintOpt) {
             const onlyConstraints = only ? { audio: { videoId: false }, video: { audioId: false } }[only] : {};
-            newConstraints = getConstraints(Object.assign(Object.assign(Object.assign(Object.assign({}, constraintOpt), retryConstraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: retryConstraintOpt.lax }) }), onlyConstraints));
+            const retryConstraints = getConstraints(Object.assign(Object.assign(Object.assign(Object.assign({}, constraintOpt), retryConstraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: retryConstraintOpt.lax }) }), onlyConstraints));
+            newConstraints = retryConstraints;
             try {
-                stream = yield getUserMedia(newConstraints);
+                stream = yield attempt(retryConstraints);
             }
             catch (e) {
-                throw addDetails(e, error);
+                throw attachAttempts(addDetails(e, error));
             }
         }
         if (!stream) {
-            throw addDetails(error);
+            throw attachAttempts(addDetails(error));
         }
         let replacedTracks;
         if (replaceStream) {
@@ -7247,7 +7269,7 @@ function getStream(constraintOpt_1) {
             replacedTracks = replaceTracksInStream(replaceStream, stream, only);
             stream = replaceStream;
         }
-        return { error: error && addDetails(error), stream, replacedTracks };
+        return { error: error && addDetails(error), stream, replacedTracks, attempts };
     });
 }
 function hasGetDisplayMedia() {

package/dist/legacy-esm.js CHANGED Viewed

@@ -7128,9 +7128,25 @@ function getStream(constraintOpt_1) {
         let newConstraints;
         let retryConstraintOpt;
         let stream = null;
+        const attempts = [];
         const only = (constraintOpt.audioId === false && "video") || (constraintOpt.videoId === false && "audio");
         const stopTracks = isMobile || only !== "video";
         const constraints = getConstraints(constraintOpt);
+        const attempt = (c) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            try {
+                const s = yield getUserMedia(c);
+                attempts.push({ constraints: c, outcome: { ok: true } });
+                return s;
+            }
+            catch (e) {
+                attempts.push({
+                    constraints: c,
+                    outcome: Object.assign({ ok: false, errorName: (_a = e === null || e === void 0 ? void 0 : e.name) !== null && _a !== void 0 ? _a : "UnknownError", errorMessage: (_b = e === null || e === void 0 ? void 0 : e.message) !== null && _b !== void 0 ? _b : String(e) }, ((e === null || e === void 0 ? void 0 : e.constraint) && { constraint: e.constraint })),
+                });
+                throw e;
+            }
+        });
         const addDetails = (err, orgErr) => {
             if (err) {
                 err.details = Object.assign({ constraints, constraint: err.constraint || (orgErr === null || orgErr === void 0 ? void 0 : orgErr.constraint), newConstraints,
@@ -7142,10 +7158,15 @@ function getStream(constraintOpt_1) {
                 return new Error("Unknown error");
             }
         };
+        const attachAttempts = (err) => {
+            if (err)
+                err.attempts = attempts;
+            return err;
+        };
         const getSingleStream = (e) => __awaiter(this, void 0, void 0, function* () {
             if (constraints.audio && constraints.video) {
                 try {
-                    stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { audioId: false })));
+                    stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { audioId: false })));
                 }
                 catch (e2) {
                     if ((e2 === null || e2 === void 0 ? void 0 : e2.name) !== "NotFoundError") {
@@ -7154,7 +7175,7 @@ function getStream(constraintOpt_1) {
                 }
                 try {
                     if (!stream)
-                        stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { videoId: false })));
+                        stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { videoId: false })));
                 }
                 catch (e2) {
                     addDetails(e2, e);
@@ -7164,12 +7185,12 @@ function getStream(constraintOpt_1) {
         if (stopTracks && replaceStream)
             stopStreamTracks(replaceStream, only);
         try {
-            stream = yield getUserMedia(constraints);
+            stream = yield attempt(constraints);
         }
         catch (e) {
             error = e;
             if (!fallback) {
-                throw addDetails(e);
+                throw attachAttempts(addDetails(e));
             }
             if ((e === null || e === void 0 ? void 0 : e.name) === "OverconstrainedError") {
                 const laxConstraints = {
@@ -7193,7 +7214,7 @@ function getStream(constraintOpt_1) {
                 }
                 else if (e.name !== "NotAllowedError") {
                     try {
-                        stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: true }) })));
+                        stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: true }) })));
                     }
                     catch (e2) {
                         logger.warn(`Tried getting stream again with laxer constraints, but failed: ${"" + e2}`);
@@ -7202,7 +7223,7 @@ function getStream(constraintOpt_1) {
                     const problemWith = { audio: "audioId", video: "videoId" }[((_a = /(video|audio)/.exec(errMsg)) === null || _a === void 0 ? void 0 : _a[0]) || only || ""];
                     if (!stream && problemWith) {
                         try {
-                            stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [problemWith]: null })));
+                            stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [problemWith]: null })));
                         }
                         catch (e2) {
                             logger.warn(`Re-tried ${problemWith} with no constraints, but failed: ${"" + e2}`);
@@ -7212,7 +7233,7 @@ function getStream(constraintOpt_1) {
                         const tryOnly = problemWith ? [problemWith] : ["videoId", "audioId"];
                         for (const kind of tryOnly) {
                             try {
-                                stream = yield getUserMedia(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [kind]: false })));
+                                stream = yield attempt(getConstraints(Object.assign(Object.assign({}, constraintOpt), { [kind]: false })));
                             }
                             catch (e2) {
                                 logger.warn(`Re-tried without ${kind}, but failed: ${"" + e2}`);
@@ -7229,16 +7250,17 @@ function getStream(constraintOpt_1) {
         }
         if (retryConstraintOpt) {
             const onlyConstraints = only ? { audio: { videoId: false }, video: { audioId: false } }[only] : {};
-            newConstraints = getConstraints(Object.assign(Object.assign(Object.assign(Object.assign({}, constraintOpt), retryConstraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: retryConstraintOpt.lax }) }), onlyConstraints));
+            const retryConstraints = getConstraints(Object.assign(Object.assign(Object.assign(Object.assign({}, constraintOpt), retryConstraintOpt), { options: Object.assign(Object.assign({}, constraintOpt.options), { lax: retryConstraintOpt.lax }) }), onlyConstraints));
+            newConstraints = retryConstraints;
             try {
-                stream = yield getUserMedia(newConstraints);
+                stream = yield attempt(retryConstraints);
             }
             catch (e) {
-                throw addDetails(e, error);
+                throw attachAttempts(addDetails(e, error));
             }
         }
         if (!stream) {
-            throw addDetails(error);
+            throw attachAttempts(addDetails(error));
         }
         let replacedTracks;
         if (replaceStream) {
@@ -7247,7 +7269,7 @@ function getStream(constraintOpt_1) {
             replacedTracks = replaceTracksInStream(replaceStream, stream, only);
             stream = replaceStream;
         }
-        return { error: error && addDetails(error), stream, replacedTracks };
+        return { error: error && addDetails(error), stream, replacedTracks, attempts };
     });
 }
 function hasGetDisplayMedia() {

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@whereby.com/media",
   "description": "Media library for Whereby",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "license": "MIT",
   "homepage": "https://github.com/whereby/sdk",
   "repository": {