livekit-client 2.0.10 → 2.1.0

package/dist/livekit-client.e2ee.worker.mjs

@@ -55,6 +55,8 @@ var loglevel = {exports: {}};
     var undefinedType = "undefined";
     var isIE = typeof window !== undefinedType && typeof window.navigator !== undefinedType && /Trident\/|MSIE /.test(window.navigator.userAgent);
     var logMethods = ["trace", "debug", "info", "warn", "error"];
+    var _loggersByName = {};
+    var defaultLogger = null;
 
     // Cross-browser bind equivalent that works at least back to IE6
     function bindMethod(obj, methodName) {
@@ -107,23 +109,31 @@ var loglevel = {exports: {}};
 
     // These private functions always need `this` to be set properly
 
-    function replaceLoggingMethods(level, loggerName) {
+    function replaceLoggingMethods() {
       /*jshint validthis:true */
+      var level = this.getLevel();
+
+      // Replace the actual methods.
       for (var i = 0; i < logMethods.length; i++) {
         var methodName = logMethods[i];
-        this[methodName] = i < level ? noop : this.methodFactory(methodName, level, loggerName);
+        this[methodName] = i < level ? noop : this.methodFactory(methodName, level, this.name);
       }
 
       // Define log.log as an alias for log.debug
       this.log = this.debug;
+
+      // Return any important warnings.
+      if (typeof console === undefinedType && level < this.levels.SILENT) {
+        return "No console available for logging";
+      }
     }
 
     // In old IE versions, the console isn't present until you first open it.
     // We build realMethod() replacements here that regenerate logging methods
-    function enableLoggingWhenConsoleArrives(methodName, level, loggerName) {
+    function enableLoggingWhenConsoleArrives(methodName) {
       return function () {
         if (typeof console !== undefinedType) {
-          replaceLoggingMethods.call(this, level, loggerName);
+          replaceLoggingMethods.call(this);
           this[methodName].apply(this, arguments);
         }
       };
@@ -131,14 +141,34 @@ var loglevel = {exports: {}};
 
     // By default, we use closely bound real methods wherever possible, and
     // otherwise we wait for a console to appear, and then try again.
-    function defaultMethodFactory(methodName, level, loggerName) {
+    function defaultMethodFactory(methodName, _level, _loggerName) {
       /*jshint validthis:true */
       return realMethod(methodName) || enableLoggingWhenConsoleArrives.apply(this, arguments);
     }
-    function Logger(name, defaultLevel, factory) {
+    function Logger(name, factory) {
+      // Private instance variables.
       var self = this;
-      var currentLevel;
-      defaultLevel = defaultLevel == null ? "WARN" : defaultLevel;
+      /**
+       * The level inherited from a parent logger (or a global default). We
+       * cache this here rather than delegating to the parent so that it stays
+       * in sync with the actual logging methods that we have installed (the
+       * parent could change levels but we might not have rebuilt the loggers
+       * in this child yet).
+       * @type {number}
+       */
+      var inheritedLevel;
+      /**
+       * The default level for this logger, if any. If set, this overrides
+       * `inheritedLevel`.
+       * @type {number|null}
+       */
+      var defaultLevel;
+      /**
+       * A user-specific level for this logger. If set, this overrides
+       * `defaultLevel`.
+       * @type {number|null}
+       */
+      var userLevel;
       var storageKey = "loglevel";
       if (typeof name === "string") {
         storageKey += ":" + name;
@@ -171,9 +201,10 @@ var loglevel = {exports: {}};
         if (typeof storedLevel === undefinedType) {
           try {
             var cookie = window.document.cookie;
-            var location = cookie.indexOf(encodeURIComponent(storageKey) + "=");
+            var cookieName = encodeURIComponent(storageKey);
+            var location = cookie.indexOf(cookieName + "=");
             if (location !== -1) {
-              storedLevel = /^([^;]+)/.exec(cookie.slice(location))[1];
+              storedLevel = /^([^;]+)/.exec(cookie.slice(location + cookieName.length + 1))[1];
             }
           } catch (ignore) {}
         }
@@ -190,7 +221,6 @@ var loglevel = {exports: {}};
         // Use localStorage if available
         try {
           window.localStorage.removeItem(storageKey);
-          return;
         } catch (ignore) {}
 
         // Use session cookie as fallback
@@ -198,6 +228,17 @@ var loglevel = {exports: {}};
           window.document.cookie = encodeURIComponent(storageKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 UTC";
         } catch (ignore) {}
       }
+      function normalizeLevel(input) {
+        var level = input;
+        if (typeof level === "string" && self.levels[level.toUpperCase()] !== undefined) {
+          level = self.levels[level.toUpperCase()];
+        }
+        if (typeof level === "number" && level >= 0 && level <= self.levels.SILENT) {
+          return level;
+        } else {
+          throw new TypeError("log.setLevel() called with invalid level: " + input);
+        }
+      }
 
       /*
        *
@@ -216,35 +257,34 @@ var loglevel = {exports: {}};
       };
       self.methodFactory = factory || defaultMethodFactory;
       self.getLevel = function () {
-        return currentLevel;
+        if (userLevel != null) {
+          return userLevel;
+        } else if (defaultLevel != null) {
+          return defaultLevel;
+        } else {
+          return inheritedLevel;
+        }
       };
       self.setLevel = function (level, persist) {
-        if (typeof level === "string" && self.levels[level.toUpperCase()] !== undefined) {
-          level = self.levels[level.toUpperCase()];
-        }
-        if (typeof level === "number" && level >= 0 && level <= self.levels.SILENT) {
-          currentLevel = level;
-          if (persist !== false) {
-            // defaults to true
-            persistLevelIfPossible(level);
-          }
-          replaceLoggingMethods.call(self, level, name);
-          if (typeof console === undefinedType && level < self.levels.SILENT) {
-            return "No console available for logging";
-          }
-        } else {
-          throw "log.setLevel() called with invalid level: " + level;
+        userLevel = normalizeLevel(level);
+        if (persist !== false) {
+          // defaults to true
+          persistLevelIfPossible(userLevel);
         }
+
+        // NOTE: in v2, this should call rebuild(), which updates children.
+        return replaceLoggingMethods.call(self);
       };
       self.setDefaultLevel = function (level) {
-        defaultLevel = level;
+        defaultLevel = normalizeLevel(level);
         if (!getPersistedLevel()) {
           self.setLevel(level, false);
         }
       };
       self.resetLevel = function () {
-        self.setLevel(defaultLevel, false);
+        userLevel = null;
         clearPersistedLevel();
+        replaceLoggingMethods.call(self);
       };
       self.enableAll = function (persist) {
         self.setLevel(self.levels.TRACE, persist);
@@ -252,13 +292,25 @@ var loglevel = {exports: {}};
       self.disableAll = function (persist) {
         self.setLevel(self.levels.SILENT, persist);
       };
+      self.rebuild = function () {
+        if (defaultLogger !== self) {
+          inheritedLevel = normalizeLevel(defaultLogger.getLevel());
+        }
+        replaceLoggingMethods.call(self);
+        if (defaultLogger === self) {
+          for (var childName in _loggersByName) {
+            _loggersByName[childName].rebuild();
+          }
+        }
+      };
 
-      // Initialize with the right level
+      // Initialize all the internal levels.
+      inheritedLevel = normalizeLevel(defaultLogger ? defaultLogger.getLevel() : "WARN");
       var initialLevel = getPersistedLevel();
-      if (initialLevel == null) {
-        initialLevel = defaultLevel;
+      if (initialLevel != null) {
+        userLevel = normalizeLevel(initialLevel);
       }
-      self.setLevel(initialLevel, false);
+      replaceLoggingMethods.call(self);
     }
 
     /*
@@ -267,15 +319,14 @@ var loglevel = {exports: {}};
      *
      */
 
-    var defaultLogger = new Logger();
-    var _loggersByName = {};
+    defaultLogger = new Logger();
     defaultLogger.getLogger = function getLogger(name) {
       if (typeof name !== "symbol" && typeof name !== "string" || name === "") {
         throw new TypeError("You must supply a name when creating a logger.");
       }
       var logger = _loggersByName[name];
       if (!logger) {
-        logger = _loggersByName[name] = new Logger(name, defaultLogger.getLevel(), defaultLogger.methodFactory);
+        logger = _loggersByName[name] = new Logger(name, defaultLogger.methodFactory);
       }
       return logger;
     };
@@ -811,14 +862,16 @@ var eventsExports = events.exports;
 function isVideoFrame(frame) {
   return 'type' in frame;
 }
-function importKey(keyBytes) {
-  let algorithm = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
-    name: ENCRYPTION_ALGORITHM
-  };
-  let usage = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'encrypt';
-  return __awaiter(this, void 0, void 0, function* () {
-    // https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/importKey
-    return crypto.subtle.importKey('raw', keyBytes, algorithm, false, usage === 'derive' ? ['deriveBits', 'deriveKey'] : ['encrypt', 'decrypt']);
+function importKey(keyBytes_1) {
+  return __awaiter(this, arguments, void 0, function (keyBytes) {
+    let algorithm = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+      name: ENCRYPTION_ALGORITHM
+    };
+    let usage = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'encrypt';
+    return function* () {
+      // https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/importKey
+      return crypto.subtle.importKey('raw', keyBytes, algorithm, false, usage === 'derive' ? ['deriveBits', 'deriveKey'] : ['encrypt', 'decrypt']);
+    }();
   });
 }
 function getAlgoOptions(algorithmName, salt) {
@@ -1091,8 +1144,8 @@ class FrameCryptor extends BaseFrameCryptor {
    * 9) Enqueue the encrypted frame for sending.
    */
   encodeFunction(encodedFrame, controller) {
-    var _a;
     return __awaiter(this, void 0, void 0, function* () {
+      var _a;
       if (!this.isEnabled() ||
       // skip for encryption for empty dtx frames
       encodedFrame.data.byteLength === 0) {
@@ -1210,89 +1263,92 @@ class FrameCryptor extends BaseFrameCryptor {
    * Function that will decrypt the given encoded frame. If the decryption fails, it will
    * ratchet the key for up to RATCHET_WINDOW_SIZE times.
    */
-  decryptFrame(encodedFrame, keyIndex) {
-    let initialMaterial = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : undefined;
-    let ratchetOpts = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {
-      ratchetCount: 0
-    };
-    var _a;
-    return __awaiter(this, void 0, void 0, function* () {
-      const keySet = this.keys.getKeySet(keyIndex);
-      if (!ratchetOpts.encryptionKey && !keySet) {
-        throw new TypeError("no encryption key found for decryption of ".concat(this.participantIdentity));
-      }
-      let frameInfo = this.getUnencryptedBytes(encodedFrame);
-      // Construct frame trailer. Similar to the frame header described in
-      // https://tools.ietf.org/html/draft-omara-sframe-00#section-4.2
-      // but we put it at the end.
-      //
-      // ---------+-------------------------+-+---------+----
-      // payload  |IV...(length = IV_LENGTH)|R|IV_LENGTH|KID |
-      // ---------+-------------------------+-+---------+----
-      try {
-        const frameHeader = new Uint8Array(encodedFrame.data, 0, frameInfo.unencryptedBytes);
-        var encryptedData = new Uint8Array(encodedFrame.data, frameHeader.length, encodedFrame.data.byteLength - frameHeader.length);
-        if (frameInfo.isH264 && needsRbspUnescaping(encryptedData)) {
-          encryptedData = parseRbsp(encryptedData);
-          const newUint8 = new Uint8Array(frameHeader.byteLength + encryptedData.byteLength);
-          newUint8.set(frameHeader);
-          newUint8.set(encryptedData, frameHeader.byteLength);
-          encodedFrame.data = newUint8.buffer;
+  decryptFrame(encodedFrame_1, keyIndex_1) {
+    return __awaiter(this, arguments, void 0, function (encodedFrame, keyIndex) {
+      var _this = this;
+      let initialMaterial = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : undefined;
+      let ratchetOpts = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {
+        ratchetCount: 0
+      };
+      return function* () {
+        var _a;
+        const keySet = _this.keys.getKeySet(keyIndex);
+        if (!ratchetOpts.encryptionKey && !keySet) {
+          throw new TypeError("no encryption key found for decryption of ".concat(_this.participantIdentity));
         }
-        const frameTrailer = new Uint8Array(encodedFrame.data, encodedFrame.data.byteLength - 2, 2);
-        const ivLength = frameTrailer[0];
-        const iv = new Uint8Array(encodedFrame.data, encodedFrame.data.byteLength - ivLength - frameTrailer.byteLength, ivLength);
-        const cipherTextStart = frameHeader.byteLength;
-        const cipherTextLength = encodedFrame.data.byteLength - (frameHeader.byteLength + ivLength + frameTrailer.byteLength);
-        const plainText = yield crypto.subtle.decrypt({
-          name: ENCRYPTION_ALGORITHM,
-          iv,
-          additionalData: new Uint8Array(encodedFrame.data, 0, frameHeader.byteLength)
-        }, (_a = ratchetOpts.encryptionKey) !== null && _a !== void 0 ? _a : keySet.encryptionKey, new Uint8Array(encodedFrame.data, cipherTextStart, cipherTextLength));
-        const newData = new ArrayBuffer(frameHeader.byteLength + plainText.byteLength);
-        const newUint8 = new Uint8Array(newData);
-        newUint8.set(new Uint8Array(encodedFrame.data, 0, frameHeader.byteLength));
-        newUint8.set(new Uint8Array(plainText), frameHeader.byteLength);
-        encodedFrame.data = newData;
-        return encodedFrame;
-      } catch (error) {
-        if (this.keyProviderOptions.ratchetWindowSize > 0) {
-          if (ratchetOpts.ratchetCount < this.keyProviderOptions.ratchetWindowSize) {
-            workerLogger.debug("ratcheting key attempt ".concat(ratchetOpts.ratchetCount, " of ").concat(this.keyProviderOptions.ratchetWindowSize, ", for kind ").concat(encodedFrame instanceof RTCEncodedAudioFrame ? 'audio' : 'video'));
-            let ratchetedKeySet;
-            if ((initialMaterial !== null && initialMaterial !== void 0 ? initialMaterial : keySet) === this.keys.getKeySet(keyIndex)) {
-              // only ratchet if the currently set key is still the same as the one used to decrypt this frame
-              // if not, it might be that a different frame has already ratcheted and we try with that one first
-              const newMaterial = yield this.keys.ratchetKey(keyIndex, false);
-              ratchetedKeySet = yield deriveKeys(newMaterial, this.keyProviderOptions.ratchetSalt);
-            }
-            const frame = yield this.decryptFrame(encodedFrame, keyIndex, initialMaterial || keySet, {
-              ratchetCount: ratchetOpts.ratchetCount + 1,
-              encryptionKey: ratchetedKeySet === null || ratchetedKeySet === void 0 ? void 0 : ratchetedKeySet.encryptionKey
-            });
-            if (frame && ratchetedKeySet) {
-              // before updating the keys, make sure that the keySet used for this frame is still the same as the currently set key
-              // if it's not, a new key might have been set already, which we don't want to override
-              if ((initialMaterial !== null && initialMaterial !== void 0 ? initialMaterial : keySet) === this.keys.getKeySet(keyIndex)) {
-                this.keys.setKeySet(ratchetedKeySet, keyIndex, true);
-                // decryption was successful, set the new key index to reflect the ratcheted key set
-                this.keys.setCurrentKeyIndex(keyIndex);
+        let frameInfo = _this.getUnencryptedBytes(encodedFrame);
+        // Construct frame trailer. Similar to the frame header described in
+        // https://tools.ietf.org/html/draft-omara-sframe-00#section-4.2
+        // but we put it at the end.
+        //
+        // ---------+-------------------------+-+---------+----
+        // payload  |IV...(length = IV_LENGTH)|R|IV_LENGTH|KID |
+        // ---------+-------------------------+-+---------+----
+        try {
+          const frameHeader = new Uint8Array(encodedFrame.data, 0, frameInfo.unencryptedBytes);
+          var encryptedData = new Uint8Array(encodedFrame.data, frameHeader.length, encodedFrame.data.byteLength - frameHeader.length);
+          if (frameInfo.isH264 && needsRbspUnescaping(encryptedData)) {
+            encryptedData = parseRbsp(encryptedData);
+            const newUint8 = new Uint8Array(frameHeader.byteLength + encryptedData.byteLength);
+            newUint8.set(frameHeader);
+            newUint8.set(encryptedData, frameHeader.byteLength);
+            encodedFrame.data = newUint8.buffer;
+          }
+          const frameTrailer = new Uint8Array(encodedFrame.data, encodedFrame.data.byteLength - 2, 2);
+          const ivLength = frameTrailer[0];
+          const iv = new Uint8Array(encodedFrame.data, encodedFrame.data.byteLength - ivLength - frameTrailer.byteLength, ivLength);
+          const cipherTextStart = frameHeader.byteLength;
+          const cipherTextLength = encodedFrame.data.byteLength - (frameHeader.byteLength + ivLength + frameTrailer.byteLength);
+          const plainText = yield crypto.subtle.decrypt({
+            name: ENCRYPTION_ALGORITHM,
+            iv,
+            additionalData: new Uint8Array(encodedFrame.data, 0, frameHeader.byteLength)
+          }, (_a = ratchetOpts.encryptionKey) !== null && _a !== void 0 ? _a : keySet.encryptionKey, new Uint8Array(encodedFrame.data, cipherTextStart, cipherTextLength));
+          const newData = new ArrayBuffer(frameHeader.byteLength + plainText.byteLength);
+          const newUint8 = new Uint8Array(newData);
+          newUint8.set(new Uint8Array(encodedFrame.data, 0, frameHeader.byteLength));
+          newUint8.set(new Uint8Array(plainText), frameHeader.byteLength);
+          encodedFrame.data = newData;
+          return encodedFrame;
+        } catch (error) {
+          if (_this.keyProviderOptions.ratchetWindowSize > 0) {
+            if (ratchetOpts.ratchetCount < _this.keyProviderOptions.ratchetWindowSize) {
+              workerLogger.debug("ratcheting key attempt ".concat(ratchetOpts.ratchetCount, " of ").concat(_this.keyProviderOptions.ratchetWindowSize, ", for kind ").concat(encodedFrame instanceof RTCEncodedAudioFrame ? 'audio' : 'video'));
+              let ratchetedKeySet;
+              if ((initialMaterial !== null && initialMaterial !== void 0 ? initialMaterial : keySet) === _this.keys.getKeySet(keyIndex)) {
+                // only ratchet if the currently set key is still the same as the one used to decrypt this frame
+                // if not, it might be that a different frame has already ratcheted and we try with that one first
+                const newMaterial = yield _this.keys.ratchetKey(keyIndex, false);
+                ratchetedKeySet = yield deriveKeys(newMaterial, _this.keyProviderOptions.ratchetSalt);
               }
+              const frame = yield _this.decryptFrame(encodedFrame, keyIndex, initialMaterial || keySet, {
+                ratchetCount: ratchetOpts.ratchetCount + 1,
+                encryptionKey: ratchetedKeySet === null || ratchetedKeySet === void 0 ? void 0 : ratchetedKeySet.encryptionKey
+              });
+              if (frame && ratchetedKeySet) {
+                // before updating the keys, make sure that the keySet used for this frame is still the same as the currently set key
+                // if it's not, a new key might have been set already, which we don't want to override
+                if ((initialMaterial !== null && initialMaterial !== void 0 ? initialMaterial : keySet) === _this.keys.getKeySet(keyIndex)) {
+                  _this.keys.setKeySet(ratchetedKeySet, keyIndex, true);
+                  // decryption was successful, set the new key index to reflect the ratcheted key set
+                  _this.keys.setCurrentKeyIndex(keyIndex);
+                }
+              }
+              return frame;
+            } else {
+              /**
+               * Because we only set a new key once decryption has been successful,
+               * we can be sure that we don't need to reset the key to the initial material at this point
+               * as the key has not been updated on the keyHandler instance
+               */
+              workerLogger.warn('maximum ratchet attempts exceeded');
+              throw new CryptorError("valid key missing for participant ".concat(_this.participantIdentity), CryptorErrorReason.InvalidKey);
             }
-            return frame;
           } else {
-            /**
-             * Because we only set a new key once decryption has been successful,
-             * we can be sure that we don't need to reset the key to the initial material at this point
-             * as the key has not been updated on the keyHandler instance
-             */
-            workerLogger.warn('maximum ratchet attempts exceeded');
-            throw new CryptorError("valid key missing for participant ".concat(this.participantIdentity), CryptorErrorReason.InvalidKey);
+            throw new CryptorError("Decryption failed: ".concat(error.message), CryptorErrorReason.InvalidKey);
           }
-        } else {
-          throw new CryptorError("Decryption failed: ".concat(error.message), CryptorErrorReason.InvalidKey);
         }
-      }
+      }();
     });
   }
   /**
@@ -1388,7 +1444,6 @@ class FrameCryptor extends BaseFrameCryptor {
     if (this.rtpMap.size === 0) {
       return undefined;
     }
-    // @ts-expect-error payloadType is not yet part of the typescript definition and currently not supported in Safari
     const payloadType = frame.getMetadata().payloadType;
     const codec = payloadType ? this.rtpMap.get(payloadType) : undefined;
     return codec;
@@ -1572,11 +1627,14 @@ class ParticipantKeyHandler extends eventsExports.EventEmitter {
    * together with the material
    * also resets the valid key property and updates the currentKeyIndex
    */
-  setKey(material) {
-    let keyIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-    return __awaiter(this, void 0, void 0, function* () {
-      yield this.setKeyFromMaterial(material, keyIndex);
-      this.resetKeyStatus();
+  setKey(material_1) {
+    return __awaiter(this, arguments, void 0, function (material) {
+      var _this = this;
+      let keyIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+      return function* () {
+        yield _this.setKeyFromMaterial(material, keyIndex);
+        _this.resetKeyStatus();
+      }();
     });
   }
   /**
@@ -1585,18 +1643,21 @@ class ParticipantKeyHandler extends eventsExports.EventEmitter {
    * together with the material
    * also updates the currentKeyIndex
    */
-  setKeyFromMaterial(material, keyIndex) {
-    let emitRatchetEvent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
-    return __awaiter(this, void 0, void 0, function* () {
-      const keySet = yield deriveKeys(material, this.keyProviderOptions.ratchetSalt);
-      const newIndex = keyIndex >= 0 ? keyIndex % this.cryptoKeyRing.length : this.currentKeyIndex;
-      workerLogger.debug("setting new key with index ".concat(keyIndex), {
-        usage: material.usages,
-        algorithm: material.algorithm,
-        ratchetSalt: this.keyProviderOptions.ratchetSalt
-      });
-      this.setKeySet(keySet, newIndex, emitRatchetEvent);
-      if (newIndex >= 0) this.currentKeyIndex = newIndex;
+  setKeyFromMaterial(material_1, keyIndex_1) {
+    return __awaiter(this, arguments, void 0, function (material, keyIndex) {
+      var _this2 = this;
+      let emitRatchetEvent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+      return function* () {
+        const keySet = yield deriveKeys(material, _this2.keyProviderOptions.ratchetSalt);
+        const newIndex = keyIndex >= 0 ? keyIndex % _this2.cryptoKeyRing.length : _this2.currentKeyIndex;
+        workerLogger.debug("setting new key with index ".concat(keyIndex), {
+          usage: material.usages,
+          algorithm: material.algorithm,
+          ratchetSalt: _this2.keyProviderOptions.ratchetSalt
+        });
+        _this2.setKeySet(keySet, newIndex, emitRatchetEvent);
+        if (newIndex >= 0) _this2.currentKeyIndex = newIndex;
+      }();
     });
   }
   setKeySet(keySet, keyIndex) {
@@ -1831,8 +1892,10 @@ if (self.RTCTransformEvent) {
   workerLogger.debug('setup transform event');
   // @ts-ignore
   self.onrtctransform = event => {
+    // @ts-ignore .transformer property is part of RTCTransformEvent
     const transformer = event.transformer;
     workerLogger.debug('transformer', transformer);
+    // @ts-ignore monkey patching non standard flag
     transformer.handled = true;
     const {
       kind,