Release 2.5.0 ((December 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's New (samples)

• Added radio buttons to select between 'legacy' and 'dual-stack' KVS endpoints. (#431)

Note

When using dual-stack mode, IPv6 support is reliant on the capabilities of the client-side network, device, and browser. Dual-stack mode uses a dual-stack KVS STUN server, but IPv6 srflx (server-reflexive) ICE candidate support is dependent on the WebRTC implementation of the running browser. Dual-stack mode has been tested across the following browsers for successful end-to-end streaming: Chrome, Edge, FireFox, and Safari; as well as in combination with our C, iOS, and Android SDKs.

Our testing on dual-stack networks where IPv6 addresses are publicly routable has shown that all tested browsers (with built-in WebRTC stacks) attempt and work successfully with host candidates; however, we did not see (or need) IPv6 srflx candidates.

Note

IPv6 KVS TURN relay allocations are not supported at this time.

Bug Fixes and Improvements (samples)

• Updated the URL for fetching regions for input validation. (#674)
• Removed attempt to access an undefined object when the master peer connection fails when connecting as viewer. (#675)
• Updated publishing to use OIDC due to npm classic tokens being permanently revoked. (#676)

Better User Experience

• Improved spacing of the example Test Page UI. (#431)

Version Bumps

• N/A

Note

The development branch containing commits between this release (v2.5.0) and v2.4.5 has been archived into the release-v2.5.0 branch.

Release 2.4.5 ((November 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's new (samples)

• N/A

Bug fixes and improvements (samples)

• Added view URL parameter for auto-starting master/viewer mode (#649)
• Resolved a warning in the log for a special ICE candidate generated only in Firefox browsers (#632)
• Log the selected ICE candidate pair in Firefox browser(#633)
• Added persistent client ID storage for viewer reconnection (#659)

Better User Experience

• Enhanced user experience with periodic logging and retry functionality in WebRTC ingestion mode(#643, #645)
• Modified logging for better user experience in WebRTC ingestion mode (#650)

Version bumps

• @types/node from 24.9.0 to 24.10.1
• @typescript-eslint/eslint-plugin from 8.46.2 to 8.48.0
• @typescript-eslint/parser from 8.46.2 to 8.48.0
• eslint from 9.38.0 to 9.39.1
• glob from 10.4.5 to 10.5.0
• js-yaml from 3.14.1 to 3.14.2
• jsdom from 27.0.0 to 27.2.0
• webpack from 5.102.1 to 5.103.0

Note

The development branch containing commits between this release (v2.4.5) and v2.4.4 has been archived into the release-v2.4.5 branch.

Release 2.4.4 ((October 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's new (samples)

• N/A

Bug fixes and improvements (samples)

• WebRTC ingestion mode connection retry timeout change for testing. (#631)

Version bumps

• @types/node from 24.7.0 to 24.9.0
• @typescript-eslint/eslint-plugin from 8.45.0 to 8.46.2
• @typescript-eslint/parser from 8.46.1 to 8.46.2
• eslint from 9.36.0 to 9.38.0
• ts-jest from 29.4.4 to 29.4.5
• webpack from 5.102.0 to 5.102.1

Note

The development branch containing commits between this release (v2.4.4) and v2.4.3 has been archived into the release-v2.4.4 branch.

Release 2.4.3 ((October 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's new (samples)

• N/A

Bug fixes and improvements (samples)

• Removed multi-viewer region check. (#616, #619)

Version bumps

• @types/node from 24.3.0 to 24.7.0
• @typescript-eslint/eslint-plugin from 8.40.0 to 8.45.0
• @typescript-eslint/parser from 8.40.0 to 8.46.0
• brace-expansion from 1.1.11 to 1.1.12
• eslint from 9.33.0 to 9.36.0
• jest from 30.0.5 to 30.2.0
• jest-environment-jsdom from 30.0.5 to 30.2.0
• jsdom from 26.1.0 to 27.0.0
• ts-jest from 29.4.1 to 29.4.4
• typescript from 5.9.2 to 5.9.3
• webpack from 5.101.3 to 5.102.0

Note

The development branch containing commits between this release (v2.4.3) and v2.4.2 has been archived into the release-v2.4.3 branch.

Release 2.4.2 ((August 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's new (samples)

• Added TURN server connection options (#505)
• Updated logging for the received tracks (#506)

Version bumps

• @expo/devcert from 1.1.4 to 1.2.0
• @types/jest from 29.5.14 to 30.0.0
• @types/node from 22.14.1 to 24.3.0
• @babel/runtime from 7.26.0 to 7.28.3
• @typescript-eslint/eslint-plugin from 8.30.1 to 8.40.0
• @typescript-eslint/parser from 8.30.0 to 8.39.0
• compression from 1.7.5 to 1.8.1
• eslint from 9.24.0 to 9.33.0
• eslint-config-prettier from 10.1.5 to 10.1.8
• eslint-plugin-prettier from 5.2.6 to 5.5.4
• form-data from 3.0.2 to 3.0.4
• http-proxy-middleware from 2.0.7 to 2.0.9
• jest from 29.7.0 to 30.0.5
• jest-environment-jsdom from 29.7.0 to 30.0.5
• on-headers from 1.0.2 to 1.1.0
• prettier from 3.5.3 to 3.6.2
• ts-jest from 29.3.2 to 29.4.1
• typescript from 5.8.3 to 5.9.2
• undici from 6.21.1 to 6.21.3
• webpack from 5.99.5 to 5.101.3
• webpack-dev-server from 5.2.1 to 5.2.2
• ws from 8.18.1 to 8.18.3
• Removed tmp. It's no longer used after updating ancestor dependency @expo/devcert.

Note

The development branch containing commits between this release (v2.4.2) and v2.4.1 has been archived into the release-v2.4.2 branch.

Release 2.4.1 ((May 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's new (samples)

• Added codec filtering options to the sample page. By default, this is ON and set to H.264 video & opus audio. (#499)
  • This demonstrates how to resolve the buffer size issue with the KVS WebRTC-C SDK v1.12.0 and older, seen following the Chrome Upgrade to v136 on 4/29/2025.
  • Chrome 136 added H.265 support, thereby increasing the size of the SDP which may exceed the signaling limits.

Note

The NPM artifacts remain the same with v2.4.0 release, this release only contains sample changes.

Release 2.4.0 ((April 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's new (samples)

• Upgraded AWS SDK JS version from v2 to v3, reducing artifact size from 9.02 MB to 162 KB (#426)
• Added option for Master to automatically reconnect to Signaling. (#465)
• Refresh expired TURN credentials when Master receives an SDP offer. (#465)

Bug fixes and improvements (samples)

• Master: Removed sendPrflxCandidates as a condition for STUN server to be used. (#434)
• Viewer: Added sendSrflxCandidates as a requirement for STUN server to be used. (#434)
• Viewer: Clean up the 'loadedData' event listener upon stopping the application (#463)

Version bumps

• @types/node from 22.10.6 to 22.14.1
• @typescript-eslint/eslint-plugin from 8.20.0 to 8.30.0
• @typescript-eslint/parser from 8.20.0 to 8.29.0
• eslint from 9.18.0 to 9.24.0
• eslint-plugin-prettier from 5.2.1 to 5.2.6
• eslint-config-prettier from 10.0.1 to 10.1.2
• fork-ts-checker-webpack-plugin from 9.0.2 to 9.1.0
• image-size from 1.2.0 to 1.2.1
• jsdom from 26.0.0 to 26.1.0
• prettier from 3.4.2 to 3.5.3
• ts-jest from 29.2.5 to 29.3.2
• typescript from 5.7.3 to 5.8.3
• undici from 6.21.0 to 6.21.1
• webpack from 5.97.1 to 5.99.5
• webpack-dev-server from 5.2.0 to 5.2.1
• ws from 8.18.0 to 8.18.1

Developer Enhancements

• Automatically merge dependabot PRs that pass the CI. (#451)
• Added the dev build for the AWS SDK JS v3 with sourcemaps (1.8 MB) for improved local development. (#426)
• Added CI to automatically build and deploy the release build of AWS SDK JS v3 (162 KB) to GitHub pages. (#426)

Note

The development branch containing commits between this release (v2.4.0) and v2.3.2 has been archived into the release-v2.4.0 branch.

Release 2.3.2 ((January 2025) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What's new

• Updated many dependencies thanks to Dependabot. See below.
• The minimum supported node version required has been changed from 16 to 18 due to eslint dependency, and 17 is past end-of-life (#360).

Bug fixes and improvements

• We have addressed non-backwards compatible dependency updates to ensure this project builds out of the box. (#348, #360, #363, #369, #388)
• Removed unused dependencies: json-schema, json5, ua-parser-js, xml2js (#385)
• Removed unused devDependencies: @trust/webcrypto, codecov (#385)
• Reduced download size by removing the examples directory from the published NPM artifacts, 19.6 MB → 331 KB. (#395)

Version bumps

• @types/jest from 24.0.23 to 29.5.14
• @types/node from 17.0.41 to 22.10.5
• @typescript-eslint/eslint-plugin from 2.34.0 to 8.18.0
• @typescript-eslint/parser from 2.34.0 to 8.18.0
• eslint from 6.8.0 to 9.16.0
• eslint-config-prettier from 6.3.0 to 10.0.1
• eslint-plugin-prettier from 3.1.0 to 5.2.1
• http-proxy-middleware from 2.0.6 to 2.0.7
• jsdom from 20.0.0 to 26.0.0
• prettier from 1.18.2 to 3.4.2
• tslib from 1.10.0 to 2.8.1
• ts-loader from 6.0.4 to 9.5.1
• typescript from 4.9.5 to 5.7.2
• webpack-cli from 4.7.0 to 6.0.1
• webpack-dev-server from 4.0.0 to 5.2.0
• webpack-merge from 4.2.2 to 6.0.1

Note

The development branch containing commits between this release (v2.3.2) and v2.3.1 has been archived into the release-v2.3.2 branch.

Release 2.3.1 ((October 2024) of the Amazon Kinesis Video Streams WebRTC JS SDK)

Version bumps

• body-parser from 1.20.2 to 1.20.3.
• cookie from 0.6.0 to 0.7.1.
• elliptic from 6.5.4 to 6.5.7.
• express from 4.19.2 to 4.21.1
• micromatch from 4.0.7 to 4.0.8.
• serve-static from 1.15.0 to 1.16.2.
• webpack from 5.80.0 to 5.95.0.
• ws from 7.5.9 to 8.18.0.

Release 2.3.0 ((August 2024) of the Amazon Kinesis Video Streams WebRTC JS SDK)

What’s new

• Sample page: Add support for Concurrent real-time viewers support for WebRTC Ingestion (Preview)

  Amazon Kinesis Video Streams now offers the ability to stream real-time audio and video to up to 3 concurrent viewers via WebRTC, while also recording the session. You can enable concurrent real-time viewers without creating separate RTP sessions from the camera. Once recorded, you can use KVS APIs to playback, retrieve or perform analytical processing for your streams. Learn more here.

Bug fixes and improvements

• Readme: Fix the badges at the top (#307)
• SDK: Remove global. before the WebSocket constructor to allow for compatibility with vite.js (#311)
• Sample page: Fix a typo (#308)
• Sample page: Add a print statement of how long it took for the ConnectAsMaster or ConnectAsViewer API call to complete (#305)
• Sample page: Moved the Endpoint field from the top to the “Advanced” section (#314)

Version bumps

• follow-redirects from 1.15.5 to 1.15.6
• webpack-dev-middleware from 5.3.3 to 5.3.4
• express from 4.18.2 to 4.19.2
• tar from 6.1.13 to 6.2.1
• braces from 3.0.2 to 3.0.3
• react-native-codegen from 0.71.5 to 0.71.6
• fork-ts-checker-webpack-plugin from 4.1.6 to 9.0.2
• ws from 8.14.2 to 8.17.1
• fast-xml-parser from 4.2.5 to 4.4.1.