@techsee/techsee-media-service 999.2.3-sap → 999.3.0-sap

package/README.md

@@ -1,25 +1,25 @@
 # @techsee/techsee-media-service
 
 **General Info**  
-This package is a starting point for creating Techsee Media SDK. 
+This package is a starting point for creating Techsee Media SDK.
 It contains basic framework for creating applications that utilizes media abilities.
 It can be video and/or audio, with or without streaming over WebRTC protocol.  
-The framework currently supports: Video+Voip over Techsee Video (Turn) + IE Plugin and OpenTOK + IE Plugin.  
+The framework currently supports: Video+Voip over Techsee Video (Turn) + IE Plugin and OpenTOK + IE Plugin.
 
 You can see a very simple demo, which demonstrates how to create very basic MediaService implementation and use it for rendering video in react component.
-Clone the repository, run `npm i`, then run `npm run demo`. The source code of the demo, can be found in ./demo folder. 
+Clone the repository, run `npm i`, then run `npm run demo`. The source code of the demo, can be found in ./demo folder.
 
 ---
 
 Some basic framework principles are described below, which will help you to work with media framework.
 
 **Framework actors**  
-`MediaStreamTrack` -  WebRTC object, the most basic media unit.  
-It can be video track (WebCam or ScreenShare), or audio track (Microphone stream).  
-  
+`MediaStreamTrack` - WebRTC object, the most basic media unit.  
+It can be video track (WebCam or ScreenShare), or audio track (Microphone stream).
+
 `MediaStream` - WebRTC object that just organizes multiple `MediaStreamTracks` into single group.
 The same `MediaStreamTrack` can belong to multiple `MediaStreams`.
-In Techsee Media Service implementation, `MediaStream` can not contain more than one `MediaStreamTrack` and it used only because HTML5 video element works with `MediaStream` object.   
+In Techsee Media Service implementation, `MediaStream` can not contain more than one `MediaStreamTrack` and it used only because HTML5 video element works with `MediaStream` object.
 
 `TechseeMediaStream` - This is a logical wrapper for WebRTC `MediaStreamTrack` and manages some additional information regarding the specific `MediaStreamTrack`.
 For example this object has the type of the `MediaStreamTrack` (USER_VIDEO, AGENT_AUDIO...etc), has indication if track is local or remote.
@@ -27,58 +27,57 @@ For example this object has the type of the `MediaStreamTrack` (USER_VIDEO, AGEN
 `MediaSubscriber` - Techsee logical unit, that responsible to render `MediaStreams` into DOM.
 In simple words this object creates video element in html, and renders `MediaStream` into it, when stream is ready.
 `MediaSubscriber` is created for specific `MediaStream`, and whenever that stream created, the subscriber will start playing it.
-The subscriber will notify it's consumers about the state changes through `onStateChanged` method.    
+The subscriber will notify it's consumers about the state changes through `onStateChanged` method.
 
 `MediaSession` - Techsee logical unit, that used to stream video over WebRTC protocol. This object is responsible to handle all aspect of peers connectivity, including signaling, or third party service handling, like OpenTok.  
 When connection with peer established, this service registers `MediaStreamTracks` that received from peer and publishes local streams the connected peer.
 Current implementation contains `MediaSessionBase` object, which have basic abstractions for all types of sessions. `SessionTurn` which handles the Techsee video sessions over TURN server.
 `SessionOpentok` which handles the session connectivity over OpenTok third party service.
- 
+
 `RTCPeerConnection` - WebRTC object that represents connection with single peer, when SessionTurn is used for session. The same peer is used to send and/or receive media information.
 
-`OTPeerConnection` - Design time only Typescript abstraction, which represents the connectivity with peer over OpenTok session. 
+`OTPeerConnection` - Design time only Typescript abstraction, which represents the connectivity with peer over OpenTok session.
 
 `MediaPublisher` - Techsee logical unit which organizes local MediaStreamTracks into single MediaStream for publishing.
 
 `MediaService` - Techsee logical unit. Represents the Facade of the framework and glues all of the above together.
 Current implementation provides `MediaServiceBase` abstract object that contains all base logic and tools for displaying media locally or streaming it over WebRTC.
-Each application should create its concrete `MediaService` and fill specific application logic gaps. 
+Each application should create its concrete `MediaService` and fill specific application logic gaps.
 For example, currently exist `DashboardMediaService` in `techsee-app` and `MobileMediaService` in `techee-mobile`.
 
 ---
 
 **Consuming media service - High Level Flow**
-  
+
 In order to be able to use media service, first you need to create and instance of it and initialize it.
-Depending on application, the constructor parameters can be different, but MediaServiceBase need to get the following in it's constructor:  
+Depending on application, the constructor parameters can be different, but MediaServiceBase need to get the following in it's constructor:
 
 `let mediaService = new SomeSpecificMediaService(environment, webRtcInfo);`
- 
-* **environment: IMediaEnvironment** - Service which will help understand in which environment the media service is currently running.
-* **webRtcSupportInfo: ClientWebRtcInfo** - Information about WebRTC support on currently running device  
 
+-   **environment: IMediaEnvironment** - Service which will help understand in which environment the media service is currently running.
+-   **webRtcSupportInfo: ClientWebRtcInfo** - Information about WebRTC support on currently running device
 
 When instance of specific MediaService was created, it should be initialized with `mediaService.initMediaService(serviceOptions)` method.
 See `MediaServiceOptions` for options details. The method returns promise that resolved when initialization is done.
 Initialization process, detects what media support currently running device have.
 It checks if video can be played (natively or using IE plugins), if device have mic and so on...
-After initialization promise resolved, the device information get be accessed through `mediaService.deviceSupportInfo`. 
+After initialization promise resolved, the device information get be accessed through `mediaService.deviceSupportInfo`.
 
-***Note:*** Before promise returned by `mediaService.initMediaService(serviceOptions)` was not resolved, you not able to call `mediaService.initLocalMediaStreams(serviceOptions)`,
+**_Note:_** Before promise returned by `mediaService.initMediaService(serviceOptions)` was not resolved, you not able to call `mediaService.initLocalMediaStreams(serviceOptions)`,
 but you can create media subscribers if needed by calling `mediaService.createSubscriber(subscriberParams)`.
 
 If audio stream is needed during the session, `mediaService.enableVoipDuringSession()` method should be called before initializing local streams.
-After initialization was done and promise was resolved `mediaService.initLocalMediaStreams(serviceOptions)` can be called when video/audio streams should be created.    
+After initialization was done and promise was resolved `mediaService.initLocalMediaStreams(serviceOptions)` can be called when video/audio streams should be created.  
 This method will start the local MediaStream creation process, and Camera/ScreenShare approval dialog will popup if there permission currently exists.
 `initLocalMediaStreams` method is called by controller which displays local media stream on mobile, and in MediaSession, when `peerConnection ` is created.
- `initLocalMediaStreams` synchronizes the calls and insures there only one instance of stream exists, and both sides receives the same one.  
- 
- As mentioned before, `mediaService.createSubscriber(subscriberParams)` can be called even before initialization, so whenever you have the `div` container that should hold video element,
- you can create the subscriber, by providing `KnownMediaStream` and `div` as container. Whenever the stream is ready, it will be played automatically by `MediaSubscriber`.
- `MediaSubscriber` will create `video` element, add it to `div` container and will insure it plays.
- `MediaSubscriber` has 'onStateChanged' method, which can be used for being notified on state changes of the subscriber.
- It will notify when it starts or stops playing the video, or when it has been muted or unmuted. In event listener you can inspect properties of the subscriber to see in which state it currently exists.
- In addition, `MediaSubscriber` has `onDispose` event handler, which will be called after `MediaSubscriber` was disposed and will never play video again, so references to it can be removed in order to avoid memory leaks.   
+`initLocalMediaStreams` synchronizes the calls and insures there only one instance of stream exists, and both sides receives the same one.
+
+As mentioned before, `mediaService.createSubscriber(subscriberParams)` can be called even before initialization, so whenever you have the `div` container that should hold video element,
+you can create the subscriber, by providing `KnownMediaStream` and `div` as container. Whenever the stream is ready, it will be played automatically by `MediaSubscriber`.
+`MediaSubscriber` will create `video` element, add it to `div` container and will insure it plays.
+`MediaSubscriber` has 'onStateChanged' method, which can be used for being notified on state changes of the subscriber.
+It will notify when it starts or stops playing the video, or when it has been muted or unmuted. In event listener you can inspect properties of the subscriber to see in which state it currently exists.
+In addition, `MediaSubscriber` has `onDispose` event handler, which will be called after `MediaSubscriber` was disposed and will never play video again, so references to it can be removed in order to avoid memory leaks.
 
 **Connecting to WebRTC Media Session - High Level Flow**
 
@@ -86,4 +85,4 @@ After initialization promise was resolved, `mediaService.connectToSession(sessio
 Connection to session can be done before media streams were initialized, if your use case requires it.
 In case of of Techsee Live implementation, connection to session is done only when Terms and camera access approved by the user.
 Depending on configuration passed in initialization method, `SessionTurn` or `SessionOpentok` will be created to manage the media session peers.
-Whenever WebRTC peer will be connected, MediaSession instance will ask from `mediaService` for MediaStream that should be published to connected peer. 
+Whenever WebRTC peer will be connected, MediaSession instance will ask from `mediaService` for MediaStream that should be published to connected peer.

package/lib/LocalStreamManager.d.ts

@@ -20,7 +20,7 @@ export declare class LocalStreamManager {
     private environment;
     private _groupedDevices;
     constructor(environment: IMediaEnvironment);
-    readonly groupedDevices: IGroupedDevices;
+    get groupedDevices(): IGroupedDevices;
     getUserMediaStream(constraints: LocalMediaConstraints): Promise<MediaRequestSuccessResult>;
     getDesktopMediaStream(constraints: LocalVideoStreamConstraints): Promise<MediaRequestSuccessResult>;
     destroyUserMediaStream(): Promise<void>;

package/lib/LocalStreamManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/LocalStreamManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAE3B,yBAAyB,EAE5B,MAAM,kBAAkB,CAAC;AAY1B,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,qBAAqB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC3D,wBAAwB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC9D,2BAA2B,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAC7D,0BAA0B,EAAE,OAAO,CAAC;KACvC;CACJ;AAeD,UAAU,eAAe;IACrB,KAAK,EAAE,QAAQ,CAAC;QAAE,IAAI,CAAC,EAAE,eAAe,CAAC;QAAC,KAAK,CAAC,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IACrE,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,eAAe,CAAgE;gBAE3E,WAAW,EAAE,iBAAiB;aAOtC,cAAc;IAIlB,kBAAkB,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA2C1F,qBAAqB,CAAC,WAAW,EAAE,2BAA2B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA4CnG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBvC,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB1C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,OAAO,CAAC,0BAA0B;IAwDlC,OAAO,CAAC,6BAA6B;IAiBrC,OAAO,CAAC,mCAAmC;IAmD3C,iBAAiB,CAAC,cAAc,EAAE;QAAC,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,eAAe,EAAE,CAAA;KAAC;IAStF,OAAO,CAAC,oBAAoB;IAuE5B,OAAO,CAAC,wBAAwB;CAwCnC","file":"LocalStreamManager.d.ts","sourcesContent":["import assign from 'lodash/assign';\nimport get from 'lodash/get';\nimport last from 'lodash/last';\nimport first from 'lodash/first';\nimport cloneDeep from 'lodash/cloneDeep';\nimport {Promise} from 'bluebird';\n\nimport {Nullable} from '@techsee/techsee-common';\n\nimport {\n    IMediaEnvironment,\n    LocalMediaConstraints,\n    LocalVideoStreamConstraints,\n    MediaRequestFailResult,\n    MediaRequestSuccessResult,\n    VideoStreamResolution\n} from './MediaContracts';\n\nimport {\n    CameraTypes,\n    ConstraintType,\n    DEFAULT_VIDEO_CONSTRAINT_TYPE,\n    DEFAULT_VIDEO_RESOLUTION,\n    LocalVideoSourceType,\n    MediaRequestErrorCode\n} from './MediaConstants';\nimport {getMediaTracer} from './MediaUtils/MediaTracer';\n\ndeclare global {\n    interface Window {\n        latestUserMediaStream: Nullable<MediaRequestSuccessResult>;\n        latestDesktopMediaStream: Nullable<MediaRequestSuccessResult>;\n        latestLocalMediaConstraints: Nullable<LocalMediaConstraints>;\n        mediaStreamAlreadyReplaced: boolean;\n    }\n}\n\ndeclare const window: Window;\n\nwindow.latestUserMediaStream = null;\nlet userMediaPromise: Nullable<Promise<MediaRequestSuccessResult>> = null;\n\nwindow.latestDesktopMediaStream = null;\nlet desktopMediaPromise: Nullable<Promise<MediaRequestSuccessResult>> = null;\n\nwindow.mediaStreamAlreadyReplaced = false;\nwindow.latestLocalMediaConstraints = null;\n\nconst trace = getMediaTracer('LocalStreamManager');\n\ninterface IGroupedDevices {\n    video: Nullable<{ back?: MediaDeviceInfo; front?: MediaDeviceInfo }>;\n    audio: Nullable<MediaDeviceInfo>;\n    camerasCount: number;\n}\n\nexport class LocalStreamManager {\n    private environment: IMediaEnvironment;\n    private _groupedDevices: IGroupedDevices = {video: null, audio: null, camerasCount: 0};\n\n    constructor(environment: IMediaEnvironment) {\n        this.environment = environment;\n\n        this.parseMediaErrorThenThrow = this.parseMediaErrorThenThrow.bind(this);\n        this.clearAllStreams = this.clearAllStreams.bind(this);\n    }\n\n    get groupedDevices() {\n        return this._groupedDevices;\n    }\n\n    getUserMediaStream(constraints: LocalMediaConstraints): Promise<MediaRequestSuccessResult> {\n        trace.info('getUserMediaStream', constraints);\n        if (userMediaPromise) {\n            return userMediaPromise;\n        }\n\n        if (window.latestUserMediaStream) {\n            const videoTrack = window.latestUserMediaStream.mediaStream.getVideoTracks();\n\n            if (videoTrack.length > 0 && videoTrack[0].readyState === 'live') {\n                return Promise.resolve({...window.latestUserMediaStream, isNew: false});\n            }\n\n            this.destroyUserMediaStream();\n        }\n\n        userMediaPromise = new Promise((resolve, reject) => {\n            const catchHandler = (err: any): void => {\n                userMediaPromise = null;\n                window.latestUserMediaStream = null;\n                trace.error('getUserMedia error', err);\n                reject(err);\n            };\n\n            try {\n                this.getHighestResolutionStream(false, constraints)\n                    .then((streamResult: MediaRequestSuccessResult) => {\n                        userMediaPromise = null;\n                        window.latestUserMediaStream = streamResult;\n                        window.latestLocalMediaConstraints = cloneDeep(constraints);\n                        window.latestLocalMediaConstraints.audio = (streamResult.constraint && streamResult.constraint.audio) as boolean;\n\n                        resolve({...window.latestUserMediaStream, isNew: true});\n                    })\n                    .catch(catchHandler);\n            } catch (err) {\n                catchHandler(err);\n            }\n        });\n\n        return userMediaPromise;\n    }\n\n    getDesktopMediaStream(constraints: LocalVideoStreamConstraints): Promise<MediaRequestSuccessResult> {\n        if (desktopMediaPromise) {\n            return desktopMediaPromise;\n        }\n\n        trace.info('getDesktopMediaStream', constraints);\n\n        if (window.latestDesktopMediaStream) {\n            const track = window.latestDesktopMediaStream.mediaStream.getVideoTracks();\n\n            if (track.length > 0 && track[0].readyState === 'live') {\n                //return Promise.resolve();\n                return Promise.resolve({...window.latestDesktopMediaStream, isNew: false});\n            }\n            this.destroyDesktopMediaStream().catch((error: any) => {\n                trace.error('Error destroying desktop media stream', error);\n            });\n\n        }\n\n        desktopMediaPromise = new Promise((resolve, reject) => {\n            const mediaCatchHandler = (err: any): void => {\n                desktopMediaPromise = null;\n                window.latestDesktopMediaStream = null;\n                trace.error('getDisplayMedia error', err);\n                reject(err);\n            };\n\n            try {\n                this.getHighestResolutionStream(true, {video: constraints, audio: false})\n                    .then((streamResult: MediaRequestSuccessResult) => {\n                        desktopMediaPromise = null;\n                        window.latestDesktopMediaStream = streamResult;\n\n                        resolve({...window.latestDesktopMediaStream, isNew: true});\n                    }).catch(mediaCatchHandler);\n            } catch (err) {\n                mediaCatchHandler(err);\n            }\n        });\n\n        return desktopMediaPromise;\n    }\n\n    destroyUserMediaStream(): Promise<void> {\n        const streamResult = window.latestUserMediaStream;\n\n        userMediaPromise = null;\n\n        if (streamResult && streamResult.mediaStream) {\n            try {\n                streamResult.mediaStream.getTracks().forEach((track: MediaStreamTrack) => {\n                    track.stop();\n                });\n\n                window.latestUserMediaStream = null;\n                window.latestLocalMediaConstraints = null;\n                window.mediaStreamAlreadyReplaced = false;\n                trace.info('destroyUserMediaStream - stop all tracks');\n            } catch (e) {\n                trace.info('destroyUserMediaStream - Failed to stop all tracks', e);\n            }\n        }\n\n        return Promise.resolve();\n    }\n\n    destroyDesktopMediaStream(): Promise<void> {\n        const streamResult = window.latestDesktopMediaStream;\n\n        window.latestDesktopMediaStream = null;\n        desktopMediaPromise = null;\n\n        if (streamResult && streamResult.mediaStream) {\n            try {\n                streamResult.mediaStream.getTracks().forEach((track: MediaStreamTrack) => {\n                    track.stop();\n                });\n\n                trace.info('destroyDesktopMediaStream - stop all tracks');\n            } catch (e) {\n                trace.info('destroyDesktopMediaStream - Failed to stop all tracks', e);\n            }\n        }\n\n        return Promise.resolve();\n    }\n\n    clearAllStreams(): Promise<void> {\n        trace.info('LocalStreamManager Clearing all streams');\n\n        return Promise.all([\n            this.destroyDesktopMediaStream(),\n            this.destroyUserMediaStream()\n        ]).then(() => undefined);\n    }\n\n    private getHighestResolutionStream(isDesktopMedia: boolean, constraints?: LocalMediaConstraints): Promise<MediaRequestSuccessResult> {\n        const constraintsCandidates = this.getParsedConstraints(isDesktopMedia, constraints);\n\n        trace.info('getHighestResolutionStream - constraintsCandidates:', constraintsCandidates);\n\n        if (constraintsCandidates.length === 0) {\n            return Promise.reject(new Error('No constraints to retrieve the stream'));\n        }\n\n        return new Promise((resolve, reject) => {\n            let lastSuccessfulResult: Nullable<MediaRequestSuccessResult> = null;\n            let lastFailedResult: Nullable<MediaRequestFailResult> = null;\n            let isStreamRequestFulfilled = false;\n\n            (Promise as any).reduce(constraintsCandidates, (total: any, candidate: MediaStreamConstraints) => {\n                if (isStreamRequestFulfilled) {\n                    return;\n                }\n\n                const constraintType = get(constraints, 'video.videoResolution.constraintType') || get(constraints, 'video.videoResolution[0].constraintType');\n\n                return this.getStreamPromiseByParsedConstraints(candidate, isDesktopMedia)\n                    .then((stream: MediaStream) => {\n                        lastSuccessfulResult = {\n                            mediaStream: stream,\n                            constraint: candidate,\n                            constraintType,\n                            isNew: true\n                        };\n                        trace.info('getHighestResolutionStream Success', lastSuccessfulResult);\n                        isStreamRequestFulfilled = true;\n                        resolve(lastSuccessfulResult);\n                    })\n                    .catch((failResult: MediaRequestFailResult) => {\n                        lastFailedResult = failResult;\n\n                        if (lastFailedResult.errorCode === MediaRequestErrorCode.PermissionDenied) {\n                            isStreamRequestFulfilled = true;\n                            reject(lastFailedResult);\n                        }\n                    });\n            }, 0)\n                .then(() => {\n                    if (!isStreamRequestFulfilled) {\n                        if (!lastFailedResult) {\n                            lastFailedResult = {\n                                errorCode: MediaRequestErrorCode.GeneralError,\n                                message: 'Suitable stream cannot be created'\n                            };\n                        }\n                        reject(lastFailedResult);\n                    }\n                });\n        });\n    }\n\n    private getUserMediaStreamMediaDevice(constraints: MediaStreamConstraints, isDesktopMedia: boolean) {\n        let streamPromise = null;\n\n        if (!isDesktopMedia) {\n            streamPromise = navigator.mediaDevices.getUserMedia(constraints);\n        } else {\n            //@ts-ignore\n            streamPromise = navigator.mediaDevices.getDisplayMedia\n                //@ts-ignore\n                ? navigator.mediaDevices.getDisplayMedia(constraints)\n                : navigator.getDisplayMedia(constraints);\n        }\n\n        return streamPromise;\n    }\n\n    //@ts-ignore\n    private getStreamPromiseByParsedConstraints(constraints: MediaStreamConstraints, isDesktopMedia: boolean): Promise<MediaStream> {\n        trace.info('getStreamPromiseByParsedConstraints', constraints);\n\n        try {\n            return this.getUserMediaStreamMediaDevice(constraints, isDesktopMedia).catch((err: any) => {\n                let streamPromise = null;\n\n                trace.info('getStreamPromiseByParsedConstraints - get user stream error', err.name);\n\n                // Android (Galaxy esp.) have a bug that when using facingMode it might cause NotReadableError. So\n                // we should try again but without facingMode. The exception to the rule is when we don't have specific\n                // device to use (like in IOS13 bug, as can be seen in MediaServiceBase.ts), in that case, we might end\n                // up using the front camera, which is a privacy concern and the preference is to fallback from video\n                if (err && (err.name === 'NotReadableError') && get(constraints, 'video.facingMode') &&\n                    get(constraints, 'video.deviceId')) {\n\n                    const newConstraints = constraints;\n\n                    trace.info(`getStreamPromiseByParsedConstraints - NotReadableError - Failed to get video user media stream with facingMode=${get(constraints, 'video.facingMode')}`, err.name);\n\n                    // @ts-ignore\n                    delete newConstraints.video.facingMode;\n                    ((newConstraints.video as MediaTrackConstraints).deviceId as ConstrainDOMStringParameters) = {\n                        exact: (constraints.video as MediaTrackConstraints).deviceId\n                    } as any as ConstrainDOMStringParameters;\n\n                    streamPromise = this.getStreamPromiseByParsedConstraints(newConstraints, isDesktopMedia);\n                } else if (err && err.name && constraints.audio && !constraints.video) {\n                    trace.info('getStreamPromiseByParsedConstraints - audioStreamFailed - Failed to get audio user media stream', err.name);\n\n                    return this.parseMediaErrorThenThrow({name: 'audioStreamFailed'});\n                } else if (err && err.name && constraints.audio) {\n                    const newConstraints = constraints;\n\n                    trace.info('getStreamPromiseByParsedConstraints - Failed to get video and audio user media stream, try to get video media stream only', err.name);\n\n                    newConstraints.audio = false;\n                    streamPromise = this.getStreamPromiseByParsedConstraints(newConstraints, isDesktopMedia);\n                } else if (err && !streamPromise) {\n                    trace.info('getStreamPromiseByParsedConstraints - Failed to get video user media stream', err && err.name);\n\n                    streamPromise = Promise.reject(err);\n                }\n\n                return streamPromise && streamPromise.catch(this.parseMediaErrorThenThrow);\n            });\n        } catch (e) {\n            this.parseMediaErrorThenThrow(e);\n        }\n    }\n\n    setGroupedDevices(groupedDevices: {video: MediaDeviceInfo[]; audio: MediaDeviceInfo[]}) {\n        trace.info('setGroupedDevices', groupedDevices);\n        this._groupedDevices = {video: groupedDevices.video\n            ? {[CameraTypes.BACK]: last(groupedDevices.video), [CameraTypes.FRONT]: first(groupedDevices.video)}\n            : null,\n        audio: last(groupedDevices.audio) || null,\n        camerasCount: groupedDevices.video.length};\n    }\n\n    private getParsedConstraints(isDesktopMedia: boolean, streamConstraints?: LocalMediaConstraints): MediaStreamConstraints[] {\n        const constraintCandidates: MediaStreamConstraints[] = [];\n\n        //TODO - Alex: need to understand which constraints not compatible with screen share\n        if (isDesktopMedia) {\n            return [{video: true}];\n        }\n\n        if (!streamConstraints) {\n            return constraintCandidates;\n        }\n\n        const baseConstraints: MediaStreamConstraints = {};\n\n        baseConstraints.audio = typeof streamConstraints.audio === 'boolean' ? streamConstraints.audio : undefined;\n\n        if (!streamConstraints.video) {\n            return [baseConstraints];\n        }\n\n        const cameraType = (streamConstraints.video !== 'boolean') &&\n            (streamConstraints.video as LocalVideoStreamConstraints).videoSourceType;\n\n        baseConstraints.video = {\n            facingMode: cameraType && cameraType === LocalVideoSourceType.CAMERA_FRONT\n                ? 'user'\n                : 'environment',\n            frameRate: {ideal: 15, max: 30}\n        };\n\n        const deviceId = get(this._groupedDevices, `video.${cameraType === LocalVideoSourceType.CAMERA_FRONT\n            ? CameraTypes.FRONT\n            : CameraTypes.BACK}.deviceId`);\n\n        if (deviceId) {\n            baseConstraints.video.deviceId = deviceId;\n\n            if (this._groupedDevices.camerasCount > 1) {\n                baseConstraints.video.facingMode = {exact: baseConstraints.video.facingMode} as any as ConstrainDOMStringParameters;\n            }\n        }\n\n        const assignConstraint = (videoResolution: VideoStreamResolution): void => {\n            const [width, height] = videoResolution.resolution.split('x');\n            const constraintCandidate = assign({}, baseConstraints);\n\n            constraintCandidate.video = assign({}, baseConstraints.video, {\n                width: _constraintByType(width, videoResolution.constraintType),\n                height: _constraintByType(height, videoResolution.constraintType)\n            });\n            constraintCandidates.push(constraintCandidate);\n        };\n\n        if ((baseConstraints.video && typeof streamConstraints.video === 'boolean') ||\n            !((streamConstraints.video as LocalVideoStreamConstraints).videoResolution instanceof Array)) {\n\n            const defaultResolution: VideoStreamResolution = {\n                resolution: DEFAULT_VIDEO_RESOLUTION,\n                constraintType: DEFAULT_VIDEO_CONSTRAINT_TYPE\n            };\n\n            assignConstraint(defaultResolution);\n\n            return constraintCandidates;\n        }\n\n        (streamConstraints.video as any).videoResolution.forEach(assignConstraint);\n\n        return constraintCandidates;\n    }\n\n    private parseMediaErrorThenThrow(error: any): MediaRequestFailResult {\n        if (error && error.errorCode) {\n            throw error;\n        }\n\n        trace.error('Get media stream error.', error);\n        const errorName = error && error.name ? error.name : '';\n\n        const permissionErrorNames = [\n            'NotAllowedError',\n            'PermissionDismissedError',\n            'PermissionDeniedError'\n\n        ];\n\n        // const generalError = [\n        //     'NotFoundError',\n        //     'DevicesNotFoundError',\n        //     'NotReadableError',\n        //     'TrackStartError'\n        // ];\n\n        const constraintsErrors = [\n            'OverconstrainedError',\n            'ConstraintNotSatisfiedError'\n\n        ];\n\n        const isErrorOfType = (errorsArr: string[]) => errorsArr.filter((err: string) => err === errorName).length > 0;\n\n        if (isErrorOfType(permissionErrorNames)) {\n            throw {errorCode: MediaRequestErrorCode.PermissionDenied, message: errorName};\n        }\n\n        if (isErrorOfType(constraintsErrors)) {\n            throw {errorCode: MediaRequestErrorCode.Overconstrained, message: errorName};\n        }\n\n        throw {errorCode: MediaRequestErrorCode.GeneralError, message: errorName};\n    }\n}\n\nfunction _constraintByType(value: any, type: ConstraintType): any {\n    switch (type) {\n        case ConstraintType.MIN:\n            return {min: value};\n        default:\n            return {ideal: value};\n    }\n}\n"]}
+{"version":3,"sources":["../src/LocalStreamManager.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAE3B,yBAAyB,EAE5B,MAAM,kBAAkB,CAAC;AAY1B,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,qBAAqB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC3D,wBAAwB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC9D,2BAA2B,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAC7D,0BAA0B,EAAE,OAAO,CAAC;KACvC;CACJ;AAeD,UAAU,eAAe;IACrB,KAAK,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,eAAe,CAAC;QAAC,KAAK,CAAC,EAAE,eAAe,CAAA;KAAC,CAAC,CAAC;IACnE,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,WAAW,CAAoB;IAEvC,OAAO,CAAC,eAAe,CAAgE;gBAE3E,WAAW,EAAE,iBAAiB;IAO1C,IAAI,cAAc,oBAEjB;IAED,kBAAkB,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA4C1F,qBAAqB,CAAC,WAAW,EAAE,2BAA2B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA4CnG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBvC,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB1C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC,OAAO,CAAC,0BAA0B;IAkElC,OAAO,CAAC,6BAA6B;IAoBrC,OAAO,CAAC,mCAAmC;IA0E3C,iBAAiB,CAAC,cAAc,EAAE;QAAC,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,eAAe,EAAE,CAAA;KAAC;IAWtF,OAAO,CAAC,oBAAoB;IA6E5B,OAAO,CAAC,wBAAwB;CA+BnC","file":"LocalStreamManager.d.ts","sourcesContent":["// eslint-disable-next-line eslint-comments/disable-enable-pair\n/*eslint-disable operator-linebreak */\nimport assign from 'lodash/assign';\nimport get from 'lodash/get';\nimport last from 'lodash/last';\nimport first from 'lodash/first';\nimport cloneDeep from 'lodash/cloneDeep';\nimport {Promise} from 'bluebird';\n\nimport {Nullable} from '@techsee/techsee-common';\n\nimport {\n    IMediaEnvironment,\n    LocalMediaConstraints,\n    LocalVideoStreamConstraints,\n    MediaRequestFailResult,\n    MediaRequestSuccessResult,\n    VideoStreamResolution\n} from './MediaContracts';\n\nimport {\n    CameraTypes,\n    ConstraintType,\n    DEFAULT_VIDEO_CONSTRAINT_TYPE,\n    DEFAULT_VIDEO_RESOLUTION,\n    LocalVideoSourceType,\n    MediaRequestErrorCode\n} from './MediaConstants';\nimport {getMediaTracer} from './MediaUtils/MediaTracer';\n\ndeclare global {\n    interface Window {\n        latestUserMediaStream: Nullable<MediaRequestSuccessResult>;\n        latestDesktopMediaStream: Nullable<MediaRequestSuccessResult>;\n        latestLocalMediaConstraints: Nullable<LocalMediaConstraints>;\n        mediaStreamAlreadyReplaced: boolean;\n    }\n}\n\ndeclare const window: Window;\n\nwindow.latestUserMediaStream = null;\nlet userMediaPromise: Nullable<Promise<MediaRequestSuccessResult>> = null;\n\nwindow.latestDesktopMediaStream = null;\nlet desktopMediaPromise: Nullable<Promise<MediaRequestSuccessResult>> = null;\n\nwindow.mediaStreamAlreadyReplaced = false;\nwindow.latestLocalMediaConstraints = null;\n\nconst trace = getMediaTracer('LocalStreamManager');\n\ninterface IGroupedDevices {\n    video: Nullable<{back?: MediaDeviceInfo; front?: MediaDeviceInfo}>;\n    audio: Nullable<MediaDeviceInfo>;\n    camerasCount: number;\n}\n\nexport class LocalStreamManager {\n    private environment: IMediaEnvironment;\n\n    private _groupedDevices: IGroupedDevices = {video: null, audio: null, camerasCount: 0};\n\n    constructor(environment: IMediaEnvironment) {\n        this.environment = environment;\n\n        this.parseMediaErrorThenThrow = this.parseMediaErrorThenThrow.bind(this);\n        this.clearAllStreams = this.clearAllStreams.bind(this);\n    }\n\n    get groupedDevices() {\n        return this._groupedDevices;\n    }\n\n    getUserMediaStream(constraints: LocalMediaConstraints): Promise<MediaRequestSuccessResult> {\n        trace.info('getUserMediaStream', constraints);\n        if (userMediaPromise) {\n            return userMediaPromise;\n        }\n\n        if (window.latestUserMediaStream) {\n            const videoTrack = window.latestUserMediaStream.mediaStream.getVideoTracks();\n\n            if (videoTrack.length > 0 && videoTrack[0].readyState === 'live') {\n                return Promise.resolve({...window.latestUserMediaStream, isNew: false});\n            }\n\n            this.destroyUserMediaStream();\n        }\n\n        userMediaPromise = new Promise((resolve, reject) => {\n            const catchHandler = (err: any): void => {\n                userMediaPromise = null;\n                window.latestUserMediaStream = null;\n                trace.error('getUserMedia error', err);\n                reject(err);\n            };\n\n            try {\n                this.getHighestResolutionStream(false, constraints)\n                    .then((streamResult: MediaRequestSuccessResult) => {\n                        userMediaPromise = null;\n                        window.latestUserMediaStream = streamResult;\n                        window.latestLocalMediaConstraints = cloneDeep(constraints);\n                        window.latestLocalMediaConstraints.audio = (streamResult.constraint &&\n                            streamResult.constraint.audio) as boolean;\n\n                        resolve({...window.latestUserMediaStream, isNew: true});\n                    })\n                    .catch(catchHandler);\n            } catch (err) {\n                catchHandler(err);\n            }\n        });\n\n        return userMediaPromise;\n    }\n\n    getDesktopMediaStream(constraints: LocalVideoStreamConstraints): Promise<MediaRequestSuccessResult> {\n        if (desktopMediaPromise) {\n            return desktopMediaPromise;\n        }\n\n        trace.info('getDesktopMediaStream', constraints);\n\n        if (window.latestDesktopMediaStream) {\n            const track = window.latestDesktopMediaStream.mediaStream.getVideoTracks();\n\n            if (track.length > 0 && track[0].readyState === 'live') {\n                //return Promise.resolve();\n                return Promise.resolve({...window.latestDesktopMediaStream, isNew: false});\n            }\n            this.destroyDesktopMediaStream().catch((error: any) => {\n                trace.error('Error destroying desktop media stream', error);\n            });\n        }\n\n        desktopMediaPromise = new Promise((resolve, reject) => {\n            const mediaCatchHandler = (err: any): void => {\n                desktopMediaPromise = null;\n                window.latestDesktopMediaStream = null;\n                trace.error('getDisplayMedia error', err);\n                reject(err);\n            };\n\n            try {\n                this.getHighestResolutionStream(true, {video: constraints, audio: false})\n                    .then((streamResult: MediaRequestSuccessResult) => {\n                        desktopMediaPromise = null;\n                        window.latestDesktopMediaStream = streamResult;\n\n                        resolve({...window.latestDesktopMediaStream, isNew: true});\n                    })\n                    .catch(mediaCatchHandler);\n            } catch (err) {\n                mediaCatchHandler(err);\n            }\n        });\n\n        return desktopMediaPromise;\n    }\n\n    destroyUserMediaStream(): Promise<void> {\n        const streamResult = window.latestUserMediaStream;\n\n        userMediaPromise = null;\n        window.latestUserMediaStream = null;\n        window.latestLocalMediaConstraints = null;\n        window.mediaStreamAlreadyReplaced = false;\n\n        if (streamResult && streamResult.mediaStream) {\n            try {\n                streamResult.mediaStream.getTracks().forEach((track: MediaStreamTrack) => {\n                    track.stop();\n                });\n\n                trace.info('destroyUserMediaStream - stop all tracks');\n            } catch (e) {\n                trace.info('destroyUserMediaStream - Failed to stop all tracks', e);\n            }\n        }\n\n        return Promise.resolve();\n    }\n\n    destroyDesktopMediaStream(): Promise<void> {\n        const streamResult = window.latestDesktopMediaStream;\n\n        window.latestDesktopMediaStream = null;\n        desktopMediaPromise = null;\n\n        if (streamResult && streamResult.mediaStream) {\n            try {\n                streamResult.mediaStream.getTracks().forEach((track: MediaStreamTrack) => {\n                    track.stop();\n                });\n\n                trace.info('destroyDesktopMediaStream - stop all tracks');\n            } catch (e) {\n                trace.info('destroyDesktopMediaStream - Failed to stop all tracks', e);\n            }\n        }\n\n        return Promise.resolve();\n    }\n\n    clearAllStreams(): Promise<void> {\n        trace.info('LocalStreamManager Clearing all streams');\n\n        return Promise.all([this.destroyDesktopMediaStream(), this.destroyUserMediaStream()]).then(() => undefined);\n    }\n\n    private getHighestResolutionStream(\n        isDesktopMedia: boolean,\n        constraints?: LocalMediaConstraints\n    ): Promise<MediaRequestSuccessResult> {\n        const constraintsCandidates = this.getParsedConstraints(isDesktopMedia, constraints);\n\n        trace.info('getHighestResolutionStream - constraintsCandidates:', constraintsCandidates);\n\n        if (constraintsCandidates.length === 0) {\n            return Promise.reject(new Error('No constraints to retrieve the stream'));\n        }\n\n        return new Promise((resolve, reject) => {\n            let lastSuccessfulResult: Nullable<MediaRequestSuccessResult> = null;\n            let lastFailedResult: Nullable<MediaRequestFailResult> = null;\n            let isStreamRequestFulfilled = false;\n\n            (Promise as any)\n                .reduce(\n                    constraintsCandidates,\n                    (total: any, candidate: MediaStreamConstraints) => {\n                        if (isStreamRequestFulfilled) {\n                            return;\n                        }\n\n                        const constraintType =\n                            get(constraints, 'video.videoResolution.constraintType') ||\n                            get(constraints, 'video.videoResolution[0].constraintType');\n\n                        return this.getStreamPromiseByParsedConstraints(candidate, isDesktopMedia)\n                            .then((stream: MediaStream) => {\n                                lastSuccessfulResult = {\n                                    mediaStream: stream,\n                                    constraint: candidate,\n                                    constraintType,\n                                    isNew: true\n                                };\n                                trace.info('getHighestResolutionStream Success', lastSuccessfulResult);\n                                isStreamRequestFulfilled = true;\n                                resolve(lastSuccessfulResult);\n                            })\n                            .catch((failResult: MediaRequestFailResult) => {\n                                lastFailedResult = failResult;\n\n                                if (lastFailedResult.errorCode === MediaRequestErrorCode.PermissionDenied) {\n                                    isStreamRequestFulfilled = true;\n                                    reject(lastFailedResult);\n                                }\n                            });\n                    },\n                    0\n                )\n                .then(() => {\n                    if (!isStreamRequestFulfilled) {\n                        if (!lastFailedResult) {\n                            lastFailedResult = {\n                                errorCode: MediaRequestErrorCode.GeneralError,\n                                message: 'Suitable stream cannot be created'\n                            };\n                        }\n                        reject(lastFailedResult);\n                    }\n                });\n        });\n    }\n\n    private getUserMediaStreamMediaDevice(constraints: MediaStreamConstraints, isDesktopMedia: boolean) {\n        let streamPromise = null;\n\n        if (!isDesktopMedia) {\n            streamPromise = navigator.mediaDevices.getUserMedia(constraints);\n        } else {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            //@ts-ignore\n            streamPromise = navigator.mediaDevices.getDisplayMedia\n                ? // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n                  //@ts-ignore\n                  navigator.mediaDevices.getDisplayMedia(constraints)\n                : // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n                  //@ts-ignore\n                  navigator.getDisplayMedia(constraints);\n        }\n\n        return streamPromise;\n    }\n\n    private getStreamPromiseByParsedConstraints(\n        constraints: MediaStreamConstraints,\n        isDesktopMedia: boolean\n    ): Promise<MediaStream> {\n        trace.info('getStreamPromiseByParsedConstraints', constraints);\n\n        try {\n            return this.getUserMediaStreamMediaDevice(constraints, isDesktopMedia).catch((err: any) => {\n                let streamPromise = null;\n\n                trace.info('getStreamPromiseByParsedConstraints - get user stream error', err.name);\n\n                // Android (Galaxy esp.) have a bug that when using facingMode it might cause NotReadableError. So\n                // we should try again but without facingMode. The exception to the rule is when we don't have specific\n                // device to use (like in IOS13 bug, as can be seen in MediaServiceBase.ts), in that case, we might end\n                // up using the front camera, which is a privacy concern and the preference is to fallback from video\n                if (\n                    err &&\n                    err.name === 'NotReadableError' &&\n                    get(constraints, 'video.facingMode') &&\n                    get(constraints, 'video.deviceId')\n                ) {\n                    const newConstraints = constraints;\n\n                    trace.info(\n                        `getStreamPromiseByParsedConstraints - NotReadableError - Failed to get video user media stream with facingMode=${get(\n                            constraints,\n                            'video.facingMode'\n                        )}`,\n                        err.name\n                    );\n\n                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n                    // @ts-ignore\n                    delete newConstraints.video.facingMode;\n                    ((newConstraints.video as MediaTrackConstraints).deviceId as ConstrainDOMStringParameters) = {\n                        exact: (constraints.video as MediaTrackConstraints).deviceId\n                    } as any as ConstrainDOMStringParameters;\n\n                    streamPromise = this.getStreamPromiseByParsedConstraints(newConstraints, isDesktopMedia);\n                } else if (err && err.name && constraints.audio && !constraints.video) {\n                    trace.info(\n                        'getStreamPromiseByParsedConstraints - audioStreamFailed - Failed to get audio user media stream',\n                        err.name\n                    );\n\n                    return this.parseMediaErrorThenThrow({name: 'audioStreamFailed'});\n                } else if (err && err.name && constraints.audio) {\n                    const newConstraints = constraints;\n\n                    trace.info(\n                        'getStreamPromiseByParsedConstraints - Failed to get video and audio user media stream, try to get video media stream only',\n                        err.name\n                    );\n\n                    newConstraints.audio = false;\n                    streamPromise = this.getStreamPromiseByParsedConstraints(newConstraints, isDesktopMedia);\n                } else if (err && !streamPromise) {\n                    trace.info(\n                        'getStreamPromiseByParsedConstraints - Failed to get video user media stream',\n                        err && err.name\n                    );\n\n                    streamPromise = Promise.reject(err);\n                }\n\n                return streamPromise && streamPromise.catch(this.parseMediaErrorThenThrow);\n            });\n        } catch (e) {\n            // @ts-ignore\n            return this.parseMediaErrorThenThrow(e);\n        }\n    }\n\n    setGroupedDevices(groupedDevices: {video: MediaDeviceInfo[]; audio: MediaDeviceInfo[]}) {\n        trace.info('setGroupedDevices', groupedDevices);\n        this._groupedDevices = {\n            video: groupedDevices.video\n                ? {[CameraTypes.BACK]: last(groupedDevices.video), [CameraTypes.FRONT]: first(groupedDevices.video)}\n                : null,\n            audio: last(groupedDevices.audio) || null,\n            camerasCount: groupedDevices.video.length\n        };\n    }\n\n    private getParsedConstraints(\n        isDesktopMedia: boolean,\n        streamConstraints?: LocalMediaConstraints\n    ): MediaStreamConstraints[] {\n        const constraintCandidates: MediaStreamConstraints[] = [];\n\n        //TODO - Alex: need to understand which constraints not compatible with screen share\n        if (isDesktopMedia) {\n            return [{video: true}];\n        }\n\n        if (!streamConstraints) {\n            return constraintCandidates;\n        }\n\n        const baseConstraints: MediaStreamConstraints = {};\n\n        baseConstraints.audio = typeof streamConstraints.audio === 'boolean' ? streamConstraints.audio : undefined;\n\n        if (!streamConstraints.video) {\n            return [baseConstraints];\n        }\n\n        const cameraType =\n            streamConstraints.video !== 'boolean' &&\n            (streamConstraints.video as LocalVideoStreamConstraints).videoSourceType;\n\n        baseConstraints.video = {\n            facingMode: cameraType && cameraType === LocalVideoSourceType.CAMERA_FRONT ? 'user' : 'environment',\n            frameRate: {ideal: 15, max: 30}\n        };\n\n        const deviceId = get(\n            this._groupedDevices,\n            `video.${cameraType === LocalVideoSourceType.CAMERA_FRONT ? CameraTypes.FRONT : CameraTypes.BACK}.deviceId`\n        );\n\n        if (deviceId) {\n            baseConstraints.video.deviceId = deviceId;\n\n            if (this._groupedDevices.camerasCount > 1) {\n                baseConstraints.video.facingMode = {\n                    exact: baseConstraints.video.facingMode\n                } as any as ConstrainDOMStringParameters;\n            }\n        }\n\n        const assignConstraint = (videoResolution: VideoStreamResolution): void => {\n            const [width, height] = videoResolution.resolution.split('x');\n            const constraintCandidate = assign({}, baseConstraints);\n\n            constraintCandidate.video = assign({}, baseConstraints.video, {\n                width: _constraintByType(width, videoResolution.constraintType),\n                height: _constraintByType(height, videoResolution.constraintType)\n            });\n            constraintCandidates.push(constraintCandidate);\n        };\n\n        if (\n            (baseConstraints.video && typeof streamConstraints.video === 'boolean') ||\n            !((streamConstraints.video as LocalVideoStreamConstraints).videoResolution instanceof Array)\n        ) {\n            const defaultResolution: VideoStreamResolution = {\n                resolution: DEFAULT_VIDEO_RESOLUTION,\n                constraintType: DEFAULT_VIDEO_CONSTRAINT_TYPE\n            };\n\n            assignConstraint(defaultResolution);\n\n            return constraintCandidates;\n        }\n\n        (streamConstraints.video as any).videoResolution.forEach(assignConstraint);\n\n        return constraintCandidates;\n    }\n\n    private parseMediaErrorThenThrow(error: any): MediaRequestFailResult {\n        if (error && error.errorCode) {\n            throw error;\n        }\n\n        trace.error('Get media stream error.', error);\n        const errorName = error && error.name ? error.name : '';\n\n        const permissionErrorNames = ['NotAllowedError', 'PermissionDismissedError', 'PermissionDeniedError'];\n\n        // const generalError = [\n        //     'NotFoundError',\n        //     'DevicesNotFoundError',\n        //     'NotReadableError',\n        //     'TrackStartError'\n        // ];\n\n        const constraintsErrors = ['OverconstrainedError', 'ConstraintNotSatisfiedError'];\n\n        const isErrorOfType = (errorsArr: string[]) => errorsArr.filter((err: string) => err === errorName).length > 0;\n\n        if (isErrorOfType(permissionErrorNames)) {\n            throw {errorCode: MediaRequestErrorCode.PermissionDenied, message: errorName};\n        }\n\n        if (isErrorOfType(constraintsErrors)) {\n            throw {errorCode: MediaRequestErrorCode.Overconstrained, message: errorName};\n        }\n\n        throw {errorCode: MediaRequestErrorCode.GeneralError, message: errorName};\n    }\n}\n\nfunction _constraintByType(value: any, type: ConstraintType): any {\n    switch (type) {\n        case ConstraintType.MIN:\n            return {min: value};\n        default:\n            return {ideal: value};\n    }\n}\n"]}