v2.3.0-beta1

Developer Notes:

This is a major update.

The new 2.3.0 version has been promoted to beta, meaning it is considered much more stable.

This new version adds support for the v3 Schema, an update that adds 30+ new TikTok LIVE events!

This new version also fixes a lot of broken protobuf fields that were incorrect or outdated in the v2 schema that has been used for the last ~1 year.

The NodeJS library & Python library schemas are now 1:1 🎉 😄.

General Changes

• Decoupled Euler Stream fully, you can now run the library without Euler by swapping out routes via RouteConfig global ⭐
• Dropped axios in favour of the much more modern got HTTP library ⭐
• Removed .proto folder & bundled Protobuf types in favour of tiktok-live-proto
• Bumped @eulerstream/euler-api-sdk to 0.3.0
• Added new WebcastEvent.SUPER_FAN 🆕
• Added new WebcastEvent.SUPER_FAN_JOIN 🆕
• Added new WebcastEvent.SUPER_FAN_BOX 🆕
• Added abortSignal to waitUntilLive function 🆕
• Split the Config into WebcastWebConfigDefaults and WebcastWebSocketConfigDefaults ⭐

Architecture Changes

• Routes were previously attached to a class object. They are now function-based instead which is much more idiomatic ⭐
• WebcastHttpClient now is only a request library, and has no specific function calling implementation in it
• Routes now have per-route configuration possible
• CookieJar has become WebcastCookieJar and is promise-based
• Refactored project to be much more modular in nature
• Removed many duplicate constructor props & merged them into other props ⭐
• Removed many no-longer relevant / deprecated constructor props ⭐
• Introduced CI/CD pipeline basics with GitHub workflows

Auto-Generated:

What's Changed

• fix for undefined properties object being passed into getRoomInfo call by @AdamJessop in #270
• Update README.md by @isaackogan in #279
• fix(ws-client): remove recursive emit('close') from onDisconnect handler by @DonnyMoshWill in #282
• fix gift not working by @adityadees in #284
• Add Support for TikTok Super Fan Box Events by @sleepylessons in #308
• Adding Support for Super Fan Box to LEGACY API by @sleepylessons in #309
• Adding missing examples to README, updating existing to show more context by @sleepylessons in #304
• #fix: update axios to 1.15.0 (CVE-2026-40175) by @dws2020 in #317
• Distinguish Super Fan Joined from New Super Fan event by @sleepylessons in #319

New Contributors

• @AdamJessop made their first contribution in #270
• @DonnyMoshWill made their first contribution in #282
• @adityadees made their first contribution in #284
• @sleepylessons made their first contribution in #308
• @dws2020 made their first contribution in #317

Full Changelog: v1.2.2...v2.3.0-beta1

v1.2.3

• Fix TikTok does not offer a websocket upgrade error

Update via npm update or npm i tiktok-live-connector

v1.2.2

• Fix empty room info (#244, #245) by @isaackogan

v1.1.9

• Add signProviderOptions for using non-default signing servers. (#204) by @shaiyon
• Fix roomId extraction from page source (#212) by @fmalk

Update via npm i tiktok-live-connector

v1.1.8

• Fix TikTok does not offer a websocket upgrade.

Update via npm i tiktok-live-connector

v1.1.7

• Fix TikTok does not offer a websocket upgrade.

Update via npm i tiktok-live-connector

v1.1.6

• Fix Websocket connection failed

Update via npm i tiktok-live-connector

v1.1.4

• Fix "TikTok does not offer a websocket upgrade" error due to missing "Sec-Websocket-Protocol" header in response.
• Remove interval causing unexpected process waiting (#171)
• Add Teamer Member Levels and Badges
• Update webcast params
• Minor optimizations

use npm i tiktok-live-connector to update your version.

v1.0.5

• Use modern syntax for node module imports (#131)

v1.0.4

• Add fallback sign server (If the primary sign server is not available) (c45dc5c)
• Fix Failed to retrieve room_id from page source issue (96a4d4f)
• Use modern syntax for node module imports (by @FilterUnfiltered) (#128)