mediasoup-client 3.7.1 → 3.7.3

package/lib/ortc.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.canReceive = exports.canSend = exports.generateProbatorRtpParameters = exports.reduceCodecs = exports.getSendingRemoteRtpParameters = exports.getSendingRtpParameters = exports.getRecvRtpCapabilities = exports.getExtendedRtpCapabilities = exports.validateSctpStreamParameters = exports.validateSctpParameters = exports.validateNumSctpStreams = exports.validateSctpCapabilities = exports.validateRtcpParameters = exports.validateRtpEncodingParameters = exports.validateRtpHeaderExtensionParameters = exports.validateRtpCodecParameters = exports.validateRtpParameters = exports.validateRtpHeaderExtension = exports.validateRtcpFeedback = exports.validateRtpCodecCapability = exports.validateRtpCapabilities = void 0;
+exports.canReceive = exports.canSend = exports.generateProbatorRtpParameters = exports.reduceCodecs = exports.getSendingRemoteRtpParameters = exports.getSendingRtpParameters = exports.getRecvRtpCapabilities = exports.getExtendedRtpCapabilities = exports.validateSctpCapabilities = exports.validateSctpStreamParameters = exports.validateRtpParameters = exports.validateRtpCapabilities = void 0;
 const h264 = __importStar(require("h264-profile-level-id"));
 const utils = __importStar(require("./utils"));
 const RTP_PROBATOR_MID = 'probator';
@@ -60,128 +60,6 @@ function validateRtpCapabilities(caps) {
     }
 }
 exports.validateRtpCapabilities = validateRtpCapabilities;
-/**
- * Validates RtpCodecCapability. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateRtpCodecCapability(codec) {
-    const MimeTypeRegex = new RegExp('^(audio|video)/(.+)', 'i');
-    if (typeof codec !== 'object') {
-        throw new TypeError('codec is not an object');
-    }
-    // mimeType is mandatory.
-    if (!codec.mimeType || typeof codec.mimeType !== 'string') {
-        throw new TypeError('missing codec.mimeType');
-    }
-    const mimeTypeMatch = MimeTypeRegex.exec(codec.mimeType);
-    if (!mimeTypeMatch) {
-        throw new TypeError('invalid codec.mimeType');
-    }
-    // Just override kind with media component of mimeType.
-    codec.kind = mimeTypeMatch[1].toLowerCase();
-    // preferredPayloadType is optional.
-    if (codec.preferredPayloadType && typeof codec.preferredPayloadType !== 'number') {
-        throw new TypeError('invalid codec.preferredPayloadType');
-    }
-    // clockRate is mandatory.
-    if (typeof codec.clockRate !== 'number') {
-        throw new TypeError('missing codec.clockRate');
-    }
-    // channels is optional. If unset, set it to 1 (just if audio).
-    if (codec.kind === 'audio') {
-        if (typeof codec.channels !== 'number') {
-            codec.channels = 1;
-        }
-    }
-    else {
-        delete codec.channels;
-    }
-    // parameters is optional. If unset, set it to an empty object.
-    if (!codec.parameters || typeof codec.parameters !== 'object') {
-        codec.parameters = {};
-    }
-    for (const key of Object.keys(codec.parameters)) {
-        let value = codec.parameters[key];
-        if (value === undefined) {
-            codec.parameters[key] = '';
-            value = '';
-        }
-        if (typeof value !== 'string' && typeof value !== 'number') {
-            throw new TypeError(`invalid codec parameter [key:${key}s, value:${value}]`);
-        }
-        // Specific parameters validation.
-        if (key === 'apt') {
-            if (typeof value !== 'number') {
-                throw new TypeError('invalid codec apt parameter');
-            }
-        }
-    }
-    // rtcpFeedback is optional. If unset, set it to an empty array.
-    if (!codec.rtcpFeedback || !Array.isArray(codec.rtcpFeedback)) {
-        codec.rtcpFeedback = [];
-    }
-    for (const fb of codec.rtcpFeedback) {
-        validateRtcpFeedback(fb);
-    }
-}
-exports.validateRtpCodecCapability = validateRtpCodecCapability;
-/**
- * Validates RtcpFeedback. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateRtcpFeedback(fb) {
-    if (typeof fb !== 'object') {
-        throw new TypeError('fb is not an object');
-    }
-    // type is mandatory.
-    if (!fb.type || typeof fb.type !== 'string') {
-        throw new TypeError('missing fb.type');
-    }
-    // parameter is optional. If unset set it to an empty string.
-    if (!fb.parameter || typeof fb.parameter !== 'string') {
-        fb.parameter = '';
-    }
-}
-exports.validateRtcpFeedback = validateRtcpFeedback;
-/**
- * Validates RtpHeaderExtension. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateRtpHeaderExtension(ext) {
-    if (typeof ext !== 'object') {
-        throw new TypeError('ext is not an object');
-    }
-    // kind is mandatory.
-    if (ext.kind !== 'audio' && ext.kind !== 'video') {
-        throw new TypeError('invalid ext.kind');
-    }
-    // uri is mandatory.
-    if (!ext.uri || typeof ext.uri !== 'string') {
-        throw new TypeError('missing ext.uri');
-    }
-    // preferredId is mandatory.
-    if (typeof ext.preferredId !== 'number') {
-        throw new TypeError('missing ext.preferredId');
-    }
-    // preferredEncrypt is optional. If unset set it to false.
-    if (ext.preferredEncrypt && typeof ext.preferredEncrypt !== 'boolean') {
-        throw new TypeError('invalid ext.preferredEncrypt');
-    }
-    else if (!ext.preferredEncrypt) {
-        ext.preferredEncrypt = false;
-    }
-    // direction is optional. If unset set it to sendrecv.
-    if (ext.direction && typeof ext.direction !== 'string') {
-        throw new TypeError('invalid ext.direction');
-    }
-    else if (!ext.direction) {
-        ext.direction = 'sendrecv';
-    }
-}
-exports.validateRtpHeaderExtension = validateRtpHeaderExtension;
 /**
  * Validates RtpParameters. It may modify given data by adding missing
  * fields with default values.
@@ -233,293 +111,87 @@ function validateRtpParameters(params) {
 }
 exports.validateRtpParameters = validateRtpParameters;
 /**
- * Validates RtpCodecParameters. It may modify given data by adding missing
+ * Validates SctpStreamParameters. It may modify given data by adding missing
  * fields with default values.
  * It throws if invalid.
  */
-function validateRtpCodecParameters(codec) {
-    const MimeTypeRegex = new RegExp('^(audio|video)/(.+)', 'i');
-    if (typeof codec !== 'object') {
-        throw new TypeError('codec is not an object');
+function validateSctpStreamParameters(params) {
+    if (typeof params !== 'object') {
+        throw new TypeError('params is not an object');
     }
-    // mimeType is mandatory.
-    if (!codec.mimeType || typeof codec.mimeType !== 'string') {
-        throw new TypeError('missing codec.mimeType');
+    // streamId is mandatory.
+    if (typeof params.streamId !== 'number') {
+        throw new TypeError('missing params.streamId');
     }
-    const mimeTypeMatch = MimeTypeRegex.exec(codec.mimeType);
-    if (!mimeTypeMatch) {
-        throw new TypeError('invalid codec.mimeType');
+    // ordered is optional.
+    let orderedGiven = false;
+    if (typeof params.ordered === 'boolean') {
+        orderedGiven = true;
     }
-    // payloadType is mandatory.
-    if (typeof codec.payloadType !== 'number') {
-        throw new TypeError('missing codec.payloadType');
+    else {
+        params.ordered = true;
     }
-    // clockRate is mandatory.
-    if (typeof codec.clockRate !== 'number') {
-        throw new TypeError('missing codec.clockRate');
+    // maxPacketLifeTime is optional.
+    if (params.maxPacketLifeTime &&
+        typeof params.maxPacketLifeTime !== 'number') {
+        throw new TypeError('invalid params.maxPacketLifeTime');
     }
-    const kind = mimeTypeMatch[1].toLowerCase();
-    // channels is optional. If unset, set it to 1 (just if audio).
-    if (kind === 'audio') {
-        if (typeof codec.channels !== 'number') {
-            codec.channels = 1;
-        }
+    // maxRetransmits is optional.
+    if (params.maxRetransmits && typeof params.maxRetransmits !== 'number') {
+        throw new TypeError('invalid params.maxRetransmits');
     }
-    else {
-        delete codec.channels;
+    if (params.maxPacketLifeTime && params.maxRetransmits) {
+        throw new TypeError('cannot provide both maxPacketLifeTime and maxRetransmits');
     }
-    // parameters is optional. If unset, set it to an empty object.
-    if (!codec.parameters || typeof codec.parameters !== 'object') {
-        codec.parameters = {};
+    if (orderedGiven &&
+        params.ordered &&
+        (params.maxPacketLifeTime || params.maxRetransmits)) {
+        throw new TypeError('cannot be ordered with maxPacketLifeTime or maxRetransmits');
     }
-    for (const key of Object.keys(codec.parameters)) {
-        let value = codec.parameters[key];
-        if (value === undefined) {
-            codec.parameters[key] = '';
-            value = '';
-        }
-        if (typeof value !== 'string' && typeof value !== 'number') {
-            throw new TypeError(`invalid codec parameter [key:${key}s, value:${value}]`);
-        }
-        // Specific parameters validation.
-        if (key === 'apt') {
-            if (typeof value !== 'number') {
-                throw new TypeError('invalid codec apt parameter');
-            }
-        }
+    else if (!orderedGiven &&
+        (params.maxPacketLifeTime || params.maxRetransmits)) {
+        params.ordered = false;
     }
-    // rtcpFeedback is optional. If unset, set it to an empty array.
-    if (!codec.rtcpFeedback || !Array.isArray(codec.rtcpFeedback)) {
-        codec.rtcpFeedback = [];
+    // label is optional.
+    if (params.label && typeof params.label !== 'string') {
+        throw new TypeError('invalid params.label');
     }
-    for (const fb of codec.rtcpFeedback) {
-        validateRtcpFeedback(fb);
+    // protocol is optional.
+    if (params.protocol && typeof params.protocol !== 'string') {
+        throw new TypeError('invalid params.protocol');
     }
 }
-exports.validateRtpCodecParameters = validateRtpCodecParameters;
+exports.validateSctpStreamParameters = validateSctpStreamParameters;
 /**
- * Validates RtpHeaderExtensionParameteters. It may modify given data by adding missing
+ * Validates SctpCapabilities. It may modify given data by adding missing
  * fields with default values.
  * It throws if invalid.
  */
-function validateRtpHeaderExtensionParameters(ext) {
-    if (typeof ext !== 'object') {
-        throw new TypeError('ext is not an object');
-    }
-    // uri is mandatory.
-    if (!ext.uri || typeof ext.uri !== 'string') {
-        throw new TypeError('missing ext.uri');
-    }
-    // id is mandatory.
-    if (typeof ext.id !== 'number') {
-        throw new TypeError('missing ext.id');
-    }
-    // encrypt is optional. If unset set it to false.
-    if (ext.encrypt && typeof ext.encrypt !== 'boolean') {
-        throw new TypeError('invalid ext.encrypt');
-    }
-    else if (!ext.encrypt) {
-        ext.encrypt = false;
-    }
-    // parameters is optional. If unset, set it to an empty object.
-    if (!ext.parameters || typeof ext.parameters !== 'object') {
-        ext.parameters = {};
+function validateSctpCapabilities(caps) {
+    if (typeof caps !== 'object') {
+        throw new TypeError('caps is not an object');
     }
-    for (const key of Object.keys(ext.parameters)) {
-        let value = ext.parameters[key];
-        if (value === undefined) {
-            ext.parameters[key] = '';
-            value = '';
-        }
-        if (typeof value !== 'string' && typeof value !== 'number') {
-            throw new TypeError('invalid header extension parameter');
-        }
+    // numStreams is mandatory.
+    if (!caps.numStreams || typeof caps.numStreams !== 'object') {
+        throw new TypeError('missing caps.numStreams');
     }
+    validateNumSctpStreams(caps.numStreams);
 }
-exports.validateRtpHeaderExtensionParameters = validateRtpHeaderExtensionParameters;
+exports.validateSctpCapabilities = validateSctpCapabilities;
 /**
- * Validates RtpEncodingParameters. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateRtpEncodingParameters(encoding) {
-    if (typeof encoding !== 'object') {
-        throw new TypeError('encoding is not an object');
-    }
-    // ssrc is optional.
-    if (encoding.ssrc && typeof encoding.ssrc !== 'number') {
-        throw new TypeError('invalid encoding.ssrc');
-    }
-    // rid is optional.
-    if (encoding.rid && typeof encoding.rid !== 'string') {
-        throw new TypeError('invalid encoding.rid');
-    }
-    // rtx is optional.
-    if (encoding.rtx && typeof encoding.rtx !== 'object') {
-        throw new TypeError('invalid encoding.rtx');
-    }
-    else if (encoding.rtx) {
-        // RTX ssrc is mandatory if rtx is present.
-        if (typeof encoding.rtx.ssrc !== 'number') {
-            throw new TypeError('missing encoding.rtx.ssrc');
-        }
-    }
-    // dtx is optional. If unset set it to false.
-    if (!encoding.dtx || typeof encoding.dtx !== 'boolean') {
-        encoding.dtx = false;
-    }
-    // scalabilityMode is optional.
-    if (encoding.scalabilityMode && typeof encoding.scalabilityMode !== 'string') {
-        throw new TypeError('invalid encoding.scalabilityMode');
-    }
-}
-exports.validateRtpEncodingParameters = validateRtpEncodingParameters;
-/**
- * Validates RtcpParameters. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateRtcpParameters(rtcp) {
-    if (typeof rtcp !== 'object') {
-        throw new TypeError('rtcp is not an object');
-    }
-    // cname is optional.
-    if (rtcp.cname && typeof rtcp.cname !== 'string') {
-        throw new TypeError('invalid rtcp.cname');
-    }
-    // reducedSize is optional. If unset set it to true.
-    if (!rtcp.reducedSize || typeof rtcp.reducedSize !== 'boolean') {
-        rtcp.reducedSize = true;
-    }
-}
-exports.validateRtcpParameters = validateRtcpParameters;
-/**
- * Validates SctpCapabilities. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateSctpCapabilities(caps) {
-    if (typeof caps !== 'object') {
-        throw new TypeError('caps is not an object');
-    }
-    // numStreams is mandatory.
-    if (!caps.numStreams || typeof caps.numStreams !== 'object') {
-        throw new TypeError('missing caps.numStreams');
-    }
-    validateNumSctpStreams(caps.numStreams);
-}
-exports.validateSctpCapabilities = validateSctpCapabilities;
-/**
- * Validates NumSctpStreams. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateNumSctpStreams(numStreams) {
-    if (typeof numStreams !== 'object') {
-        throw new TypeError('numStreams is not an object');
-    }
-    // OS is mandatory.
-    if (typeof numStreams.OS !== 'number') {
-        throw new TypeError('missing numStreams.OS');
-    }
-    // MIS is mandatory.
-    if (typeof numStreams.MIS !== 'number') {
-        throw new TypeError('missing numStreams.MIS');
-    }
-}
-exports.validateNumSctpStreams = validateNumSctpStreams;
-/**
- * Validates SctpParameters. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateSctpParameters(params) {
-    if (typeof params !== 'object') {
-        throw new TypeError('params is not an object');
-    }
-    // port is mandatory.
-    if (typeof params.port !== 'number') {
-        throw new TypeError('missing params.port');
-    }
-    // OS is mandatory.
-    if (typeof params.OS !== 'number') {
-        throw new TypeError('missing params.OS');
-    }
-    // MIS is mandatory.
-    if (typeof params.MIS !== 'number') {
-        throw new TypeError('missing params.MIS');
-    }
-    // maxMessageSize is mandatory.
-    if (typeof params.maxMessageSize !== 'number') {
-        throw new TypeError('missing params.maxMessageSize');
-    }
-}
-exports.validateSctpParameters = validateSctpParameters;
-/**
- * Validates SctpStreamParameters. It may modify given data by adding missing
- * fields with default values.
- * It throws if invalid.
- */
-function validateSctpStreamParameters(params) {
-    if (typeof params !== 'object') {
-        throw new TypeError('params is not an object');
-    }
-    // streamId is mandatory.
-    if (typeof params.streamId !== 'number') {
-        throw new TypeError('missing params.streamId');
-    }
-    // ordered is optional.
-    let orderedGiven = false;
-    if (typeof params.ordered === 'boolean') {
-        orderedGiven = true;
-    }
-    else {
-        params.ordered = true;
-    }
-    // maxPacketLifeTime is optional.
-    if (params.maxPacketLifeTime && typeof params.maxPacketLifeTime !== 'number') {
-        throw new TypeError('invalid params.maxPacketLifeTime');
-    }
-    // maxRetransmits is optional.
-    if (params.maxRetransmits && typeof params.maxRetransmits !== 'number') {
-        throw new TypeError('invalid params.maxRetransmits');
-    }
-    if (params.maxPacketLifeTime && params.maxRetransmits) {
-        throw new TypeError('cannot provide both maxPacketLifeTime and maxRetransmits');
-    }
-    if (orderedGiven &&
-        params.ordered &&
-        (params.maxPacketLifeTime || params.maxRetransmits)) {
-        throw new TypeError('cannot be ordered with maxPacketLifeTime or maxRetransmits');
-    }
-    else if (!orderedGiven && (params.maxPacketLifeTime || params.maxRetransmits)) {
-        params.ordered = false;
-    }
-    // label is optional.
-    if (params.label && typeof params.label !== 'string') {
-        throw new TypeError('invalid params.label');
-    }
-    // protocol is optional.
-    if (params.protocol && typeof params.protocol !== 'string') {
-        throw new TypeError('invalid params.protocol');
-    }
-}
-exports.validateSctpStreamParameters = validateSctpStreamParameters;
-/**
- * Generate extended RTP capabilities for sending and receiving.
+ * Generate extended RTP capabilities for sending and receiving.
  */
 function getExtendedRtpCapabilities(localCaps, remoteCaps) {
     const extendedRtpCapabilities = {
         codecs: [],
-        headerExtensions: []
+        headerExtensions: [],
     };
     // Match media codecs and keep the order preferred by remoteCaps.
     for (const remoteCodec of remoteCaps.codecs || []) {
         if (isRtxCodec(remoteCodec)) {
             continue;
         }
-        const matchingLocalCodec = (localCaps.codecs || [])
-            .find((localCodec) => (matchCodecs(localCodec, remoteCodec, { strict: true, modify: true })));
+        const matchingLocalCodec = (localCaps.codecs || []).find((localCodec) => matchCodecs(localCodec, remoteCodec, { strict: true, modify: true }));
         if (!matchingLocalCodec) {
             continue;
         }
@@ -534,27 +206,26 @@ function getExtendedRtpCapabilities(localCaps, remoteCaps) {
             remoteRtxPayloadType: undefined,
             localParameters: matchingLocalCodec.parameters,
             remoteParameters: remoteCodec.parameters,
-            rtcpFeedback: reduceRtcpFeedback(matchingLocalCodec, remoteCodec)
+            rtcpFeedback: reduceRtcpFeedback(matchingLocalCodec, remoteCodec),
         };
         extendedRtpCapabilities.codecs.push(extendedCodec);
     }
     // Match RTX codecs.
     for (const extendedCodec of extendedRtpCapabilities.codecs) {
-        const matchingLocalRtxCodec = localCaps.codecs
-            .find((localCodec) => (isRtxCodec(localCodec) &&
-            localCodec.parameters.apt === extendedCodec.localPayloadType));
-        const matchingRemoteRtxCodec = remoteCaps.codecs
-            .find((remoteCodec) => (isRtxCodec(remoteCodec) &&
-            remoteCodec.parameters.apt === extendedCodec.remotePayloadType));
+        const matchingLocalRtxCodec = localCaps.codecs.find((localCodec) => isRtxCodec(localCodec) &&
+            localCodec.parameters.apt === extendedCodec.localPayloadType);
+        const matchingRemoteRtxCodec = remoteCaps.codecs.find((remoteCodec) => isRtxCodec(remoteCodec) &&
+            remoteCodec.parameters.apt === extendedCodec.remotePayloadType);
         if (matchingLocalRtxCodec && matchingRemoteRtxCodec) {
-            extendedCodec.localRtxPayloadType = matchingLocalRtxCodec.preferredPayloadType;
-            extendedCodec.remoteRtxPayloadType = matchingRemoteRtxCodec.preferredPayloadType;
+            extendedCodec.localRtxPayloadType =
+                matchingLocalRtxCodec.preferredPayloadType;
+            extendedCodec.remoteRtxPayloadType =
+                matchingRemoteRtxCodec.preferredPayloadType;
         }
     }
     // Match header extensions.
     for (const remoteExt of remoteCaps.headerExtensions) {
-        const matchingLocalExt = localCaps.headerExtensions
-            .find((localExt) => (matchHeaderExtensions(localExt, remoteExt)));
+        const matchingLocalExt = localCaps.headerExtensions.find((localExt) => matchHeaderExtensions(localExt, remoteExt));
         if (!matchingLocalExt) {
             continue;
         }
@@ -564,29 +235,25 @@ function getExtendedRtpCapabilities(localCaps, remoteCaps) {
             sendId: matchingLocalExt.preferredId,
             recvId: remoteExt.preferredId,
             encrypt: matchingLocalExt.preferredEncrypt,
-            direction: 'sendrecv'
+            direction: 'sendrecv',
         };
         switch (remoteExt.direction) {
-            case 'sendrecv':
-                {
-                    extendedExt.direction = 'sendrecv';
-                    break;
-                }
-            case 'recvonly':
-                {
-                    extendedExt.direction = 'sendonly';
-                    break;
-                }
-            case 'sendonly':
-                {
-                    extendedExt.direction = 'recvonly';
-                    break;
-                }
-            case 'inactive':
-                {
-                    extendedExt.direction = 'inactive';
-                    break;
-                }
+            case 'sendrecv': {
+                extendedExt.direction = 'sendrecv';
+                break;
+            }
+            case 'recvonly': {
+                extendedExt.direction = 'sendonly';
+                break;
+            }
+            case 'sendonly': {
+                extendedExt.direction = 'recvonly';
+                break;
+            }
+            case 'inactive': {
+                extendedExt.direction = 'inactive';
+                break;
+            }
         }
         extendedRtpCapabilities.headerExtensions.push(extendedExt);
     }
@@ -600,7 +267,7 @@ exports.getExtendedRtpCapabilities = getExtendedRtpCapabilities;
 function getRecvRtpCapabilities(extendedRtpCapabilities) {
     const rtpCapabilities = {
         codecs: [],
-        headerExtensions: []
+        headerExtensions: [],
     };
     for (const extendedCodec of extendedRtpCapabilities.codecs) {
         const codec = {
@@ -610,7 +277,7 @@ function getRecvRtpCapabilities(extendedRtpCapabilities) {
             clockRate: extendedCodec.clockRate,
             channels: extendedCodec.channels,
             parameters: extendedCodec.localParameters,
-            rtcpFeedback: extendedCodec.rtcpFeedback
+            rtcpFeedback: extendedCodec.rtcpFeedback,
         };
         rtpCapabilities.codecs.push(codec);
         // Add RTX codec.
@@ -623,9 +290,9 @@ function getRecvRtpCapabilities(extendedRtpCapabilities) {
             preferredPayloadType: extendedCodec.remoteRtxPayloadType,
             clockRate: extendedCodec.clockRate,
             parameters: {
-                apt: extendedCodec.remotePayloadType
+                apt: extendedCodec.remotePayloadType,
             },
-            rtcpFeedback: []
+            rtcpFeedback: [],
         };
         rtpCapabilities.codecs.push(rtxCodec);
         // TODO: In the future, we need to add FEC, CN, etc, codecs.
@@ -641,7 +308,7 @@ function getRecvRtpCapabilities(extendedRtpCapabilities) {
             uri: extendedExtension.uri,
             preferredId: extendedExtension.recvId,
             preferredEncrypt: extendedExtension.encrypt,
-            direction: extendedExtension.direction
+            direction: extendedExtension.direction,
         };
         rtpCapabilities.headerExtensions.push(ext);
     }
@@ -658,7 +325,7 @@ function getSendingRtpParameters(kind, extendedRtpCapabilities) {
         codecs: [],
         headerExtensions: [],
         encodings: [],
-        rtcp: {}
+        rtcp: {},
     };
     for (const extendedCodec of extendedRtpCapabilities.codecs) {
         if (extendedCodec.kind !== kind) {
@@ -670,7 +337,7 @@ function getSendingRtpParameters(kind, extendedRtpCapabilities) {
             clockRate: extendedCodec.clockRate,
             channels: extendedCodec.channels,
             parameters: extendedCodec.localParameters,
-            rtcpFeedback: extendedCodec.rtcpFeedback
+            rtcpFeedback: extendedCodec.rtcpFeedback,
         };
         rtpParameters.codecs.push(codec);
         // Add RTX codec.
@@ -680,9 +347,9 @@ function getSendingRtpParameters(kind, extendedRtpCapabilities) {
                 payloadType: extendedCodec.localRtxPayloadType,
                 clockRate: extendedCodec.clockRate,
                 parameters: {
-                    apt: extendedCodec.localPayloadType
+                    apt: extendedCodec.localPayloadType,
                 },
-                rtcpFeedback: []
+                rtcpFeedback: [],
             };
             rtpParameters.codecs.push(rtxCodec);
         }
@@ -698,7 +365,7 @@ function getSendingRtpParameters(kind, extendedRtpCapabilities) {
             uri: extendedExtension.uri,
             id: extendedExtension.sendId,
             encrypt: extendedExtension.encrypt,
-            parameters: {}
+            parameters: {},
         };
         rtpParameters.headerExtensions.push(ext);
     }
@@ -714,7 +381,7 @@ function getSendingRemoteRtpParameters(kind, extendedRtpCapabilities) {
         codecs: [],
         headerExtensions: [],
         encodings: [],
-        rtcp: {}
+        rtcp: {},
     };
     for (const extendedCodec of extendedRtpCapabilities.codecs) {
         if (extendedCodec.kind !== kind) {
@@ -726,7 +393,7 @@ function getSendingRemoteRtpParameters(kind, extendedRtpCapabilities) {
             clockRate: extendedCodec.clockRate,
             channels: extendedCodec.channels,
             parameters: extendedCodec.remoteParameters,
-            rtcpFeedback: extendedCodec.rtcpFeedback
+            rtcpFeedback: extendedCodec.rtcpFeedback,
         };
         rtpParameters.codecs.push(codec);
         // Add RTX codec.
@@ -736,9 +403,9 @@ function getSendingRemoteRtpParameters(kind, extendedRtpCapabilities) {
                 payloadType: extendedCodec.localRtxPayloadType,
                 clockRate: extendedCodec.clockRate,
                 parameters: {
-                    apt: extendedCodec.localPayloadType
+                    apt: extendedCodec.localPayloadType,
                 },
-                rtcpFeedback: []
+                rtcpFeedback: [],
             };
             rtpParameters.codecs.push(rtxCodec);
         }
@@ -754,28 +421,25 @@ function getSendingRemoteRtpParameters(kind, extendedRtpCapabilities) {
             uri: extendedExtension.uri,
             id: extendedExtension.sendId,
             encrypt: extendedExtension.encrypt,
-            parameters: {}
+            parameters: {},
         };
         rtpParameters.headerExtensions.push(ext);
     }
     // Reduce codecs' RTCP feedback. Use Transport-CC if available, REMB otherwise.
-    if (rtpParameters.headerExtensions.some((ext) => (ext.uri === 'http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01'))) {
+    if (rtpParameters.headerExtensions.some(ext => ext.uri ===
+        'http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01')) {
         for (const codec of rtpParameters.codecs) {
-            codec.rtcpFeedback = (codec.rtcpFeedback || [])
-                .filter((fb) => fb.type !== 'goog-remb');
+            codec.rtcpFeedback = (codec.rtcpFeedback || []).filter((fb) => fb.type !== 'goog-remb');
         }
     }
-    else if (rtpParameters.headerExtensions.some((ext) => (ext.uri === 'http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time'))) {
+    else if (rtpParameters.headerExtensions.some(ext => ext.uri === 'http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time')) {
         for (const codec of rtpParameters.codecs) {
-            codec.rtcpFeedback = (codec.rtcpFeedback || [])
-                .filter((fb) => fb.type !== 'transport-cc');
+            codec.rtcpFeedback = (codec.rtcpFeedback || []).filter(fb => fb.type !== 'transport-cc');
         }
     }
     else {
         for (const codec of rtpParameters.codecs) {
-            codec.rtcpFeedback = (codec.rtcpFeedback || [])
-                .filter((fb) => (fb.type !== 'transport-cc' &&
-                fb.type !== 'goog-remb'));
+            codec.rtcpFeedback = (codec.rtcpFeedback || []).filter((fb) => fb.type !== 'transport-cc' && fb.type !== 'goog-remb');
         }
     }
     return rtpParameters;
@@ -831,7 +495,7 @@ function generateProbatorRtpParameters(videoRtpParameters) {
         codecs: [],
         headerExtensions: [],
         encodings: [{ ssrc: RTP_PROBATOR_SSRC }],
-        rtcp: { cname: 'probator' }
+        rtcp: { cname: 'probator' },
     };
     rtpParameters.codecs.push(videoRtpParameters.codecs[0]);
     rtpParameters.codecs[0].payloadType = RTP_PROBATOR_CODEC_PAYLOAD_TYPE;
@@ -843,8 +507,7 @@ exports.generateProbatorRtpParameters = generateProbatorRtpParameters;
  * Whether media can be sent based on the given RTP capabilities.
  */
 function canSend(kind, extendedRtpCapabilities) {
-    return extendedRtpCapabilities.codecs.
-        some((codec) => codec.kind === kind);
+    return extendedRtpCapabilities.codecs.some((codec) => codec.kind === kind);
 }
 exports.canSend = canSend;
 /**
@@ -858,10 +521,305 @@ function canReceive(rtpParameters, extendedRtpCapabilities) {
         return false;
     }
     const firstMediaCodec = rtpParameters.codecs[0];
-    return extendedRtpCapabilities.codecs
-        .some((codec) => codec.remotePayloadType === firstMediaCodec.payloadType);
+    return extendedRtpCapabilities.codecs.some((codec) => codec.remotePayloadType === firstMediaCodec.payloadType);
 }
 exports.canReceive = canReceive;
+/**
+ * Validates RtpCodecCapability. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateRtpCodecCapability(codec) {
+    const MimeTypeRegex = new RegExp('^(audio|video)/(.+)', 'i');
+    if (typeof codec !== 'object') {
+        throw new TypeError('codec is not an object');
+    }
+    // mimeType is mandatory.
+    if (!codec.mimeType || typeof codec.mimeType !== 'string') {
+        throw new TypeError('missing codec.mimeType');
+    }
+    const mimeTypeMatch = MimeTypeRegex.exec(codec.mimeType);
+    if (!mimeTypeMatch) {
+        throw new TypeError('invalid codec.mimeType');
+    }
+    // Just override kind with media component of mimeType.
+    codec.kind = mimeTypeMatch[1].toLowerCase();
+    // preferredPayloadType is optional.
+    if (codec.preferredPayloadType &&
+        typeof codec.preferredPayloadType !== 'number') {
+        throw new TypeError('invalid codec.preferredPayloadType');
+    }
+    // clockRate is mandatory.
+    if (typeof codec.clockRate !== 'number') {
+        throw new TypeError('missing codec.clockRate');
+    }
+    // channels is optional. If unset, set it to 1 (just if audio).
+    if (codec.kind === 'audio') {
+        if (typeof codec.channels !== 'number') {
+            codec.channels = 1;
+        }
+    }
+    else {
+        delete codec.channels;
+    }
+    // parameters is optional. If unset, set it to an empty object.
+    if (!codec.parameters || typeof codec.parameters !== 'object') {
+        codec.parameters = {};
+    }
+    for (const key of Object.keys(codec.parameters)) {
+        let value = codec.parameters[key];
+        if (value === undefined) {
+            codec.parameters[key] = '';
+            value = '';
+        }
+        if (typeof value !== 'string' && typeof value !== 'number') {
+            throw new TypeError(`invalid codec parameter [key:${key}s, value:${value}]`);
+        }
+        // Specific parameters validation.
+        if (key === 'apt') {
+            if (typeof value !== 'number') {
+                throw new TypeError('invalid codec apt parameter');
+            }
+        }
+    }
+    // rtcpFeedback is optional. If unset, set it to an empty array.
+    if (!codec.rtcpFeedback || !Array.isArray(codec.rtcpFeedback)) {
+        codec.rtcpFeedback = [];
+    }
+    for (const fb of codec.rtcpFeedback) {
+        validateRtcpFeedback(fb);
+    }
+}
+/**
+ * Validates RtcpFeedback. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateRtcpFeedback(fb) {
+    if (typeof fb !== 'object') {
+        throw new TypeError('fb is not an object');
+    }
+    // type is mandatory.
+    if (!fb.type || typeof fb.type !== 'string') {
+        throw new TypeError('missing fb.type');
+    }
+    // parameter is optional. If unset set it to an empty string.
+    if (!fb.parameter || typeof fb.parameter !== 'string') {
+        fb.parameter = '';
+    }
+}
+/**
+ * Validates RtpHeaderExtension. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateRtpHeaderExtension(ext) {
+    if (typeof ext !== 'object') {
+        throw new TypeError('ext is not an object');
+    }
+    // kind is mandatory.
+    if (ext.kind !== 'audio' && ext.kind !== 'video') {
+        throw new TypeError('invalid ext.kind');
+    }
+    // uri is mandatory.
+    if (!ext.uri || typeof ext.uri !== 'string') {
+        throw new TypeError('missing ext.uri');
+    }
+    // preferredId is mandatory.
+    if (typeof ext.preferredId !== 'number') {
+        throw new TypeError('missing ext.preferredId');
+    }
+    // preferredEncrypt is optional. If unset set it to false.
+    if (ext.preferredEncrypt && typeof ext.preferredEncrypt !== 'boolean') {
+        throw new TypeError('invalid ext.preferredEncrypt');
+    }
+    else if (!ext.preferredEncrypt) {
+        ext.preferredEncrypt = false;
+    }
+    // direction is optional. If unset set it to sendrecv.
+    if (ext.direction && typeof ext.direction !== 'string') {
+        throw new TypeError('invalid ext.direction');
+    }
+    else if (!ext.direction) {
+        ext.direction = 'sendrecv';
+    }
+}
+/**
+ * Validates RtpCodecParameters. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateRtpCodecParameters(codec) {
+    const MimeTypeRegex = new RegExp('^(audio|video)/(.+)', 'i');
+    if (typeof codec !== 'object') {
+        throw new TypeError('codec is not an object');
+    }
+    // mimeType is mandatory.
+    if (!codec.mimeType || typeof codec.mimeType !== 'string') {
+        throw new TypeError('missing codec.mimeType');
+    }
+    const mimeTypeMatch = MimeTypeRegex.exec(codec.mimeType);
+    if (!mimeTypeMatch) {
+        throw new TypeError('invalid codec.mimeType');
+    }
+    // payloadType is mandatory.
+    if (typeof codec.payloadType !== 'number') {
+        throw new TypeError('missing codec.payloadType');
+    }
+    // clockRate is mandatory.
+    if (typeof codec.clockRate !== 'number') {
+        throw new TypeError('missing codec.clockRate');
+    }
+    const kind = mimeTypeMatch[1].toLowerCase();
+    // channels is optional. If unset, set it to 1 (just if audio).
+    if (kind === 'audio') {
+        if (typeof codec.channels !== 'number') {
+            codec.channels = 1;
+        }
+    }
+    else {
+        delete codec.channels;
+    }
+    // parameters is optional. If unset, set it to an empty object.
+    if (!codec.parameters || typeof codec.parameters !== 'object') {
+        codec.parameters = {};
+    }
+    for (const key of Object.keys(codec.parameters)) {
+        let value = codec.parameters[key];
+        if (value === undefined) {
+            codec.parameters[key] = '';
+            value = '';
+        }
+        if (typeof value !== 'string' && typeof value !== 'number') {
+            throw new TypeError(`invalid codec parameter [key:${key}s, value:${value}]`);
+        }
+        // Specific parameters validation.
+        if (key === 'apt') {
+            if (typeof value !== 'number') {
+                throw new TypeError('invalid codec apt parameter');
+            }
+        }
+    }
+    // rtcpFeedback is optional. If unset, set it to an empty array.
+    if (!codec.rtcpFeedback || !Array.isArray(codec.rtcpFeedback)) {
+        codec.rtcpFeedback = [];
+    }
+    for (const fb of codec.rtcpFeedback) {
+        validateRtcpFeedback(fb);
+    }
+}
+/**
+ * Validates RtpHeaderExtensionParameteters. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateRtpHeaderExtensionParameters(ext) {
+    if (typeof ext !== 'object') {
+        throw new TypeError('ext is not an object');
+    }
+    // uri is mandatory.
+    if (!ext.uri || typeof ext.uri !== 'string') {
+        throw new TypeError('missing ext.uri');
+    }
+    // id is mandatory.
+    if (typeof ext.id !== 'number') {
+        throw new TypeError('missing ext.id');
+    }
+    // encrypt is optional. If unset set it to false.
+    if (ext.encrypt && typeof ext.encrypt !== 'boolean') {
+        throw new TypeError('invalid ext.encrypt');
+    }
+    else if (!ext.encrypt) {
+        ext.encrypt = false;
+    }
+    // parameters is optional. If unset, set it to an empty object.
+    if (!ext.parameters || typeof ext.parameters !== 'object') {
+        ext.parameters = {};
+    }
+    for (const key of Object.keys(ext.parameters)) {
+        let value = ext.parameters[key];
+        if (value === undefined) {
+            ext.parameters[key] = '';
+            value = '';
+        }
+        if (typeof value !== 'string' && typeof value !== 'number') {
+            throw new TypeError('invalid header extension parameter');
+        }
+    }
+}
+/**
+ * Validates RtpEncodingParameters. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateRtpEncodingParameters(encoding) {
+    if (typeof encoding !== 'object') {
+        throw new TypeError('encoding is not an object');
+    }
+    // ssrc is optional.
+    if (encoding.ssrc && typeof encoding.ssrc !== 'number') {
+        throw new TypeError('invalid encoding.ssrc');
+    }
+    // rid is optional.
+    if (encoding.rid && typeof encoding.rid !== 'string') {
+        throw new TypeError('invalid encoding.rid');
+    }
+    // rtx is optional.
+    if (encoding.rtx && typeof encoding.rtx !== 'object') {
+        throw new TypeError('invalid encoding.rtx');
+    }
+    else if (encoding.rtx) {
+        // RTX ssrc is mandatory if rtx is present.
+        if (typeof encoding.rtx.ssrc !== 'number') {
+            throw new TypeError('missing encoding.rtx.ssrc');
+        }
+    }
+    // dtx is optional. If unset set it to false.
+    if (!encoding.dtx || typeof encoding.dtx !== 'boolean') {
+        encoding.dtx = false;
+    }
+    // scalabilityMode is optional.
+    if (encoding.scalabilityMode &&
+        typeof encoding.scalabilityMode !== 'string') {
+        throw new TypeError('invalid encoding.scalabilityMode');
+    }
+}
+/**
+ * Validates RtcpParameters. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateRtcpParameters(rtcp) {
+    if (typeof rtcp !== 'object') {
+        throw new TypeError('rtcp is not an object');
+    }
+    // cname is optional.
+    if (rtcp.cname && typeof rtcp.cname !== 'string') {
+        throw new TypeError('invalid rtcp.cname');
+    }
+    // reducedSize is optional. If unset set it to true.
+    if (!rtcp.reducedSize || typeof rtcp.reducedSize !== 'boolean') {
+        rtcp.reducedSize = true;
+    }
+}
+/**
+ * Validates NumSctpStreams. It may modify given data by adding missing
+ * fields with default values.
+ * It throws if invalid.
+ */
+function validateNumSctpStreams(numStreams) {
+    if (typeof numStreams !== 'object') {
+        throw new TypeError('numStreams is not an object');
+    }
+    // OS is mandatory.
+    if (typeof numStreams.OS !== 'number') {
+        throw new TypeError('missing numStreams.OS');
+    }
+    // MIS is mandatory.
+    if (typeof numStreams.MIS !== 'number') {
+        throw new TypeError('missing numStreams.MIS');
+    }
+}
 function isRtxCodec(codec) {
     if (!codec) {
         return false;
@@ -882,49 +840,46 @@ function matchCodecs(aCodec, bCodec, { strict = false, modify = false } = {}) {
     }
     // Per codec special checks.
     switch (aMimeType) {
-        case 'video/h264':
-            {
-                if (strict) {
-                    const aPacketizationMode = aCodec.parameters['packetization-mode'] || 0;
-                    const bPacketizationMode = bCodec.parameters['packetization-mode'] || 0;
-                    if (aPacketizationMode !== bPacketizationMode) {
-                        return false;
-                    }
-                    if (!h264.isSameProfile(aCodec.parameters, bCodec.parameters)) {
-                        return false;
-                    }
-                    let selectedProfileLevelId;
-                    try {
-                        selectedProfileLevelId =
-                            h264.generateProfileLevelIdForAnswer(aCodec.parameters, bCodec.parameters);
-                    }
-                    catch (error) {
-                        return false;
+        case 'video/h264': {
+            if (strict) {
+                const aPacketizationMode = aCodec.parameters['packetization-mode'] || 0;
+                const bPacketizationMode = bCodec.parameters['packetization-mode'] || 0;
+                if (aPacketizationMode !== bPacketizationMode) {
+                    return false;
+                }
+                if (!h264.isSameProfile(aCodec.parameters, bCodec.parameters)) {
+                    return false;
+                }
+                let selectedProfileLevelId;
+                try {
+                    selectedProfileLevelId = h264.generateProfileLevelIdStringForAnswer(aCodec.parameters, bCodec.parameters);
+                }
+                catch (error) {
+                    return false;
+                }
+                if (modify) {
+                    if (selectedProfileLevelId) {
+                        aCodec.parameters['profile-level-id'] = selectedProfileLevelId;
+                        bCodec.parameters['profile-level-id'] = selectedProfileLevelId;
                     }
-                    if (modify) {
-                        if (selectedProfileLevelId) {
-                            aCodec.parameters['profile-level-id'] = selectedProfileLevelId;
-                            bCodec.parameters['profile-level-id'] = selectedProfileLevelId;
-                        }
-                        else {
-                            delete aCodec.parameters['profile-level-id'];
-                            delete bCodec.parameters['profile-level-id'];
-                        }
+                    else {
+                        delete aCodec.parameters['profile-level-id'];
+                        delete bCodec.parameters['profile-level-id'];
                     }
                 }
-                break;
             }
-        case 'video/vp9':
-            {
-                if (strict) {
-                    const aProfileId = aCodec.parameters['profile-id'] || 0;
-                    const bProfileId = bCodec.parameters['profile-id'] || 0;
-                    if (aProfileId !== bProfileId) {
-                        return false;
-                    }
+            break;
+        }
+        case 'video/vp9': {
+            if (strict) {
+                const aProfileId = aCodec.parameters['profile-id'] || 0;
+                const bProfileId = bCodec.parameters['profile-id'] || 0;
+                if (aProfileId !== bProfileId) {
+                    return false;
                 }
-                break;
             }
+            break;
+        }
     }
     return true;
 }
@@ -940,9 +895,8 @@ function matchHeaderExtensions(aExt, bExt) {
 function reduceRtcpFeedback(codecA, codecB) {
     const reducedRtcpFeedback = [];
     for (const aFb of codecA.rtcpFeedback || []) {
-        const matchingBFb = (codecB.rtcpFeedback || [])
-            .find((bFb) => (bFb.type === aFb.type &&
-            (bFb.parameter === aFb.parameter || (!bFb.parameter && !aFb.parameter))));
+        const matchingBFb = (codecB.rtcpFeedback || []).find((bFb) => bFb.type === aFb.type &&
+            (bFb.parameter === aFb.parameter || (!bFb.parameter && !aFb.parameter)));
         if (matchingBFb) {
             reducedRtcpFeedback.push(matchingBFb);
         }