@fishjam-cloud/ts-client 0.5.1 → 0.5.2

package/README.md

@@ -1,11 +1,20 @@
 [![NPM Version](https://img.shields.io/npm/v/@fishjam-cloud/ts-client)](https://www.npmjs.com/package/@fishjam-cloud/ts-client)
 [![TypeScript Strict](https://badgen.net/badge/TS/Strict)](https://www.typescriptlang.org)
-[![TypeDoc](https://img.shields.io/badge/TypeDoc-8A2BE2)](https://fishjam-cloud.github.io/web-client-sdk/)
+[![TypeDoc](https://img.shields.io/badge/TypeDoc-8A2BE2)](https://fishjam-cloud.github.io/web-client-sdk/modules/_fishjam_dev_ts_client.html)
 
 # Fishjam TS Client
 
 TypeScript client library for [Fishjam Cloud](https://cloud.fishjam.stream).
 
+## Documentation
+
+Documentation is available [here](https://fishjam-cloud.github.io/web-client-sdk/modules/_fishjam_dev_ts_client.html) or
+you can generate it locally:
+
+```bash
+yarn run docs
+```
+
 ## Installation
 
 You can install this package using `npm`:
@@ -17,27 +26,17 @@ npm install @fishjam-cloud/ts-client
 or `yarn`:
 
 ```bash
-yarn @fishjam-cloud/react-client
+yarn @fishjam-cloud/ts-client
 ```
 
-## Documentation
-
-Documentation is available
-[here](https://fishjam-cloud.github.io/web-client-sdk/modules/_fishjam_dev_ts_client.html/).
-
-For a more comprehensive tutorial on Fishjam, its capabilities and usage in
-production, refer to the [Fishjam Cloud Docs](https://cloud.fishjam.stream/).
-
 ## Usage
 
 Prerequisites:
 
-- Account on Fishjam Cloud with App configured.
-- Created room and token of peer in that room. You can use Room Manager to
-  create room and peer token.
+- Account on [Fishjam Cloud](https://cloud.fishjam.stream) with App configured.
+- Created room and token of peer in that room. You can use Room Manager to create room and peer token.
 
-The following code snippet is based on the
-[minimal](../../examples/ts-client//minimal/) example.
+The following code snippet is based on the [minimal](../../examples/ts-client/minimal/) example.
 
 ```ts
 import { FishjamClient, WebRTCEndpoint } from '@fishjam-cloud/ts-client';
@@ -65,11 +64,13 @@ const client = new FishjamClient<PeerMetadata, TrackMetadata>();
 
 const peerToken = prompt('Enter peer token') ?? 'YOUR_PEER_TOKEN';
 
+const FISHJAM_URL = 'ws://localhost:5002';
+
 // Start the peer connection
 client.connect({
   peerMetadata: { name: 'peer' },
   token: peerToken,
-  // if the 'signaling' field is missing, the client will connect to ws://localhost:5002/socket/peer/websocket
+  url: FISHJAM_URL,
 });
 
 // You can listen to events emitted by the client
@@ -109,14 +110,10 @@ client.on('trackRemoved', (ctx) => {
 
 async function startScreenSharing(webrtc: WebRTCEndpoint) {
   // Get screen sharing MediaStream
-  const screenStream = await navigator.mediaDevices.getDisplayMedia(
-    SCREEN_SHARING_MEDIA_CONSTRAINTS,
-  );
+  const screenStream = await navigator.mediaDevices.getDisplayMedia(SCREEN_SHARING_MEDIA_CONSTRAINTS);
 
   // Add local MediaStream to webrtc
-  screenStream
-    .getTracks()
-    .forEach((track) => webrtc.addTrack(track, { type: 'screen' }));
+  screenStream.getTracks().forEach((track) => webrtc.addTrack(track, { type: 'screen' }));
 }
 ```
 
@@ -126,8 +123,7 @@ For more examples, see the [examples](../../examples/ts-client/) folder.
 
 ## Copyright and License
 
-Copyright 2024,
-[Software Mansion](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=fishjam-ts)
+Copyright 2024, [Software Mansion](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=fishjam-ts)
 
 [![Software Mansion](https://logo.swmansion.com/logo?color=white&variant=desktop&width=200&tag=fishjam-github)](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=fishjam-ts)
 

package/dist/src/FishjamClient.d.ts

@@ -1,4 +1,4 @@
-import type { BandwidthLimit, Endpoint, SimulcastConfig, TrackBandwidthLimit, TrackContext, Encoding, MetadataParser, WebRTCEndpointEvents } from './webrtc';
+import type { BandwidthLimit, Encoding, Endpoint, MetadataParser, SimulcastConfig, TrackBandwidthLimit, TrackContext, WebRTCEndpointEvents } from './webrtc';
 import type TypedEmitter from 'typed-emitter';
 import type { ReconnectConfig } from './reconnection';
 import type { AuthErrorReason } from './auth';
@@ -134,30 +134,14 @@ export interface MessageEvents<PeerMetadata, TrackMetadata> {
     localTrackMetadataChanged: (event: Parameters<WebRTCEndpointEvents<PeerMetadata, TrackMetadata>['localTrackMetadataChanged']>[0]) => void;
     disconnectRequested: (event: Parameters<WebRTCEndpointEvents<PeerMetadata, TrackMetadata>['disconnectRequested']>[0]) => void;
 }
-export type SignalingUrl = {
-    /**
-     * Protocol of the websocket server
-     * Default is `"ws"`
-     */
-    protocol?: string;
-    /**
-     * Host of the websocket server
-     * Default is `"localhost:5002"`
-     */
-    host?: string;
-    /**
-     * Path of the websocket server
-     * Default is `"/socket/peer/websocket"`
-     */
-    path?: string;
-};
 /** Configuration object for the client */
 export interface ConnectConfig<PeerMetadata> {
     /** Metadata for the peer */
     peerMetadata: PeerMetadata;
     /** Token for authentication */
     token: string;
-    signaling?: SignalingUrl;
+    /** Fishjam url */
+    url: string;
 }
 export type CreateConfig<PeerMetadata, TrackMetadata> = {
     peerMetadataParser?: MetadataParser<PeerMetadata>;
@@ -228,6 +212,7 @@ export declare class FishjamClient<PeerMetadata, TrackMetadata> extends FishjamC
      */
     connect(config: ConnectConfig<PeerMetadata>): void;
     private initConnection;
+    private getUrl;
     private initWebsocket;
     /**
      * Retrieves statistics related to the RTCPeerConnection.
@@ -380,11 +365,9 @@ export declare class FishjamClient<PeerMetadata, TrackMetadata> extends FishjamC
      *
      * @param {string} trackId - Id of audio or video track to replace.
      * @param {MediaStreamTrack} newTrack - New audio or video track.
-     * @param {TrackMetadata} [newTrackMetadata] - Optional track metadata to apply to the new track. If no track metadata is passed, the
-     * old track metadata is retained.
      * @returns {Promise<boolean>} Success
      */
-    replaceTrack(trackId: string, newTrack: MediaStreamTrack | null, newTrackMetadata?: TrackMetadata): Promise<void>;
+    replaceTrack(trackId: string, newTrack: MediaStreamTrack | null): Promise<void>;
     /**
      * Updates maximum bandwidth for the track identified by trackId. This value directly translates to quality of the
      * stream and, in case of video, to the amount of RTP packets being sent. In case trackId points at the simulcast

package/dist/src/FishjamClient.js

@@ -10,6 +10,7 @@ const isComponent = (endpoint) => endpoint.type === 'recording' ||
     endpoint.type === 'file' ||
     endpoint.type === 'rtsp' ||
     endpoint.type === 'sip';
+const WEBSOCKET_PATH = 'socket/peer/websocket';
 /**
  * FishjamClient is the main class to interact with Fishjam.
  *
@@ -56,10 +57,8 @@ export class FishjamClient extends EventEmitter {
     trackMetadataParser;
     constructor(config) {
         super();
-        this.peerMetadataParser =
-            config?.peerMetadataParser ?? ((x) => x);
-        this.trackMetadataParser =
-            config?.trackMetadataParser ?? ((x) => x);
+        this.peerMetadataParser = config?.peerMetadataParser ?? ((x) => x);
+        this.trackMetadataParser = config?.trackMetadataParser ?? ((x) => x);
         this.reconnectManager = new ReconnectManager(this, (peerMetadata) => this.initConnection(peerMetadata), config?.reconnect);
     }
     /**
@@ -95,14 +94,16 @@ export class FishjamClient extends EventEmitter {
         this.setupCallbacks();
         this.status = 'initialized';
     }
+    getUrl(url) {
+        if (url.endsWith('/'))
+            return `${url}${WEBSOCKET_PATH}`;
+        return `${url}/${WEBSOCKET_PATH}`;
+    }
     initWebsocket(peerMetadata) {
         if (!this.connectConfig)
             throw Error('ConnectConfig is null');
-        const { token, signaling } = this.connectConfig;
-        const protocol = signaling?.protocol ?? 'ws';
-        const host = signaling?.host ?? 'localhost:5002';
-        const path = signaling?.path ?? '/socket/peer/websocket';
-        const websocketUrl = protocol + '://' + host + path;
+        const { token, url } = this.connectConfig;
+        const websocketUrl = this.getUrl(url);
         this.websocket = new WebSocket(websocketUrl);
         this.websocket.binaryType = 'arraybuffer';
         const socketOpenHandler = (event) => {
@@ -180,7 +181,7 @@ export class FishjamClient extends EventEmitter {
         return Object.entries(this.webrtc?.getRemoteEndpoints() ?? {}).reduce((acc, [id, peer]) => (isPeer(peer) ? { ...acc, [id]: peer } : acc), {});
     }
     getRemoteComponents() {
-        return Object.entries(this.webrtc?.getRemoteEndpoints() ?? {}).reduce((acc, [id, component]) => isComponent(component) ? { ...acc, [id]: component } : acc, {});
+        return Object.entries(this.webrtc?.getRemoteEndpoints() ?? {}).reduce((acc, [id, component]) => (isComponent(component) ? { ...acc, [id]: component } : acc), {});
     }
     getLocalPeer() {
         return this.webrtc?.getLocalEndpoint() || null;
@@ -458,14 +459,12 @@ export class FishjamClient extends EventEmitter {
      *
      * @param {string} trackId - Id of audio or video track to replace.
      * @param {MediaStreamTrack} newTrack - New audio or video track.
-     * @param {TrackMetadata} [newTrackMetadata] - Optional track metadata to apply to the new track. If no track metadata is passed, the
-     * old track metadata is retained.
      * @returns {Promise<boolean>} Success
      */
-    async replaceTrack(trackId, newTrack, newTrackMetadata) {
+    async replaceTrack(trackId, newTrack) {
         if (!this.webrtc)
             throw this.handleWebRTCNotInitialized();
-        return this.webrtc.replaceTrack(trackId, newTrack, newTrackMetadata);
+        return this.webrtc.replaceTrack(trackId, newTrack);
     }
     /**
      * Updates maximum bandwidth for the track identified by trackId. This value directly translates to quality of the

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export type { Peer, Component, ConnectConfig, CreateConfig, MessageEvents, SignalingUrl, } from './FishjamClient';
+export type { Peer, Component, ConnectConfig, CreateConfig, MessageEvents } from './FishjamClient';
 export type { ReconnectConfig, ReconnectionStatus } from './reconnection';
 export type { AuthErrorReason } from './auth.js';
 export { isAuthError, AUTH_ERROR_REASONS } from './auth.js';

package/dist/src/reconnection.js

@@ -78,8 +78,7 @@ export class ReconnectManager {
             this.client.emit('reconnectionStarted');
             this.lastLocalEndpoint = this.client.getLocalPeer() || null;
         }
-        const timeout = this.reconnectConfig.initialDelay +
-            this.reconnectAttempt * this.reconnectConfig.delay;
+        const timeout = this.reconnectConfig.initialDelay + this.reconnectAttempt * this.reconnectConfig.delay;
         this.reconnectAttempt += 1;
         this.reconnectTimeoutId = setTimeout(() => {
             this.reconnectTimeoutId = null;
@@ -115,7 +114,6 @@ export const createReconnectConfig = (config) => {
         maxAttempts: config?.maxAttempts ?? DEFAULT_RECONNECT_CONFIG.maxAttempts,
         initialDelay: config?.initialDelay ?? DEFAULT_RECONNECT_CONFIG.initialDelay,
         delay: config?.delay ?? DEFAULT_RECONNECT_CONFIG.delay,
-        addTracksOnReconnect: config?.addTracksOnReconnect ??
-            DEFAULT_RECONNECT_CONFIG.addTracksOnReconnect,
+        addTracksOnReconnect: config?.addTracksOnReconnect ?? DEFAULT_RECONNECT_CONFIG.addTracksOnReconnect,
     };
 };

package/dist/src/webrtc/CommandsQueue.js

@@ -28,31 +28,15 @@ export class CommandsQueue {
             }
         };
         this.clearConnectionCallbacks = () => {
-            connection
-                .getConnection()
-                .removeEventListener('signalingstatechange', onSignalingStateChange);
-            connection
-                .getConnection()
-                .removeEventListener('icegatheringstatechange', onIceGatheringStateChange);
-            connection
-                .getConnection()
-                .removeEventListener('connectionstatechange', onConnectionStateChange);
-            connection
-                .getConnection()
-                .removeEventListener('iceconnectionstatechange', onIceConnectionStateChange);
+            connection.getConnection().removeEventListener('signalingstatechange', onSignalingStateChange);
+            connection.getConnection().removeEventListener('icegatheringstatechange', onIceGatheringStateChange);
+            connection.getConnection().removeEventListener('connectionstatechange', onConnectionStateChange);
+            connection.getConnection().removeEventListener('iceconnectionstatechange', onIceConnectionStateChange);
         };
-        connection
-            .getConnection()
-            .addEventListener('icegatheringstatechange', onIceConnectionStateChange);
-        connection
-            .getConnection()
-            .addEventListener('connectionstatechange', onConnectionStateChange);
-        connection
-            .getConnection()
-            .addEventListener('iceconnectionstatechange', onIceConnectionStateChange);
-        connection
-            .getConnection()
-            .addEventListener('signalingstatechange', onSignalingStateChange);
+        connection.getConnection().addEventListener('icegatheringstatechange', onIceConnectionStateChange);
+        connection.getConnection().addEventListener('connectionstatechange', onConnectionStateChange);
+        connection.getConnection().addEventListener('iceconnectionstatechange', onIceConnectionStateChange);
+        connection.getConnection().addEventListener('signalingstatechange', onSignalingStateChange);
     };
     commandsQueue = [];
     commandResolutionNotifier = null;

package/dist/src/webrtc/ConnectionManager.js

@@ -35,14 +35,10 @@ export class ConnectionManager {
         return this.connection;
     };
     setTransceiversToReadOnly = () => {
-        this.connection
-            .getTransceivers()
-            .forEach((transceiver) => (transceiver.direction = 'sendonly'));
+        this.connection.getTransceivers().forEach((transceiver) => (transceiver.direction = 'sendonly'));
     };
     addTransceiversIfNeeded = (serverTracks) => {
-        const recvTransceivers = this.connection
-            .getTransceivers()
-            .filter((elem) => elem.direction === 'recvonly');
+        const recvTransceivers = this.connection.getTransceivers().filter((elem) => elem.direction === 'recvonly');
         ['audio', 'video']
             .flatMap((type) => this.getNeededTransceiversTypes(type, recvTransceivers, serverTracks))
             .forEach((kind) => this.connection.addTransceiver(kind, { direction: 'recvonly' }));
@@ -73,9 +69,7 @@ export class ConnectionManager {
     removeTrack = (sender) => {
         this.connection.removeTrack(sender);
     };
-    findSender = (mediaStreamTrackId) => this.connection
-        .getSenders()
-        .find((sender) => sender.track && sender.track.id === mediaStreamTrackId);
+    findSender = (mediaStreamTrackId) => this.connection.getSenders().find((sender) => sender.track && sender.track.id === mediaStreamTrackId);
     addIceCandidate = async (iceCandidate) => {
         await this.connection.addIceCandidate(iceCandidate);
     };

package/dist/src/webrtc/tracks/Local.d.ts

@@ -31,7 +31,7 @@ export declare class Local<EndpointMetadata, TrackMetadata> {
     disableAllLocalTrackEncodings: () => Promise<void>;
     getTrackByMidOrNull: (mid: string) => LocalTrack<EndpointMetadata, TrackMetadata> | null;
     removeTrack: (trackId: TrackId) => void;
-    replaceTrack: (webrtc: WebRTCEndpoint<EndpointMetadata, TrackMetadata>, trackId: TrackId, newTrack: MediaStreamTrack | null, newTrackMetadata: TrackMetadata | undefined) => Promise<void>;
+    replaceTrack: (webrtc: WebRTCEndpoint<EndpointMetadata, TrackMetadata>, trackId: TrackId, newTrack: MediaStreamTrack | null) => Promise<void>;
     setEndpointMetadata: (metadata: EndpointMetadata) => void;
     getEndpoint: () => EndpointWithTrackContext<EndpointMetadata, TrackMetadata>;
     setTrackBandwidth: (trackId: string, bandwidth: BandwidthLimit) => Promise<void>;

package/dist/src/webrtc/tracks/Local.js

@@ -85,8 +85,7 @@ export class Local {
         }
     };
     getTrackByMidOrNull = (mid) => {
-        return (Object.values(this.localTracks).find((track) => track.mLineId === mid) ??
-            null);
+        return Object.values(this.localTracks).find((track) => track.mLineId === mid) ?? null;
     };
     removeTrack = (trackId) => {
         const trackManager = this.localTracks[trackId];
@@ -98,16 +97,12 @@ export class Local {
         this.localEndpoint.tracks.delete(trackId);
         delete this.localTracks[trackId];
     };
-    replaceTrack = async (
-    // todo remove webrtc with newTrackMetadata
-    webrtc, trackId, newTrack, 
-    // todo remove webrtc with newTrackMetadata
-    newTrackMetadata) => {
+    replaceTrack = async (webrtc, trackId, newTrack) => {
         // TODO add validation to track.kind, you cannot replace video with audio
         const trackManager = this.localTracks[trackId];
         if (!trackManager)
             throw new Error(`Cannot find ${trackId}`);
-        await trackManager.replaceTrack(newTrack, newTrackMetadata, webrtc);
+        await trackManager.replaceTrack(newTrack, webrtc);
     };
     setEndpointMetadata = (metadata) => {
         try {

package/dist/src/webrtc/tracks/LocalTrack.d.ts

@@ -49,7 +49,7 @@ export declare class LocalTrack<EndpointMetadata, TrackMetadata> implements Trac
     addTrackToConnection: () => void;
     private updateEncodings;
     removeFromConnection: () => void;
-    replaceTrack: (newTrack: MediaStreamTrack | null, newTrackMetadata: TrackMetadata | undefined, webrtc: WebRTCEndpoint<EndpointMetadata, TrackMetadata>) => Promise<void>;
+    replaceTrack: (newTrack: MediaStreamTrack | null, webrtc: WebRTCEndpoint<EndpointMetadata, TrackMetadata>) => Promise<void>;
     setTrackBandwidth: (bandwidth: BandwidthLimit) => Promise<void>;
     setEncodingBandwidth(rid: Encoding, bandwidth: BandwidthLimit): Promise<void>;
     updateTrackMetadata: (metadata: unknown) => void;

package/dist/src/webrtc/tracks/LocalTrack.js

@@ -1,5 +1,5 @@
 import { generateCustomEvent, generateMediaEvent } from '../mediaEvent';
-import { defaultBitrates, defaultSimulcastBitrates, UNLIMITED_BANDWIDTH, } from '../bitrate';
+import { defaultBitrates, defaultSimulcastBitrates, UNLIMITED_BANDWIDTH } from '../bitrate';
 import { getEncodingParameters } from './encodings';
 import { createTransceiverConfig } from './transceivers';
 /**
@@ -82,8 +82,7 @@ export class LocalTrack {
     };
     // 1
     updateEncodings = () => {
-        if (this.trackContext?.track?.kind === 'video' &&
-            this.trackContext.simulcastConfig?.activeEncodings) {
+        if (this.trackContext?.track?.kind === 'video' && this.trackContext.simulcastConfig?.activeEncodings) {
             const activeEncodings = this.trackContext.simulcastConfig.activeEncodings;
             this.encodings.l = activeEncodings.some((e) => e === 'l');
             this.encodings.m = activeEncodings.some((e) => e === 'm');
@@ -97,14 +96,7 @@ export class LocalTrack {
             throw new Error(`There is no active RTCPeerConnection`);
         this.connection.removeTrack(this.sender);
     };
-    // TODO: Remove `newTrackMetadata` parameter because this function should be an atomic operation.
-    //  Metadata are updated after `await this.sender.replaceTrack(newTrack)`,
-    //  so it could be chained by the user.
-    replaceTrack = async (newTrack, 
-    // todo remove webrtc with newTrackMetadata
-    newTrackMetadata, 
-    // todo remove webrtc with newTrackMetadata
-    webrtc) => {
+    replaceTrack = async (newTrack, webrtc) => {
         const trackId = this.id;
         const stream = this.trackContext.stream;
         if (!this.sender)
@@ -131,11 +123,8 @@ export class LocalTrack {
         try {
             await this.sender.replaceTrack(newTrack);
             this.trackContext.track = newTrack;
-            if (newTrackMetadata) {
-                webrtc.updateTrackMetadata(trackId, newTrackMetadata);
-            }
         }
-        catch (error) {
+        catch (_error) {
             // ignore
         }
     };
@@ -209,8 +198,7 @@ export class LocalTrack {
             throw new Error(`RTCRtpSender for track ${this.id} not found`);
         const encodings = this.sender.getParameters().encodings;
         if (this.isNotSimulcastTrack(encodings)) {
-            return (encodings[0].maxBitrate ||
-                (kind ? defaultBitrates[kind] : UNLIMITED_BANDWIDTH));
+            return encodings[0].maxBitrate || (kind ? defaultBitrates[kind] : UNLIMITED_BANDWIDTH);
         }
         else if (kind === 'audio') {
             throw 'Audio track cannot have multiple encodings';

package/dist/src/webrtc/tracks/LocalTrackManager.d.ts

@@ -31,7 +31,7 @@ export declare class LocalTrackManager<EndpointMetadata, TrackMetadata> {
     parseAddTrack: (track: MediaStreamTrack, simulcastConfig: SimulcastConfig, maxBandwidth: TrackBandwidthLimit) => void;
     addTrackHandler: (trackId: string, track: MediaStreamTrack, stream: MediaStream, trackMetadata: TrackMetadata | undefined, simulcastConfig: SimulcastConfig, maxBandwidth: TrackBandwidthLimit) => void;
     removeTrackHandler: (trackId: string) => void;
-    replaceTrackHandler: (webrtc: WebRTCEndpoint<EndpointMetadata, TrackMetadata>, trackId: string, newTrack: MediaStreamTrack | null, newTrackMetadata?: TrackMetadata) => Promise<void>;
+    replaceTrackHandler: (webrtc: WebRTCEndpoint<EndpointMetadata, TrackMetadata>, trackId: string, newTrack: MediaStreamTrack | null) => Promise<void>;
     getEndpointId: () => string;
     updateConnection: (connection: ConnectionManager) => void;
     updateSenders: () => void;

package/dist/src/webrtc/tracks/LocalTrackManager.js

@@ -59,19 +59,14 @@ export class LocalTrackManager {
         this.ongoingRenegotiation = true;
         this.local.removeTrack(trackId);
     };
-    replaceTrackHandler = async (
-    // todo remove webrtc with newTrackMetadata
-    webrtc, trackId, newTrack, 
-    // todo remove webrtc with newTrackMetadata
-    newTrackMetadata) => {
+    replaceTrackHandler = async (webrtc, trackId, newTrack) => {
         this.ongoingTrackReplacement = true;
         try {
-            await this.local.replaceTrack(webrtc, trackId, newTrack, newTrackMetadata);
+            await this.local.replaceTrack(webrtc, trackId, newTrack);
         }
-        catch (e) {
+        finally {
             this.ongoingTrackReplacement = false;
         }
-        this.ongoingTrackReplacement = false;
     };
     getEndpointId = () => this.local.getEndpoint().id;
     updateConnection = (connection) => {

package/dist/src/webrtc/tracks/encodings.js

@@ -1,7 +1,5 @@
 import { splitBandwidth } from './bandwidth';
 export const getEncodingParameters = (parameters, bandwidth) => {
     const unlimitedEncodings = [{}];
-    return parameters.encodings.length === 0
-        ? unlimitedEncodings
-        : splitBandwidth(parameters.encodings, bandwidth);
+    return parameters.encodings.length === 0 ? unlimitedEncodings : splitBandwidth(parameters.encodings, bandwidth);
 };

package/dist/src/webrtc/tracks/transceivers.js

@@ -16,8 +16,7 @@ const createAudioTransceiverConfig = (stream) => {
 const createVideoTransceiverConfig = (trackContext, maxBandwidth) => {
     if (!trackContext.simulcastConfig)
         throw new Error(`Simulcast config for track ${trackContext.trackId} not found.`);
-    if (typeof maxBandwidth !== 'number' &&
-        trackContext.simulcastConfig.enabled) {
+    if (typeof maxBandwidth !== 'number' && trackContext.simulcastConfig.enabled) {
         return createSimulcastTransceiverConfig(trackContext, maxBandwidth);
     }
     if (typeof maxBandwidth === 'number') {

package/dist/src/webrtc/types.d.ts

@@ -243,7 +243,6 @@ export interface WebRTCEndpointEvents<EndpointMetadata, TrackMetadata> {
     localTrackReplaced: (event: {
         trackId: string;
         track: MediaStreamTrack | null;
-        metadata?: TrackMetadata;
     }) => void;
     localTrackMuted: (event: {
         trackId: string;

package/dist/src/webrtc/webRTCEndpoint.d.ts

@@ -127,8 +127,6 @@ export declare class WebRTCEndpoint<EndpointMetadata = any, TrackMetadata = any>
      * @param trackId - Audio or video track.
      * @param {string} trackId - Id of audio or video track to replace.
      * @param {MediaStreamTrack} newTrack
-     * @param {any} [newTrackMetadata] - Optional track metadata to apply to the new track. If no
-     *                              track metadata is passed, the old track metadata is retained.
      * @returns {Promise<boolean>} success
      * @example
      * ```ts
@@ -169,7 +167,7 @@ export declare class WebRTCEndpoint<EndpointMetadata = any, TrackMetadata = any>
      *   })
      * ```
      */
-    replaceTrack(trackId: string, newTrack: MediaStreamTrack | null, newTrackMetadata?: any): Promise<void>;
+    replaceTrack(trackId: string, newTrack: MediaStreamTrack | null): Promise<void>;
     /**
      * Updates maximum bandwidth for the track identified by trackId.
      * This value directly translates to quality of the stream and, in case of video, to the amount of RTP packets being sent.

package/dist/src/webrtc/webRTCEndpoint.js

@@ -1,4 +1,4 @@
-import { deserializeMediaEvent, generateCustomEvent, generateMediaEvent, serializeMediaEvent, } from './mediaEvent';
+import { deserializeMediaEvent, generateCustomEvent, generateMediaEvent, serializeMediaEvent } from './mediaEvent';
 import { v4 as uuidv4 } from 'uuid';
 import EventEmitter from 'events';
 import { Deferred } from './deferred';
@@ -23,10 +23,8 @@ export class WebRTCEndpoint extends EventEmitter {
     clearConnectionCallbacks = null;
     constructor(config) {
         super();
-        this.endpointMetadataParser =
-            config?.endpointMetadataParser ?? ((x) => x);
-        this.trackMetadataParser =
-            config?.trackMetadataParser ?? ((x) => x);
+        this.endpointMetadataParser = config?.endpointMetadataParser ?? ((x) => x);
+        this.trackMetadataParser = config?.trackMetadataParser ?? ((x) => x);
         const sendEvent = (mediaEvent) => this.sendMediaEvent(mediaEvent);
         const emit = (events, ...args) => {
             this.emit(events, ...args);
@@ -77,8 +75,7 @@ export class WebRTCEndpoint extends EventEmitter {
         switch (deserializedMediaEvent.type) {
             case 'connected': {
                 this.local.setLocalEndpointId(deserializedMediaEvent.data.id);
-                const endpoints = deserializedMediaEvent.data
-                    .otherEndpoints;
+                const endpoints = deserializedMediaEvent.data.otherEndpoints;
                 // todo implement track mapping (+ validate metadata)
                 // todo implement endpoint metadata mapping
                 endpoints.forEach((endpoint) => {
@@ -113,8 +110,7 @@ export class WebRTCEndpoint extends EventEmitter {
      * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/getStats | MDN Web Docs: RTCPeerConnection.getStats()}
      */
     async getStatistics(selector) {
-        return ((await this.connectionManager?.getConnection().getStats(selector)) ??
-            new Map());
+        return (await this.connectionManager?.getConnection().getStats(selector)) ?? new Map();
     }
     /**
      * Returns a snapshot of currently received remote tracks.
@@ -361,8 +357,6 @@ export class WebRTCEndpoint extends EventEmitter {
      * @param trackId - Audio or video track.
      * @param {string} trackId - Id of audio or video track to replace.
      * @param {MediaStreamTrack} newTrack
-     * @param {any} [newTrackMetadata] - Optional track metadata to apply to the new track. If no
-     *                              track metadata is passed, the old track metadata is retained.
      * @returns {Promise<boolean>} success
      * @example
      * ```ts
@@ -403,29 +397,17 @@ export class WebRTCEndpoint extends EventEmitter {
      *   })
      * ```
      */
-    async replaceTrack(trackId, newTrack, newTrackMetadata) {
+    async replaceTrack(trackId, newTrack) {
         const resolutionNotifier = new Deferred();
-        try {
-            const newMetadata = newTrackMetadata !== undefined
-                ? this.trackMetadataParser(newTrackMetadata)
-                : undefined;
-            this.commandsQueue.pushCommand({
-                handler: () => {
-                    this.localTrackManager.replaceTrackHandler(this, trackId, newTrack, newMetadata);
-                },
-                resolutionNotifier,
-                resolve: 'immediately',
-            });
-        }
-        catch (error) {
-            resolutionNotifier.reject(error);
-        }
+        this.commandsQueue.pushCommand({
+            handler: () => {
+                this.localTrackManager.replaceTrackHandler(this, trackId, newTrack);
+            },
+            resolutionNotifier,
+            resolve: 'immediately',
+        });
         return resolutionNotifier.promise.then(() => {
-            this.emit('localTrackReplaced', {
-                trackId,
-                track: newTrack,
-                metadata: newTrackMetadata,
-            });
+            this.emit('localTrackReplaced', { trackId, track: newTrack });
         });
     }
     /**
@@ -635,31 +617,15 @@ export class WebRTCEndpoint extends EventEmitter {
             if (!connection)
                 throw new Error(`There is no active RTCPeerConnection`);
             this.clearConnectionCallbacks = () => {
-                connection
-                    ?.getConnection()
-                    ?.removeEventListener('icecandidate', onIceCandidate);
-                connection
-                    ?.getConnection()
-                    ?.removeEventListener('icecandidateerror', onIceCandidateError);
-                connection
-                    ?.getConnection()
-                    ?.removeEventListener('connectionstatechange', onConnectionStateChange);
-                connection
-                    ?.getConnection()
-                    ?.removeEventListener('iceconnectionstatechange', onIceConnectionStateChange);
+                connection?.getConnection()?.removeEventListener('icecandidate', onIceCandidate);
+                connection?.getConnection()?.removeEventListener('icecandidateerror', onIceCandidateError);
+                connection?.getConnection()?.removeEventListener('connectionstatechange', onConnectionStateChange);
+                connection?.getConnection()?.removeEventListener('iceconnectionstatechange', onIceConnectionStateChange);
             };
-            connection
-                .getConnection()
-                .addEventListener('icecandidate', onIceCandidate);
-            connection
-                .getConnection()
-                .addEventListener('icecandidateerror', onIceCandidateError);
-            connection
-                .getConnection()
-                .addEventListener('connectionstatechange', onConnectionStateChange);
-            connection
-                .getConnection()
-                .addEventListener('iceconnectionstatechange', onIceConnectionStateChange);
+            connection.getConnection().addEventListener('icecandidate', onIceCandidate);
+            connection.getConnection().addEventListener('icecandidateerror', onIceCandidateError);
+            connection.getConnection().addEventListener('connectionstatechange', onConnectionStateChange);
+            connection.getConnection().addEventListener('iceconnectionstatechange', onIceConnectionStateChange);
             this.commandsQueue.initConnection(connection);
             this.local.addAllTracksToConnection();
             connection.setTransceiversToReadOnly();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishjam-cloud/ts-client",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Typescript client library for Fishjam Cloud",
   "license": "Apache-2.0",
   "author": "Fishjam Cloud Team",
@@ -52,22 +52,22 @@
     "uuid": "^10.0.0"
   },
   "devDependencies": {
-    "@playwright/test": "^1.45.3",
+    "@playwright/test": "^1.46.1",
     "@types/events": "^3.0.3",
-    "@types/node": "^22.0.0",
+    "@types/node": "^22.4.1",
     "@types/uuid": "^10.0.0",
-    "@vitest/coverage-v8": "^2.0.4",
+    "@vitest/coverage-v8": "^2.0.5",
     "fake-mediastreamtrack": "^1.2.0",
     "husky": "^9.1.4",
-    "lint-staged": "^15.2.5",
+    "lint-staged": "^15.2.9",
     "react": "^18.2.0",
-    "ts-proto": "^1.181.1",
+    "ts-proto": "^2.0.2",
     "typed-emitter": "^2.1.0",
-    "typedoc": "^0.26.5",
+    "typedoc": "^0.26.6",
     "typedoc-plugin-external-resolver": "^1.0.3",
-    "typedoc-plugin-mdn-links": "^3.2.6",
+    "typedoc-plugin-mdn-links": "^3.2.9",
     "typescript": "^5.5.4",
-    "vitest": "^2.0.4",
+    "vitest": "^2.0.5",
     "zod": "^3.23.6"
   },
   "lint-staged": {