twilio-video 2.29.0-preview.1 → 2.29.0

package/CHANGELOG.md

@@ -2,16 +2,26 @@ 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.29.0-preview.1 (August 13, 2024)
-==================================
+2.29.0 (December 5, 2024)
+================================
 
 Changes
 -------
 
+### Video Processor V3 support (Beta)
+- `AddProcessorOptions.outputFrameBufferContextType = 'bitmaprenderer'` is now supported on Safari and Firefox. (VBLOCKS-3643, VBLOCKS-3644)
 - `AddProcessorOptions.inputFrameBufferType` now has a new value `videoframe`. On browsers that support [`VideoFrame`](https://developer.mozilla.org/en-US/docs/Web/API/VideoFrame), the `inputFrameBuffer` argument of [`VideoProcessor.processFrame()`](https://twilio.github.io/twilio-video-processors.js/classes/VirtualBackgroundProcessor.html#processFrame) will be a `VideoFrame`. On other supported browsers, it will be an `HTMLVideoElement`.
 - `AddProcessorOptions.outputFrameBufferContextType` now has a new value `bitmaprenderer`. Currently, this is only **supported for Chromium-based browsers**. On other supported browsers, it falls back to `2d`.
 - Patched the build script to work around the issue: https://github.com/markdown-it/linkify-it/issues/111.
 
+2.28.2 (November 22, 2024)
+==========================
+
+Bug Fixes
+---------
+
+- Fixed a bug in Desktop Safari 18 and all iOS browsers on iOS 18 where cloning a disabled `MediaStreamTrack` would incorrectly set the `enabled` property to `true` instead of preserving the original disabled state. This ensures track cloning behavior matches the MediaStreamTrack specification and works consistently across browsers. Bug report: https://bugs.webkit.org/show_bug.cgi?id=281758
+
 2.28.1 (October 3, 2023)
 ========================
 

package/LICENSE.md

@@ -1,7 +1,7 @@
 The following license applies to all parts of this software except as
 documented below.
 
-    Copyright (C) 2019-2022 Twilio, inc.
+    Copyright (C) 2019-2025 Twilio, inc.
     All rights reserved.
 
     Redistribution and use in source and binary forms, with or without

package/README.md

@@ -3,10 +3,6 @@ twilio-video.js
 
 [![NPM](https://img.shields.io/npm/v/twilio-video.svg)](https://www.npmjs.com/package/twilio-video) [![CircleCI](https://circleci.com/gh/twilio/twilio-video.js/tree/master.svg?style=svg&circle-token=80e91c8284c21ff16d3003702e17b903c0b32f1d)](https://circleci.com/gh/twilio/twilio-video.js/tree/master)
 
-> [!WARNING]  
-> We are no longer allowing new customers to onboard to Twilio Video. Effective **December 5th, 2026**, Twilio Video will End of Life (EOL) and will cease to function for all customers. Customers may transition to any video provider they choose, however, we are recommending customers migrate to the Zoom Video SDK and we have prepared a [Migration Guide](https://developers.zoom.us/docs/video-sdk/twilio/). Additional information on this EOL is available in our Help Center [here](https://help.twilio.com/articles/24158233644443-Programmable-Video-End-of-Life-Extension). 
-
-
 twilio-video.js allows you to add real-time voice and video to your web apps.
 
 * [API Docs](//sdk.twilio.com/js/video/latest/docs)
@@ -78,7 +74,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.28.1/twilio-video.min.js"></script>
+<script src="//sdk.twilio.com/js/video/releases/2.29.0/twilio-video.min.js"></script>
 ```
 
 Using this method, twilio-video.js will set a browser global:

package/dist/twilio-video.js

@@ -1,9 +1,9 @@
-/*! twilio-video.js 2.29.0-preview.1
+/*! twilio-video.js 2.29.0
 
 The following license applies to all parts of this software except as
 documented below.
 
-    Copyright (C) 2019-2022 Twilio, inc.
+    Copyright (C) 2019-2025 Twilio, inc.
     All rights reserved.
 
     Redistribution and use in source and binary forms, with or without
@@ -7517,13 +7517,6 @@ var VideoTrack = /** @class */ (function (_super) {
         // that the correct type is used and on Firefox, it throws an exception if you try to capture
         // frames prior calling getContext https://bugzilla.mozilla.org/show_bug.cgi?id=1572422
         outputFrameBufferContextType = outputFrameBufferContextType || '2d';
-        // NOTE(mmalavalli): For now, we support bitmaprenderer context type only on Chrome.
-        // On other browsers, it will fall back to "2d".
-        if (outputFrameBufferContextType === 'bitmaprenderer' && guessBrowser() !== 'chrome') {
-            this._log.warn('outputFrameBufferContextType = "bitmaprenderer" is not supported by '
-                + 'the SDK for this browser, falling back to "2d".');
-            outputFrameBufferContextType = '2d';
-        }
         var ctx = this._outputFrame.getContext(outputFrameBufferContextType);
         if (!ctx) {
             throw new Error("Cannot get outputFrameBufferContextType: " + outputFrameBufferContextType + ".");
@@ -7763,8 +7756,7 @@ function dimensionsChanged(track, elem) {
  * that your Video Processor uses in order to properly generate the processed track. For example, if your Video Processor uses WebGL2 (`canvas.getContext('webgl2')`),
  * you should set `outputFrameBufferContextType` to `webgl2`. If you're using Canvas 2D processing (`canvas.getContext('2d')`),
  * you should set `outputFrameBufferContextType` to `2d`. If the output frame is an [ImageBitmap](https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap),
- * you should set `outputFrameBufferContextType` to `bitmaprenderer`. For now, this is supported only on Chrome. On other
- * browsers, it will fall back to `2d`.
+ * you should set `outputFrameBufferContextType` to `bitmaprenderer`.
  */
 /**
  * The {@link VideoTrack}'s dimensions changed.
@@ -11040,7 +11032,14 @@ var LocalTrackPublicationSignaling = /** @class */ (function (_super) {
      */
     function LocalTrackPublicationSignaling(trackSender, name, priority) {
         var _this = this;
-        trackSender = trackSender.clone();
+        // NOTE(lrivas): Safely clone a media stream track while preserving the original
+        // enabled state. This is needed because Safari 18 incorrectly enables tracks
+        // during cloning. Bug report: https://bugs.webkit.org/show_bug.cgi?id=281758
+        var clonedTrackSender = trackSender.clone();
+        if (trackSender.kind !== 'data') {
+            clonedTrackSender.track.enabled = trackSender.track.enabled;
+        }
+        trackSender = clonedTrackSender;
         var enabled = trackSender.kind === 'data' ? true : trackSender.track.enabled;
         _this = _super.call(this, name, trackSender.kind, enabled, priority) || this;
         _this.setTrackTransceiver(trackSender);
@@ -30257,7 +30256,7 @@ module.exports={
   "name": "twilio-video",
   "title": "Twilio Video",
   "description": "Twilio Video JavaScript Library",
-  "version": "2.29.0-preview.1",
+  "version": "2.29.0",
   "homepage": "https://twilio.com",
   "author": "Mark Andrus Roberts <mroberts@twilio.com>",
   "contributors": [