mediasoup-client 3.7.16 → 3.7.17

package/lib/Device.d.ts

@@ -14,13 +14,8 @@ export type DeviceOptions = {
      * Custom handler factory.
      */
     handlerFactory?: HandlerFactory;
-    /**
-     * DEPRECATED!
-     * The name of one of the builtin handlers.
-     */
-    Handler?: string;
 };
-export declare function detectDevice(): BuiltinHandlerName | undefined;
+export declare function detectDevice(userAgent?: string): BuiltinHandlerName | undefined;
 export type DeviceObserver = EnhancedEventEmitter<DeviceObserverEvents>;
 export type DeviceObserverEvents = {
     newtransport: [Transport];
@@ -39,7 +34,7 @@ export declare class Device {
      *
      * @throws {UnsupportedError} if device is not supported.
      */
-    constructor({ handlerName, handlerFactory, Handler }?: DeviceOptions);
+    constructor({ handlerName, handlerFactory }?: DeviceOptions);
     /**
      * The RTC handler name.
      */

package/lib/Device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Device.d.ts","sourceRoot":"","sources":["../src/Device.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Device.d.ts","sourceRoot":"","sources":["../src/Device.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIxD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAoB,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAoB,MAAM,6BAA6B,CAAC;AAa/E,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,MAAM,MAAM,kBAAkB,GAC3B,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,QAAQ,GACR,wBAAwB,GACxB,aAAa,CAAC;AAEjB,MAAM,MAAM,aAAa,GAAG;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,wBAAgB,YAAY,CAC3B,SAAS,CAAC,EAAE,MAAM,GAChB,kBAAkB,GAAG,SAAS,CAuKhC;AAED,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG;IAClC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;CAC1B,CAAC;AAEF,qBAAa,MAAM;IAElB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IAEjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,wBAAwB,CAAC,CAAM;IAEvC,OAAO,CAAC,oBAAoB,CAAC,CAAkB;IAG/C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IAErD,OAAO,CAAC,iBAAiB,CAAC,CAAmB;IAE7C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,cAAc,CACM;IAElD;;;;OAIG;gBACS,EAAE,WAAW,EAAE,cAAc,EAAE,GAAE,aAAkB;IA2G/D;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;OAIG;IACH,IAAI,eAAe,IAAI,eAAe,CAMrC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAMvC;IAED,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED;;OAEG;IACG,IAAI,CAAC,EACV,qBAAqB,GACrB,EAAE;QACF,qBAAqB,EAAE,eAAe,CAAC;KACvC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+FjB;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAUpC;;;;;OAKG;IACH,mBAAmB,CAAC,gBAAgB,SAAS,OAAO,GAAG,OAAO,EAAE,EAC/D,EAAE,EACF,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,GACP,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAkBnE;;;;;OAKG;IACH,mBAAmB,CAAC,gBAAgB,SAAS,OAAO,GAAG,OAAO,EAAE,EAC/D,EAAE,EACF,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,GACP,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAkBnE,OAAO,CAAC,eAAe;CAsDvB"}

package/lib/Device.js

@@ -45,11 +45,13 @@ const Edge11_1 = require("./handlers/Edge11");
 const ReactNativeUnifiedPlan_1 = require("./handlers/ReactNativeUnifiedPlan");
 const ReactNative_1 = require("./handlers/ReactNative");
 const logger = new Logger_1.Logger('Device');
-function detectDevice() {
+function detectDevice(userAgent) {
     // React-Native.
     // NOTE: react-native-webrtc >= 1.75.0 is required.
     // NOTE: react-native-webrtc with Unified Plan requires version >= 106.0.0.
-    if (typeof navigator === 'object' && navigator.product === 'ReactNative') {
+    if (!userAgent &&
+        typeof navigator === 'object' &&
+        navigator.product === 'ReactNative') {
         logger.debug('detectDevice() | React-Native detected');
         if (typeof RTCPeerConnection === 'undefined') {
             logger.warn('detectDevice() | unsupported react-native-webrtc without RTCPeerConnection, forgot to call registerGlobals()?');
@@ -65,11 +67,11 @@ function detectDevice() {
         }
     }
     // Browser.
-    else if (typeof navigator === 'object' &&
-        typeof navigator.userAgent === 'string') {
-        const ua = navigator.userAgent;
-        const uaParser = new ua_parser_js_1.UAParser(ua);
-        logger.debug('detectDevice() | browser detected [ua:%s, parsed:%o]', ua, uaParser.getResult());
+    else if (userAgent ||
+        (typeof navigator === 'object' && typeof navigator.userAgent === 'string')) {
+        userAgent ?? (userAgent = navigator.userAgent);
+        const uaParser = new ua_parser_js_1.UAParser(userAgent);
+        logger.debug('detectDevice() | browser detected [userAgent:%s, parsed:%o]', userAgent, uaParser.getResult());
         const browser = uaParser.getBrowser();
         const browserName = browser.name?.toLowerCase();
         const browserVersion = parseInt(browser.major ?? '0');
@@ -146,7 +148,7 @@ function detectDevice() {
         // Best effort for Chromium based browsers.
         else if (engineName === 'blink') {
             // eslint-disable-next-line @typescript-eslint/prefer-regexp-exec
-            const match = ua.match(/(?:(?:Chrome|Chromium))[ /](\w+)/i);
+            const match = userAgent.match(/(?:(?:Chrome|Chromium))[ /](\w+)/i);
             if (match) {
                 const version = Number(match[1]);
                 if (version >= 111) {
@@ -187,22 +189,12 @@ class Device {
      *
      * @throws {UnsupportedError} if device is not supported.
      */
-    constructor({ handlerName, handlerFactory, Handler } = {}) {
+    constructor({ handlerName, handlerFactory } = {}) {
         // Loaded flag.
         this._loaded = false;
         // Observer instance.
         this._observer = new enhancedEvents_1.EnhancedEventEmitter();
         logger.debug('constructor()');
-        // Handle deprecated option.
-        if (Handler) {
-            logger.warn('constructor() | Handler option is DEPRECATED, use handlerName or handlerFactory instead');
-            if (typeof Handler === 'string') {
-                handlerName = Handler;
-            }
-            else {
-                throw new TypeError('non string Handler option no longer supported, use handlerFactory instead');
-            }
-        }
         if (handlerName && handlerFactory) {
             throw new TypeError('just one of handlerName or handlerInterface can be given');
         }

package/lib/index.d.ts

@@ -8,7 +8,7 @@ export { types };
 /**
  * Expose mediasoup-client version.
  */
-export declare const version = "3.7.16";
+export declare const version = "3.7.17";
 /**
  * Expose Device class and detectDevice() helper.
  */

package/lib/index.js

@@ -37,7 +37,7 @@ exports.types = types;
 /**
  * Expose mediasoup-client version.
  */
-exports.version = '3.7.16';
+exports.version = '3.7.17';
 /**
  * Expose parseScalabilityMode() function.
  */

package/lib/test/test.js

@@ -1268,26 +1268,20 @@ test('parseScalabilityMode() works', () => {
     });
 });
 describe('detectDevice() assigns proper handler based on UserAgent', () => {
-    const originalNavigator = global.navigator;
     for (const uaTestCase of uaTestCases_1.uaTestCases) {
         test(
         // eslint-disable-next-line jest/valid-title --- Jest is not that smart.
         uaTestCase.desc, () => {
-            // @ts-expect-error --- On purpose.
-            global.navigator = {
-                userAgent: uaTestCase.ua,
-            };
             const originalRTCRtpTransceiver = global.RTCRtpTransceiver;
+            // We need to force presence of RTCRtpTransceiver to test Safari 12.
             if (uaTestCase.expect === 'Safari12') {
                 global.RTCRtpTransceiver = class Dummy {
                     currentDirection() { }
                 };
             }
-            expect(detectDevice()).toBe(uaTestCase.expect);
+            expect(detectDevice(uaTestCase.ua)).toBe(uaTestCase.expect);
             // Cleanup.
             global.RTCRtpTransceiver = originalRTCRtpTransceiver;
         }, 100);
     }
-    // Cleanup.
-    global.navigator = originalNavigator;
 });

package/lib/test/uaTestCases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uaTestCases.d.ts","sourceRoot":"","sources":["../../src/test/uaTestCases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,KAAK,UAAU,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,EAiFnC,CAAC"}
+{"version":3,"file":"uaTestCases.d.ts","sourceRoot":"","sources":["../../src/test/uaTestCases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,KAAK,UAAU,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,EA4FnC,CAAC"}

package/lib/test/uaTestCases.js

@@ -82,4 +82,15 @@ exports.uaTestCases = [
         ua: 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/114.0.5735.124 Mobile/15E148 Safari/604.1',
         expect: 'Safari12',
     },
+    {
+        desc: 'Fake Foo Invalid Browser',
+        ua: 'Fake/5.0 (Foo; Bar Lalala OS_19.5) Foo/22.2',
+        expect: undefined,
+    },
+    {
+        // Zoom App Marketplace browser.
+        desc: 'Zoom App Marketplace browser',
+        ua: 'Mozilla/5.0 ZoomWebKit/537.36 (KHTML, like Gecko) ZoomApps/1.0',
+        expect: undefined,
+    },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mediasoup-client",
-	"version": "3.7.16",
+	"version": "3.7.17",
 	"description": "mediasoup client side TypeScript library",
 	"contributors": [
 		"Iñaki Baz Castillo <ibc@aliax.net> (https://inakibaz.me)",
@@ -67,34 +67,34 @@
 		"@types/debug": "^4.1.12",
 		"@types/npm-events-package": "npm:@types/events@^3.0.3",
 		"awaitqueue": "^3.0.2",
-		"debug": "^4.3.6",
+		"debug": "^4.3.7",
 		"npm-events-package": "npm:events@^3.3.0",
 		"fake-mediastreamtrack": "^1.2.0",
 		"h264-profile-level-id": "^2.0.0",
 		"queue-microtask": "^1.2.3",
 		"sdp-transform": "^2.14.2",
 		"supports-color": "^9.4.0",
-		"ua-parser-js": "^1.0.38"
+		"ua-parser-js": "^1.0.39"
 	},
 	"devDependencies": {
-		"@eslint/js": "^9.9.0",
-		"@types/jest": "^29.5.12",
+		"@eslint/js": "^9.11.1",
+		"@types/jest": "^29.5.13",
 		"@types/node": "22",
 		"@types/sdp-transform": "^2.4.9",
 		"@types/ua-parser-js": "^0.7.39",
-		"@typescript-eslint/eslint-plugin": "^8.1.0",
-		"@typescript-eslint/parser": "^8.1.0",
+		"@typescript-eslint/eslint-plugin": "^8.8.0",
+		"@typescript-eslint/parser": "^8.8.0",
 		"eslint": "^8.57.0",
-		"eslint": "^9.9.0",
+		"eslint": "^9.11.1",
 		"eslint-config-prettier": "^9.1.0",
-		"eslint-plugin-jest": "^28.8.0",
+		"eslint-plugin-jest": "^28.8.3",
 		"eslint-plugin-prettier": "^5.2.1",
 		"globals": "^15.9.0",
 		"jest": "^29.7.0",
 		"open-cli": "^8.0.0",
 		"prettier": "^3.3.3",
-		"ts-jest": "^29.2.4",
-		"typescript": "^5.5.4",
-		"typescript-eslint": "^8.1.0"
+		"ts-jest": "^29.2.5",
+		"typescript": "^5.6.2",
+		"typescript-eslint": "^8.8.0"
 	}
 }