livekit-client 2.1.0 → 2.1.2

package/src/room/utils.ts

@@ -1,5 +1,4 @@
-import { ClientInfo, ClientInfo_SDK } from '@livekit/protocol';
-import type { DetectableBrowser } from '../utils/browserParser';
+import { ClientInfo, ClientInfo_SDK, Transcription as TranscriptionModel } from '@livekit/protocol';
 import { getBrowser } from '../utils/browserParser';
 import { protocolVersion, version } from '../version';
 import CriticalTimers from './timers';
@@ -7,7 +6,7 @@ import type LocalAudioTrack from './track/LocalAudioTrack';
 import type RemoteAudioTrack from './track/RemoteAudioTrack';
 import { VideoCodec, videoCodecs } from './track/options';
 import { getNewAudioContext } from './track/utils';
-import type { LiveKitReactNativeInfo } from './types';
+import type { LiveKitReactNativeInfo, TranscriptionSegment } from './types';
 
 const separator = '|';
 export const ddExtensionURI =
@@ -107,31 +106,6 @@ export function supportsSetSinkId(elm?: HTMLMediaElement): boolean {
   return 'setSinkId' in elm;
 }
 
-const setCodecPreferencesVersions: Record<DetectableBrowser, string> = {
-  Chrome: '100',
-  Safari: '15',
-  Firefox: '100',
-};
-
-export function supportsSetCodecPreferences(transceiver: RTCRtpTransceiver): boolean {
-  if (!isWeb()) {
-    return false;
-  }
-  if (!('setCodecPreferences' in transceiver)) {
-    return false;
-  }
-  const browser = getBrowser();
-  if (!browser?.name || !browser.version) {
-    // version is required
-    return false;
-  }
-  const v = setCodecPreferencesVersions[browser.name];
-  if (v) {
-    return compareVersions(browser.version, v) >= 0;
-  }
-  return false;
-}
-
 export function isBrowserSupported() {
   if (typeof RTCPeerConnection === 'undefined') {
     return false;
@@ -158,7 +132,35 @@ export function isSafari17(): boolean {
 
 export function isMobile(): boolean {
   if (!isWeb()) return false;
-  return /Tablet|iPad|Mobile|Android|BlackBerry/.test(navigator.userAgent);
+
+  return (
+    // @ts-expect-error `userAgentData` is not yet part of typescript
+    navigator.userAgentData?.mobile ??
+    /Tablet|iPad|Mobile|Android|BlackBerry/.test(navigator.userAgent)
+  );
+}
+
+export function isE2EESimulcastSupported() {
+  const browser = getBrowser();
+  const supportedSafariVersion = '17.2'; // see https://bugs.webkit.org/show_bug.cgi?id=257803
+  if (browser) {
+    if (browser.name !== 'Safari' && browser.os !== 'iOS') {
+      return true;
+    } else if (
+      browser.os === 'iOS' &&
+      browser.osVersion &&
+      compareVersions(supportedSafariVersion, browser.osVersion) >= 0
+    ) {
+      return true;
+    } else if (
+      browser.name === 'Safari' &&
+      compareVersions(supportedSafariVersion, browser.version) >= 0
+    ) {
+      return true;
+    } else {
+      return false;
+    }
+  }
 }
 
 export function isWeb(): boolean {
@@ -525,3 +527,18 @@ export function toHttpUrl(url: string): string {
   }
   return url;
 }
+
+export function extractTranscriptionSegments(
+  transcription: TranscriptionModel,
+): TranscriptionSegment[] {
+  return transcription.segments.map(({ id, text, language, startTime, endTime, final }) => {
+    return {
+      id,
+      text,
+      startTime: Number.parseInt(startTime.toString()),
+      endTime: Number.parseInt(endTime.toString()),
+      final,
+      language,
+    };
+  });
+}

package/src/utils/browserParser.test.ts

@@ -29,12 +29,14 @@ describe('browser parser', () => {
     expect(details?.name).toBe('Safari');
     expect(details?.version).toBe('16.3');
     expect(details?.os).toBe('macOS');
+    expect(details?.osVersion).toBe('10.15.7');
   });
   it('parses Safari iOS correctly', () => {
     const details = getBrowser(iOSSafariUA, true);
     expect(details?.name).toBe('Safari');
     expect(details?.version).toBe('16.5');
     expect(details?.os).toBe('iOS');
+    expect(details?.osVersion).toBe('16.5.1');
   });
   it('parses Firefox correctly', () => {
     const details = getBrowser(firefoxUA, true);
@@ -46,6 +48,7 @@ describe('browser parser', () => {
     expect(details?.name).toBe('Firefox');
     expect(details?.version).toBe('115.0');
     expect(details?.os).toBe('iOS');
+    expect(details?.osVersion).toBe('13.4.1');
   });
   it('parses Chrome correctly', () => {
     const details = getBrowser(chromeUA, true);
@@ -57,6 +60,7 @@ describe('browser parser', () => {
     expect(details?.name).toBe('Chrome');
     expect(details?.version).toBe('115.0.5790.130');
     expect(details?.os).toBe('iOS');
+    expect(details?.osVersion).toBe('16.5');
   });
   it('detects brave as chromium based', () => {
     const details = getBrowser(braveUA, true);

package/src/utils/browserParser.ts

@@ -10,6 +10,7 @@ export type BrowserDetails = {
   name: DetectableBrowser;
   version: string;
   os?: DetectableOS;
+  osVersion?: string;
 };
 
 let browserDetails: BrowserDetails | undefined;
@@ -17,7 +18,7 @@ let browserDetails: BrowserDetails | undefined;
 /**
  * @internal
  */
-export function getBrowser(userAgent?: string, force = true) {
+export function getBrowser(userAgent?: string, force = true): BrowserDetails | undefined {
   if (typeof userAgent === 'undefined' && typeof navigator === 'undefined') {
     return;
   }
@@ -37,6 +38,7 @@ const browsersList = [
         name: 'Firefox',
         version: getMatch(/(?:firefox|iceweasel|fxios)[\s/](\d+(\.?_?\d+)+)/i, ua),
         os: ua.toLowerCase().includes('fxios') ? 'iOS' : undefined,
+        osVersion: getOSVersion(ua),
       };
       return browser;
     },
@@ -48,6 +50,7 @@ const browsersList = [
         name: 'Chrome',
         version: getMatch(/(?:chrome|chromium|crios|crmo)\/(\d+(\.?_?\d+)+)/i, ua),
         os: ua.toLowerCase().includes('crios') ? 'iOS' : undefined,
+        osVersion: getOSVersion(ua),
       };
 
       return browser;
@@ -61,6 +64,7 @@ const browsersList = [
         name: 'Safari',
         version: getMatch(commonVersionIdentifier, ua),
         os: ua.includes('mobile/') ? 'iOS' : 'macOS',
+        osVersion: getOSVersion(ua),
       };
 
       return browser;
@@ -72,3 +76,9 @@ function getMatch(exp: RegExp, ua: string, id = 1) {
   const match = ua.match(exp);
   return (match && match.length >= id && match[id]) || '';
 }
+
+function getOSVersion(ua: string) {
+  return ua.includes('mac os')
+    ? getMatch(/\(.+?(\d+_\d+(:?_\d+)?)/, ua, 1).replace(/_/g, '.')
+    : undefined;
+}