mediasoup-client 3.6.59 → 3.6.60

package/.eslintrc.js

@@ -1,243 +0,0 @@
-const eslintConfig =
-{
-	env :
-	{
-		browser : true,
-		es6     : true,
-		node    : true
-	},
-	plugins       : [],
-	settings      : {},
-	parserOptions :
-	{
-		ecmaVersion  : 2018,
-		sourceType   : 'module',
-		ecmaFeatures :
-		{
-			impliedStrict : true
-		},
-		lib : [ 'es2018', 'dom' ]
-	},
-	rules :
-	{
-		'array-bracket-spacing' : [ 2, 'always',
-			{
-				objectsInArrays : true,
-				arraysInArrays  : true
-			}
-		],
-		'arrow-parens'              : [ 2, 'always' ],
-		'arrow-spacing'             : 2,
-		'block-spacing'             : [ 2, 'always' ],
-		'brace-style'               : [ 2, 'allman', { allowSingleLine: true } ],
-		'camelcase'                 : 2,
-		'comma-dangle'              : 2,
-		'comma-spacing'             : [ 2, { before: false, after: true } ],
-		'comma-style'               : 2,
-		'computed-property-spacing' : 2,
-		'constructor-super'         : 2,
-		'func-call-spacing'         : 2,
-		'generator-star-spacing'    : 2,
-		'guard-for-in'              : 2,
-		'indent'                    : [ 2, 'tab', { 'SwitchCase': 1 } ],
-		'key-spacing'               : [ 2,
-			{
-				singleLine :
-				{
-					beforeColon : false,
-					afterColon  : true
-				},
-				multiLine :
-				{
-					beforeColon : true,
-					afterColon  : true,
-					align       : 'colon'
-				}
-			}
-		],
-		'keyword-spacing'      : 2,
-		'linebreak-style'      : [ 2, 'unix' ],
-		'lines-around-comment' : [ 2,
-			{
-				allowBlockStart    : true,
-				allowObjectStart   : true,
-				beforeBlockComment : false,
-				beforeLineComment  : false
-			}
-		],
-		'max-len' : [ 2, 90,
-			{
-				tabWidth               : 2,
-				comments               : 100,
-				ignoreUrls             : true,
-				ignoreStrings          : true,
-				ignoreTemplateLiterals : true,
-				ignoreRegExpLiterals   : true
-			}
-		],
-		'newline-after-var'             : 2,
-		'newline-before-return'         : 2,
-		'newline-per-chained-call'      : 2,
-		'no-alert'                      : 2,
-		'no-caller'                     : 2,
-		'no-case-declarations'          : 2,
-		'no-catch-shadow'               : 2,
-		'no-class-assign'               : 2,
-		'no-confusing-arrow'            : 2,
-		'no-console'                    : 2,
-		'no-const-assign'               : 2,
-		'no-debugger'                   : 2,
-		'no-dupe-args'                  : 2,
-		'no-dupe-keys'                  : 2,
-		'no-duplicate-case'             : 2,
-		'no-div-regex'                  : 2,
-		'no-empty'                      : [ 2, { allowEmptyCatch: true } ],
-		'no-empty-pattern'              : 2,
-		'no-else-return'                : 0,
-		'no-eval'                       : 2,
-		'no-extend-native'              : 2,
-		'no-ex-assign'                  : 2,
-		'no-extra-bind'                 : 2,
-		'no-extra-boolean-cast'         : 2,
-		'no-extra-label'                : 2,
-		'no-extra-semi'                 : 2,
-		'no-fallthrough'                : 2,
-		'no-func-assign'                : 2,
-		'no-global-assign'              : 2,
-		'no-implicit-coercion'          : 2,
-		'no-implicit-globals'           : 2,
-		'no-inner-declarations'         : 2,
-		'no-invalid-regexp'             : 2,
-		'no-invalid-this'               : 2,
-		'no-irregular-whitespace'       : 2,
-		'no-lonely-if'                  : 2,
-		'no-mixed-operators'            : 2,
-		'no-mixed-spaces-and-tabs'      : 2,
-		'no-multi-spaces'               : 2,
-		'no-multi-str'                  : 2,
-		'no-multiple-empty-lines'       : [ 1, { max: 1, maxEOF: 0, maxBOF: 0 } ],
-		'no-native-reassign'            : 2,
-		'no-negated-in-lhs'             : 2,
-		'no-new'                        : 2,
-		'no-new-func'                   : 2,
-		'no-new-wrappers'               : 2,
-		'no-obj-calls'                  : 2,
-		'no-proto'                      : 2,
-		'no-prototype-builtins'         : 0,
-		'no-redeclare'                  : 2,
-		'no-regex-spaces'               : 2,
-		'no-restricted-imports'         : 2,
-		'no-return-assign'              : 2,
-		'no-self-assign'                : 2,
-		'no-self-compare'               : 2,
-		'no-sequences'                  : 2,
-		'no-shadow'                     : 2,
-		'no-shadow-restricted-names'    : 2,
-		'no-spaced-func'                : 2,
-		'no-sparse-arrays'              : 2,
-		'no-this-before-super'          : 2,
-		'no-throw-literal'              : 2,
-		'no-undef'                      : 2,
-		'no-unexpected-multiline'       : 2,
-		'no-unmodified-loop-condition'  : 2,
-		'no-unreachable'                : 2,
-		'no-unused-vars'                : [ 1, { vars: 'all', args: 'after-used' } ],
-		'no-use-before-define'          : 0,
-		'no-useless-call'               : 2,
-		'no-useless-computed-key'       : 2,
-		'no-useless-concat'             : 2,
-		'no-useless-rename'             : 2,
-		'no-var'                        : 2,
-		'no-whitespace-before-property' : 2,
-		'object-curly-newline'          : 0,
-		'object-curly-spacing'          : [ 2, 'always' ],
-		'object-property-newline'       : [ 2, { allowMultiplePropertiesPerLine: true } ],
-		'prefer-const'                  : 2,
-		'prefer-rest-params'            : 2,
-		'prefer-spread'                 : 2,
-		'prefer-template'               : 2,
-		'quotes'                        : [ 2, 'single', { avoidEscape: true } ],
-		'semi'                          : [ 2, 'always' ],
-		'semi-spacing'                  : 2,
-		'space-before-blocks'           : 2,
-		'space-before-function-paren'   : [ 2,
-			{
-				anonymous  : 'never',
-				named      : 'never',
-				asyncArrow : 'always'
-			}
-		],
-		'space-in-parens' : [ 2, 'never' ],
-		'spaced-comment'  : [ 2, 'always' ],
-		'strict'          : 2,
-		'valid-typeof'    : 2,
-		'yoda'            : 2
-	}
-};
-
-switch (process.env.MEDIASOUP_NODE_LANGUAGE)
-{
-	case 'typescript':
-	{
-		eslintConfig.parser = '@typescript-eslint/parser';
-		eslintConfig.plugins =
-		[
-			...eslintConfig.plugins,
-			'@typescript-eslint'
-		];
-		eslintConfig.extends =
-		[
-			'eslint:recommended',
-			'plugin:@typescript-eslint/eslint-recommended',
-			'plugin:@typescript-eslint/recommended'
-		];
-		eslintConfig.rules =
-		{
-			...eslintConfig.rules,
-			'no-unused-vars'                                    : 0,
-			'@typescript-eslint/ban-types'                      : 0,
-			'@typescript-eslint/ban-ts-comment'                 : 0,
-			'@typescript-eslint/ban-ts-ignore'                  : 0,
-			'@typescript-eslint/explicit-module-boundary-types' : 0,
-			'@typescript-eslint/member-delimiter-style'         : [ 2,
-
-				{
-					multiline  : { delimiter: 'semi', requireLast: true },
-					singleline : { delimiter: 'semi', requireLast: false }
-				}
-			],
-			'@typescript-eslint/no-explicit-any' : 0,
-			'@typescript-eslint/no-unused-vars'  : [ 2,
-				{
-					vars               : 'all',
-					args               : 'after-used',
-					ignoreRestSiblings : false
-				}
-			],
-			'@typescript-eslint/no-use-before-define'  : [ 2, { functions: false } ],
-			'@typescript-eslint/no-empty-function'     : 0,
-			'@typescript-eslint/no-non-null-assertion' : 0
-		};
-
-		break;
-	}
-
-	case 'javascript':
-	{
-		eslintConfig.env['jest/globals'] = true;
-		eslintConfig.plugins =
-		[
-			...eslintConfig.plugins,
-			'jest'
-		];
-
-		break;
-	}
-
-	default:
-	{
-		throw new TypeError('wrong/missing MEDIASOUP_NODE_LANGUAGE env');
-	}
-}
-
-module.exports = eslintConfig;

package/.github/FUNDING.yml

@@ -1,12 +0,0 @@
-# These are supported funding model platforms
-
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: # Replace with a single Patreon username
-open_collective: mediasoup
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
-custom: # Replace with a single custom sponsorship URL

package/.github/ISSUE_TEMPLATE/Bug_Report.md

@@ -1,24 +0,0 @@
----
-name: 🐍 Bug Report
-about: Report a bug in mediasoup-client
-labels: bug
----
-
-## Bug Report
-
-**IMPORTANT:** We primarily use GitHub as an issue tracker. Just open an issue here if you have encountered a bug in mediasoup-client.
-
-If you have questions or doubts about mediasoup-client or need support, please use the mediasoup Discourse Group instead:
-
-https://mediasoup.discourse.group
-
-### Your environment
-
-- Operating system:
-- Browser version:
-- npm version:
-- mediasoup version:
-- mediasoup-client version:
-
-
-### Issue description

package/.github/ISSUE_TEMPLATE/Feature_Request.md

@@ -1,7 +0,0 @@
----
-name: 🚀 Feature Request
-about: Suggest an idea or improvement for mediasoup-client
-labels: feature
----
-
-## Feature Request

package/.github/ISSUE_TEMPLATE/Support_Question.md

@@ -1,12 +0,0 @@
----
-name: 🙈 Support Question
-about: If you have any questions use the mediasoup Discourse Group
----
-
-**IMPORTANT:** We primarily use GitHub as an issue tracker. Please, use the mediasoup Discourse Group if you have questions or doubts or if you need support about mediasoup and its ecosystem:
-
-https://mediasoup.discourse.group
-
-Before asking any questions, please check the mediasoup official documentation:
-
-https://mediasoup.org/documentation/

package/.travis.yml

@@ -1,26 +0,0 @@
-branches:
-  only:
-  - v3
-
-language: node_js
-
-node_js:
-- 10
-- 12
-- 14
-
-install:
-- npm install
-
-script:
-- npm run lint
-- npm run typescript:build
-- npm test
-
-notifications:
-  email:
-    on_success: change
-    on_failure: always
-    recipients:
-    - secure: nZrn+wwkyo7sLlB9/Gsk4CyzyG3UccqOimQRz5VwTwyafYqpwin5T6eWBoDq6nphfLPt4D9keC4NawRlv2bX9AWRuKlrU7Z8/1rkObIwSm1ZNk/Yn718Q/IwEDSabS00pNXV3X9dV1QfxelrHiH1PgNdjU1aOyMqWWD445aXq/RM8L6ushksMbMkoW6DWaM83DGFB2FWumkFqI84uRpWqdESp9mVVErxBeWrTAOQqRsLDHGFwcDq07xBJDNw7vrPN2Furnf3xE6hGDWiBpstjwGpY0vql+5UzjOnC6oqdLP9H3i5znR2lzPw5x/4S0cW6fKzF/G02aPPk2Oty9CRXdLJKuJ9Xrwo7BVAEfnQFpc6q1kvONx/j0bY2UdLO2zgUGM1IWO2Pvmm7//FWiv9WgCF3kfOIp5qh5SN1o/W+SErmvKaYyOPMe3OUOemDjOnVIQcMDTISue2aYUS7GuoTx/+jp+F8Y99/3shyBWEaAbg1LVptRgMUvSzrBG/3Y2b6Gx2qSojMisyqfv3USx8h91sxZ96qyHkbHm4LCzB6PeRgNf+ebUnm/+fTrTtkdeo3byD5ZsKI1dzJ+/ZqDaAEEZRKwLxBdJLlLsWAoM+iQ4L6rPgFP5xZ2E4eVQY/MPJt3bjCxEhNSc/8y1vTIozx33PoiemILODj+I/ARxYxB8=
-    - secure: dSfH0lbTzxCBjMnZdg1nBy3i7BVtLpiM+1PkWcj3FrLwNVDc6yjNmsqxF+AwDJRYlsq/KtaZIKx8GeTIz59LpOnXunFugnpl2XnJAw+QdNYsTRnfj99PlbGaZFoqL5p1l/8zJxRcuIiaIlpE3yV5iD7pT35DoTY/WWew/6Wcu1aawWUwJ6oR4y/K8hyN0J8GaWb62HTmdwPWY0mc1qtCHVGDWGAQXi828U7QhQpXmk9e8G8j3a9yiVAHI3hFzgUkQv2qBil/1NHr9RY4J/bOuiWymBfDTzyfOdJgn2nZUD+ky+UucEqVnzUE9kvNYkOHUTzq3+H5LLgUy8n4uSIwhvYsGNVgpJCQufc4F+GM70bEA+jCB+pihiBDLN2o2vpbNH45vi8zZtW1bUIdJC88MMjiKC4Yvu33n0ii0/1arqUK9Na96phYJUpgbz6nCKBRO0N/VlXwZTvwJ5hmIhoYzZ9vrvXD66RMGB+Bbm318TvOJqCUEoNRyTaXcBFBr0vEgq3+vTlnOGcxv83efHP8+GUM7Q3f22N4GHXBtIlRIYVtcEm5PjYtdtvzAup2Upr3Y8UnaYhq8SJREZIBEFfNRPB3g0/knizmls0zIzoXvakOtsUq+sUt5xapayD8RYiN4W/Kj8fhWKFUL+zby6OJx+bC9MTA+LVRhROKdLhvga8=

package/src/Consumer.ts

@@ -1,334 +0,0 @@
-import { Logger } from './Logger';
-import { EnhancedEventEmitter } from './EnhancedEventEmitter';
-import { InvalidStateError } from './errors';
-import { MediaKind, RtpParameters } from './RtpParameters';
-
-const logger = new Logger('Consumer');
-
-export type ConsumerOptions =
-{
-	id?: string;
-	producerId?: string;
-	kind?: 'audio' | 'video';
-	rtpParameters: RtpParameters;
-	appData?: Record<string, unknown>;
-}
-
-export type ConsumerEvents =
-{
-	transportclose: [];
-	trackended: [];
-	// Private events.
-	'@getstats': [(stats: RTCStatsReport) => void, (error: Error) => void];
-	'@close': [];
-	'@pause': [];
-	'@resume': [];
-}
-
-export type ConsumerObserverEvents =
-{
-	close: [];
-	pause: [];
-	resume: [];
-	trackended: [];
-}
-
-export class Consumer extends EnhancedEventEmitter<ConsumerEvents>
-{
-	// Id.
-	private readonly _id: string;
-	// Local id.
-	private readonly _localId: string;
-	// Associated Producer id.
-	private readonly _producerId: string;
-	// Closed flag.
-	private _closed = false;
-	// Associated RTCRtpReceiver.
-	private readonly _rtpReceiver?: RTCRtpReceiver;
-	// Remote track.
-	private readonly _track: MediaStreamTrack;
-	// RTP parameters.
-	private readonly _rtpParameters: RtpParameters;
-	// Paused flag.
-	private _paused: boolean;
-	// App custom data.
-	private readonly _appData: Record<string, unknown>;
-	// Observer instance.
-	protected readonly _observer = new EnhancedEventEmitter<ConsumerObserverEvents>();
-
-	constructor(
-		{
-			id,
-			localId,
-			producerId,
-			rtpReceiver,
-			track,
-			rtpParameters,
-			appData
-		}:
-		{
-			id: string;
-			localId: string;
-			producerId: string;
-			rtpReceiver?: RTCRtpReceiver;
-			track: MediaStreamTrack;
-			rtpParameters: RtpParameters;
-			appData?: Record<string, unknown>;
-		}
-	)
-	{
-		super();
-
-		logger.debug('constructor()');
-
-		this._id = id;
-		this._localId = localId;
-		this._producerId = producerId;
-		this._rtpReceiver = rtpReceiver;
-		this._track = track;
-		this._rtpParameters = rtpParameters;
-		this._paused = !track.enabled;
-		this._appData = appData || {};
-		this._onTrackEnded = this._onTrackEnded.bind(this);
-
-		this._handleTrack();
-	}
-
-	/**
-	 * Consumer id.
-	 */
-	get id(): string
-	{
-		return this._id;
-	}
-
-	/**
-	 * Local id.
-	 */
-	get localId(): string
-	{
-		return this._localId;
-	}
-
-	/**
-	 * Associated Producer id.
-	 */
-	get producerId(): string
-	{
-		return this._producerId;
-	}
-
-	/**
-	 * Whether the Consumer is closed.
-	 */
-	get closed(): boolean
-	{
-		return this._closed;
-	}
-
-	/**
-	 * Media kind.
-	 */
-	get kind(): MediaKind
-	{
-		return this._track.kind as MediaKind;
-	}
-
-	/**
-	 * Associated RTCRtpReceiver.
-	 */
-	get rtpReceiver(): RTCRtpReceiver | undefined
-	{
-		return this._rtpReceiver;
-	}
-
-	/**
-	 * The associated track.
-	 */
-	get track(): MediaStreamTrack
-	{
-		return this._track;
-	}
-
-	/**
-	 * RTP parameters.
-	 */
-	get rtpParameters(): RtpParameters
-	{
-		return this._rtpParameters;
-	}
-
-	/**
-	 * Whether the Consumer is paused.
-	 */
-	get paused(): boolean
-	{
-		return this._paused;
-	}
-
-	/**
-	 * App custom data.
-	 */
-	get appData(): Record<string, unknown>
-	{
-		return this._appData;
-	}
-
-	/**
-	 * Invalid setter.
-	 */
-	// eslint-disable-next-line @typescript-eslint/no-unused-vars
-	set appData(appData: Record<string, unknown>)
-	{
-		throw new Error('cannot override appData object');
-	}
-
-	get observer(): EnhancedEventEmitter
-	{
-		return this._observer;
-	}
-
-	/**
-	 * Closes the Consumer.
-	 */
-	close(): void
-	{
-		if (this._closed)
-			return;
-
-		logger.debug('close()');
-
-		this._closed = true;
-
-		this._destroyTrack();
-
-		this.emit('@close');
-
-		// Emit observer event.
-		this._observer.safeEmit('close');
-	}
-
-	/**
-	 * Transport was closed.
-	 */
-	transportClosed(): void
-	{
-		if (this._closed)
-			return;
-
-		logger.debug('transportClosed()');
-
-		this._closed = true;
-
-		this._destroyTrack();
-
-		this.safeEmit('transportclose');
-
-		// Emit observer event.
-		this._observer.safeEmit('close');
-	}
-
-	/**
-	 * Get associated RTCRtpReceiver stats.
-	 */
-	async getStats(): Promise<RTCStatsReport>
-	{
-		if (this._closed)
-			throw new InvalidStateError('closed');
-
-		return new Promise<RTCStatsReport>((resolve, reject) =>
-		{
-			this.safeEmit(
-				'@getstats',
-				resolve,
-				reject
-			);
-		});
-	}
-
-	/**
-	 * Pauses receiving media.
-	 */
-	pause(): void
-	{
-		logger.debug('pause()');
-
-		if (this._closed)
-		{
-			logger.error('pause() | Consumer closed');
-
-			return;
-		}
-
-		if (this._paused)
-		{
-			logger.debug('pause() | Consumer is already paused');
-
-			return;
-		}
-
-		this._paused = true;
-		this._track.enabled = false;
-
-		this.emit('@pause');
-
-		// Emit observer event.
-		this._observer.safeEmit('pause');
-	}
-
-	/**
-	 * Resumes receiving media.
-	 */
-	resume(): void
-	{
-		logger.debug('resume()');
-
-		if (this._closed)
-		{
-			logger.error('resume() | Consumer closed');
-
-			return;
-		}
-
-		if (!this._paused)
-		{
-			logger.debug('resume() | Consumer is already resumed');
-
-			return;
-		}
-
-		this._paused = false;
-		this._track.enabled = true;
-
-		this.emit('@resume');
-
-		// Emit observer event.
-		this._observer.safeEmit('resume');
-	}
-
-	private _onTrackEnded(): void
-	{
-		logger.debug('track "ended" event');
-
-		this.safeEmit('trackended');
-
-		// Emit observer event.
-		this._observer.safeEmit('trackended');
-	}
-
-	private _handleTrack(): void
-	{
-		this._track.addEventListener('ended', this._onTrackEnded);
-	}
-
-	private _destroyTrack(): void
-	{
-		try
-		{
-			this._track.removeEventListener('ended', this._onTrackEnded);
-			this._track.stop();
-		}
-		catch (error)
-		{}
-	}
-}