@js-toolkit/web-utils 1.67.0 → 1.68.0

package/webrtc/sdputils.js

@@ -1 +1,417 @@
-export function trace(e){if(e.endsWith("\n")&&(e=e.substring(0,e.length-1)),window.performance){const t=(window.performance.now()/1e3).toFixed(3);console.log(`${t}: ${e}`)}else console.log(e)}function iceCandidateType(e){return e.split(" ")[7]}export function isValidIceCandidate({candidate:e},t){return!(!e||e.includes("tcp"))&&(!t||"relay"!==t.iceTransportPolicy||"relay"===iceCandidateType(e))}function maybeSetOpusOptions(e,t){return"true"===t.opusStereo?e=setCodecParam(e,"opus/48000","stereo","1"):"false"===t.opusStereo&&(e=removeCodecParam(e,"opus/48000","stereo")),"true"===t.opusFec?e=setCodecParam(e,"opus/48000","useinbandfec","1"):"false"===t.opusFec&&(e=removeCodecParam(e,"opus/48000","useinbandfec")),"true"===t.opusDtx?e=setCodecParam(e,"opus/48000","usedtx","1"):"false"===t.opusDtx&&(e=removeCodecParam(e,"opus/48000","usedtx")),t.opusMaxPbr&&(e=setCodecParam(e,"opus/48000","maxplaybackrate",t.opusMaxPbr)),e}function maybeSetAudioSendBitRate(e,t){return t.audioSendBitrate?(trace(`Prefer audio send bitrate: ${t.audioSendBitrate}`),preferBitRate(e,t.audioSendBitrate,"audio")):e}function maybeSetAudioReceiveBitRate(e,t){return t.audioRecvBitrate?(trace(`Prefer audio receive bitrate: ${t.audioRecvBitrate}`),preferBitRate(e,t.audioRecvBitrate,"audio")):e}function maybeSetVideoSendBitRate(e,t){return t.videoSendBitrate?(trace(`Prefer video send bitrate: ${t.videoSendBitrate}`),preferBitRate(e,t.videoSendBitrate,"video")):e}function maybeSetVideoReceiveBitRate(e,t){return t.videoRecvBitrate?(trace(`Prefer video receive bitrate: ${t.videoRecvBitrate}`),preferBitRate(e,t.videoRecvBitrate,"video")):e}function preferBitRate(e,t,n){const i=e.split("\r\n"),o=findLine(i,"m=",n);if(-1===o)return trace("Failed to add bandwidth line to sdp, as no m-line found"),e;let r=findLineInRange(i,o+1,-1,"m=");-1===r&&(r=i.length);const a=findLineInRange(i,o+1,r,"c=");if(-1===a)return trace("Failed to add bandwidth line to sdp, as no c-line found"),e;const d=findLineInRange(i,a+1,r,"b=AS");d>=0&&i.splice(d,1);const c=`b=AS:${t}`;return i.splice(a+1,0,c),e=i.join("\r\n")}function maybeSetVideoSendInitialBitRate(e,t){let n=t.videoSendInitialBitrate;if(!n)return e;let i=n;const o=t.videoSendBitrate;o&&(n>o&&(trace(`Clamping initial bitrate to max bitrate of ${o} kbps.`),n=o,t.videoSendInitialBitrate=n),i=o);if(-1===findLine(e.split("\r\n"),"m=","video"))return trace("Failed to find video m-line"),e;const r=t.videoRecvCodec||"";return e=setCodecParam(e,r,"x-google-min-bitrate",t.videoSendInitialBitrate||""),e=setCodecParam(e,r,"x-google-max-bitrate",i.toString())}function removePayloadTypeFromMline(e,t){const n=e.split(" "),{length:i}=n;for(let e=0;e<i;++e)n[e]===t.toString()&&n.splice(e,1);return n.join(" ")}function removeCodecByName(e,t){const n=findLine(e,"a=rtpmap",t);if(-1===n)return e;const i=getCodecPayloadTypeFromLine(e[n]);e.splice(n,1);const o=findLine(e,"m=","video");return-1===o||(e[o]=removePayloadTypeFromMline(e[o],i)),e}function removeCodecByPayloadType(e,t){const n=findLine(e,"a=rtpmap",t.toString());if(-1===n)return e;e.splice(n,1);const i=findLine(e,"m=","video");return-1===i||(e[i]=removePayloadTypeFromMline(e[i],t)),e}function maybeRemoveVideoFec(e,t){if("false"!==t.videoFec)return e;let n=e.split("\r\n"),i=findLine(n,"a=rtpmap","red");if(-1===i)return e;const o=getCodecPayloadTypeFromLine(n[i]);if(n=removeCodecByPayloadType(n,o),n=removeCodecByName(n,"ulpfec"),i=findLine(n,"a=fmtp",o.toString()),-1===i)return e;const r=parseFmtpLine(n[i]).pt;return null==r?e:(n.splice(i,1),n=removeCodecByPayloadType(n,r),n.join("\r\n"))}function maybePreferAudioSendCodec(e,t){return maybePreferCodec(e,"audio","send",t.audioSendCodec)}function maybePreferAudioReceiveCodec(e,t){return maybePreferCodec(e,"audio","receive",t.audioRecvCodec)}function maybePreferVideoSendCodec(e,t){return maybePreferCodec(e,"video","send",t.videoSendCodec)}function maybePreferVideoReceiveCodec(e,t){return maybePreferCodec(e,"video","receive",t.videoRecvCodec)}function maybePreferCodec(e,t,n,i){if(!i)return e;const o=e.split("\r\n"),r=findLine(o,"m=",t);if(-1===r)return e;const a=getCodecPayloadType(o,i);return a&&(o[r]=setDefaultCodec(o[r],a)),e=o.join("\r\n")}function setCodecParam(e,t,n,i){const o=e.split("\r\n"),r=findFmtpLine(o,t);if(null===r){const r=findLine(o,"a=rtpmap",t);if(-1===r)return e;const a={pt:getCodecPayloadTypeFromLine(o[r]).toString(),params:{[n]:i}};o.splice(r+1,0,writeFmtpLine(a))}else{const e=parseFmtpLine(o[r]);e.params[n]=i,o[r]=writeFmtpLine(e)}return e=o.join("\r\n")}function removeCodecParam(e,t,n){const i=e.split("\r\n"),o=findFmtpLine(i,t);if(null===o)return e;const r=parseFmtpLine(i[o]);if(r){delete r.params[n];const e=writeFmtpLine(r);null===e?i.splice(o,1):i[o]=e}return e=i.join("\r\n")}function parseFmtpLine(e){const t={},n=e.indexOf(" "),i=e.substring(n+1).split("; "),o=/a=fmtp:(\d+)/.exec(e);o&&2===o.length&&(t.pt=o[1]);const r={};return i.forEach(e=>{const t=e.split("=");2===t.length&&(r[t[0]]=t[1])}),t.params=r,t}function writeFmtpLine(e){if(!e.hasOwnProperty("pt")||!e.hasOwnProperty("params"))return"";const{pt:t="",params:n={}}=e,i=Object.entries(n).map(([e,t])=>`${e}=${t}`);return 0===i.length?"":`a=fmtp:${t.toString()} ${i.join("; ")}`}function findFmtpLine(e,t){const n=getCodecPayloadType(e,t);return n?findLine(e,`a=fmtp:${n.toString()}`):null}function findLine(e,t,n){return findLineInRange(e,0,-1,t,n)}function findLineInRange(e,t,n,i,o){const r=-1!==n?n:e.length;for(let n=t;n<r;++n)if(e[n].startsWith(i)&&(!o||e[n].toLowerCase().includes(o.toLowerCase())))return n;return-1}function getCodecPayloadType(e,t){const n=findLine(e,"a=rtpmap",t);return n>=0?getCodecPayloadTypeFromLine(e[n]):null}function getCodecPayloadTypeFromLine(e){const t=/a=rtpmap:(\d+) [a-zA-Z0-9-]+\/\d+/.exec(e);return t&&2===t.length?t[1]:""}function setDefaultCodec(e,t){const n=e.split(" "),i=n.slice(0,3);i.push(t);const{length:o}=n;for(let e=3;e<o;e++)n[e]!==t&&i.push(n[e]);return i.join(" ")}export function prepareLocalDescription(e,t={}){let n=maybePreferAudioReceiveCodec(e.sdp||"",t);n=maybePreferVideoReceiveCodec(n,t),n=maybeSetAudioReceiveBitRate(n,t),n=maybeSetVideoReceiveBitRate(n,t),n=maybeRemoveVideoFec(n,t);return{sdp:n,type:e.type}}export function prepareRemoteDescription(e,t={}){let n=maybeSetOpusOptions(e.sdp||"",t);n=maybePreferAudioSendCodec(n,t),n=maybePreferVideoSendCodec(n,t),n=maybeSetAudioSendBitRate(n,t),n=maybeSetVideoSendBitRate(n,t),n=maybeSetVideoSendInitialBitRate(n,t),n=maybeRemoveVideoFec(n,t);return{sdp:n,type:e.type}}
+/* eslint-disable @typescript-eslint/no-dynamic-delete */
+/* eslint-disable @typescript-eslint/no-unnecessary-type-conversion */
+/* eslint-disable @typescript-eslint/no-use-before-define */
+/* eslint-disable no-prototype-builtins, prefer-destructuring, no-param-reassign */
+// This export function is used for logging.
+export function trace(text) {
+    if (text.endsWith('\n')) {
+        text = text.substring(0, text.length - 1);
+    }
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+    if (window.performance) {
+        const now = (window.performance.now() / 1000).toFixed(3);
+        console.log(`${now}: ${text}`);
+    }
+    else {
+        console.log(text);
+    }
+}
+function iceCandidateType(candidateStr) {
+    return candidateStr.split(' ')[7];
+}
+export function isValidIceCandidate({ candidate }, config) {
+    // const candidateStr = candidateObj.candidate;
+    // Always eat TCP candidates. Not needed in this context.
+    if (!candidate || candidate.includes('tcp')) {
+        return false;
+    }
+    // If we're trying to eat non-relay candidates, do that.
+    if (config?.iceTransportPolicy === 'relay' && iceCandidateType(candidate) !== 'relay') {
+        return false;
+    }
+    return true;
+}
+function maybeSetOpusOptions(sdp, params) {
+    // Set Opus in Stereo, if stereo is true, unset it, if stereo is false, and
+    // do nothing if otherwise.
+    if (params.opusStereo === 'true') {
+        sdp = setCodecParam(sdp, 'opus/48000', 'stereo', '1');
+    }
+    else if (params.opusStereo === 'false') {
+        sdp = removeCodecParam(sdp, 'opus/48000', 'stereo');
+    }
+    // Set Opus FEC, if opusfec is true, unset it, if opusfec is false, and
+    // do nothing if otherwise.
+    if (params.opusFec === 'true') {
+        sdp = setCodecParam(sdp, 'opus/48000', 'useinbandfec', '1');
+    }
+    else if (params.opusFec === 'false') {
+        sdp = removeCodecParam(sdp, 'opus/48000', 'useinbandfec');
+    }
+    // Set Opus DTX, if opusdtx is true, unset it, if opusdtx is false, and
+    // do nothing if otherwise.
+    if (params.opusDtx === 'true') {
+        sdp = setCodecParam(sdp, 'opus/48000', 'usedtx', '1');
+    }
+    else if (params.opusDtx === 'false') {
+        sdp = removeCodecParam(sdp, 'opus/48000', 'usedtx');
+    }
+    // Set Opus maxplaybackrate, if requested.
+    if (params.opusMaxPbr) {
+        sdp = setCodecParam(sdp, 'opus/48000', 'maxplaybackrate', params.opusMaxPbr);
+    }
+    return sdp;
+}
+function maybeSetAudioSendBitRate(sdp, params) {
+    if (!params.audioSendBitrate) {
+        return sdp;
+    }
+    trace(`Prefer audio send bitrate: ${params.audioSendBitrate}`);
+    return preferBitRate(sdp, params.audioSendBitrate, 'audio');
+}
+function maybeSetAudioReceiveBitRate(sdp, params) {
+    if (!params.audioRecvBitrate) {
+        return sdp;
+    }
+    trace(`Prefer audio receive bitrate: ${params.audioRecvBitrate}`);
+    return preferBitRate(sdp, params.audioRecvBitrate, 'audio');
+}
+function maybeSetVideoSendBitRate(sdp, params) {
+    if (!params.videoSendBitrate) {
+        return sdp;
+    }
+    trace(`Prefer video send bitrate: ${params.videoSendBitrate}`);
+    return preferBitRate(sdp, params.videoSendBitrate, 'video');
+}
+function maybeSetVideoReceiveBitRate(sdp, params) {
+    if (!params.videoRecvBitrate) {
+        return sdp;
+    }
+    trace(`Prefer video receive bitrate: ${params.videoRecvBitrate}`);
+    return preferBitRate(sdp, params.videoRecvBitrate, 'video');
+}
+// Add a b=AS:bitrate line to the m=mediaType section.
+function preferBitRate(sdp, bitrate, mediaType) {
+    const sdpLines = sdp.split('\r\n');
+    // Find m line for the given mediaType.
+    const mLineIndex = findLine(sdpLines, 'm=', mediaType);
+    if (mLineIndex === -1) {
+        trace('Failed to add bandwidth line to sdp, as no m-line found');
+        return sdp;
+    }
+    // Find next m-line if any.
+    let nextMLineIndex = findLineInRange(sdpLines, mLineIndex + 1, -1, 'm=');
+    if (nextMLineIndex === -1) {
+        nextMLineIndex = sdpLines.length;
+    }
+    // Find c-line corresponding to the m-line.
+    const cLineIndex = findLineInRange(sdpLines, mLineIndex + 1, nextMLineIndex, 'c=');
+    if (cLineIndex === -1) {
+        trace('Failed to add bandwidth line to sdp, as no c-line found');
+        return sdp;
+    }
+    // Check if bandwidth line already exists between c-line and next m-line.
+    const bLineIndex = findLineInRange(sdpLines, cLineIndex + 1, nextMLineIndex, 'b=AS');
+    if (bLineIndex >= 0) {
+        sdpLines.splice(bLineIndex, 1);
+    }
+    // Create the b (bandwidth) sdp line.
+    const bwLine = `b=AS:${bitrate}`;
+    // As per RFC 4566, the b line should follow after c-line.
+    sdpLines.splice(cLineIndex + 1, 0, bwLine);
+    sdp = sdpLines.join('\r\n');
+    return sdp;
+}
+// Add an a=fmtp: x-google-min-bitrate=kbps line, if videoSendInitialBitrate
+// is specified. We'll also add a x-google-min-bitrate value, since the max
+// must be >= the min.
+function maybeSetVideoSendInitialBitRate(sdp, params) {
+    let initialBitrate = params.videoSendInitialBitrate;
+    if (!initialBitrate) {
+        return sdp;
+    }
+    // Validate the initial bitrate value.
+    let maxBitrate = initialBitrate;
+    const bitrate = params.videoSendBitrate;
+    if (bitrate) {
+        if (initialBitrate > bitrate) {
+            trace(`Clamping initial bitrate to max bitrate of ${bitrate} kbps.`);
+            initialBitrate = bitrate;
+            params.videoSendInitialBitrate = initialBitrate;
+        }
+        maxBitrate = bitrate;
+    }
+    const sdpLines = sdp.split('\r\n');
+    // Search for m line.
+    const mLineIndex = findLine(sdpLines, 'm=', 'video');
+    if (mLineIndex === -1) {
+        trace('Failed to find video m-line');
+        return sdp;
+    }
+    const codec = params.videoRecvCodec || '';
+    sdp = setCodecParam(sdp, codec, 'x-google-min-bitrate', params.videoSendInitialBitrate || '');
+    sdp = setCodecParam(sdp, codec, 'x-google-max-bitrate', maxBitrate.toString());
+    return sdp;
+}
+function removePayloadTypeFromMline(mLine, payloadType) {
+    const lines = mLine.split(' ');
+    const { length } = lines;
+    for (let i = 0; i < length; ++i) {
+        if (lines[i] === payloadType.toString()) {
+            lines.splice(i, 1);
+        }
+    }
+    return lines.join(' ');
+}
+function removeCodecByName(sdpLines, codec) {
+    const index = findLine(sdpLines, 'a=rtpmap', codec);
+    if (index === -1) {
+        return sdpLines;
+    }
+    const payloadType = getCodecPayloadTypeFromLine(sdpLines[index]);
+    sdpLines.splice(index, 1);
+    // Search for the video m= line and remove the codec.
+    const mLineIndex = findLine(sdpLines, 'm=', 'video');
+    if (mLineIndex === -1) {
+        return sdpLines;
+    }
+    sdpLines[mLineIndex] = removePayloadTypeFromMline(sdpLines[mLineIndex], payloadType);
+    return sdpLines;
+}
+function removeCodecByPayloadType(sdpLines, payloadType) {
+    const index = findLine(sdpLines, 'a=rtpmap', payloadType.toString());
+    if (index === -1) {
+        return sdpLines;
+    }
+    sdpLines.splice(index, 1);
+    // Search for the video m= line and remove the codec.
+    const mLineIndex = findLine(sdpLines, 'm=', 'video');
+    if (mLineIndex === -1) {
+        return sdpLines;
+    }
+    sdpLines[mLineIndex] = removePayloadTypeFromMline(sdpLines[mLineIndex], payloadType);
+    return sdpLines;
+}
+function maybeRemoveVideoFec(sdp, params) {
+    if (params.videoFec !== 'false') {
+        return sdp;
+    }
+    let sdpLines = sdp.split('\r\n');
+    let index = findLine(sdpLines, 'a=rtpmap', 'red');
+    if (index === -1) {
+        return sdp;
+    }
+    const redPayloadType = getCodecPayloadTypeFromLine(sdpLines[index]);
+    sdpLines = removeCodecByPayloadType(sdpLines, redPayloadType);
+    sdpLines = removeCodecByName(sdpLines, 'ulpfec');
+    // Remove fmtp lines associated with red codec.
+    index = findLine(sdpLines, 'a=fmtp', redPayloadType.toString());
+    if (index === -1) {
+        return sdp;
+    }
+    const fmtpLine = parseFmtpLine(sdpLines[index]);
+    const rtxPayloadType = fmtpLine.pt;
+    if (rtxPayloadType == null) {
+        return sdp;
+    }
+    sdpLines.splice(index, 1);
+    sdpLines = removeCodecByPayloadType(sdpLines, rtxPayloadType);
+    return sdpLines.join('\r\n');
+}
+// Promotes |audioSendCodec| to be the first in the m=audio line, if set.
+function maybePreferAudioSendCodec(sdp, params) {
+    return maybePreferCodec(sdp, 'audio', 'send', params.audioSendCodec);
+}
+// Promotes |audioRecvCodec| to be the first in the m=audio line, if set.
+function maybePreferAudioReceiveCodec(sdp, params) {
+    return maybePreferCodec(sdp, 'audio', 'receive', params.audioRecvCodec);
+}
+// Promotes |videoSendCodec| to be the first in the m=audio line, if set.
+function maybePreferVideoSendCodec(sdp, params) {
+    return maybePreferCodec(sdp, 'video', 'send', params.videoSendCodec);
+}
+// Promotes |videoRecvCodec| to be the first in the m=audio line, if set.
+function maybePreferVideoReceiveCodec(sdp, params) {
+    return maybePreferCodec(sdp, 'video', 'receive', params.videoRecvCodec);
+}
+// Sets |codec| as the default |type| codec if it's present.
+// The format of |codec| is 'NAME/RATE', e.g. 'opus/48000'.
+function maybePreferCodec(sdp, type, _dir, codec) {
+    // const str = `${type} ${dir} codec`;
+    if (!codec) {
+        // trace(`No preference on ${str}.`);
+        return sdp;
+    }
+    // trace(`Prefer ${str}: ${codec}`);
+    const sdpLines = sdp.split('\r\n');
+    // Search for m line.
+    const mLineIndex = findLine(sdpLines, 'm=', type);
+    if (mLineIndex === -1) {
+        return sdp;
+    }
+    // If the codec is available, set it as the default in m line.
+    const payload = getCodecPayloadType(sdpLines, codec);
+    if (payload) {
+        sdpLines[mLineIndex] = setDefaultCodec(sdpLines[mLineIndex], payload);
+    }
+    sdp = sdpLines.join('\r\n');
+    return sdp;
+}
+// Set fmtp param to specific codec in SDP. If param does not exists, add it.
+function setCodecParam(sdp, codec, param, value) {
+    const sdpLines = sdp.split('\r\n');
+    const fmtpLineIndex = findFmtpLine(sdpLines, codec);
+    if (fmtpLineIndex === null) {
+        const index = findLine(sdpLines, 'a=rtpmap', codec);
+        if (index === -1) {
+            return sdp;
+        }
+        const payload = getCodecPayloadTypeFromLine(sdpLines[index]);
+        const fmtpObj = {
+            pt: payload.toString(),
+            params: { [param]: value },
+        };
+        sdpLines.splice(index + 1, 0, writeFmtpLine(fmtpObj));
+    }
+    else {
+        const fmtpObj = parseFmtpLine(sdpLines[fmtpLineIndex]);
+        fmtpObj.params[param] = value;
+        sdpLines[fmtpLineIndex] = writeFmtpLine(fmtpObj);
+    }
+    sdp = sdpLines.join('\r\n');
+    return sdp;
+}
+// Remove fmtp param if it exists.
+function removeCodecParam(sdp, codec, param) {
+    const sdpLines = sdp.split('\r\n');
+    const fmtpLineIndex = findFmtpLine(sdpLines, codec);
+    if (fmtpLineIndex === null) {
+        return sdp;
+    }
+    const map = parseFmtpLine(sdpLines[fmtpLineIndex]);
+    // if (map) {
+    delete map.params[param];
+    const newLine = writeFmtpLine(map);
+    if (newLine === null) {
+        sdpLines.splice(fmtpLineIndex, 1);
+    }
+    else {
+        sdpLines[fmtpLineIndex] = newLine;
+    }
+    // }
+    sdp = sdpLines.join('\r\n');
+    return sdp;
+}
+// Split an fmtp line into an object including 'pt' and 'params'.
+function parseFmtpLine(fmtpLine) {
+    const fmtpObj = {};
+    const spacePos = fmtpLine.indexOf(' ');
+    const keyValues = fmtpLine.substring(spacePos + 1).split('; ');
+    const pattern = /a=fmtp:(\d+)/;
+    const result = pattern.exec(fmtpLine);
+    if (result?.length === 2) {
+        fmtpObj.pt = result[1];
+    }
+    else {
+        // return null;
+    }
+    const params = {};
+    keyValues.forEach((keyValue) => {
+        const pair = keyValue.split('=');
+        if (pair.length === 2) {
+            params[pair[0]] = pair[1];
+        }
+    });
+    fmtpObj.params = params;
+    return fmtpObj;
+}
+// Generate an fmtp line from an object including 'pt' and 'params'.
+function writeFmtpLine(fmtpObj) {
+    if (!fmtpObj.hasOwnProperty('pt') || !fmtpObj.hasOwnProperty('params')) {
+        // return null;
+        return '';
+    }
+    const { pt = '', params = {} } = fmtpObj;
+    const keyValues = Object.entries(params).map(([key, value]) => `${key}=${value}`);
+    if (keyValues.length === 0) {
+        return '';
+    }
+    return `a=fmtp:${pt.toString()} ${keyValues.join('; ')}`;
+}
+// Find fmtp attribute for |codec| in |sdpLines|.
+function findFmtpLine(sdpLines, codec) {
+    // Find payload of codec.
+    const payload = getCodecPayloadType(sdpLines, codec);
+    // Find the payload in fmtp line.
+    return payload ? findLine(sdpLines, `a=fmtp:${payload.toString()}`) : null;
+}
+// Find the line in sdpLines that starts with |prefix|, and, if specified,
+// contains |substr| (case-insensitive search).
+function findLine(sdpLines, prefix, substr) {
+    return findLineInRange(sdpLines, 0, -1, prefix, substr);
+}
+// Find the line in sdpLines[startLine...endLine - 1] that starts with |prefix|
+// and, if specified, contains |substr| (case-insensitive search).
+function findLineInRange(sdpLines, startLine, endLine, prefix, substr) {
+    const realEndLine = endLine !== -1 ? endLine : sdpLines.length;
+    for (let i = startLine; i < realEndLine; ++i) {
+        if (sdpLines[i].startsWith(prefix)) {
+            if (!substr || sdpLines[i].toLowerCase().includes(substr.toLowerCase())) {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+// Gets the codec payload type from sdp lines.
+function getCodecPayloadType(sdpLines, codec) {
+    const index = findLine(sdpLines, 'a=rtpmap', codec);
+    return index >= 0 ? getCodecPayloadTypeFromLine(sdpLines[index]) : null;
+}
+// Gets the codec payload type from an a=rtpmap:X line.
+function getCodecPayloadTypeFromLine(sdpLine) {
+    const pattern = /a=rtpmap:(\d+) [a-zA-Z0-9-]+\/\d+/;
+    const result = pattern.exec(sdpLine);
+    return result?.length === 2 ? result[1] : '';
+}
+// Returns a new m= line with the specified codec as the first one.
+function setDefaultCodec(mLine, payload) {
+    const elements = mLine.split(' ');
+    // Just copy the first three parameters; codec order starts on fourth.
+    const newLine = elements.slice(0, 3);
+    // Put target payload first and copy in the rest.
+    newLine.push(payload);
+    const { length } = elements;
+    for (let i = 3; i < length; i++) {
+        if (elements[i] !== payload) {
+            newLine.push(elements[i]);
+        }
+    }
+    return newLine.join(' ');
+}
+export function prepareLocalDescription(desc, preferCodecs = {}) {
+    let sdp = maybePreferAudioReceiveCodec(desc.sdp || '', preferCodecs);
+    sdp = maybePreferVideoReceiveCodec(sdp, preferCodecs);
+    sdp = maybeSetAudioReceiveBitRate(sdp, preferCodecs);
+    sdp = maybeSetVideoReceiveBitRate(sdp, preferCodecs);
+    sdp = maybeRemoveVideoFec(sdp, preferCodecs);
+    const newDesc = {
+        sdp,
+        type: desc.type,
+    };
+    return newDesc;
+}
+export function prepareRemoteDescription(desc, preferCodecs = {}) {
+    let sdp = maybeSetOpusOptions(desc.sdp || '', preferCodecs);
+    sdp = maybePreferAudioSendCodec(sdp, preferCodecs);
+    sdp = maybePreferVideoSendCodec(sdp, preferCodecs);
+    sdp = maybeSetAudioSendBitRate(sdp, preferCodecs);
+    sdp = maybeSetVideoSendBitRate(sdp, preferCodecs);
+    sdp = maybeSetVideoSendInitialBitRate(sdp, preferCodecs);
+    sdp = maybeRemoveVideoFec(sdp, preferCodecs);
+    const newDesc = {
+        sdp,
+        type: desc.type,
+    };
+    return newDesc;
+}

package/ws/WSController.js

@@ -1 +1,148 @@
-import ReconnectingWebSocket,{}from"reconnecting-websocket";import{EventEmitter}from"@js-toolkit/utils/EventEmitter";import{delayed}from"@js-toolkit/utils/delayed";import{EventEmitterListener}from"../EventEmitterListener";function getNotConnectedError(){return new Error("The object is not connected yet.")}export class WSController extends EventEmitter{get Events(){return WSController.Events}logger;ws;listener;reconnectOnIdle;halfOpen;constructor(e,t){super();const{logger:n,protocols:s,binaryType:o,idleTimeout:r,halfOpenDetection:i,startClosed:c,...l}=t??{};this.logger=n??console,this.ws=new ReconnectingWebSocket(e,s,{...l,startClosed:!0}),null!=o&&(this.ws.binaryType=o),this.listener=new EventEmitterListener(this.ws),r&&r>0&&(this.reconnectOnIdle=delayed(()=>{this.logger.info(`WS connection reconnecting after ${r}ms due to inactivity.`),this.ws.reconnect()},r)),this.halfOpen=(()=>{if(!i)return;const{pingTimeout:e=12e3,outMessage:t=()=>JSON.stringify({type:"pong"}),inMessageFilter:n=e=>e&&"object"==typeof e&&"ping"===e.type}=i,s=delayed(()=>{this.logger.info(`WS connection reconnecting after ${e}ms due to the probability of a half-open connection.`),this.ws.reconnect()},e),o=()=>{s(),this.ws.send("function"!=typeof t||t instanceof Blob?t:t())};return{heartbeat:o,cancel:()=>s.cancel(),onMessage:({data:e})=>{n(e)?o():s()}}})(),this.listener.on("open",()=>{this.reconnectOnIdle&&this.reconnectOnIdle(),this.halfOpen?.heartbeat(),this.emit(this.Events.Connected)}).on("close",({code:e})=>{this.reconnectOnIdle?.cancel(),this.halfOpen?.cancel(),null!=t?.maxRetries&&this.ws.readyState===this.ws.CLOSED&&this.ws.retryCount===t.maxRetries&&this.close(e,`Failed to connect after ${t.maxRetries} attempts.`)}).on("message",e=>{this.reconnectOnIdle&&this.reconnectOnIdle(),this.halfOpen?.onMessage(e),this.emit(this.Events.Message,e)}).on("error",({error:e,message:t})=>{this.emit(this.Events.Error,{error:e,message:t})}),this.halfOpen&&(this.isConnected()||this.ws.readyState===this.ws.CONNECTING)&&this.halfOpen.heartbeat(),c||this.connect()}isConnected(){return this.ws.readyState===this.ws.OPEN}getUrl(){return this.ws.url}connect(){this.ws.reconnect()}send(e){if(!this.ws)throw getNotConnectedError();this.ws.send(e)}close(e,t){const n=!!this.ws;try{this.reconnectOnIdle&&this.reconnectOnIdle.cancel(),this.halfOpen&&this.halfOpen.cancel(),this.ws.close(e,t)}catch(e){this.logger.warn(e)}n&&this.emit(this.Events.Closed,t?{reason:t}:void 0)}destroy(){this.close(),this.listener.removeAllListeners(),this.removeAllListeners()}[Symbol.dispose](){this.destroy()}}!function(e){let t;!function(e){e.Connected="Connected",e.Message="Message",e.Error="Error",e.Closed="Closed"}(t=e.Events||(e.Events={}))}(WSController||(WSController={}));
+import ReconnectingWebSocket, {} from 'reconnecting-websocket';
+import { EventEmitter } from '@js-toolkit/utils/EventEmitter';
+import { delayed } from '@js-toolkit/utils/delayed';
+import { EventEmitterListener } from '../EventEmitterListener';
+// function getNotConnectedError(): Error {
+//   return new Error('The object is not connected yet.');
+// }
+export class WSController extends EventEmitter {
+    // eslint-disable-next-line class-methods-use-this
+    get Events() {
+        return WSController.Events;
+    }
+    logger;
+    ws;
+    listener;
+    reconnectOnIdle;
+    halfOpen;
+    // private closeInvoked = false;
+    constructor(url, options) {
+        super();
+        const { logger, protocols, binaryType, idleTimeout, halfOpenDetection, startClosed, ...rest } = options ?? {};
+        this.logger = logger ?? console;
+        this.ws = new ReconnectingWebSocket(url, protocols, {
+            ...rest,
+            startClosed: true,
+        });
+        if (binaryType != null) {
+            this.ws.binaryType = binaryType;
+        }
+        this.listener = new EventEmitterListener(this.ws);
+        // reconnect on idle
+        if (idleTimeout != null && idleTimeout > 0) {
+            this.reconnectOnIdle = delayed(() => {
+                this.logger.info(`WS connection reconnecting after ${idleTimeout}ms due to inactivity.`);
+                this.ws.reconnect();
+            }, idleTimeout);
+        }
+        // reconnect on half-open
+        this.halfOpen = (() => {
+            if (!halfOpenDetection)
+                return undefined;
+            const { pingTimeout = 12_000, outMessage = () => JSON.stringify({ type: 'pong' }), inMessageFilter = (message) => message != null && typeof message === 'object' && message.type === 'ping', } = halfOpenDetection;
+            const reconnectOnHalfOpen = delayed(() => {
+                this.logger.info(`WS connection reconnecting after ${pingTimeout}ms due to the probability of a half-open connection.`);
+                this.ws.reconnect();
+            }, pingTimeout);
+            const heartbeat = () => {
+                // console.log('heartbeat');
+                reconnectOnHalfOpen();
+                this.ws.send(typeof outMessage === 'function' && !(outMessage instanceof Blob)
+                    ? outMessage()
+                    : outMessage);
+            };
+            const onMessage = ({ data }) => {
+                if (inMessageFilter(data))
+                    heartbeat();
+                else
+                    reconnectOnHalfOpen(); // Any message signals that the connection still alive.
+            };
+            return { heartbeat, cancel: () => reconnectOnHalfOpen.cancel(), onMessage };
+        })();
+        this.listener
+            .on('open', () => {
+            if (this.reconnectOnIdle)
+                this.reconnectOnIdle();
+            this.halfOpen?.heartbeat();
+            this.emit(this.Events.Connected);
+        })
+            .on('close', ({ code }) => {
+            this.reconnectOnIdle?.cancel();
+            this.halfOpen?.cancel();
+            if (options?.maxRetries != null &&
+                this.ws.readyState === this.ws.CLOSED &&
+                this.ws.retryCount === options.maxRetries) {
+                // Without this call ws will constantly try to reconnect
+                this.close(code, `Failed to connect after ${options.maxRetries} attempts.`);
+            }
+        })
+            .on('message', (event) => {
+            if (this.reconnectOnIdle)
+                this.reconnectOnIdle();
+            this.halfOpen?.onMessage(event);
+            this.emit(this.Events.Message, event);
+        })
+            .on('error', ({ error, message }) => {
+            this.emit(this.Events.Error, { error, message });
+        });
+        if (this.halfOpen && (this.isConnected() || this.ws.readyState === this.ws.CONNECTING)) {
+            this.halfOpen.heartbeat();
+        }
+        if (!startClosed) {
+            this.connect();
+        }
+    }
+    isConnected() {
+        return this.ws.readyState === this.ws.OPEN;
+    }
+    getUrl() {
+        return this.ws.url;
+    }
+    connect() {
+        // this.close()
+        // this.closeInvoked = false;
+        this.ws.reconnect();
+    }
+    send(data) {
+        // if (!this.ws) throw getNotConnectedError();
+        this.ws.send(data);
+    }
+    close(code, reason) {
+        // if (this.closeInvoked) return;
+        // this.closeInvoked = true;
+        // const hasWS = !!this.ws;
+        try {
+            if (this.reconnectOnIdle) {
+                this.reconnectOnIdle.cancel();
+            }
+            if (this.halfOpen) {
+                this.halfOpen.cancel();
+            }
+            this.ws.close(code, reason);
+        }
+        catch (ex) {
+            this.logger.warn(ex);
+        }
+        // if (hasWS) this.emit(this.Events.Closed, reason ? { reason } : undefined);
+        this.emit(this.Events.Closed, reason ? { reason } : undefined);
+    }
+    destroy() {
+        this.close();
+        this.listener.removeAllListeners();
+        this.removeAllListeners();
+    }
+    [Symbol.dispose]() {
+        this.destroy();
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-namespace
+(function (WSController) {
+    let Events;
+    (function (Events) {
+        Events["Connected"] = "Connected";
+        Events["Message"] = "Message";
+        Events["Error"] = "Error";
+        /** If connection was closed and the object will not to try to reconnect */
+        Events["Closed"] = "Closed";
+    })(Events = WSController.Events || (WSController.Events = {}));
+})(WSController || (WSController = {}));