twilio-video 2.35.0 → 2.36.0

package/CHANGELOG.md

@@ -2,6 +2,41 @@ The Twilio Programmable Video SDKs use [Semantic Versioning](http://www.semver.o
 
 **Version 1.x reached End of Life on September 8th, 2021.** See the changelog entry [here](https://www.twilio.com/changelog/end-of-life-complete-for-unsupported-versions-of-the-programmable-video-sdk). Support for the 1.x version ended on December 4th, 2020.
 
+2.36.0 (September 11, 2026)
+====================
+
+New Features
+------------
+- Added support for `@twilio/krisp-audio-plugin` 2.x. Version 1.x remains supported, so
+  existing applications continue to work without changes.
+
+  The 2.x plugin expects the raw microphone signal, so disable the browser's own audio
+  processing when using it:
+
+  ```js
+  const localAudioTrack = await createLocalAudioTrack({
+    noiseCancellationOptions: {
+      sdkAssetsPath: 'path/to/hosted/twilio/krisp/audio/plugin/{version}/dist',
+      vendor: 'krisp'
+    },
+    // Required for 2.x only — omit these for 1.x.
+    echoCancellation: false,
+    noiseSuppression: false,
+    autoGainControl: false
+  });
+  ```
+
+Bug Fixes
+---------
+- Fixed loading of the noise cancellation plugin when the SDK is bundled by tools that
+  rewrite dynamic imports. The module path is now passed as an argument to the import
+  function instead of being embedded in its body.
+
+Changes
+-------
+- Updated `ws` to address a security advisory. This affects the Node.js build only;
+  browser builds do not include `ws`.
+
 2.35.0 (April 29, 2026)
 ====================
 

package/README.md

@@ -1,7 +1,7 @@
 twilio-video.js
 ===============
 
-[![NPM](https://img.shields.io/npm/v/twilio-video.svg)](https://www.npmjs.com/package/twilio-video) [![CircleCI](https://dl.circleci.com/status-badge/img/gh/twilio/twilio-video.js/tree/master.svg?style=shield&circle-token=CCIPRJ_7qmZwk292pKYnNqeFyi5x8_a409cfa25489fb617be3c56119e8064cc77ffb80)](https://circleci.com/gh/twilio/twilio-video.js/tree/master)
+[![NPM](https://img.shields.io/npm/v/twilio-video.svg)](https://www.npmjs.com/package/twilio-video) [![CircleCI](https://dl.circleci.com/status-badge/img/gh/twilio/twilio-video.js/tree/master.svg?style=shield)](https://circleci.com/gh/twilio/twilio-video.js/tree/master)
 
 twilio-video.js allows you to add real-time voice and video to your web apps.
 
@@ -73,7 +73,7 @@ Releases of twilio-video.js are hosted on a CDN, and you can include these
 directly in your web app using a <script> tag.
 
 ```html
-<script src="//sdk.twilio.com/js/video/releases/2.35.0/twilio-video.min.js"></script>
+<script src="//sdk.twilio.com/js/video/releases/2.36.0/twilio-video.min.js"></script>
 ```
 
 Using this method, twilio-video.js will set a browser global:

package/dist/twilio-video.js

@@ -1,4 +1,4 @@
-/*! twilio-video.js 2.35.0
+/*! twilio-video.js 2.36.0
 
 The following license applies to all parts of this software except as
 documented below.
@@ -518,6 +518,141 @@ var __twilio_video = (function () {
 
 	var noisecancellationadapter = {};
 
+	var legacyPluginAdapter = {};
+
+	/* globals webkitAudioContext, AudioContext */
+
+	var audiocontext;
+	var hasRequiredAudiocontext;
+
+	function requireAudiocontext () {
+		if (hasRequiredAudiocontext) return audiocontext;
+		hasRequiredAudiocontext = 1;
+		const NativeAudioContext = typeof AudioContext !== 'undefined'
+		    ? AudioContext
+		    : typeof webkitAudioContext !== 'undefined'
+		        ? webkitAudioContext
+		        : null;
+		/**
+		 * @interface AudioContextFactoryOptions
+		 * @property {AudioContext} [AudioContext] - The AudioContext constructor
+		 */
+		/**
+		 * {@link AudioContextFactory} ensures we construct at most one AudioContext
+		 * at a time, and that it is eventually closed when we no longer need it.
+		 * @property {AudioContextFactory} AudioContextFactory - The
+		 *   {@link AudioContextFactory} constructor
+		 */
+		class AudioContextFactory {
+		    /**
+		     * @param {AudioContextFactoryOptions} [options]
+		     */
+		    constructor(options) {
+		        options = Object.assign({
+		            AudioContext: NativeAudioContext
+		        }, options);
+		        Object.defineProperties(this, {
+		            _AudioContext: {
+		                value: options.AudioContext
+		            },
+		            _audioContext: {
+		                value: null,
+		                writable: true
+		            },
+		            _holders: {
+		                value: new Set()
+		            },
+		            AudioContextFactory: {
+		                enumerable: true,
+		                value: AudioContextFactory
+		            }
+		        });
+		    }
+		    /**
+		     * Each call to {@link AudioContextFactory#getOrCreate} should be paired with a
+		     * call to {@link AudioContextFactory#release}. Calling this increments an
+		     * internal reference count.
+		     * @param {*} holder - The object to hold a reference to the AudioContext
+		     * @returns {?AudioContext}
+		     */
+		    getOrCreate(holder) {
+		        if (!this._holders.has(holder)) {
+		            this._holders.add(holder);
+		            if (this._AudioContext && !this._audioContext) {
+		                try {
+		                    this._audioContext = new this._AudioContext();
+		                }
+		                catch (error) {
+		                    // Do nothing;
+		                }
+		            }
+		        }
+		        return this._audioContext;
+		    }
+		    /**
+		     * Decrement the internal reference count. If it reaches zero, close and destroy
+		     * the AudioContext.
+		     * @param {*} holder - The object that held a reference to the AudioContext
+		     * @returns {void}
+		     */
+		    release(holder) {
+		        if (this._holders.has(holder)) {
+		            this._holders.delete(holder);
+		            if (!this._holders.size && this._audioContext) {
+		                this._audioContext.close();
+		                this._audioContext = null;
+		            }
+		        }
+		    }
+		}
+		audiocontext = new AudioContextFactory();
+		
+		return audiocontext;
+	}
+
+	var hasRequiredLegacyPluginAdapter;
+
+	function requireLegacyPluginAdapter () {
+		if (hasRequiredLegacyPluginAdapter) return legacyPluginAdapter;
+		hasRequiredLegacyPluginAdapter = 1;
+		Object.defineProperty(legacyPluginAdapter, "__esModule", { value: true });
+		legacyPluginAdapter.LegacyPluginAdapter = void 0;
+		const AudioContextFactory = requireAudiocontext();
+		class LegacyPluginAdapter {
+		    constructor(legacy) {
+		        this.legacy = legacy;
+		    }
+		    init(options) { return this.legacy.init(options); }
+		    isInitialized() { return this.legacy.isInitialized(); }
+		    isConnected() { return this.legacy.isConnected(); }
+		    isEnabled() { return this.legacy.isEnabled(); }
+		    connect(input) { return this.legacy.connect(input); }
+		    disconnect() { this.legacy.disconnect(); }
+		    enable() { this.legacy.enable(); }
+		    disable() { this.legacy.disable(); }
+		    setLogging(enable) { this.legacy.setLogging(enable); }
+		    getVersion() { return this.legacy.getVersion(); }
+		    isSupported() {
+		        const holder = {};
+		        const ctx = AudioContextFactory.getOrCreate(holder);
+		        try {
+		            return !!ctx && this.legacy.isSupported(ctx);
+		        }
+		        finally {
+		            AudioContextFactory.release(holder);
+		        }
+		    }
+		    destroy() {
+		        return Promise.resolve().then(() => {
+		            this.legacy.destroy();
+		        });
+		    }
+		}
+		legacyPluginAdapter.LegacyPluginAdapter = LegacyPluginAdapter;
+		
+		return legacyPluginAdapter;
+	}
+
 	var dynamicimport;
 	var hasRequiredDynamicimport;
 
@@ -534,14 +669,20 @@ var __twilio_video = (function () {
 		    scope.__twilioVideoImportedModules = {
 		    // Imported module map.
 		    };
+		    // NOTE(mmalavalli): Calling import() directly can cause build issues in TypeScript and Webpack
+		    // (and probably other frameworks). So, we create a Function that calls import() in its body.
+		    // The path arrives only as the `url` argument, so it stays data and never joins the body source.
+		    // eslint-disable-next-line no-new-func
+		    const importModule = new Function('url', 'return import(url);');
 		    return function dynamicImport(module) {
 		        if (module in scope.__twilioVideoImportedModules) {
 		            return Promise.resolve(scope.__twilioVideoImportedModules[module]);
 		        }
-		        // NOTE(mmalavalli): Calling import() directly can cause build issues in TypeScript and Webpack
-		        // (and probably other frameworks). So, we create a Function that calls import() in its body.
-		        // eslint-disable-next-line no-new-func
-		        return new Function('scope', `return import('${new URL(module, location)}').then(m => scope.__twilioVideoImportedModules['${module}'] = m);`)(scope);
+		        return importModule(new URL(module, location).toString())
+		            .then(m => {
+		            scope.__twilioVideoImportedModules[module] = m;
+		            return m;
+		        });
 		    };
 		}(globalThis));
 		
@@ -800,7 +941,7 @@ var __twilio_video = (function () {
 	var constants = {exports: {}};
 
 	var name = "twilio-video";
-	var version = "2.35.0";
+	var version = "2.36.0";
 	var require$$5 = {
 		name: name,
 		version: version};
@@ -1197,42 +1338,45 @@ var __twilio_video = (function () {
 		Object.defineProperty(noisecancellationadapter, "__esModule", { value: true });
 		noisecancellationadapter.createNoiseCancellationAudioProcessor = createNoiseCancellationAudioProcessor;
 		const tslib_1 = require$$0;
+		const legacy_plugin_adapter_1 = requireLegacyPluginAdapter();
 		const dynamicImport = requireDynamicimport();
 		requireLog();
 		const PLUGIN_CONFIG = {
 		    krisp: {
-		        supportedVersion: '1.0.0',
+		        supportedVersions: ['1.0.0', '2.0.0'],
 		        pluginFile: 'krispsdk.mjs'
 		    },
 		    rnnoise: {
-		        supportedVersion: '0.6.0',
+		        supportedVersions: ['0.6.0'],
 		        pluginFile: 'rnnoise_sdk.mjs'
 		    }
 		};
-		const ensureVersionSupported = ({ supportedVersion, plugin, log }) => {
-		    if (!plugin.getVersion || !plugin.isSupported) {
-		        throw new Error('Plugin does not export getVersion/isSupported api. Are you using old version of the plugin ?');
-		    }
-		    const pluginVersion = plugin.getVersion();
-		    log.debug(`Plugin Version = ${pluginVersion}`);
-		    const supportedVersions = supportedVersion.split('.').map(version => Number(version));
-		    const pluginVersions = pluginVersion.split('.').map(version => Number(version));
-		    if (supportedVersions.length !== 3 || pluginVersions.length !== 3) {
-		        throw new Error(`Unsupported Plugin version format: ${supportedVersion}, ${pluginVersion}`);
-		    }
-		    if (supportedVersions[0] !== pluginVersions[0]) {
-		        throw new Error(`Major version mismatch: [Plugin version ${pluginVersion}],  [Supported Version ${supportedVersion}]`);
-		    }
-		    if (pluginVersions[1] < supportedVersions[1]) {
-		        throw new Error(`Minor version mismatch: [Plugin version ${pluginVersion}] < [Supported Version ${supportedVersion}]`);
+		const parseVersion = (version) => {
+		    // Strip semver pre-release suffix (e.g. "2.0.0-rc.1") before parsing.
+		    const core = version.split('-')[0];
+		    const parts = core.split('.').map(v => Number(v));
+		    if (parts.length !== 3 || parts.some(Number.isNaN)) {
+		        throw new Error(`Unsupported Plugin version format: ${version}`);
+		    }
+		    return parts;
+		};
+		const ensureVersionCompatible = ({ supportedVersions, pluginVersion }) => {
+		    const pluginParts = parseVersion(pluginVersion);
+		    const match = supportedVersions
+		        .map(parseVersion)
+		        .find(parts => parts[0] === pluginParts[0]);
+		    if (!match) {
+		        throw new Error(`Major version mismatch: [Plugin version ${pluginVersion}], [Supported Versions ${supportedVersions.join(', ')}]`);
 		    }
-		    const tempContext = new AudioContext();
-		    const isSupported = plugin.isSupported(tempContext);
-		    tempContext.close();
-		    if (!isSupported) {
-		        throw new Error('Noise Cancellation plugin is not supported on your browser');
+		    if (pluginParts[1] < match[1]) {
+		        throw new Error(`Minor version mismatch: [Plugin version ${pluginVersion}] < [Supported Version ${match.join('.')}]`);
 		    }
 		};
+		const adaptPlugin = (maybeLegacyPlugin, major) => {
+		    return major === 2
+		        ? maybeLegacyPlugin
+		        : new legacy_plugin_adapter_1.LegacyPluginAdapter(maybeLegacyPlugin);
+		};
 		let audioProcessors = new Map();
 		function createNoiseCancellationAudioProcessor(noiseCancellationOptions, log) {
 		    return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -1242,19 +1386,25 @@ var __twilio_video = (function () {
 		            if (!pluginConfig) {
 		                throw new Error(`Unsupported NoiseCancellationOptions.vendor: ${noiseCancellationOptions.vendor}`);
 		            }
-		            const { supportedVersion, pluginFile } = pluginConfig;
+		            const { supportedVersions, pluginFile } = pluginConfig;
 		            const rootDir = noiseCancellationOptions.sdkAssetsPath;
 		            const sdkFilePath = `${rootDir}/${pluginFile}`;
 		            try {
 		                log.debug('loading noise cancellation sdk: ', sdkFilePath);
 		                const dynamicModule = yield dynamicImport(sdkFilePath);
 		                log.debug('Loaded noise cancellation sdk:', dynamicModule);
-		                const plugin = dynamicModule.default;
-		                ensureVersionSupported({
-		                    supportedVersion,
-		                    plugin,
-		                    log
-		                });
+		                const maybeLegacyPlugin = dynamicModule.default;
+		                if (!maybeLegacyPlugin || typeof maybeLegacyPlugin.getVersion !== 'function') {
+		                    throw new Error(`Invalid noise cancellation plugin module: ${sdkFilePath}`);
+		                }
+		                const pluginVersion = maybeLegacyPlugin.getVersion();
+		                log.debug('Plugin Version =', pluginVersion);
+		                ensureVersionCompatible({ supportedVersions, pluginVersion });
+		                const major = parseVersion(pluginVersion)[0];
+		                const plugin = adaptPlugin(maybeLegacyPlugin, major);
+		                if (!plugin.isSupported()) {
+		                    throw new Error('Noise Cancellation plugin is not supported on your browser');
+		                }
 		                if (!plugin.isInitialized()) {
 		                    log.debug('initializing noise cancellation sdk: ', rootDir);
 		                    yield plugin.init({ rootDir });
@@ -1323,11 +1473,17 @@ var __twilio_video = (function () {
 		 * const { connect, createLocalAudioTrack } = require('twilio-video');
 		 *
 		 * // Create a LocalAudioTrack with Krisp noise cancellation enabled.
+		 * // Supported plugin versions: @twilio/krisp-audio-plugin 1.x or 2.x.
 		 * const localAudioTrack = await createLocalAudioTrack({
 		 *   noiseCancellationOptions: {
-		 *     sdkAssetsPath: 'path/to/hosted/twilio/krisp/audio/plugin/1.0.0/dist',
+		 *     sdkAssetsPath: 'path/to/hosted/twilio/krisp/audio/plugin/{version}/dist',
 		 *     vendor: 'krisp'
-		 *   }
+		 *   },
+		 *   // Required for @twilio/krisp-audio-plugin 2.x only, so Krisp receives
+		 *   // the raw microphone signal. Omit these for 1.x.
+		 *   echoCancellation: false,
+		 *   noiseSuppression: false,
+		 *   autoGainControl: false
 		 * });
 		 *
 		 * if (!localAudioTrack.noiseCancellation) {
@@ -1425,7 +1581,7 @@ var __twilio_video = (function () {
 		            this._processor.disconnect();
 		            const track = yield reacquire();
 		            this._sourceTrack = track;
-		            const processedTrack = yield this._processor.connect(track);
+		            const processedTrack = this._processor.connect(track);
 		            if (processorWasEnabled) {
 		                this._processor.enable();
 		            }
@@ -5887,96 +6043,6 @@ var __twilio_video = (function () {
 		return detectsilence;
 	}
 
-	/* globals webkitAudioContext, AudioContext */
-
-	var audiocontext;
-	var hasRequiredAudiocontext;
-
-	function requireAudiocontext () {
-		if (hasRequiredAudiocontext) return audiocontext;
-		hasRequiredAudiocontext = 1;
-		const NativeAudioContext = typeof AudioContext !== 'undefined'
-		    ? AudioContext
-		    : typeof webkitAudioContext !== 'undefined'
-		        ? webkitAudioContext
-		        : null;
-		/**
-		 * @interface AudioContextFactoryOptions
-		 * @property {AudioContext} [AudioContext] - The AudioContext constructor
-		 */
-		/**
-		 * {@link AudioContextFactory} ensures we construct at most one AudioContext
-		 * at a time, and that it is eventually closed when we no longer need it.
-		 * @property {AudioContextFactory} AudioContextFactory - The
-		 *   {@link AudioContextFactory} constructor
-		 */
-		class AudioContextFactory {
-		    /**
-		     * @param {AudioContextFactoryOptions} [options]
-		     */
-		    constructor(options) {
-		        options = Object.assign({
-		            AudioContext: NativeAudioContext
-		        }, options);
-		        Object.defineProperties(this, {
-		            _AudioContext: {
-		                value: options.AudioContext
-		            },
-		            _audioContext: {
-		                value: null,
-		                writable: true
-		            },
-		            _holders: {
-		                value: new Set()
-		            },
-		            AudioContextFactory: {
-		                enumerable: true,
-		                value: AudioContextFactory
-		            }
-		        });
-		    }
-		    /**
-		     * Each call to {@link AudioContextFactory#getOrCreate} should be paired with a
-		     * call to {@link AudioContextFactory#release}. Calling this increments an
-		     * internal reference count.
-		     * @param {*} holder - The object to hold a reference to the AudioContext
-		     * @returns {?AudioContext}
-		     */
-		    getOrCreate(holder) {
-		        if (!this._holders.has(holder)) {
-		            this._holders.add(holder);
-		            if (this._AudioContext && !this._audioContext) {
-		                try {
-		                    this._audioContext = new this._AudioContext();
-		                }
-		                catch (error) {
-		                    // Do nothing;
-		                }
-		            }
-		        }
-		        return this._audioContext;
-		    }
-		    /**
-		     * Decrement the internal reference count. If it reaches zero, close and destroy
-		     * the AudioContext.
-		     * @param {*} holder - The object that held a reference to the AudioContext
-		     * @returns {void}
-		     */
-		    release(holder) {
-		        if (this._holders.has(holder)) {
-		            this._holders.delete(holder);
-		            if (!this._holders.size && this._audioContext) {
-		                this._audioContext.close();
-		                this._audioContext = null;
-		            }
-		        }
-		    }
-		}
-		audiocontext = new AudioContextFactory();
-		
-		return audiocontext;
-	}
-
 	var detectsilentaudio;
 	var hasRequiredDetectsilentaudio;
 
@@ -29648,8 +29714,8 @@ MediaStreamTracks and calling getUserMedia again. This is retry \
 		 * @example
 		 * var Video = require('twilio-video');
 		 *
-		 * // Request the LocalAudioTrack with a custom name
-		 * // and krisp noise cancellation
+		 * // Request the LocalAudioTrack with a custom name and noise cancellation
+		 * // from @twilio/krisp-audio-plugin 1.x.
 		 * Video.createLocalAudioTrack({
 		 *   name: 'microphone',
 		 *   noiseCancellationOptions: {
@@ -29657,6 +29723,22 @@ MediaStreamTracks and calling getUserMedia again. This is retry \
 		 *      sdkAssetsPath: '/twilio-krisp-audio-plugin/1.0.0/dist'
 		 *   }
 		 * });
+		 * @example
+		 * var Video = require('twilio-video');
+		 *
+		 * // Request the LocalAudioTrack with noise cancellation from
+		 * // @twilio/krisp-audio-plugin 2.x, which expects the raw microphone signal,
+		 * // so the browser's own audio processing is disabled.
+		 * Video.createLocalAudioTrack({
+		 *   name: 'microphone',
+		 *   noiseCancellationOptions: {
+		 *      vendor: 'krisp',
+		 *      sdkAssetsPath: '/twilio-krisp-audio-plugin/2.0.0/dist'
+		 *   },
+		 *   echoCancellation: false,
+		 *   noiseSuppression: false,
+		 *   autoGainControl: false
+		 * });
 		 */
 		function createLocalAudioTrack(options) {
 		    return createLocalTrack('audio', options);
@@ -29717,7 +29799,7 @@ MediaStreamTracks and calling getUserMedia again. This is retry \
 		 *   LocalAudioTrack continues to capture from the same audio input device even after the default audio input device changes.
 		 *   When the property is not specified, it defaults to "auto".
 		 * @property {NoiseCancellationOptions} [noiseCancellationOptions] - This optional property enables using 3rd party plugins
-		 *   for noise cancellation.
+		 *   for noise cancellation. Supports @twilio/krisp-audio-plugin 1.x and 2.x.
 		 */
 		/**
 		 * Create {@link LocalTrack} options. Apart from the properties listed here, you can