chore(release): v2.4.1

:]

CONTRIBUTING.md

@@ -12,10 +12,7 @@ ___
   * [Create a PR](#changes-2)
   * [Run tests](#test)
   * [Lint your code](#lint)
-  * [Build for node](#build-1)
-  * [Bundle for browsers](#build-2)
-  * [Compile proto file](#build-3)
-  * [Build parser map](#build-4)
+  * [Build](#build)
   
 ## Issues
 
@@ -25,7 +22,7 @@ If you find a problem, search if an issue already exists. If a related issue doe
 
 <a id="issue-2"></a>
 #### Solve an issue
-Scan through the existing issues to find one that interests you. You can narrow down the search using labels as filters. If you find an issue to work on, you are welcome to open a PR with a fix.
+Scan through the existing issues to find one that interests you. You can narrow down the search using labels as filters. If you find an issue to work on, you are welcome to open a PR with a fix. Documentation updates and grammar fixes are also appreciated!
 
 <a id="changes"></a>
 ## Make changes
@@ -62,42 +59,23 @@ npm run test
 
 ```bash
 npm run lint
-```
-
-Or
-
-```bash
 npm run lint:fix
 ```
 
-<a id="build-1"></a>
-#### Build for Node
+<a id="build"></a>
+#### Build
 
 ```bash
+# Node
 npm run build:node
-```
 
-<a id="build-2"></a>
-#### Build for browsers 
-
-```bash
+# Browser
 npm run build:browser
-```
-Or:
-```bash
 npm run build:browser:prod
-```
 
-<a id="build-3"></a>
-#### Compile proto file
+# Protobuf
+npm run build:proto
 
-```bash
-// TODO
-```
-
-<a id="build-4"></a>
-#### Build parser map
-
-```bash
+# Parser map
 npm run build:parser-map
-```
+```

README.md

@@ -40,9 +40,11 @@
   [![Tests](https://github.com/LuanRT/YouTube.js/actions/workflows/node.js.yml/badge.svg)][actions]
   [![Latest version](https://img.shields.io/npm/v/youtubei.js?color=%2335C757)][versions]
   [![Codefactor](https://www.codefactor.io/repository/github/luanrt/youtube.js/badge)][codefactor]
-  [![Monthly downloads](https://img.shields.io/npm/dm/youtubei.js)][npm]
+  [![Downloads](https://img.shields.io/npm/dt/youtubei.js)][npm]
   [![Say thanks](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)][say-thanks]
-
+  <br>
+  [![Donate](https://img.shields.io/badge/donate-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=#white)][github-sponsors]
+ 
 </div>
 
 <!-- SPONSORS -->
@@ -292,7 +294,7 @@ Retrieves video info, including playback data and even layout elements such as m
 | Param | Type | Description |
 | --- | --- | --- |
 | video_id | `string` | The id of the video |
-| client? | `InnerTubeClient` | `WEB`, `ANDROID` or `YTMUSIC` |
+| client? | `InnerTubeClient` | `WEB`, `ANDROID`, `YTMUSIC`, `YTMUSIC_ANDROID` or `TV_EMBEDDED` |
 
 <details>
 <summary>Methods & Getters</summary>
@@ -347,7 +349,7 @@ Suitable for cases where you only need basic video metadata. Also, it is faster
 | Param | Type | Description |
 | --- | --- | --- |
 | video_id | `string` | The id of the video |
-| client? | `InnerTubeClient` | `WEB`, `ANDROID` or `YTMUSIC` |
+| client? | `InnerTubeClient` | `WEB`, `ANDROID`, `YTMUSIC_ANDROID`, `YTMUSIC`, `TV_EMBEDDED` |
 
 <a name="search"></a>
 ### search(query, filters?)
@@ -404,7 +406,32 @@ See [`./examples/comments`](https://github.com/LuanRT/YouTube.js/blob/main/examp
 ### getHomeFeed()
 Retrieves YouTube's home feed.
 
-**Returns**: `Promise.<FilterableFeed>`
+**Returns**: `Promise.<HomeFeed>`
+
+<details>
+<summary>Methods & Getters</summary>
+<p>
+
+- `<home_feed>#videos`
+  - Returns all videos in the home feed.
+
+- `<home_feed>#posts`
+  - Returns all posts in the home feed.
+
+- `<home_feed>#shelfs`
+  - Returns all shelfs in the home feed.
+
+- `<home_feed>#filters`
+  - Returns available filters.
+
+- `<home_feed>#applyFilter(name | ChipCloudChip)`
+  - Applies given filter and returns a new HomeFeed instance.
+
+- `<home_feed>#getContinuation()`
+  - Retrieves feed continuation.
+
+</p>
+</details> 
 
 <a name="getlibrary"></a>
 ### getLibrary()
@@ -527,6 +554,14 @@ Retrieves playlist contents.
 ### getStreamingData(video_id, options)
 Returns deciphered streaming data.
 
+**Note:**
+It is recommended to retrieve streaming data from a `VideoInfo`/`TrackInfo` object instead if you want to select formats manually, example:
+```ts
+const info = await yt.getBasicInfo('somevideoid');
+const url = info.streaming_data?.formats[0].decipher(yt.session.player);
+console.info('Playback url:', url);
+```
+
 **Returns**: `Promise.<object>`
 
 | Param | Type | Description |
@@ -568,8 +603,9 @@ For example, you may want to call an endpoint directly, that can be achieved wit
 // ...
 
 const payload = {
+  // ...
   videoId: 'jLTOuvBTLxA',
-  client: 'YTMUSIC', // InnerTube client, can be ANDROID, YTMUSIC, WEB
+  client: 'YTMUSIC', // InnerTube client, can be ANDROID, YTMUSIC, YTMUSIC_ANDROID, WEB or TV_EMBEDDED
   parse: true // tells YouTube.js to parse the response, this is not sent to InnerTube.
 };
 
@@ -583,14 +619,14 @@ Or maybe there's an interesting `NavigationEndpoint` in a parsed response and we
 ```ts
 // ...
 const artist = await yt.music.getArtist('UC52ZqHVQz5OoGhvbWiRal6g');
-const albums = artist.sections[1].as(MusicCarouselShelf);
+const albums = artist.sections[1].as(YTNodes.MusicCarouselShelf);
 
 // Say we have a button and want to “click” it
-const button = albums.as(MusicCarouselShelf).header?.more_content;
+const button = albums.as(YTNodes.MusicCarouselShelf).header?.more_content;
   
 if (button) {
   // To do that, we can call its navigation endpoint:
-  const page = await button.endpoint.call(yt.actions, 'YTMUSIC', true);
+  const page = await button.endpoint.call(yt.actions, { parse: true, client: 'YTMUSIC' });
   console.info(page);
 }
 ```
@@ -599,24 +635,11 @@ if (button) {
 
 If you're working on an extension for the library or just want to have nicely typed and sanitized InnerTube responses for a project then have a look at our powerful parser!
 
-<details>
-<summary>Example:</summary>
-<p>
-
+Example:
 ```ts
 // See ./examples/parser
 
-import { Parser } from 'youtubei.js';
-
-import SectionList from 'youtubei.js/dist/src/parser/classes/SectionList';
-import SingleColumnBrowseResults from 'youtubei.js/dist/src/parser/classes/SingleColumnBrowseResults';
-
-import MusicVisualHeader from 'youtubei.js/dist/src/parser/classes/MusicVisualHeader';
-import MusicImmersiveHeader from 'youtubei.js/dist/src/parser/classes/MusicImmersiveHeader';
-import MusicCarouselShelf from 'youtubei.js/dist/src/parser/classes/MusicCarouselShelf';
-import MusicDescriptionShelf from 'youtubei.js/dist/src/parser/classes/MusicDescriptionShelf';
-import MusicShelf from 'youtubei.js/dist/src/parser/classes/MusicShelf';
-
+import { Parser, YTNodes } from 'youtubei.js';
 import { readFileSync } from 'fs';
 
 // Artist page response from YouTube Music
@@ -624,7 +647,7 @@ const data = readFileSync('./artist.json').toString();
 
 const page = Parser.parseResponse(JSON.parse(data));
 
-const header = page.header.item().as(MusicImmersiveHeader, MusicVisualHeader);
+const header = page.header?.item().as(YTNodes.MusicImmersiveHeader, YTNodes.MusicVisualHeader);
 
 console.info('Header:', header);
 
@@ -632,7 +655,8 @@ console.info('Header:', header);
 // A proxy intercepts access to the actual data, allowing
 // the parser to add type safety and many utility methods
 // that make working with InnerTube much easier.
-const tab = page.contents.item().as(SingleColumnBrowseResults).tabs.get({ selected: false });
+const tab = page.contents.item().as(YTNodes.SingleColumnBrowseResults).tabs.firstOfType(YTNodes.Tab);
+
 
 if (!tab)
   throw new Error('Target tab not found');
@@ -640,14 +664,11 @@ if (!tab)
 if (!tab.content)
   throw new Error('Target tab appears to be empty');
   
-const sections = tab.content?.as(SectionList).contents.array().as(MusicCarouselShelf, MusicDescriptionShelf, MusicShelf);
+const sections = tab.content?.as(YTNodes.SectionList).contents.array().as(YTNodes.MusicCarouselShelf, YTNodes.MusicDescriptionShelf, YTNodes.MusicShelf);
 
 console.info('Sections:', sections);
 ```
 
-</p>
-</details>
-
 Detailed documentation can be found [here](https://github.com/LuanRT/YouTube.js/blob/main/src/parser).
 
 <!-- CONTRIBUTING -->

docs/API/music.md

@@ -5,7 +5,7 @@ YouTube Music class.
 ## API
 
 * Music 
-  * [.getInfo(video_id)](#getinfo)
+  * [.getInfo(target)](#getinfo)
   * [.search(query, filters?)](#search)
   * [.getHomeFeed()](#gethomefeed)
   * [.getExplore()](#getexplore)
@@ -14,13 +14,13 @@ YouTube Music class.
   * [.getAlbum(album_id)](#getalbum)
   * [.getPlaylist(playlist_id)](#getplaylist)
   * [.getLyrics(video_id)](#getlyrics)
-  * [.getUpNext(video_id)](#getupnext)
+  * [.getUpNext(video_id, automix?)](#getupnext)
   * [.getRelated(video_id)](#getrelated)
   * [.getRecap()](#getrecap)
   * [.getSearchSuggestions(query)](#getsearchsuggestions)
 
 <a name="getinfo"></a>
-### getInfo(video_id)
+### getInfo(target)
 
 Retrieves track info.
 
@@ -28,7 +28,29 @@ Retrieves track info.
 
 | Param | Type | Description |
 | --- | --- | --- |
-| video_id | `string` | Video id |
+| target | `string` or `MusicTwoRowItem` | video id or list item |
+
+<details>
+<summary>Methods & Getters</summary>
+<p>
+
+- `<info>#getTab(title)`
+  - Retrieves contents of the given tab.
+
+- `<info>#getUpNext(automix?)`
+  - Retrieves up next.
+
+- `<info>#getRelated()`
+  - Retrieves related content.
+
+- `<info>#getLyrics()`
+  - Retrieves song lyrics.
+
+- `<info>#available_tabs`
+  - Returns available tabs.
+
+</p>
+</details> 
 
 <a name="search"></a>
 ### search(query, filters?)
@@ -127,9 +149,35 @@ Retrieves “Explore” feed.
 
 Retrieves library.
 
-**Returns:** `Promise.<Library>`
+**Returns:** `Library`
 
-<!-- TODO: document Library's methods and getters. -->
+<details>
+<summary>Methods & Getters</summary>
+<p>
+
+- `<library>#applyFilter(filter)`
+  - Applies given filter to the library.
+
+- `<library>#applySortFilter(filter)`
+  - Applies given sort filter to the library items.
+
+- `<library>#getContinuation()`
+  - Retrieves continuation of the library items.
+
+- `<library>#has_continuation`
+  - Checks if continuation is available.
+
+- `<library>#filters`
+  - Returns available filters.
+
+- `<library>#sort_filters`
+  - Returns available sort filters.
+
+- `<library>#page`
+  - Returns original InnerTube response (sanitized).
+
+</p>
+</details> 
 
 <a name="getartist"></a>
 ### getArtist(artist_id)
@@ -211,14 +259,14 @@ Retrieves given playlist.
 
 Retrieves song lyrics.
 
-**Returns:** `Promise.<{ text: string; footer: object; }>`
+**Returns:** `Promise.<MusicDescriptionShelf | undefined>`
 
 | Param | Type | Description |
 | --- | --- | --- |
 | video_id | `string` | Video id |
 
 <a name="getupnext"></a>
-### getUpNext(video_id)
+### getUpNext(video_id, automix?)
 
 Retrieves up next content.
 
@@ -227,6 +275,7 @@ Retrieves up next content.
 | Param | Type | Description |
 | --- | --- | --- |
 | video_id | `string` | Video id |
+| automix? | `boolean` | if automix should be fetched |
 
 <a name="getrelated"></a>
 ### getRelated(video_id)

docs/API/session.md

@@ -41,7 +41,7 @@ InnerTube API key.
 **Returns:** `string`
 
 <a name="api_version"></a>
-### key
+### api_version
 
 InnerTube API version.
 
@@ -80,4 +80,4 @@ Player script object.
 
 Client language.
 
-**Returns:** `string`
+**Returns:** `string`

docs/API/studio.md

@@ -6,6 +6,7 @@ YouTube Studio class (WIP).
 
 * Studio 
   * [.setThumbnail(video_id, buffer)](#setthumbnail)
+  * [.updateVideoMetadata(video_id, metadata)](#updatemetadata)
   * [.upload(file, metadata)](#upload)
 
 <a name="setthumbnail"></a>
@@ -20,6 +21,18 @@ Uploads a custom thumbnail and sets it for a video.
 | video_id | `string` | Video id |
 | buffer | `Uint8Array` | Thumbnail buffer |
 
+<a name="updatemetadata"></a>
+### updateVideoMetadata(video_id, metadata)
+
+Updates given video's metadata.
+
+**Returns:** `Promise.<ActionsResponse>`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| video_id | `string` | Video id |
+| metadata | `VideoMetadata` | Video metadata |
+
 <a name="upload"></a>
 ### upload(file, metadata)
 
@@ -30,4 +43,4 @@ Uploads a video to YouTube.
 | Param | Type | Description |
 | --- | --- | --- |
 | file | `BodyInit` | Video file |
-| metadata | `VideoMetadata` | Video metadata |
+| metadata | `UploadedVideoMetadata` | Video metadata |

docs/updating-the-parser.md

@@ -0,0 +1,54 @@
+# Updating the parser
+
+YouTube is constantly changing, so it is not rare to see YouTube crawlers/scrapers breaking every now and then. 
+
+Our parser, on the other hand, was written so that it behaves similarly to an official client, parsing and mapping renderers (a.k.a YTNodes) dynamically without hard-coding their path in the response.  This way, whenever a new renderer pops up (e.g; YouTube adds a new feature / minor UI changes) the library will print a warning like this in the console:
+```
+InnertubeError: SomeRenderer not found!
+This is a bug, want to help us fix it? Follow the instructions at https://github.com/LuanRT/YouTube.js/blob/main/docs/updating-the-parser.md or report it at https://github.com/LuanRT/YouTube.js/issues!
+    at Parser.printError (...)
+    at Parser.parseItem (...)
+    at Parser.parseArray (...) {
+  info: {
+    // renderer data, can be used as a reference to implement the renderer parser
+  },
+  date: 2022-05-22T22:16:06.831Z,
+  version: '2.2.3'
+}
+```
+
+This warning, however, **does not** throw an error. The parser itself will continue working normally, even if a parsing error occurs in an existing renderer parser.
+
+## Adding a new renderer parser
+
+Thanks to the modularity of the parser, a renderer can be implemented by simply adding a new file anywhere in the [classes directory](../src/parser/classes)!
+
+For example, say we found a new renderer named `verticalListRenderer`, to let the parser know it exists we would have to create a file with the following structure:
+
+> `../classes/VerticalList.ts`
+```ts
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+class VerticalList extends YTNode {
+  static type = 'VerticalList';
+  
+  header;
+  contents;
+
+  constructor(data: any) {
+    // parse the data here, ex;
+    this.header = Parser.parseItem(data.header);
+    this.contents = Parser.parseArray(data.contents);
+  }
+}
+
+export default VerticalList;
+```
+
+Then update the parser map:
+```bash
+npm run build:parser-map
+```
+
+And that's it!

examples/browser/README.md

@@ -6,17 +6,52 @@ YouTube.js works in the browser!
 
 To use YouTube.js in the browser you must proxy requests through your own server. You can see our simple reference implementation in Deno in `examples/browser/proxy/deno.ts`.
 
-Once the proxy is set up you need to tell Innertube about it when instantiating it.
+We'll use our own fetch implementation to proxy requests through our server. This is a simple example, but you can use any fetch implementation you want.
 
 ```ts
 import { Innertube } from "youtubei.js/build/browser";
 
 const yt = await Innertube.create({
-    browser_proxy: {
-        host: "localhost",
-        schema: 'http',
-    }
-})
+    fetch: async (input, init) => {
+        // url
+        const url = typeof input === 'string'
+            ? new URL(input)
+            : input instanceof URL
+            ? input
+            : new URL(input.url);
+
+        // transform the url for use with our proxy
+        url.searchParams.set('__host', url.host);
+        url.host = 'localhost:8080';
+        url.protocol = 'http';
+
+        const headers = init?.headers
+            ? new Headers(init.headers)
+            : input instanceof Request
+            ? input.headers
+            : new Headers();
+
+        // now serialize the headers
+        url.searchParams.set('__headers', JSON.stringify([...headers]));
+
+        // copy over the request
+        const request = new Request(
+            url,
+            input instanceof Request ? input : undefined,
+        );
+
+        headers.delete('user-agent');
+
+        // fetch the url
+        return fetch(request, init ? {
+            ...init,
+            headers
+        } : {
+            headers
+        });
+    },
+    cache: new UniversalCache(),
+});
 ```
 
 after that you can use the library as normal.

examples/browser/proxy/deno.ts

@@ -18,7 +18,7 @@ const handler = async (request: Request): Promise<Response> => {
         'Access-Control-Allow-Origin': request.headers.get('origin') || '*',
         'Access-Control-Allow-Methods': '*',
         'Access-Control-Allow-Headers':
-          'Origin, X-Requested-With, Content-Type, Accept, Authorization, x-goog-visitor-id, x-origin, x-youtube-client-version, Accept-Language, Range',
+          'Origin, X-Requested-With, Content-Type, Accept, Authorization, x-goog-visitor-id, x-origin, x-youtube-client-version, Accept-Language, Range, Referer',
         'Access-Control-Max-Age': '86400',
         'Access-Control-Allow-Credentials': 'true',
       }),
@@ -45,7 +45,7 @@ const handler = async (request: Request): Promise<Response> => {
     JSON.parse(url.searchParams.get('__headers') || '{}'),
   );
   copyHeader('range', request_headers, request.headers);
-  copyHeader('user-agent', request_headers, request.headers);
+  !request_headers.has('user-agent') && copyHeader('user-agent', request_headers, request.headers);
   url.searchParams.delete('__headers');
 
   // Make the request to YouTube
@@ -62,6 +62,8 @@ const handler = async (request: Request): Promise<Response> => {
   copyHeader('content-length', headers, fetchRes.headers);
   copyHeader('content-type', headers, fetchRes.headers);
   copyHeader('content-disposition', headers, fetchRes.headers);
+  copyHeader('accept-ranges', headers, fetchRes.headers);
+  copyHeader('content-range', headers, fetchRes.headers);
 
   // add cors headers
   headers.set(

examples/channel/basic-info.ts

@@ -1,12 +1,14 @@
-import { Innertube, UniversalCache } from 'youtubei.js';
+import { Innertube, UniversalCache, YTNodes } from 'youtubei.js';
 
 (async () => {
   const yt = await Innertube.create({ cache: new UniversalCache() });
 
   const channel = await yt.getChannel('UCX6OQ3DkcsbYNE6H8uQQuVA');
 
-  console.info('Viewing channel:', channel.header.author.name);
-  console.info('Family Safe:', channel.metadata.is_family_safe);
+  if (channel.header?.is(YTNodes.C4TabbedHeader)) {
+    console.info('Viewing channel:', channel?.header?.author.name);
+    console.info('Family Safe:', channel.metadata.is_family_safe);
+  }
 
   const about = await channel.getAbout();
 

examples/livechat/README.md

@@ -21,6 +21,7 @@ const livechat = await info.getLiveChat();
   * [.ev](#ev) ⇒ `EventEmitter`
   * [.start](#start) ⇒ `function`
   * [.stop](#stop) ⇒ `function`
+  * [.getItemMenu](#getitemmenu) ⇒ `function`
   * [.sendMessage](#sendmessage) ⇒ `function`
 
 <a name="ev"></a>
@@ -58,6 +59,16 @@ Starts the Live Chat.
 ### stop()
 Stops the Live Chat.
 
+<a name="getitemmenu"></a>
+### getItemMenu(item)
+Retrieves given chat item's menu.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| item | `object` | Chat item |
+
+**Returns:** `Promise<ItemMenu>`
+
 <a name="sendmessage"></a>
 ### sendMessage(text)
 Sends a message.

examples/livechat/index.ts

@@ -1,31 +1,25 @@
-import { Innertube, UniversalCache } from 'youtubei.js';
+import { Innertube, UniversalCache, YTNodes } from 'youtubei.js';
+
 import { LiveChatContinuation } from 'youtubei.js/dist/src/parser';
-
-import LiveChat, { ChatAction, LiveMetadata } from 'youtubei.js/dist/src/parser/youtube/LiveChat';
-
-import Video from 'youtubei.js/dist/src/parser/classes/Video';
-import AddChatItemAction from 'youtubei.js/dist/src/parser/classes/livechat/AddChatItemAction';
-import MarkChatItemAsDeletedAction from 'youtubei.js/dist/src/parser/classes/livechat/MarkChatItemAsDeletedAction';
-
-import LiveChatTextMessage from 'youtubei.js/dist/src/parser/classes/livechat/items/LiveChatTextMessage';
-import LiveChatPaidMessage from 'youtubei.js/dist/src/parser/classes/livechat/items/LiveChatPaidMessage';
+import { ChatAction, LiveMetadata } from 'youtubei.js/dist/src/parser/youtube/LiveChat';
 
 (async () => {
   const yt = await Innertube.create({ cache: new UniversalCache() });
+
   
   const search = await yt.search('Lofi girl live');
-  const info = await yt.getInfo(search.videos[0].as(Video).id);
+  const info = await yt.getInfo(search.videos[0].as(YTNodes.Video).id);
+
+  const livechat = info.getLiveChat();
 
-  const livechat = await info.getLiveChat();
-  
   livechat.on('start', (initial_data: LiveChatContinuation) => {
     /**
      * Initial info is what you see when you first open a Live Chat — this is; inital actions (pinned messages, top donations..), account's info and so on.
      */
-     
+
     console.info(`Hey ${initial_data.viewer_name || 'N/A'}, welcome to Live Chat!`);
   });
-  
+
   livechat.on('chat-update', (action: ChatAction) => {
     /**
      * An action represents what is being added to
@@ -35,28 +29,28 @@ import LiveChatPaidMessage from 'youtubei.js/dist/src/parser/classes/livechat/it
      * Below are a few examples of how this can be used.
      */
 
-    if (action.is(AddChatItemAction)) {
-      const item = action.as(AddChatItemAction).item;
-   
+    if (action.is(YTNodes.AddChatItemAction)) {
+      const item = action.as(YTNodes.AddChatItemAction).item;
+
       if (!item)
         return console.info('Action did not have an item.', action);
-      
+
       const hours = new Date(item.hasKey('timestamp') ? item.timestamp : Date.now()).toLocaleTimeString('en-US', {
         hour: '2-digit',
         minute: '2-digit'
       });
-      
+
       switch (item.type) {
         case 'LiveChatTextMessage':
           console.info(
-            `${hours} - ${item.as(LiveChatTextMessage).author?.name.toString()}:\n` +
-            `${item.as(LiveChatTextMessage).message.toString()}\n`
+            `${hours} - ${item.as(YTNodes.LiveChatTextMessage).author?.name.toString()}:\n` +
+            `${item.as(YTNodes.LiveChatTextMessage).message.toString()}\n`
           );
           break;
         case 'LiveChatPaidMessage':
           console.info(
-            `${hours} - ${item.as(LiveChatPaidMessage).author.name.toString()}:\n` +
-            `${item.as(LiveChatPaidMessage).purchase_amount}\n`
+            `${hours} - ${item.as(YTNodes.LiveChatPaidMessage).author.name.toString()}:\n` +
+            `${item.as(YTNodes.LiveChatPaidMessage).purchase_amount}\n`
           );
           break;
         default:
@@ -64,8 +58,8 @@ import LiveChatPaidMessage from 'youtubei.js/dist/src/parser/classes/livechat/it
           break;
       }
     }
-      
-    if (action.is(MarkChatItemAsDeletedAction)) {
+
+    if (action.is(YTNodes.MarkChatItemAsDeletedAction)) {
       console.warn(`Message ${action.target_item_id} just got deleted and should be replaced with ${action.deleted_state_message.toString()}!`, '\n');
     }
   });

examples/parser/index.ts

@@ -1,22 +1,11 @@
-import { Parser } from 'youtubei.js';
-
-import SectionList from 'youtubei.js/dist/src/parser/classes/SectionList';
-import SingleColumnBrowseResults from 'youtubei.js/dist/src/parser/classes/SingleColumnBrowseResults';
-
-import MusicVisualHeader from 'youtubei.js/dist/src/parser/classes/MusicVisualHeader';
-import MusicImmersiveHeader from 'youtubei.js/dist/src/parser/classes/MusicImmersiveHeader';
-import MusicCarouselShelf from 'youtubei.js/dist/src/parser/classes/MusicCarouselShelf';
-import MusicDescriptionShelf from 'youtubei.js/dist/src/parser/classes/MusicDescriptionShelf';
-import MusicShelf from 'youtubei.js/dist/src/parser/classes/MusicShelf';
-
+import { Parser, YTNodes } from 'youtubei.js';
 import { readFileSync } from 'fs';
 
 // Artist page response from YouTube Music
 const data = readFileSync('./artist.json').toString();
-
 const page = Parser.parseResponse(JSON.parse(data));
 
-const header = page.header.item().as(MusicImmersiveHeader, MusicVisualHeader);
+const header = page.header?.item().as(YTNodes.MusicImmersiveHeader, YTNodes.MusicVisualHeader);
 
 console.info('Header:', header);
 
@@ -24,14 +13,14 @@ console.info('Header:', header);
 // A proxy intercepts access to the actual data, allowing
 // the parser to add type safety and many utility methods
 // that make working with InnerTube much easier.
-const tab = page.contents.item().as(SingleColumnBrowseResults).tabs.get({ selected: false });
+const tab = page.contents.item().as(YTNodes.SingleColumnBrowseResults).tabs.firstOfType(YTNodes.Tab);
 
 if (!tab)
   throw new Error('Target tab not found');
 
 if (!tab.content)
   throw new Error('Target tab appears to be empty');
-  
-const sections = tab.content?.as(SectionList).contents.array().as(MusicCarouselShelf, MusicDescriptionShelf, MusicShelf);
+
+const sections = tab.content?.as(YTNodes.SectionList).contents.array().as(YTNodes.MusicCarouselShelf, YTNodes.MusicDescriptionShelf, YTNodes.MusicShelf);
 
 console.info('Sections:', sections);

index.ts

@@ -10,6 +10,11 @@ if (getRuntime() === 'node') {
   Reflect.set(globalThis, 'Response', undici.Response);
   Reflect.set(globalThis, 'FormData', undici.FormData);
   Reflect.set(globalThis, 'File', undici.File);
+  try {
+    // eslint-disable-next-line
+    const { ReadableStream } = require('node:stream/web');
+    Reflect.set(globalThis, 'ReadableStream', ReadableStream);
+  } catch { /* do nothing */ }
 }
 
 import Innertube from './src/Innertube';

package.json

@@ -1,7 +1,7 @@
 {
   "name": "youtubei.js",
-  "version": "2.0.2",
-  "description": "Full-featured wrapper around YouTube's private API.",
+  "version": "2.4.1",
+  "description": "Full-featured wrapper around YouTube's private API. Supports YouTube, YouTube Music and YouTube Studio (WIP).",
   "main": "./dist/index.js",
   "browser": "./bundle/browser.js",
   "types": "./dist",
@@ -12,7 +12,8 @@
   "contributors": [
     "Wykerd (https://github.com/wykerd/)",
     "MasterOfBob777 (https://github.com/MasterOfBob777)",
-    "patrickkfkan (https://github.com/patrickkfkan)"
+    "patrickkfkan (https://github.com/patrickkfkan)",
+    "akkadaska (https://github.com/akkadaska)"
   ],
   "directories": {
     "test": "./test",
@@ -39,16 +40,16 @@
   "license": "MIT",
   "dependencies": {
     "@protobuf-ts/runtime": "^2.7.0",
-    "jintr": "^0.1.9",
+    "jintr": "^0.3.1",
     "linkedom": "^0.14.12",
     "undici": "^5.7.0"
   },
   "devDependencies": {
-    "@typescript-eslint/eslint-plugin": "^5.30.6",
-    "@typescript-eslint/parser": "^5.30.6",
     "@protobuf-ts/plugin": "^2.7.0",
     "@types/jest": "^28.1.7",
     "@types/node": "^17.0.45",
+    "@typescript-eslint/eslint-plugin": "^5.30.6",
+    "@typescript-eslint/parser": "^5.30.6",
     "esbuild": "^0.14.49",
     "eslint": "^8.19.0",
     "eslint-plugin-tsdoc": "^0.2.16",
@@ -70,6 +71,7 @@
     "youtube-dl",
     "youtube-downloader",
     "youtube-music",
+    "youtube-studio",
     "innertubeapi",
     "innertube",
     "unofficial",

scripts/build-parser-map.js

@@ -24,11 +24,11 @@ import { YTNodeConstructor } from './helpers';
 
 ${import_list.join('\n')}
 
-const map: Record<string, YTNodeConstructor> = {
+export const YTNodes = {
   ${json.join(',\n  ')}
 };
 
-export const YTNodes = map;
+const map: Record<string, YTNodeConstructor> = YTNodes;
 
 /**
  * @param name - Name of the node to be parsed

src/Innertube.ts

@@ -17,38 +17,26 @@ import { ActionsResponse } from './core/Actions';
 import Feed from './core/Feed';
 import YTMusic from './core/Music';
 import Studio from './core/Studio';
+import HomeFeed from './parser/youtube/HomeFeed';
 import AccountManager from './core/AccountManager';
 import PlaylistManager from './core/PlaylistManager';
 import InteractionManager from './core/InteractionManager';
-import FilterableFeed from './core/FilterableFeed';
 import TabbedFeed from './core/TabbedFeed';
 import Constants from './utils/Constants';
 import Proto from './proto/index';
 
 import { throwIfMissing, generateRandomString } from './utils/Utils';
 
-export type InnertubeConfig = SessionOptions
+export type InnertubeConfig = SessionOptions;
 
 export interface SearchFilters {
-  /**
-   * Filter videos by upload date, can be: any | last_hour | today | this_week | this_month | this_year
-   */
-  upload_date?: 'any' | 'last_hour' | 'today' | 'this_week' | 'this_month' | 'this_year';
-  /**
-   * Filter results by type, can be: any | video | channel | playlist | movie
-   */
-  type?: 'any' | 'video' | 'channel' | 'playlist' | 'movie';
-  /**
-   * Filter videos by duration, can be: any | short | medium | long
-   */
-  duration?: 'any' | 'short' | 'medium' | 'long';
-  /**
-   * Filter video results by order, can be: relevance | rating | upload_date | view_count
-   */
-  sort_by?: 'relevance' | 'rating' | 'upload_date' | 'view_count';
+  upload_date?: 'all' | 'hour' | 'today' | 'week' | 'month' | 'year',
+  type?: 'all' | 'video' | 'channel' | 'playlist' | 'movie',
+  duration?: 'all' | 'short' | 'medium' | 'long',
+  sort_by?: 'relevance' | 'rating' | 'upload_date' | 'view_count'
 }
 
-export type InnerTubeClient = 'ANDROID' | 'YTMUSIC_ANDROID' | 'WEB' | 'YTMUSIC';
+export type InnerTubeClient = 'WEB' | 'ANDROID' | 'YTMUSIC_ANDROID' | 'YTMUSIC' | 'TV_EMBEDDED';
 
 class Innertube {
   session;
@@ -75,12 +63,14 @@ class Innertube {
 
   /**
    * Retrieves video info.
+   * @param video_id - The video id.
+   * @param client - The client to use.
    */
   async getInfo(video_id: string, client?: InnerTubeClient) {
     const cpn = generateRandomString(16);
 
-    const initial_info = await this.actions.getVideoInfo(video_id, cpn, client);
-    const continuation = this.actions.next({ video_id });
+    const initial_info = this.actions.getVideoInfo(video_id, cpn, client);
+    const continuation = this.actions.execute('/next', { videoId: video_id });
 
     const response = await Promise.all([ initial_info, continuation ]);
     return new VideoInfo(response, this.actions, this.session.player, cpn);
@@ -88,6 +78,8 @@ class Innertube {
 
   /**
    * Retrieves basic video info.
+   * @param video_id - The video id.
+   * @param client - The client to use.
    */
   async getBasicInfo(video_id: string, client?: InnerTubeClient) {
     const cpn = generateRandomString(16);
@@ -98,18 +90,27 @@ class Innertube {
 
   /**
    * Searches a given query.
-   * @param query - search query.
-   * @param filters - search filters.
+   * @param query - The search query.
+   * @param filters - Search filters.
    */
   async search(query: string, filters: SearchFilters = {}) {
     throwIfMissing({ query });
-    const response = await this.actions.search({ query, filters });
+
+    const args = {
+      query,
+      ...{
+        params: filters ? Proto.encodeSearchFilters(filters) : undefined
+      }
+    };
+
+    const response = await this.actions.execute('/search', args);
+
     return new Search(this.actions, response.data);
   }
 
   /**
    * Retrieves search suggestions for a given query.
-   * @param query - the search query.
+   * @param query - The search query.
    */
   async getSearchSuggestions(query: string): Promise<string[]> {
     throwIfMissing({ query });
@@ -134,8 +135,8 @@ class Innertube {
 
   /**
    * Retrieves comments for a video.
-   * @param video_id - the video id.
-   * @param sort_by - can be: `TOP_COMMENTS` or `NEWEST_FIRST`.
+   * @param video_id - The video id.
+   * @param sort_by - Sorting options.
    */
   async getComments(video_id: string, sort_by?: 'TOP_COMMENTS' | 'NEWEST_FIRST') {
     throwIfMissing({ video_id });
@@ -144,7 +145,8 @@ class Innertube {
       sort_by: sort_by || 'TOP_COMMENTS'
     });
 
-    const response = await this.actions.next({ ctoken: payload });
+    const response = await this.actions.execute('/next', { continuation: payload });
+
     return new Comments(this.actions, response.data);
   }
 
@@ -152,15 +154,15 @@ class Innertube {
    * Retrieves YouTube's home feed (aka recommendations).
    */
   async getHomeFeed() {
-    const response = await this.actions.browse('FEwhat_to_watch');
-    return new FilterableFeed(this.actions, response.data);
+    const response = await this.actions.execute('/browse', { browseId: 'FEwhat_to_watch' });
+    return new HomeFeed(this.actions, response.data);
   }
 
   /**
    * Returns the account's library.
    */
   async getLibrary() {
-    const response = await this.actions.browse('FElibrary');
+    const response = await this.actions.execute('/browse', { browseId: 'FElibrary' });
     return new Library(response.data, this.actions);
   }
 
@@ -169,7 +171,7 @@ class Innertube {
    * Which can also be achieved with {@link getLibrary}.
    */
   async getHistory() {
-    const response = await this.actions.browse('FEhistory');
+    const response = await this.actions.execute('/browse', { browseId: 'FEhistory' });
     return new History(this.actions, response.data);
   }
 
@@ -177,7 +179,7 @@ class Innertube {
    * Retrieves trending content.
    */
   async getTrending() {
-    const response = await this.actions.browse('FEtrending');
+    const response = await this.actions.execute('/browse', { browseId: 'FEtrending' });
     return new TabbedFeed(this.actions, response.data);
   }
 
@@ -185,7 +187,7 @@ class Innertube {
    * Retrieves subscriptions feed.
    */
   async getSubscriptionsFeed() {
-    const response = await this.actions.browse('FEsubscriptions');
+    const response = await this.actions.execute('/browse', { browseId: 'FEsubscriptions' });
     return new Feed(this.actions, response.data);
   }
 
@@ -195,7 +197,7 @@ class Innertube {
    */
   async getChannel(id: string) {
     throwIfMissing({ id });
-    const response = await this.actions.browse(id);
+    const response = await this.actions.execute('/browse', { browseId: id });
     return new Channel(this.actions, response.data);
   }
 
@@ -203,16 +205,17 @@ class Innertube {
    * Retrieves notifications.
    */
   async getNotifications() {
-    const response = await this.actions.notifications('get_notification_menu');
+    const response = await this.actions.execute('/notification/get_notification_menu', { notificationsMenuRequestType: 'NOTIFICATIONS_MENU_REQUEST_TYPE_INBOX' });
     return new NotificationsMenu(this.actions, response);
   }
 
   /**
    * Retrieves unseen notifications count.
    */
-  async getUnseenNotificationsCount() {
-    const response = await this.actions.notifications('get_unseen_count');
-    return response.data.unseenCount;
+  async getUnseenNotificationsCount(): Promise<number> {
+    const response = await this.actions.execute('/notification/get_unseen_count');
+    // TODO: properly parse this
+    return response.data?.unseenCount || response.data?.actions?.[0].updateNotificationsUnseenCountAction?.unseenCount || 0;
   }
 
   /**
@@ -220,7 +223,12 @@ class Innertube {
    */
   async getPlaylist(id: string) {
     throwIfMissing({ id });
-    const response = await this.actions.browse(`VL${id.replace(/VL/g, '')}`);
+
+    if (!id.startsWith('VL')) {
+      id = `VL${id}`;
+    }
+
+    const response = await this.actions.execute('/browse', { browseId: id });
     return new Playlist(this.actions, response.data);
   }
 
@@ -245,11 +253,16 @@ class Innertube {
     return info.download(options);
   }
 
+  /**
+   * Utility method to call an endpoint without having to use {@link Actions}.
+   * @param endpoint -The endpoint to call.
+   * @param args - Call arguments.
+   */
   call(endpoint: NavigationEndpoint, args: { [ key: string ]: any; parse: true }): Promise<ParsedResponse>;
   call(endpoint: NavigationEndpoint, args?: { [ key: string ]: any; parse?: false }): Promise<ActionsResponse>;
   call(endpoint: NavigationEndpoint, args?: object): Promise<ActionsResponse | ParsedResponse> {
-    return endpoint.callTest(this.actions, args);
+    return endpoint.call(this.actions, args);
   }
 }
 
-export default Innertube;
+export default Innertube;

src/core/AccountManager.ts

@@ -5,6 +5,7 @@ import Analytics from '../parser/youtube/Analytics';
 import TimeWatched from '../parser/youtube/TimeWatched';
 import AccountInfo from '../parser/youtube/AccountInfo';
 import Settings from '../parser/youtube/Settings';
+import { InnertubeError } from '../utils/Utils';
 
 class AccountManager {
   #actions;
@@ -16,13 +17,30 @@ class AccountManager {
     this.channel = {
       /**
        * Edits channel name.
+       * @param new_name - The new channel name.
        */
-      editName: (new_name: string) => this.#actions.channel('channel/edit_name', { new_name }),
+      editName: (new_name: string) => {
+        if (!this.#actions.session.logged_in)
+          throw new InnertubeError('You must be signed in to perform this operation.');
+
+        return this.#actions.execute('/channel/edit_name', {
+          givenName: new_name,
+          client: 'ANDROID'
+        });
+      },
       /**
        * Edits channel description.
-       *
+       * @param new_description - The new description.
        */
-      editDescription: (new_description: string) => this.#actions.channel('channel/edit_description', { new_description }),
+      editDescription: (new_description: string) => {
+        if (!this.#actions.session.logged_in)
+          throw new InnertubeError('You must be signed in to perform this operation.');
+
+        return this.#actions.execute('/channel/edit_description', {
+          givenDescription: new_description,
+          client: 'ANDROID'
+        });
+      },
       /**
        * Retrieves basic channel analytics.
        */
@@ -34,6 +52,9 @@ class AccountManager {
    * Retrieves channel info.
    */
   async getInfo() {
+    if (!this.#actions.session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
     const response = await this.#actions.execute('/account/accounts_list', { client: 'ANDROID' });
     return new AccountInfo(response);
   }
@@ -68,7 +89,12 @@ class AccountManager {
     const info = await this.getInfo();
 
     const params = Proto.encodeChannelAnalyticsParams(info.footers?.endpoint.payload.browseId);
-    const response = await this.#actions.browse('FEanalytics_screen', { params, client: 'ANDROID' });
+
+    const response = await this.#actions.execute('/browse', {
+      browseId: 'FEanalytics_screen',
+      client: 'ANDROID',
+      params
+    });
 
     return new Analytics(response);
   }

src/core/Actions.ts

@@ -1,54 +1,14 @@
-import Proto from '../proto/index';
 import Session from './Session';
-
 import Parser, { ParsedResponse } from '../parser/index';
+import { InnertubeError } from '../utils/Utils';
 
-import { hasKeys, InnertubeError, MissingParamError, uuidv4 } from '../utils/Utils';
-
-export interface BrowseArgs {
-  params?: string | null;
-  is_ytm?: boolean;
-  is_ctoken?: boolean;
-  form_data?: {};
-  client?: string;
-}
-
-export interface EngageArgs {
-  video_id?: string;
-  channel_id?: string;
-  comment_id?: string;
-  comment_action?: string;
-  params?: string;
-  text?: string;
-  target_language?: string;
-}
-
-export interface AccountArgs {
-  new_value?: string | boolean; // TODO: is this correct?
-  setting_item_id?: string;
-  client?: string;
-}
-
-export interface SearchArgs {
-  query?: string,
-  options?: {
-    period?: string,
-    duration?: string,
-    order?: string
-  },
-  client?: string,
-  ctoken?: string,
-  params?: string
-  filters?: any // TODO: what is this type??
-}
-
-export interface AxioslikeResponse {
+export interface ApiResponse {
   success: boolean;
   status_code: number;
   data: any;
 }
 
-export type ActionsResponse = Promise<AxioslikeResponse>;
+export type ActionsResponse = Promise<ApiResponse>;
 
 class Actions {
   #session;
@@ -63,562 +23,24 @@ class Actions {
 
   /**
    * Mimmics the Axios API using Fetch's Response object.
+   * @param response - The response object.
    */
-  async #wrap(response: Response, protobuf?: boolean) {
+  async #wrap(response: Response) {
     return {
       success: response.ok,
       status_code: response.status,
-      data: protobuf ? await response.text() : JSON.parse(await response.text())
+      data: JSON.parse(await response.text())
     };
   }
 
-  /**
-   * Covers `/browse` endpoint, mostly used to access
-   * YouTube's sections such as the home feed, etc
-   * and sometimes to retrieve continuations.
-   *
-   * @param id - browseId or a continuation token
-   * @param args - additional arguments
-   */
-  async browse(id: string, args: BrowseArgs = {}) {
-    if (this.#needsLogin(id) && !this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data: Record<string, any> = {};
-
-    if (args.params)
-      data.params = args.params;
-
-    if (args.is_ctoken) {
-      data.continuation = id;
-    } else {
-      data.browseId = id;
-    }
-
-    if (args.form_data) {
-      data.formData = args.form_data;
-    }
-
-    if (args.client) {
-      data.client = args.client;
-    }
-
-    const response = await this.#session.http.fetch('/browse', {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Covers endpoints used to perform direct interactions
-   * on YouTube.
-   */
-  async engage(action: string, args: EngageArgs = {}) {
-    if (!this.#session.logged_in && !args.hasOwnProperty('text'))
-      throw new InnertubeError('You are not signed in');
-
-    const data: Record<string, any> = {};
-
-    switch (action) {
-      case 'like/like':
-      case 'like/dislike':
-      case 'like/removelike':
-        if (!hasKeys(args, 'video_id'))
-          throw new MissingParamError('Arguments lacks video_id');
-
-        data.target = {};
-        data.target.videoId = args.video_id;
-
-        if (args.params) {
-          data.params = args.params;
-        }
-        break;
-      case 'subscription/subscribe':
-      case 'subscription/unsubscribe':
-        if (!hasKeys(args, 'channel_id'))
-          throw new MissingParamError('Arguments lacks channel_id');
-
-        data.channelIds = [ args.channel_id ];
-        data.params = action === 'subscription/subscribe' ? 'EgIIAhgA' : 'CgIIAhgA';
-        break;
-      case 'comment/create_comment':
-        data.commentText = args.text;
-
-        if (!hasKeys(args, 'video_id'))
-          throw new MissingParamError('Arguments lacks video_id');
-
-        data.createCommentParams = Proto.encodeCommentParams(args.video_id);
-        break;
-      case 'comment/create_comment_reply':
-        if (!hasKeys(args, 'comment_id', 'video_id', 'text'))
-          throw new MissingParamError('Arguments lacks comment_id, video_id or text');
-
-        data.createReplyParams = Proto.encodeCommentReplyParams(args.comment_id, args.video_id);
-        data.commentText = args.text;
-        break;
-      case 'comment/perform_comment_action':
-        const target_action = (() => {
-          switch (args.comment_action) {
-            case 'like':
-              return Proto.encodeCommentActionParams(5, args);
-            case 'dislike':
-              return Proto.encodeCommentActionParams(4, args);
-            case 'translate':
-              return Proto.encodeCommentActionParams(22, args);
-            default:
-              break;
-          }
-        })();
-        data.actions = [ target_action ];
-        break;
-      default:
-        throw new InnertubeError('Action not implemented', action);
-    }
-
-    const response = await this.#session.http.fetch(`/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Covers endpoints related to account management.
-   */
-  async account(action: string, args: AccountArgs = {}) {
-    if (!this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data: Record<string, any> = { client: args.client };
-
-    switch (action) {
-      case 'account/set_setting':
-        data.newValue = {
-          boolValue: args.new_value
-        };
-        data.settingItemId = args.setting_item_id;
-        break;
-      case 'account/accounts_list':
-        break;
-      default:
-        throw new InnertubeError('Action not implemented', action);
-    }
-
-    const response = await this.#session.http.fetch(`/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Endpoint used for search.
-   */
-  async search(args: SearchArgs = {}) {
-    const data: Record<string, any> = { client: args.client };
-
-    if (args.query) {
-      data.query = args.query;
-    }
-
-    if (args.ctoken) {
-      data.continuation = args.ctoken;
-    }
-
-    if (args.params) {
-      data.params = args.params;
-    }
-
-    if (args.filters) {
-      if (args.client == 'YTMUSIC' && args.filters?.type && args.filters.type !== 'all') {
-        data.params = Proto.encodeMusicSearchFilters(args.filters);
-      } else {
-        data.params = Proto.encodeSearchFilters(args.filters);
-      }
-    }
-
-    const response = await this.#session.http.fetch('/search', {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Endpoint used fo Shorts' sound search.
-   */
-  async searchSound(args: { query: string; }) {
-    const data = {
-      query: args.query,
-      client: 'ANDROID'
-    };
-
-    const response = await this.#session.http.fetch('/sfv/search', {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Channel management endpoints.
-   */
-  async channel(action: string, args: { new_name?: string; new_description?: string; client?: string; } = {}) {
-    if (!this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data: Record<string, any> = { client: args.client || 'ANDROID' };
-
-    switch (action) {
-      case 'channel/edit_name':
-        data.givenName = args.new_name;
-        break;
-      case 'channel/edit_description':
-        data.description = args.new_description;
-        break;
-      case 'channel/get_profile_editor':
-        break;
-      default:
-        throw new InnertubeError('Action not implemented', action);
-    }
-
-    const response = await this.#session.http.fetch(`/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Covers endpoints used for playlist management.
-   */
-  async playlist(action: string, args: {
-    title?: string;
-    ids?: string[];
-    playlist_id?: string;
-    action?: string;
-  } = {}) {
-    if (!this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data: Record<string, any> = {};
-
-    switch (action) {
-      case 'playlist/create':
-        data.title = args.title;
-        data.videoIds = args.ids;
-        break;
-      case 'playlist/delete':
-        data.playlistId = args.playlist_id;
-        break;
-      case 'browse/edit_playlist':
-        if (!hasKeys(args, 'ids'))
-          throw new MissingParamError('Arguments lacks ids');
-        data.playlistId = args.playlist_id;
-        data.actions = args.ids.map((id) => {
-          switch (args.action) {
-            case 'ACTION_ADD_VIDEO':
-              return {
-                action: args.action,
-                addedVideoId: id
-              };
-            case 'ACTION_REMOVE_VIDEO':
-              return {
-                action: args.action,
-                setVideoId: id
-              };
-            default:
-              break;
-          }
-        });
-        break;
-      default:
-        throw new InnertubeError('Action not implemented', action);
-    }
-
-    const response = await this.#session.http.fetch(`/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Covers endpoints used for notifications management.
-   */
-  async notifications(action: string, args: {
-    pref?: string;
-    channel_id?: string;
-    ctoken?: string;
-    params?: string
-  } = {}) {
-    if (!this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data: Record<string, any> = {};
-
-    switch (action) {
-      case 'modify_channel_preference':
-        if (!hasKeys(args, 'channel_id', 'pref'))
-          throw new MissingParamError('Arguments lacks channel_id or pref');
-        const pref_types = {
-          PERSONALIZED: 1,
-          ALL: 2,
-          NONE: 3
-        };
-        if (!Object.keys(pref_types).includes(args.pref.toUpperCase()))
-          throw new InnertubeError('Invalid preference type', args.pref);
-        data.params = Proto.encodeNotificationPref(args.channel_id, pref_types[args.pref.toUpperCase() as keyof typeof pref_types]);
-        break;
-      case 'get_notification_menu':
-        data.notificationsMenuRequestType = 'NOTIFICATIONS_MENU_REQUEST_TYPE_INBOX';
-        if (args.ctoken)
-          data.ctoken = args.ctoken;
-        break;
-      case 'record_interactions':
-        data.serializedRecordNotificationInteractionsRequest = args.params;
-        break;
-      case 'get_unseen_count':
-        break;
-      default:
-        throw new InnertubeError('Action not implemented', action);
-    }
-
-    const response = await this.#session.http.fetch(`/notification/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Covers livechat endpoints.
-   */
-  async livechat(action: string, args: {
-    text?: string;
-    video_id?: string;
-    channel_id?: string;
-    ctoken?: string;
-    params?: string;
-    client?: string;
-  } = {}) {
-    // TODO: should client be required?
-    const data: Record<string, any> = { client: args.client };
-
-    switch (action) {
-      case 'live_chat/get_live_chat':
-      case 'live_chat/get_live_chat_replay':
-        data.continuation = args.ctoken;
-        break;
-      case 'live_chat/send_message':
-        if (!hasKeys(args, 'channel_id', 'video_id', 'text'))
-          throw new MissingParamError('Arguments lacks channel_id, video_id or text');
-        data.params = Proto.encodeMessageParams(args.channel_id, args.video_id);
-        data.clientMessageId = uuidv4();
-        data.richMessage = {
-          textSegments: [ {
-            text: args.text
-          } ]
-        };
-        break;
-      case 'live_chat/get_item_context_menu':
-        // Note: this is currently broken due to a recent refactor
-        // TODO: this should be implemented
-        break;
-      case 'live_chat/moderate':
-        data.params = args.params;
-        break;
-      case 'updated_metadata':
-        data.videoId = args.video_id;
-        if (args.ctoken)
-          data.continuation = args.ctoken;
-        break;
-      default:
-        throw new InnertubeError('Action not implemented', action);
-    }
-
-    const response = await this.#session.http.fetch(`/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Endpoint used to retrieve video thumbnails.
-   */
-  async thumbnails(args: { video_id: string; }) {
-    const data = {
-      client: 'ANDROID',
-      videoId: args.video_id
-    };
-
-    const response = await this.#session.http.fetch('/thumbnails', {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Place Autocomplete endpoint, found it in the APK but
-   * doesn't seem to be used anywhere on YouTube (maybe for ads?).
-   *
-   * Ex:
-   * ```js
-   * const places = await session.actions.geo('place_autocomplete', { input: 'San diego cafe' });
-   * console.info(places.data);
-   * ```
-   */
-  async geo(action: string, args: { input: string; }) {
-    if (!this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data = {
-      input: args.input,
-      client: 'ANDROID'
-    };
-
-    const response = await this.#session.http.fetch(`/geo/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Covers endpoints used to report content.
-   */
-  async flag(action: string, args: { action: string; params?: string; }) {
-    if (!this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data: Record<string, any> = {};
-
-    switch (action) {
-      case 'flag/flag':
-        data.action = args.action;
-        break;
-      case 'flag/get_form':
-        data.params = args.params;
-        break;
-      default:
-        throw new InnertubeError('Action not implemented', action);
-    }
-
-    const response = await this.#session.http.fetch(`/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Covers specific YouTube Music endpoints.
-   */
-  async music(action: string, args: { input?: string; }) {
-    const data = {
-      input: args.input || '',
-      client: 'YTMUSIC'
-    };
-
-    const response = await this.#session.http.fetch(`/music/${action}`, {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
-  /**
-   * Mostly used for pagination and specific operations.
-   */
-  async next(args: { video_id?: string; ctoken?: string; client?: string; playlist_id?: string; params?: string } = {}) {
-    const data: Record<string, any> = { client: args.client };
-
-    if (args.ctoken) {
-      data.continuation = args.ctoken;
-    }
-
-    if (args.video_id) {
-      data.videoId = args.video_id;
-    }
-
-    if (args.playlist_id) {
-      data.playlistId = args.playlist_id;
-    }
-
-    if (args.params) {
-      data.params = args.params;
-    }
-
-    const response = await this.#session.http.fetch('/next', {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
   /**
    * Used to retrieve video info.
+   * @param id - The video ID.
+   * @param cpn - Content Playback Nonce.
+   * @param client - The client to use.
+   * @param playlist_id - The playlist ID.
    */
-  async getVideoInfo(id: string, cpn?: string, client?: string) {
+  async getVideoInfo(id: string, cpn?: string, client?: string, playlist_id?: string) {
     const data: Record<string, any> = {
       playbackContext: {
         contentPlaybackContext: {
@@ -647,6 +69,10 @@ class Actions {
       data.cpn = cpn;
     }
 
+    if (playlist_id) {
+      data.playlistId = playlist_id;
+    }
+
     const response = await this.#session.http.fetch('/player', {
       method: 'POST',
       body: JSON.stringify(data),
@@ -658,31 +84,11 @@ class Actions {
     return this.#wrap(response);
   }
 
-  /**
-   * Endpoint used to retrieve user mention suggestions.
-   */
-  async getUserMentionSuggestions(args: { input: string; }) {
-    if (!this.#session.logged_in)
-      throw new InnertubeError('You are not signed in');
-
-    const data = {
-      input: args.input,
-      client: 'ANDROID'
-    };
-
-    const response = await this.#session.http.fetch('/get_user_mention_suggestions', {
-      method: 'POST',
-      body: JSON.stringify(data),
-      headers: {
-        'Content-Type': 'application/json'
-      }
-    });
-
-    return this.#wrap(response);
-  }
-
   /**
    * Makes calls to the playback tracking API.
+   * @param url - The URL to call.
+   * @param client - The client to use.
+   * @param params - Call parameters.
    */
   async stats(url: string, client: { client_name: string; client_version: string }, params: { [key: string]: any }) {
     const s_url = new URL(url);
@@ -703,22 +109,25 @@ class Actions {
 
   /**
    * Executes an API call.
-   * @param action - endpoint
-   * @param args - call arguments
+   * @param action - The endpoint to call.
+   * @param args - Call arguments
    */
   async execute(action: string, args: { [key: string]: any; parse: true; protobuf?: false; serialized_data?: any }) : Promise<ParsedResponse>;
-  async execute(action: string, args: { [key: string]: any; parse?: false; protobuf?: true; serialized_data?: any }) : Promise<ActionsResponse>;
-  async execute(action: string, args: { [key: string]: any; parse?: boolean; protobuf?: boolean; serialized_data?: any }): Promise<ParsedResponse | ActionsResponse> {
+  async execute(action: string, args?: { [key: string]: any; parse?: false; protobuf?: true; serialized_data?: any }) : Promise<ActionsResponse>;
+  async execute(action: string, args?: { [key: string]: any; parse?: boolean; protobuf?: boolean; serialized_data?: any }): Promise<ParsedResponse | ActionsResponse> {
     let data;
 
-    if (!args.protobuf) {
+    if (args && !args.protobuf) {
       data = { ...args };
 
       if (Reflect.has(data, 'browseId')) {
         if (this.#needsLogin(data.browseId) && !this.#session.logged_in)
-          throw new InnertubeError('You are not signed in');
+          throw new InnertubeError('You must be signed in to perform this operation.');
       }
 
+      if (Reflect.has(data, 'override_endpoint'))
+        delete data.override_endpoint;
+
       if (Reflect.has(data, 'parse'))
         delete data.parse;
 
@@ -745,25 +154,31 @@ class Actions {
         data.continuation = data.token;
         delete data.token;
       }
-    } else {
+
+      if (data?.client === 'YTMUSIC') {
+        data.isAudioOnly = true;
+      }
+    } else if (args) {
       data = args.serialized_data;
     }
 
-    const response = await this.#session.http.fetch(action, {
+    const endpoint = Reflect.has(args || {}, 'override_endpoint') ? args?.override_endpoint : action;
+
+    const response = await this.#session.http.fetch(endpoint, {
       method: 'POST',
-      body: args.protobuf ? data : JSON.stringify(data),
+      body: args?.protobuf ? data : JSON.stringify((data || {})),
       headers: {
-        'Content-Type': args.protobuf ?
+        'Content-Type': args?.protobuf ?
           'application/x-protobuf' :
           'application/json'
       }
     });
 
-    if (args.parse) {
+    if (args?.parse) {
       return Parser.parseResponse(await response.json());
     }
 
-    return this.#wrap(response, args.protobuf);
+    return this.#wrap(response);
   }
 
   #needsLogin(id: string) {
@@ -772,6 +187,7 @@ class Actions {
       'FEhistory',
       'FEsubscriptions',
       'FEmusic_listening_review',
+      'FEmusic_library_landing',
       'SPaccount_notifications',
       'SPaccount_privacy',
       'SPtime_watched'
@@ -779,5 +195,4 @@ class Actions {
   }
 }
 
-// TODO: maybe do this inferrance in a more elegant way
 export default Actions;

src/core/Feed.ts

@@ -1,6 +1,6 @@
 import Parser, { ParsedResponse, ReloadContinuationItemsCommand } from '../parser/index';
 import { Memo, ObservedArray } from '../parser/helpers';
-import { InnertubeError } from '../utils/Utils';
+import { concatMemos, InnertubeError } from '../utils/Utils';
 import Actions from './Actions';
 
 import Post from '../parser/classes/Post';
@@ -30,7 +30,6 @@ import ContinuationItem from '../parser/classes/ContinuationItem';
 
 import Video from '../parser/classes/Video';
 
-// TODO: add a way subdivide into sections and return subfeeds?
 class Feed {
   #page: ParsedResponse;
   #continuation?: ObservedArray<ContinuationItem>;
@@ -44,16 +43,14 @@ class Feed {
       this.#page = Parser.parseResponse(data);
     }
 
-    // Xxx: this can be extremely confusing — maybe refactor?
-    const memo =
-            this.#page.on_response_received_commands ?
-              this.#page.on_response_received_commands_memo :
-              this.#page.on_response_received_endpoints ?
-                this.#page.on_response_received_endpoints_memo :
-                this.#page.contents ?
-                  this.#page.contents_memo :
-                  this.#page.on_response_received_actions ?
-                    this.#page.on_response_received_actions_memo : undefined;
+    const memo = concatMemos(
+      this.#page.contents_memo,
+      this.#page.on_response_received_commands_memo,
+      this.#page.on_response_received_endpoints_memo,
+      this.#page.on_response_received_actions_memo,
+      this.#page.sidebar_memo,
+      this.#page.header_memo
+    );
 
     if (!memo)
       throw new InnertubeError('No memo found in feed');
@@ -118,7 +115,7 @@ class Feed {
   /**
    * Returns contents from the page.
    */
-  get contents() {
+  get page_contents() {
     const tab_content = this.#memo.getType(Tab)?.[0]?.content;
     const reload_continuation_items = this.#memo.getType(ReloadContinuationItemsCommand)?.[0];
     const append_continuation_items = this.#memo.getType(AppendContinuationItemsAction)?.[0];
@@ -183,7 +180,7 @@ class Feed {
       if (this.#continuation.length === 0)
         throw new InnertubeError('There are no continuations');
 
-      const response = await this.#continuation[0].endpoint.call(this.#actions, undefined, true);
+      const response = await this.#continuation[0].endpoint.call(this.#actions, { parse: true });
 
       return response;
     }

src/core/FilterableFeed.ts

@@ -13,7 +13,7 @@ class FilterableFeed extends Feed {
   }
 
   /**
-   * Get filters for the feed
+   * Returns the filter chips.
    */
   get filter_chips() {
     if (this.#chips)
@@ -30,6 +30,9 @@ class FilterableFeed extends Feed {
     return this.#chips || [];
   }
 
+  /**
+   * Returns available filters.
+   */
   get filters() {
     return this.filter_chips.map((chip) => chip.text.toString()) || [];
   }
@@ -42,9 +45,7 @@ class FilterableFeed extends Feed {
 
     if (typeof filter === 'string') {
       if (!this.filters.includes(filter))
-        throw new InnertubeError('Filter not found', {
-          available_filters: this.filters
-        });
+        throw new InnertubeError('Filter not found', { available_filters: this.filters });
       target_filter = this.filter_chips.find((chip) => chip.text.toString() === filter);
     } else if (filter.type === 'ChipCloudChip') {
       target_filter = filter;
@@ -54,10 +55,12 @@ class FilterableFeed extends Feed {
 
     if (!target_filter)
       throw new InnertubeError('Filter not found');
+
     if (target_filter.is_selected)
       return this;
 
-    const response = await target_filter.endpoint?.call(this.actions, undefined, true);
+    const response = await target_filter.endpoint?.call(this.actions, { parse: true });
+
     return new Feed(this.actions, response, true);
   }
 }

src/core/InteractionManager.ts

@@ -1,5 +1,6 @@
-import { throwIfMissing } from '../utils/Utils';
+import Proto from '../proto';
 import Actions from './Actions';
+import { throwIfMissing } from '../utils/Utils';
 
 class InteractionManager {
   #actions;
@@ -10,55 +11,119 @@ class InteractionManager {
 
   /**
    * Likes a given video.
+   * @param video_id - The video ID
    */
   async like(video_id: string) {
     throwIfMissing({ video_id });
-    const action = await this.#actions.engage('like/like', { video_id });
+
+    if (!this.#actions.session.logged_in)
+      throw new Error('You must be signed in to perform this operation.');
+
+    const action = await this.#actions.execute('/like/like', {
+      client: 'ANDROID',
+      target: {
+        videoId: video_id
+      }
+    });
+
     return action;
   }
 
   /**
    * Dislikes a given video.
+   * @param video_id - The video ID
    */
   async dislike(video_id: string) {
     throwIfMissing({ video_id });
-    const action = await this.#actions.engage('like/dislike', { video_id });
+
+    if (!this.#actions.session.logged_in)
+      throw new Error('You must be signed in to perform this operation.');
+
+    const action = await this.#actions.execute('/like/dislike', {
+      client: 'ANDROID',
+      target: {
+        videoId: video_id
+      }
+    });
+
     return action;
   }
 
   /**
    * Removes a like/dislike.
+   * @param video_id - The video ID
    */
-  async removeLike(video_id: string) {
+  async removeRating(video_id: string) {
     throwIfMissing({ video_id });
-    const action = await this.#actions.engage('like/removelike', { video_id });
+
+    if (!this.#actions.session.logged_in)
+      throw new Error('You must be signed in to perform this operation.');
+
+    const action = await this.#actions.execute('/like/removelike', {
+      client: 'ANDROID',
+      target: {
+        videoId: video_id
+      }
+    });
+
     return action;
   }
 
   /**
    * Subscribes to a given channel.
+   * @param channel_id - The channel ID
    */
   async subscribe(channel_id: string) {
     throwIfMissing({ channel_id });
-    const action = await this.#actions.engage('subscription/subscribe', { channel_id });
+
+    if (!this.#actions.session.logged_in)
+      throw new Error('You must be signed in to perform this operation.');
+
+    const action = await this.#actions.execute('/subscription/subscribe', {
+      client: 'ANDROID',
+      channelIds: [ channel_id ],
+      params: 'EgIIAhgA'
+    });
+
     return action;
   }
 
   /**
    * Unsubscribes from a given channel.
+   * @param channel_id - The channel ID
    */
   async unsubscribe(channel_id: string) {
     throwIfMissing({ channel_id });
-    const action = await this.#actions.engage('subscription/unsubscribe', { channel_id });
+
+    if (!this.#actions.session.logged_in)
+      throw new Error('You must be signed in to perform this operation.');
+
+    const action = await this.#actions.execute('/subscription/unsubscribe', {
+      client: 'ANDROID',
+      channelIds: [ channel_id ],
+      params: 'CgIIAhgA'
+    });
+
     return action;
   }
 
   /**
    * Posts a comment on a given video.
+   * @param video_id - The video ID
+   * @param text - The comment text
    */
   async comment(video_id: string, text: string) {
     throwIfMissing({ video_id, text });
-    const action = await this.#actions.engage('comment/create_comment', { video_id, text });
+
+    if (!this.#actions.session.logged_in)
+      throw new Error('You must be signed in to perform this operation.');
+
+    const action = await this.#actions.execute('/comment/create_comment', {
+      client: 'ANDROID',
+      commentText: text,
+      createCommentParams: Proto.encodeCommentParams(video_id)
+    });
+
     return action;
   }
 
@@ -71,12 +136,11 @@ class InteractionManager {
   async translate(text: string, target_language: string, args: { video_id?: string; comment_id?: string; } = {}) {
     throwIfMissing({ text, target_language });
 
-    const response = await await this.#actions.engage('comment/perform_comment_action', {
-      video_id: args.video_id,
-      comment_id: args.comment_id,
-      target_language: target_language,
-      comment_action: 'translate',
-      text
+    const target_action = Proto.encodeCommentActionParams(22, { text, target_language, ...args });
+
+    const response = await this.#actions.execute('/comment/perform_comment_action', {
+      client: 'ANDROID',
+      actions: [ target_action ]
     });
 
     const mutation = response.data.frameworkUpdates.entityBatchUpdate.mutations[0].payload.commentEntityPayload;
@@ -92,10 +156,29 @@ class InteractionManager {
   /**
    * Changes notification preferences for a given channel.
    * Only works with channels you are subscribed to.
+   * @param channel_id - The channel ID.
+   * @param type - The notification type.
    */
   async setNotificationPreferences(channel_id: string, type: 'PERSONALIZED' | 'ALL' | 'NONE') {
     throwIfMissing({ channel_id, type });
-    const action = await this.#actions.notifications('modify_channel_preference', { channel_id, pref: type || 'NONE' });
+
+    if (!this.#actions.session.logged_in)
+      throw new Error('You must be signed in to perform this operation.');
+
+    const pref_types = {
+      PERSONALIZED: 1,
+      ALL: 2,
+      NONE: 3
+    };
+
+    if (!Object.keys(pref_types).includes(type.toUpperCase()))
+      throw new Error(`Invalid notification preference type: ${type}`);
+
+    const action = await this.#actions.execute('/notification/modify_channel_preference', {
+      client: 'ANDROID',
+      params: Proto.encodeNotificationPref(channel_id, pref_types[type.toUpperCase() as keyof typeof pref_types])
+    });
+
     return action;
   }
 }

src/core/Music.ts

@@ -1,7 +1,6 @@
 import Session from './Session';
 
 import TrackInfo from '../parser/ytmusic/TrackInfo';
-
 import Search from '../parser/ytmusic/Search';
 import HomeFeed from '../parser/ytmusic/HomeFeed';
 import Explore from '../parser/ytmusic/Explore';
@@ -11,39 +10,95 @@ import Album from '../parser/ytmusic/Album';
 import Playlist from '../parser/ytmusic/Playlist';
 import Recap from '../parser/ytmusic/Recap';
 
-import Parser from '../parser/index';
-import { observe, YTNode } from '../parser/helpers';
-
 import Tab from '../parser/classes/Tab';
 import Tabbed from '../parser/classes/Tabbed';
 import SingleColumnMusicWatchNextResults from '../parser/classes/SingleColumnMusicWatchNextResults';
 import WatchNextTabbedResults from '../parser/classes/WatchNextTabbedResults';
 import SectionList from '../parser/classes/SectionList';
 
+import Message from '../parser/classes/Message';
 import MusicQueue from '../parser/classes/MusicQueue';
 import PlaylistPanel from '../parser/classes/PlaylistPanel';
-import Message from '../parser/classes/Message';
 import MusicDescriptionShelf from '../parser/classes/MusicDescriptionShelf';
 import MusicCarouselShelf from '../parser/classes/MusicCarouselShelf';
 import SearchSuggestionsSection from '../parser/classes/SearchSuggestionsSection';
+import AutomixPreviewVideo from '../parser/classes/AutomixPreviewVideo';
+import MusicTwoRowItem from '../parser/classes/MusicTwoRowItem';
 
+import { observe, ObservedArray, YTNode } from '../parser/helpers';
 import { InnertubeError, throwIfMissing, generateRandomString } from '../utils/Utils';
+import Proto from '../proto';
 
 class Music {
+  #session;
   #actions;
 
   constructor(session: Session) {
+    this.#session = session;
     this.#actions = session.actions;
   }
 
   /**
-   * Retrieves track info.
+   * Retrieves track info. Passing a list item of type MusicTwoRowItem automatically starts a radio.
+   * @param target - Video id or a list item.
    */
-  async getInfo(video_id: string) {
+  getInfo(target: string | MusicTwoRowItem): Promise<TrackInfo> {
+    if (target instanceof MusicTwoRowItem) {
+      return this.#fetchInfoFromListItem(target);
+    } else if (typeof target === 'string') {
+      return this.#fetchInfoFromVideoId(target);
+    }
+
+    throw new InnertubeError('Invalid target, expected either a video id or a valid MusicTwoRowItem', target);
+  }
+
+  async #fetchInfoFromVideoId(video_id: string) {
     const cpn = generateRandomString(16);
 
-    const initial_info = await this.#actions.getVideoInfo(video_id, cpn, 'YTMUSIC');
-    const continuation = this.#actions.execute('/next', { client: 'YTMUSIC', videoId: video_id });
+    const initial_info = this.#actions.execute('/player', {
+      cpn,
+      client: 'YTMUSIC',
+      videoId: video_id,
+      playbackContext: {
+        contentPlaybackContext: {
+          signatureTimestamp: this.#session.player.sts
+        }
+      }
+    });
+
+    const continuation = this.#actions.execute('/next', {
+      client: 'YTMUSIC',
+      videoId: video_id
+    });
+
+    const response = await Promise.all([ initial_info, continuation ]);
+    return new TrackInfo(response, this.#actions, cpn);
+  }
+
+  async #fetchInfoFromListItem(list_item: MusicTwoRowItem | undefined) {
+    if (!list_item)
+      throw new InnertubeError('List item cannot be undefined');
+
+    if (!list_item.endpoint)
+      throw new Error('This item does not have an endpoint.');
+
+    const cpn = generateRandomString(16);
+
+    const initial_info = list_item.endpoint.call(this.#actions, {
+      cpn,
+      client: 'YTMUSIC',
+      playbackContext: {
+        contentPlaybackContext: {
+          signatureTimestamp: this.#session.player.sts
+        }
+      }
+    });
+
+    const continuation = list_item.endpoint.call(this.#actions, {
+      client: 'YTMUSIC',
+      enablePersistentPlaylistPanel: true,
+      override_endpoint: '/next'
+    });
 
     const response = await Promise.all([ initial_info, continuation ]);
     return new TrackInfo(response, this.#actions, cpn);
@@ -51,126 +106,134 @@ class Music {
 
   /**
    * Searches on YouTube Music.
+   * @param query - Search query.
+   * @param filters - Search filters.
    */
   async search(query: string, filters: {
     type?: 'all' | 'song' | 'video' | 'album' | 'playlist' | 'artist';
-  } = {}) {
+  } = {}): Promise<Search> {
     throwIfMissing({ query });
-    const response = await this.#actions.search({ query, filters, client: 'YTMUSIC' });
+
+    const payload: {
+      query: string;
+      client: string;
+      params?: string;
+    } = { query, client: 'YTMUSIC' };
+
+    if (filters.type && filters.type !== 'all') {
+      payload.params = Proto.encodeMusicSearchFilters(filters);
+    }
+
+    const response = await this.#actions.execute('/search', payload);
+
     return new Search(response, this.#actions, { is_filtered: Reflect.has(filters, 'type') && filters.type !== 'all' });
   }
 
   /**
    * Retrieves the home feed.
    */
-  async getHomeFeed() {
-    const response = await this.#actions.browse('FEmusic_home', { client: 'YTMUSIC' });
+  async getHomeFeed(): Promise<HomeFeed> {
+    const response = await this.#actions.execute('/browse', {
+      client: 'YTMUSIC',
+      browseId: 'FEmusic_home'
+    });
+
     return new HomeFeed(response, this.#actions);
   }
 
   /**
    * Retrieves the Explore feed.
    */
-  async getExplore() {
-    const response = await this.#actions.browse('FEmusic_explore', { client: 'YTMUSIC' });
+  async getExplore(): Promise<Explore> {
+    const response = await this.#actions.execute('/browse', {
+      client: 'YTMUSIC',
+      browseId: 'FEmusic_explore'
+    });
+
     return new Explore(response);
     // TODO: return new Explore(response, this.#actions);
   }
 
   /**
-   * Retrieves the Library.
+   * Retrieves the library.
    */
-  getLibrary() {
-    return new Library(this.#actions);
+  async getLibrary(): Promise<Library> {
+    const response = await this.#actions.execute('/browse', {
+      client: 'YTMUSIC',
+      browseId: 'FEmusic_library_landing'
+    });
+
+    return new Library(response, this.#actions);
   }
 
   /**
    * Retrieves artist's info & content.
+   * @param artist_id - The artist id.
    */
-  async getArtist(artist_id: string) {
+  async getArtist(artist_id: string): Promise<Artist> {
     throwIfMissing({ artist_id });
 
     if (!artist_id.startsWith('UC') && !artist_id.startsWith('FEmusic_library_privately_owned_artist'))
       throw new InnertubeError('Invalid artist id', artist_id);
 
-    const response = await this.#actions.browse(artist_id, { client: 'YTMUSIC' });
+    const response = await this.#actions.execute('/browse', {
+      client: 'YTMUSIC',
+      browseId: artist_id
+    });
+
     return new Artist(response, this.#actions);
   }
 
   /**
    * Retrieves album.
+   * @param album_id - The album id.
    */
-  async getAlbum(album_id: string) {
+  async getAlbum(album_id: string): Promise<Album> {
     throwIfMissing({ album_id });
 
     if (!album_id.startsWith('MPR') && !album_id.startsWith('FEmusic_library_privately_owned_release'))
       throw new InnertubeError('Invalid album id', album_id);
 
-    const response = await this.#actions.browse(album_id, { client: 'YTMUSIC' });
+    const response = await this.#actions.execute('/browse', {
+      client: 'YTMUSIC',
+      browseId: album_id
+    });
+
     return new Album(response, this.#actions);
   }
 
   /**
    * Retrieves playlist.
+   * @param playlist_id - The playlist id.
    */
-  async getPlaylist(playlist_id: string) {
+  async getPlaylist(playlist_id: string): Promise<Playlist> {
     throwIfMissing({ playlist_id });
 
     if (!playlist_id.startsWith('VL')) {
       playlist_id = `VL${playlist_id}`;
     }
 
-    const response = await this.#actions.browse(playlist_id, { client: 'YTMUSIC' });
+    const response = await this.#actions.execute('/browse', {
+      client: 'YTMUSIC',
+      browseId: playlist_id
+    });
+
     return new Playlist(response, this.#actions);
   }
 
-  /**
-   * Retrieves song lyrics.
-   */
-  async getLyrics(video_id: string) {
-    throwIfMissing({ video_id });
-
-    const response = await this.#actions.next({ video_id, client: 'YTMUSIC' });
-
-    const data = Parser.parseResponse(response.data);
-
-    const tabs = data.contents.item()
-      .as(SingleColumnMusicWatchNextResults).contents.item()
-      .as(Tabbed).contents.item()
-      .as(WatchNextTabbedResults)
-      .tabs.array().as(Tab);
-
-    const tab = tabs.get({ title: 'Lyrics' });
-
-    if (!tab)
-      throw new InnertubeError('Could not find target tab.');
-
-    const page = await tab.endpoint.call(this.#actions, 'YTMUSIC', true);
-
-    if (!page)
-      throw new InnertubeError('Could not retrieve tab contents, the given id may be invalid or is not a song.');
-
-    if (page.contents.item().key('type').string() === 'Message')
-      throw new InnertubeError(page.contents.item().as(Message).text, video_id);
-
-    const section_list = page.contents.item().as(SectionList).contents.array();
-    const description_shelf = section_list.firstOfType(MusicDescriptionShelf);
-
-    return {
-      text: description_shelf?.description.toString(),
-      footer: description_shelf?.footer
-    };
-  }
-
   /**
    * Retrieves up next.
+   * @param video_id - The video id.
+   * @param automix - Whether to enable automix.
    */
-  async getUpNext(video_id: string) {
+  async getUpNext(video_id: string, automix = true): Promise<PlaylistPanel> {
     throwIfMissing({ video_id });
 
-    const response = await this.#actions.next({ video_id, client: 'YTMUSIC' });
-
-    const data = Parser.parseResponse(response.data);
+    const data = await this.#actions.execute('/next', {
+      videoId: video_id,
+      client: 'YTMUSIC',
+      parse: true
+    });
 
     const tabs = data.contents.item()
       .as(SingleColumnMusicWatchNextResults).contents.item()
@@ -188,20 +251,41 @@ class Music {
     if (!music_queue || !music_queue.content)
       throw new InnertubeError('Music queue was empty, the given id is probably invalid.', music_queue);
 
-    const playlist_panel = music_queue.content.item().as(PlaylistPanel);
+    const playlist_panel = music_queue.content.as(PlaylistPanel);
+
+    if (!playlist_panel.playlist_id && automix) {
+      const automix_preview_video = playlist_panel.contents.firstOfType(AutomixPreviewVideo);
+
+      if (!automix_preview_video)
+        throw new InnertubeError('Automix item not found');
+
+      const page = await automix_preview_video.playlist_video?.endpoint.call(this.#actions, {
+        videoId: video_id,
+        client: 'YTMUSIC',
+        parse: true
+      });
+
+      if (!page)
+        throw new InnertubeError('Could not fetch automix');
+
+      return page.contents_memo.getType(PlaylistPanel)?.[0];
+    }
 
     return playlist_panel;
   }
 
   /**
    * Retrieves related content.
+   * @param video_id - The video id.
    */
-  async getRelated(video_id: string) {
+  async getRelated(video_id: string): Promise<ObservedArray<MusicCarouselShelf | MusicDescriptionShelf>> {
     throwIfMissing({ video_id });
 
-    const response = await this.#actions.next({ video_id, client: 'YTMUSIC' });
-
-    const data = Parser.parseResponse(response.data);
+    const data = await this.#actions.execute('/next', {
+      videoId: video_id,
+      client: 'YTMUSIC',
+      parse: true
+    });
 
     const tabs = data.contents.item()
       .as(SingleColumnMusicWatchNextResults).contents.item()
@@ -214,17 +298,50 @@ class Music {
     if (!tab)
       throw new InnertubeError('Could not find target tab.');
 
-    const page = await tab.endpoint.call(this.#actions, 'YTMUSIC', true);
-
-    if (!page)
-      throw new InnertubeError('Could not retrieve tab contents, the given id may be invalid or is not a song.');
+    const page = await tab.endpoint.call(this.#actions, { client: 'YTMUSIC', parse: true });
 
     const shelves = page.contents.item().as(SectionList).contents.array().as(MusicCarouselShelf, MusicDescriptionShelf);
 
     return shelves;
   }
 
-  async getRecap() {
+  /**
+   * Retrieves song lyrics.
+   * @param video_id - The video id.
+   */
+  async getLyrics(video_id: string): Promise<MusicDescriptionShelf | undefined> {
+    throwIfMissing({ video_id });
+
+    const data = await this.#actions.execute('/next', {
+      videoId: video_id,
+      client: 'YTMUSIC',
+      parse: true
+    });
+
+    const tabs = data.contents.item()
+      .as(SingleColumnMusicWatchNextResults).contents.item()
+      .as(Tabbed).contents.item()
+      .as(WatchNextTabbedResults)
+      .tabs.array().as(Tab);
+
+    const tab = tabs.get({ title: 'Lyrics' });
+
+    if (!tab)
+      throw new InnertubeError('Could not find target tab.');
+
+    const page = await tab.endpoint.call(this.#actions, { client: 'YTMUSIC', parse: true });
+
+    if (page.contents.item().key('type').string() === 'Message')
+      throw new InnertubeError(page.contents.item().as(Message).text, video_id);
+
+    const section_list = page.contents.item().as(SectionList).contents.array();
+    return section_list.firstOfType(MusicDescriptionShelf);
+  }
+
+  /**
+   * Retrieves recap.
+   */
+  async getRecap(): Promise<Recap> {
     const response = await this.#actions.execute('/browse', {
       browseId: 'FEmusic_listening_review',
       client: 'YTMUSIC_ANDROID'
@@ -235,6 +352,7 @@ class Music {
 
   /**
    * Retrieves search suggestions for the given query.
+   * @param query - The query.
    */
   async getSearchSuggestions(query: string) {
     const response = await this.#actions.execute('/music/get_search_suggestions', {
@@ -245,7 +363,7 @@ class Music {
 
     const search_suggestions_section = response.contents_memo.getType(SearchSuggestionsSection)?.[0];
 
-    if (!search_suggestions_section.contents.is_array)
+    if (!search_suggestions_section?.contents.is_array)
       return observe([] as YTNode[]);
 
     return search_suggestions_section?.contents.array();

src/core/OAuth.ts

@@ -241,7 +241,6 @@ class OAuth {
       .replace(/\n/g, '')
       .match(Constants.OAUTH.REGEX.CLIENT_IDENTITY);
 
-    // TODO: check this.
     const groups = client_identity?.groups;
 
     if (!groups)

src/core/Player.ts

@@ -166,20 +166,21 @@ export default class Player {
   }
 
   static extractSigSourceCode(data: string) {
-    const funcs = getStringBetweenStrings(data, 'this.audioTracks};var', '};');
     const calls = getStringBetweenStrings(data, 'function(a){a=a.split("")', 'return a.join("")}');
+    const obj_name = calls?.split('.')?.[0]?.replace(';', '');
+    const functions = getStringBetweenStrings(data, `var ${obj_name}=`, '};');
 
-    if (!funcs || !calls)
-      throw new PlayerError('Failed to extract signature decipher algorithm');
+    if (!functions || !calls)
+      console.warn(new PlayerError('Failed to extract signature decipher algorithm'));
 
-    return `function descramble_sig(a) { a = a.split(""); ${funcs}}${calls} return a.join("") } descramble_sig(sig);`;
+    return `function descramble_sig(a) { a = a.split(""); let ${obj_name}=${functions}}${calls} return a.join("") } descramble_sig(sig);`;
   }
 
   static extractNSigSourceCode(data: string) {
     const sc = `function descramble_nsig(a) { let b=a.split("")${getStringBetweenStrings(data, 'b=a.split("")', '}return b.join("")}')}} return b.join(""); } descramble_nsig(nsig)`;
 
     if (!sc)
-      throw new PlayerError('Failed to extract n-token decipher algorithm');
+      console.warn(new PlayerError('Failed to extract n-token decipher algorithm'));
 
     return sc;
   }

src/core/PlaylistManager.ts

@@ -13,11 +13,20 @@ class PlaylistManager {
 
   /**
    * Creates a playlist.
+   * @param title - The title of the playlist.
+   * @param video_ids - An array of video IDs to add to the playlist.
    */
   async create(title: string, video_ids: string[]) {
     throwIfMissing({ title, video_ids });
 
-    const response = await this.#actions.execute('/playlist/create', { title, ids: video_ids, parse: false });
+    if (!this.#actions.session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
+    const response = await this.#actions.execute('/playlist/create', {
+      title,
+      ids: video_ids,
+      parse: false
+    });
 
     return {
       success: response.success,
@@ -29,10 +38,14 @@ class PlaylistManager {
 
   /**
    * Deletes a given playlist.
+   * @param playlist_id - The playlist ID.
    */
   async delete(playlist_id: string) {
     throwIfMissing({ playlist_id });
 
+    if (!this.#actions.session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
     const response = await this.#actions.execute('playlist/delete', { playlistId: playlist_id });
 
     return {
@@ -45,10 +58,15 @@ class PlaylistManager {
 
   /**
    * Adds videos to a given playlist.
+   * @param playlist_id - The playlist ID.
+   * @param video_ids - An array of video IDs to add to the playlist.
    */
   async addVideos(playlist_id: string, video_ids: string[]) {
     throwIfMissing({ playlist_id, video_ids });
 
+    if (!this.#actions.session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
     const response = await this.#actions.execute('/browse/edit_playlist', {
       playlistId: playlist_id,
       actions: video_ids.map((id) => ({
@@ -66,11 +84,20 @@ class PlaylistManager {
 
   /**
    * Removes videos from a given playlist.
+   * @param playlist_id - The playlist ID.
+   * @param video_ids - An array of video IDs to remove from the playlist.
    */
   async removeVideos(playlist_id: string, video_ids: string[]) {
     throwIfMissing({ playlist_id, video_ids });
 
-    const info = await this.#actions.execute('/browse', { browseId: `VL${playlist_id}`, parse: true });
+    if (!this.#actions.session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
+    const info = await this.#actions.execute('/browse', {
+      browseId: `VL${playlist_id}`,
+      parse: true
+    });
+
     const playlist = new Playlist(this.#actions, info, true);
 
     if (!playlist.info.is_editable)
@@ -115,11 +142,21 @@ class PlaylistManager {
 
   /**
    * Moves a video to a new position within a given playlist.
+   * @param playlist_id - The playlist ID.
+   * @param moved_video_id - The video ID to move.
+   * @param predecessor_video_id - The video ID to move the moved video before.
    */
   async moveVideo(playlist_id: string, moved_video_id: string, predecessor_video_id: string) {
     throwIfMissing({ playlist_id, moved_video_id, predecessor_video_id });
 
-    const info = await this.#actions.execute('/browse', { browseId: `VL${playlist_id}`, parse: true });
+    if (!this.#actions.session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
+    const info = await this.#actions.execute('/browse', {
+      browseId: `VL${playlist_id}`,
+      parse: true
+    });
+
     const playlist = new Playlist(this.#actions, info, true);
 
     if (!playlist.info.is_editable)
@@ -157,7 +194,10 @@ class PlaylistManager {
       movedSetVideoIdPredecessor: set_video_id_1
     });
 
-    const response = await this.#actions.execute('/browse/edit_playlist', { ...payload, parse: false });
+    const response = await this.#actions.execute('/browse/edit_playlist', {
+      ...payload,
+      parse: false
+    });
 
     return {
       playlist_id,

src/core/Session.ts

@@ -1,12 +1,11 @@
 import Player from './Player';
-import Proto from '../proto/index';
 import Actions from './Actions';
 import Constants from '../utils/Constants';
 import UniversalCache from '../utils/Cache';
 import EventEmitterLike from '../utils/EventEmitterLike';
 
 import HTTPClient, { FetchFunction } from '../utils/HTTPClient';
-import { DeviceCategory, generateRandomString, getRandomUserAgent, InnertubeError, SessionError } from '../utils/Utils';
+import { DeviceCategory, getRandomUserAgent, InnertubeError, SessionError } from '../utils/Utils';
 import OAuth, { Credentials, OAuthAuthErrorEventHandler, OAuthAuthEventHandler, OAuthAuthPendingEventHandler } from './OAuth';
 
 export enum ClientType {
@@ -21,10 +20,15 @@ export interface Context {
     hl: string;
     gl: string;
     remoteHost: string;
+    screenDensityFloat: number;
+    screenHeightPoints: number;
+    screenPixelDensity: number;
+    screenWidthPoints: number;
     visitorData: string;
     userAgent: string;
     clientName: string;
     clientVersion: string;
+    clientScreen?: string,
     androidSdkVersion?: string;
     osName: string;
     osVersion: string;
@@ -42,6 +46,9 @@ export interface Context {
   user: {
     lockedSafetyMode: false;
   };
+  thirdParty?: {
+    embedUrl: string;
+  };
   request: {
     useSsl: true;
   };
@@ -49,6 +56,7 @@ export interface Context {
 
 export interface SessionOptions {
   lang?: string;
+  account_index?: number;
   device_category?: DeviceCategory;
   client_type?: ClientType;
   timezone?: string;
@@ -61,6 +69,7 @@ export default class Session extends EventEmitterLike {
   #api_version;
   #key;
   #context;
+  #account_index;
   #player;
 
   oauth;
@@ -69,9 +78,10 @@ export default class Session extends EventEmitterLike {
   actions;
   cache;
 
-  constructor(context: Context, api_key: string, api_version: string, player: Player, cookie?: string, fetch?: FetchFunction, cache?: UniversalCache) {
+  constructor(context: Context, api_key: string, api_version: string, account_index: number, player: Player, cookie?: string, fetch?: FetchFunction, cache?: UniversalCache) {
     super();
     this.#context = context;
+    this.#account_index = account_index;
     this.#key = api_key;
     this.#api_version = api_version;
     this.#player = player;
@@ -100,12 +110,20 @@ export default class Session extends EventEmitterLike {
   }
 
   static async create(options: SessionOptions = {}) {
-    const { context, api_key, api_version } = await Session.getSessionData(options.lang, options.device_category, options.client_type, options.timezone, options.fetch);
-    return new Session(context, api_key, api_version, await Player.create(options.cache, options.fetch), options.cookie, options.fetch, options.cache);
+    const { context, api_key, api_version, account_index } = await Session.getSessionData(
+      options.lang,
+      options.account_index,
+      options.device_category,
+      options.client_type,
+      options.timezone,
+      options.fetch
+    );
+    return new Session(context, api_key, api_version, account_index, await Player.create(options.cache, options.fetch), options.cookie, options.fetch, options.cache);
   }
 
   static async getSessionData(
     lang = 'en-US',
+    account_index = 0,
     device_category: DeviceCategory = 'desktop',
     client_name: ClientType = ClientType.WEB,
     tz: string = Intl.DateTimeFormat().resolvedOptions().timeZone,
@@ -136,16 +154,16 @@ export default class Session extends EventEmitterLike {
 
     const [ [ device_info ], api_key ] = ytcfg;
 
-    const id = generateRandomString(11);
-    const timestamp = Math.floor(Date.now() / 1000);
-    const visitor_data = Proto.encodeVisitorData(id, timestamp);
-
     const context: Context = {
       client: {
         hl: device_info[0],
         gl: device_info[2],
         remoteHost: device_info[3],
-        visitorData: visitor_data,
+        screenDensityFloat: 1,
+        screenHeightPoints: 720,
+        screenPixelDensity: 1,
+        screenWidthPoints: 1280,
+        visitorData: device_info[13],
         userAgent: device_info[14],
         clientName: client_name,
         clientVersion: device_info[16],
@@ -157,7 +175,7 @@ export default class Session extends EventEmitterLike {
         timeZone: device_info[79],
         browserName: device_info[86],
         browserVersion: device_info[87],
-        originalUrl: Constants.URLS.API.BASE,
+        originalUrl: Constants.URLS.YT_BASE,
         deviceMake: device_info[11],
         deviceModel: device_info[12],
         utcOffsetMinutes: new Date().getTimezoneOffset()
@@ -170,7 +188,7 @@ export default class Session extends EventEmitterLike {
       }
     };
 
-    return { context, api_key, api_version };
+    return { context, api_key, api_version, account_index };
   }
 
   async signIn(credentials?: Credentials): Promise<void> {
@@ -206,7 +224,7 @@ export default class Session extends EventEmitterLike {
 
   async signOut() {
     if (!this.logged_in)
-      throw new InnertubeError('You are not signed in');
+      throw new InnertubeError('You must be signed in to perform this operation.');
 
     const response = await this.oauth.revokeCredentials();
     this.logged_in = false;
@@ -230,6 +248,10 @@ export default class Session extends EventEmitterLike {
     return this.#context.client.clientName;
   }
 
+  get account_index() {
+    return this.#account_index;
+  }
+
   get context() {
     return this.#context;
   }

src/core/Studio.ts

@@ -1,15 +1,15 @@
 import Proto from '../proto';
 import Session from './Session';
-import { AxioslikeResponse } from './Actions';
+import { ApiResponse } from './Actions';
 import { InnertubeError, MissingParamError, uuidv4 } from '../utils/Utils';
 import { Constants } from '../utils';
 
-export interface UploadResult {
+interface UploadResult {
   status: string;
   scottyResourceId: string;
 }
 
-export interface InitialUploadData {
+interface InitialUploadData {
   frontend_upload_id: string;
   upload_id: string;
   upload_url: string;
@@ -18,6 +18,17 @@ export interface InitialUploadData {
 }
 
 export interface VideoMetadata {
+  title?: string;
+  description?: string;
+  tags?: string[];
+  category?: number;
+  license?: string;
+  age_restricted?: boolean;
+  made_for_kids?: boolean;
+  privacy?: 'PUBLIC' | 'PRIVATE' | 'UNLISTED';
+}
+
+export interface UploadedVideoMetadata {
   title?: string;
   description?: string;
   privacy?: 'PUBLIC' | 'PRIVATE' | 'UNLISTED';
@@ -39,7 +50,10 @@ class Studio {
    * const response = await yt.studio.setThumbnail(video_id, buffer);
    * ```
    */
-  async setThumbnail(video_id: string, buffer: Uint8Array): Promise<AxioslikeResponse> {
+  async setThumbnail(video_id: string, buffer: Uint8Array): Promise<ApiResponse> {
+    if (!this.#session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
     if (!video_id || !buffer)
       throw new MissingParamError('One or more parameters are missing.');
 
@@ -53,6 +67,34 @@ class Studio {
     return response;
   }
 
+  /**
+   * Updates given video's metadata.
+   * @example
+   * ```ts
+   * const response = await yt.studio.updateVideoMetadata('videoid', {
+   *   tags: [ 'astronomy', 'NASA', 'APOD' ],
+   *   title: 'Artemis Mission',
+   *   description: 'A nicely written description...',
+   *   category: 27,
+   *   license: 'creative_commons'
+   *   // ...
+   * });
+   * ```
+   */
+  async updateVideoMetadata(video_id: string, metadata: VideoMetadata) {
+    if (!this.#session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
+    const payload = Proto.encodeVideoMetadataPayload(video_id, metadata);
+
+    const response = await this.#session.actions.execute('/video_manager/metadata_update', {
+      protobuf: true,
+      serialized_data: payload
+    });
+
+    return response;
+  }
+
   /**
    * Uploads a video to YouTube.
    * @example
@@ -61,7 +103,10 @@ class Studio {
    * const response = await yt.studio.upload(file.buffer, { title: 'Wow!' });
    * ```
    */
-  async upload(file: BodyInit, metadata: VideoMetadata = {}): Promise<AxioslikeResponse> {
+  async upload(file: BodyInit, metadata: UploadedVideoMetadata = {}): Promise<ApiResponse> {
+    if (!this.#session.logged_in)
+      throw new InnertubeError('You must be signed in to perform this operation.');
+
     const initial_data = await this.#getInitialUploadData();
     const upload_result = await this.#uploadVideo(initial_data.upload_url, file);
 
@@ -128,7 +173,7 @@ class Studio {
     return data;
   }
 
-  async #setVideoMetadata(initial_data: InitialUploadData, upload_result: UploadResult, metadata: VideoMetadata) {
+  async #setVideoMetadata(initial_data: InitialUploadData, upload_result: UploadResult, metadata: UploadedVideoMetadata) {
     const metadata_payload = {
       resourceId: {
         scottyResourceId: {

src/parser/README.md

@@ -1,6 +1,25 @@
 # Parser
 
-Sanitizes and standardizes InnerTube responses while maintaining the integrity of the data. Also [drastically improves](https://github.com/LuanRT/YouTube.js/blob/main/lib/parser/youtube/Library.js#L44) how API calls are made and handled. 
+Sanitizes and standardizes InnerTube responses while maintaining the integrity of the data. Also [drastically improves](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/youtube/Library.ts#L69) how API calls are made and handled. 
+
+<ol>
+  <li>
+    <a href="#api">API</a>
+  </li>
+  <li>
+    <a href="#usage">Usage</a>
+    <ul>
+      <li><a href="#observedarray">ObservedArray</a></li>
+      <li><a href="#superparsedresponse">SuperParsedResponse</a></li>
+      <li><a href="#ytnode">YTNode</a></li>
+      <li><a href="#memo">Memo</a></li>
+    </ul>
+  </li>
+  <li><a href="#adding-new-nodes">Adding new nodes</a></li>
+  <li><a href="#how-it-works">How it works</a></li>
+</ol>
+
+___
 
 ## API
 
@@ -20,7 +39,7 @@ Responsible for parsing individual nodes.
 | --- | --- | --- |
 | data | `any` | The data |
 | requireArray | `?boolean` | Whether the response should be an array |
-| validTypes | `YTNodeConstructor<T> | YTNodeConstructor<T>[] | undefined` | The types of YTNodes are allowed |
+| validTypes | `YTNodeConstructor<T> \| YTNodeConstructor<T>[] \| undefined` | Types of `YTNode` allowed |
 
 When `requireArray` is `true`, the response will be an `ObservedArray<YTNodes>`.
 
@@ -43,6 +62,8 @@ Unlike `parse`, this can be used to parse the entire response object.
 | --- | --- | --- |
 | data | `object` | Raw InnerTube response |
 
+## Usage
+
 ## ObservedArray
 You may use `ObservedArray<T extends YTNode>` as a normal array, but it provides additional methods for typesafe access and casting.
 
@@ -58,13 +79,13 @@ const firstVideo = feed.firstOfType(GridVideo);
 // We may cast the whole array to a GridVideo[] and throw if we have any non-GridVideo elements:
 const allVideos = feed.as(GridVideo);
 
-// There's some extra methods for ObservedArray<T extends YTNode>
+// There are some extra methods for ObservedArray<T extends YTNode>
 // which we use internally but not documented here (yet).
 // see the source code for more details.
 ```
 
 ## SuperParsedResponse
-Represents a parsed response in an unknown state. Either a `YTNode` or a `ObservedArray<YTNode>` or `null`.
+Represents a parsed response in an unknown state. Either a `YTNode` or an `ObservedArray<YTNode>` or `null`.
 
 You will need to assert the type and unwrap the response to get the actual value.
 
@@ -89,7 +110,7 @@ const is_null = response.is_null;
 ## YTNode
 All renderers returned by InnerTube are converted to this generic class and then extended for the specific renderers.
 
-This class is allows us a typesafe way to use data returned by the InnerTube API.
+This class is what allows us a typesafe way to use data returned by the InnerTube API.
 
 Here's how to use this class to access returned data:
 
@@ -116,14 +137,14 @@ if (node.is(TwoColumnSearchResults, VideoList)) {
 ```
 
 ### Accessing properties without casting
-Sometimes multiple nodes have the same properties and we don't want to check the type of the node before accessing the property, for example the property "contents" is used by many node types, and we may add more in the future, as such we want to only assert the property instead of casting to a specific type.
+Sometimes multiple nodes have the same properties and we don't want to check the type of the node before accessing the property, for example, the property "contents" is used by many node types, and we may add more in the future, as such we want to only assert the property instead of casting to a specific type.
 
 ```ts
-// Accesing a property on a node which you aren't sure if it exists.
+// Accessing a property on a node which you aren't sure if it exists.
 const prop = node.key("contents");
 // This returns the value wrapped into a `Maybe` type
 // which you can use to find the type of the value
-// note however, this throws an error if the key doesn't exist
+// note, however, this throws an error if the key doesn't exist
 // we may want to check for the key before accessing it.
 if (node.hasKey("contents")) {
   const prop = node.key("contents");
@@ -146,7 +167,7 @@ if (prop.isInstanceof(Text)) {
   });
 }
 
-// There's some special methods for using with the parser —
+// There are some special methods for using with the parser —
 // such as getting the value as a YTNode.
 const prop = node.key("contents");
 if (prop.isNode()) {
@@ -171,7 +192,7 @@ const prop = node.key("contents");
 if (prop.isObserved()) {
   const array = prop.observed();
 
-  // Now we may use the all the ObservedArray methods as normal,
+  // Now we may use all the ObservedArray methods as normal,
   // like finding nodes of a certain type for example.
   const results = array.filterType(GridVideo);
 }
@@ -187,7 +208,7 @@ if (prop.isParsed()) {
   const videos = results.filterType(Video);
 }
 
-// Sometimes we just want to debug something and not interested in finding the type.
+// Sometimes we just want to debug something and are not interested in finding the type.
 // This will, however, warn you when being used.
 const prop = node.key("contents");
 const value = prop.any();
@@ -200,7 +221,7 @@ if (prop.isArray()) {
   // This will return Maybe[]
 }
 
-// Or if you want zero typesafety you can use the `array` method.
+// Or if you want zero type safety you can use the `array` method.
 const prop = node.key("contents");
 if (prop.isArray()) {
   const array = prop.array();
@@ -221,13 +242,16 @@ const videos = response.contents_memo.getType(Video);
 
 `Memo` extends `Map<string, YTNode[]>` and can be used as a normal `Map` too if you want.
 
+## Adding new nodes
+Instructions can be found [here](https://github.com/LuanRT/YouTube.js/blob/main/docs/updating-the-parser.md).
+
 ## How it works
 
-If you decompile a YouTube client and analize it for a while you will notice that it has classes named `protos/youtube/api/innertube/MusicItemRenderer`, `protos/youtube/api/innertube/SectionListRenderer`, etc. 
+If you decompile a YouTube client and analyze it for a while you will notice that it has classes named `protos/youtube/api/innertube/MusicItemRenderer`, `protos/youtube/api/innertube/SectionListRenderer`, etc. 
 
-These classes are used to parse objects from the response, map them into models and generate the UI. The website works in a similar way, the difference is that it uses plain JSON (likely converted from protobuf server-side, hence the weird structure of the response).
+These classes are used to parse objects from the response, map them into models and generate the UI. The website works similarly, the difference is that it uses plain JSON (likely converted from protobuf server-side, hence the weird structure of the response).
 
-Here we're taking a similar approach, the parser goes through all the renderers and parses their inner element(s). The final result is a nicely structured JSON, and on top of that it also parses navigation endpoints which allows us to make an API call with all required parameters in one line and even emulate client actions (eg; clicking a button).
+Here we're taking a similar approach, the parser goes through all the renderers and parses their inner element(s). The final result is a nicely structured JSON, and on top of that, it also parses navigation endpoints which allow us to make an API call with all required parameters in one line and even emulate client actions (eg; clicking a button).
 
 Here is your average, arguably ugly InnerTube response:
 <details>

src/parser/classes/AudioOnlyPlayability.ts

@@ -0,0 +1,14 @@
+import { YTNode } from '../helpers';
+
+class AudioOnlyPlayability extends YTNode {
+  static type = 'AudioOnlyPlayability';
+
+  audio_only_availability: string;
+
+  constructor (data: any) {
+    super();
+    this.audio_only_availability = data.audioOnlyAvailability;
+  }
+}
+
+export default AudioOnlyPlayability;

src/parser/classes/BrowserMediaSession.ts

@@ -0,0 +1,18 @@
+import Text from './misc/Text';
+import Thumbnail from './misc/Thumbnail';
+import { YTNode } from '../helpers';
+
+class BrowserMediaSession extends YTNode {
+  static type = 'BrowserMediaSession';
+
+  album;
+  thumbnails;
+
+  constructor (data: any) {
+    super();
+    this.album = new Text(data.album);
+    this.thumbnails = Thumbnail.fromResponse(data.thumbnailDetails);
+  }
+}
+
+export default BrowserMediaSession;

src/parser/classes/Card.ts

@@ -6,8 +6,8 @@ class Card extends YTNode {
 
   teaser;
   content;
-  card_id: string;
-  feature: string;
+  card_id: string | null;
+  feature: string | null;
 
   cue_ranges: {
     start_card_active_ms: string;
@@ -18,10 +18,10 @@ class Card extends YTNode {
 
   constructor(data: any) {
     super();
-    this.teaser = Parser.parse(data.teaser);
-    this.content = Parser.parse(data.content);
-    this.card_id = data.cardId;
-    this.feature = data.feature;
+    this.teaser = Parser.parseItem(data.teaser);
+    this.content = Parser.parseItem(data.content);
+    this.card_id = data.cardId || null;
+    this.feature = data.feature || null;
 
     this.cue_ranges = data.cueRanges.map((cr: any) => ({
       start_card_active_ms: cr.startCardActiveMs,
@@ -32,4 +32,4 @@ class Card extends YTNode {
   }
 }
 
-export default Card;
+export default Card;

src/parser/classes/CarouselHeader.ts

@@ -0,0 +1,13 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+export default class CarouselHeader extends YTNode {
+  static type = 'CarouselHeader';
+
+  contents: YTNode[];
+
+  constructor(data: any) {
+    super();
+    this.contents = Parser.parseArray(data.contents);
+  }
+}

src/parser/classes/CarouselItem.ts

@@ -0,0 +1,23 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+import Thumbnail from './misc/Thumbnail';
+
+export default class CarouselItem extends YTNode {
+  static type = 'CarouselItem';
+
+  items: YTNode[];
+  background_color: string;
+  layout_style: string;
+  pagination_thumbnails: Thumbnail[];
+  paginator_alignment: string;
+
+  constructor (data: any) {
+    super();
+    this.items = Parser.parseArray(data.carouselItems);
+    this.background_color = data.backgroundColor;
+    this.layout_style = data.layoutStyle;
+    this.pagination_thumbnails = Thumbnail.fromResponse(data.paginationThumbnails);
+    this.paginator_alignment = data.paginatorAlignment;
+  }
+}

src/parser/classes/CollaboratorInfoCardContent.ts

@@ -0,0 +1,26 @@
+import Text from './misc/Text';
+import Thumbnail from './misc/Thumbnail';
+import NavigationEndpoint from './NavigationEndpoint';
+
+import { YTNode } from '../helpers';
+
+class CollaboratorInfoCardContent extends YTNode {
+  static type = 'CollaboratorInfoCardContent';
+
+  channel_avatar: Thumbnail[];
+  custom_text: Text;
+  channel_name: Text;
+  subscriber_count: Text;
+  endpoint: NavigationEndpoint;
+
+  constructor(data: any) {
+    super();
+    this.channel_avatar = Thumbnail.fromResponse(data.channelAvatar);
+    this.custom_text = new Text(data.customText);
+    this.channel_name = new Text(data.channelName);
+    this.subscriber_count = new Text(data.subscriberCountText);
+    this.endpoint = new NavigationEndpoint(data.endpoint);
+  }
+}
+
+export default CollaboratorInfoCardContent;

src/parser/classes/CompactStation.ts

@@ -0,0 +1,25 @@
+import { YTNode } from '../helpers';
+
+import Text from './misc/Text';
+import Thumbnail from './misc/Thumbnail';
+import NavigationEndpoint from './NavigationEndpoint';
+
+export default class CompactStation extends YTNode {
+  static type = 'CompactStation';
+
+  title: Text;
+  description: Text;
+  video_count: Text;
+  endpoint: NavigationEndpoint;
+  thumbnail: Thumbnail[];
+
+  constructor(data: any) {
+    super();
+
+    this.title = new Text(data.title);
+    this.description = new Text(data.description);
+    this.video_count = new Text(data.videoCountText);
+    this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
+    this.thumbnail = Thumbnail.fromResponse(data.thumbnail);
+  }
+}

src/parser/classes/ConfirmDialog.ts

@@ -0,0 +1,24 @@
+import Parser from '..';
+import Text from './misc/Text';
+import Button from './Button';
+
+import { YTNode } from '../helpers';
+
+class ConfirmDialog extends YTNode {
+  static type = 'ConfirmDialog';
+
+  title: Text;
+  confirm_button: Button | null;
+  cancel_button: Button | null;
+  dialog_messages: Text[];
+
+  constructor (data: any) {
+    super();
+    this.title = new Text(data.title);
+    this.confirm_button = Parser.parseItem<Button>(data.confirmButton, Button);
+    this.cancel_button = Parser.parseItem<Button>(data.cancelButton, Button);
+    this.dialog_messages = data.dialogMessages.map((txt: any) => new Text(txt));
+  }
+}
+
+export default ConfirmDialog;

src/parser/classes/DefaultPromoPanel.ts

@@ -0,0 +1,36 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+import Text from './misc/Text';
+import NavigationEndpoint from './NavigationEndpoint';
+
+export default class DefaultPromoPanel extends YTNode {
+  static type = 'DefaultPromoPanel';
+
+  title: Text;
+  description: Text;
+  endpoint: NavigationEndpoint;
+  large_form_factor_background_thumbnail;
+  small_form_factor_background_thumbnail;
+  scrim_color_values: number[];
+  min_panel_display_duration_ms: number;
+  min_video_play_duration_ms: number;
+  scrim_duration: number;
+  metadata_order: string;
+  panel_layout: string;
+
+  constructor(data: any) {
+    super();
+    this.title = new Text(data.title);
+    this.description = new Text(data.description);
+    this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
+    this.large_form_factor_background_thumbnail = Parser.parseItem(data.largeFormFactorBackgroundThumbnail);
+    this.small_form_factor_background_thumbnail = Parser.parseItem(data.smallFormFactorBackgroundThumbnail);
+    this.scrim_color_values = data.scrimColorValues;
+    this.min_panel_display_duration_ms = data.minPanelDisplayDurationMs;
+    this.min_video_play_duration_ms = data.minVideoPlayDurationMs;
+    this.scrim_duration = data.scrimDuration;
+    this.metadata_order = data.metadataOrder;
+    this.panel_layout = data.panelLayout;
+  }
+}

src/parser/classes/FeedFilterChipBar.ts

@@ -1,15 +1,14 @@
 import Parser from '../index';
 import { YTNode } from '../helpers';
+import ChipCloudChip from './ChipCloudChip';
 
-class FeedFilterChipBar extends YTNode {
+export default class FeedFilterChipBar extends YTNode {
   static type = 'FeedFilterChipBar';
 
   contents;
 
   constructor(data: any) {
     super();
-    this.contents = Parser.parse(data.contents);
+    this.contents = Parser.parseArray<ChipCloudChip>(data.contents, ChipCloudChip);
   }
-}
-
-export default FeedFilterChipBar;
+}

src/parser/classes/GameCard.ts

@@ -0,0 +1,13 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+export default class GameCard extends YTNode {
+  static type = 'GameCard';
+
+  game;
+
+  constructor(data: any) {
+    super();
+    this.game = Parser.parseItem(data.game);
+  }
+}

src/parser/classes/GameDetails.ts

@@ -0,0 +1,24 @@
+import { YTNode } from '../helpers';
+
+import Text from './misc/Text';
+import Thumbnail from './misc/Thumbnail';
+import NavigationEndpoint from './NavigationEndpoint';
+
+export default class GameDetails extends YTNode {
+  static type = 'GameDetails';
+
+  title: Text;
+  box_art: Thumbnail[];
+  box_art_overlay_text: Text;
+  endpoint: NavigationEndpoint;
+  is_official_box_art: boolean;
+
+  constructor(data: any) {
+    super();
+    this.title = new Text(data.title);
+    this.box_art = Thumbnail.fromResponse(data.boxArt);
+    this.box_art_overlay_text = new Text(data.boxArtOverlayText);
+    this.endpoint = new NavigationEndpoint(data.endpoint);
+    this.is_official_box_art = data.isOfficialBoxArt;
+  }
+}

src/parser/classes/Grid.ts

@@ -5,23 +5,34 @@ class Grid extends YTNode {
   static type = 'Grid';
 
   items;
-  is_collapsible: boolean;
-  visible_row_count: string;
-  target_id: string;
+  is_collapsible?: boolean;
+  visible_row_count?: string;
+  target_id?: string;
   continuation: string | null;
   header?;
 
   constructor(data: any) {
     super();
-    this.items = Parser.parse(data.items);
-    this.is_collapsible = data.isCollapsible;
-    this.visible_row_count = data.visibleRowCount;
-    this.target_id = data.targetId;
-    this.continuation = data.continuations?.[0]?.nextContinuationData?.continuation || null;
+
+    this.items = Parser.parseArray(data.items);
 
     if (data.header) {
       this.header = Parser.parse(data.header);
     }
+
+    if (data.isCollapsible) {
+      this.is_collapsible = data.isCollapsible;
+    }
+
+    if (data.visibleRowCount) {
+      this.visible_row_count = data.visibleRowCount;
+    }
+
+    if (data.targetId) {
+      this.target_id = data.targetId;
+    }
+
+    this.continuation = data.continuations?.[0]?.nextContinuationData?.continuation || null;
   }
 
   // XXX: alias for consistency

src/parser/classes/InteractiveTabbedHeader.ts

@@ -0,0 +1,36 @@
+import Parser from '..';
+import { ObservedArray, YTNode } from '../helpers';
+
+import Text from './misc/Text';
+import Thumbnail from './misc/Thumbnail';
+import SubscribeButton from './SubscribeButton';
+import MetadataBadge from './MetadataBadge';
+import Button from './Button';
+
+export default class InteractiveTabbedHeader extends YTNode {
+  static type = 'InteractiveTabbedHeader';
+
+  header_type: string;
+  title: Text;
+  description: Text;
+  metadata: Text;
+  badges: MetadataBadge[];
+  box_art: Thumbnail[];
+  banner: Thumbnail[];
+  buttons: ObservedArray<SubscribeButton | Button>;
+  auto_generated: Text;
+
+  constructor(data: any) {
+    super();
+
+    this.header_type = data.type;
+    this.title = new Text(data.title);
+    this.description = new Text(data.description);
+    this.metadata = new Text(data.metadata);
+    this.badges = Parser.parseArray<MetadataBadge>(data.badges, MetadataBadge);
+    this.box_art = Thumbnail.fromResponse(data.boxArt);
+    this.banner = Thumbnail.fromResponse(data.banner);
+    this.buttons = Parser.parseArray<SubscribeButton | Button>(data.buttons, [ SubscribeButton, Button ]);
+    this.auto_generated = new Text(data.autoGenerated);
+  }
+}

src/parser/classes/ItemSection.ts

@@ -3,17 +3,18 @@ import ItemSectionHeader from './ItemSectionHeader';
 
 import { YTNode } from '../helpers';
 import ItemSectionTabbedHeader from './ItemSectionTabbedHeader';
+import CommentsHeader from './comments/CommentsHeader';
 
 class ItemSection extends YTNode {
   static type = 'ItemSection';
 
-  header: ItemSectionHeader | ItemSectionTabbedHeader | null;
+  header: CommentsHeader | ItemSectionHeader | ItemSectionTabbedHeader | null;
   contents;
   target_id;
 
   constructor(data: any) {
     super();
-    this.header = Parser.parseItem<ItemSectionHeader | ItemSectionTabbedHeader>(data.header, [ ItemSectionHeader, ItemSectionTabbedHeader ]);
+    this.header = Parser.parseItem<CommentsHeader | ItemSectionHeader | ItemSectionTabbedHeader>(data.header);
     this.contents = Parser.parse(data.contents, true);
 
     if (data.targetId || data.sectionIdentifier) {

src/parser/classes/LiveChatDialog.ts

@@ -0,0 +1,19 @@
+import Parser from '..';
+import Text from './misc/Text';
+import Button from './Button';
+import { YTNode } from '../helpers';
+
+class LiveChatDialog extends YTNode {
+  static type = 'LiveChatDialog';
+
+  confirm_button: Button | null;
+  dialog_messages: Text[];
+
+  constructor (data: any) {
+    super();
+    this.confirm_button = Parser.parseItem<Button>(data.confirmButton, Button);
+    this.dialog_messages = data.dialogMessages.map((el: any) => new Text(el));
+  }
+}
+
+export default LiveChatDialog;

src/parser/classes/MetadataScreen.ts

@@ -0,0 +1,15 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+class MetadataScreen extends YTNode {
+  static type = 'MetadataScreen';
+
+  section_list;
+
+  constructor (data: any) {
+    super();
+    this.section_list = Parser.parseItem(data);
+  }
+}
+
+export default MetadataScreen;

src/parser/classes/MusicDetailHeader.ts

@@ -36,12 +36,12 @@ class MusicDetailHeader extends YTNode {
     this.thumbnails = Thumbnail.fromResponse(data.thumbnail.croppedSquareThumbnailRenderer.thumbnail);
     this.badges = Parser.parse(data.subtitleBadges);
 
-    const author = this.subtitle.runs?.find((run) => (run as TextRun)?.endpoint?.browse?.id.startsWith('UC'));
+    const author = this.subtitle.runs?.find((run) => (run as TextRun)?.endpoint?.payload?.browseId.startsWith('UC'));
 
     if (author) {
       this.author = {
         name: (author as TextRun).text,
-        channel_id: (author as TextRun).endpoint?.browse?.id,
+        channel_id: (author as TextRun).endpoint?.payload?.browseId,
         endpoint: (author as TextRun).endpoint
       };
     }

src/parser/classes/MusicDownloadStateBadge.ts

@@ -0,0 +1,16 @@
+import { YTNode } from '../helpers';
+
+class MusicDownloadStateBadge extends YTNode {
+  static type = 'MusicDownloadStateBadge';
+
+  playlist_id: string;
+  supported_download_states: string[];
+
+  constructor(data: any) {
+    super();
+    this.playlist_id = data.playlistId;
+    this.supported_download_states = data.supportedDownloadStates;
+  }
+}
+
+export default MusicDownloadStateBadge;

src/parser/classes/MusicItemThumbnailOverlay.ts

@@ -1,4 +1,5 @@
 import Parser from '../index';
+import MusicPlayButton from './MusicPlayButton';
 import { YTNode } from '../helpers';
 
 class MusicItemThumbnailOverlay extends YTNode {
@@ -10,7 +11,7 @@ class MusicItemThumbnailOverlay extends YTNode {
 
   constructor(data: any) {
     super();
-    this.content = Parser.parse(data.content);
+    this.content = Parser.parseItem<MusicPlayButton>(data.content, MusicPlayButton);
     this.content_position = data.contentPosition;
     this.display_style = data.displayStyle;
   }

src/parser/classes/MusicQueue.ts

@@ -1,14 +1,15 @@
 import Parser from '../index';
+import PlaylistPanel from './PlaylistPanel';
 import { YTNode } from '../helpers';
 
 class MusicQueue extends YTNode {
   static type = 'MusicQueue';
 
-  content;
+  content: PlaylistPanel | null;
 
   constructor(data: any) {
     super();
-    this.content = Parser.parse(data.content);
+    this.content = Parser.parseItem<PlaylistPanel>(data.content, PlaylistPanel);
   }
 }
 

src/parser/classes/MusicResponsiveListItem.ts

@@ -3,12 +3,16 @@
 
 import Parser from '../index';
 import Text from './misc/Text';
-import { timeToSeconds } from '../../utils/Utils';
+import TextRun from './misc/TextRun';
 import Thumbnail from './misc/Thumbnail';
 import NavigationEndpoint from './NavigationEndpoint';
+import MusicItemThumbnailOverlay from './MusicItemThumbnailOverlay';
+import MusicResponsiveListItemFlexColumn from './MusicResponsiveListItemFlexColumn';
+import MusicResponsiveListItemFixedColumn from './MusicResponsiveListItemFixedColumn';
+import Menu from './menus/Menu';
 
+import { timeToSeconds } from '../../utils/Utils';
 import { YTNode } from '../helpers';
-import TextRun from './misc/TextRun';
 
 class MusicResponsiveListItem extends YTNode {
   static type = 'MusicResponsiveListItem';
@@ -66,8 +70,8 @@ class MusicResponsiveListItem extends YTNode {
 
   constructor(data: any) {
     super();
-    this.#flex_columns = Parser.parseArray(data.flexColumns);
-    this.#fixed_columns = Parser.parseArray(data.fixedColumns);
+    this.#flex_columns = Parser.parseArray<MusicResponsiveListItemFlexColumn>(data.flexColumns, MusicResponsiveListItemFlexColumn);
+    this.#fixed_columns = Parser.parseArray<MusicResponsiveListItemFixedColumn>(data.fixedColumns, MusicResponsiveListItemFixedColumn);
 
     this.#playlist_item_data = {
       video_id: data?.playlistItemData?.videoId || null,
@@ -76,7 +80,9 @@ class MusicResponsiveListItem extends YTNode {
 
     this.endpoint = data.navigationEndpoint ? new NavigationEndpoint(data.navigationEndpoint) : null;
 
-    switch (this.endpoint?.browse?.page_type) {
+    const page_type = this.endpoint?.payload?.browseEndpointContextSupportedConfigs?.browseEndpointContextMusicConfig?.pageType;
+
+    switch (page_type) {
       case 'MUSIC_PAGE_TYPE_ALBUM':
         this.item_type = 'album';
         this.#parseAlbum();
@@ -109,8 +115,8 @@ class MusicResponsiveListItem extends YTNode {
 
     this.thumbnails = data.thumbnail ? Thumbnail.fromResponse(data.thumbnail.musicThumbnailRenderer?.thumbnail) : [];
     this.badges = Parser.parseArray(data.badges);
-    this.menu = Parser.parse(data.menu);
-    this.overlay = Parser.parse(data.overlay);
+    this.menu = Parser.parseItem<Menu>(data.menu, Menu);
+    this.overlay = Parser.parseItem<MusicItemThumbnailOverlay>(data.overlay, MusicItemThumbnailOverlay);
   }
 
   #parseOther() {
@@ -135,7 +141,7 @@ class MusicResponsiveListItem extends YTNode {
   }
 
   #parseSong() {
-    this.id = this.#playlist_item_data.video_id || this.endpoint?.watch?.video_id;
+    this.id = this.#playlist_item_data.video_id || this.endpoint?.payload?.videoId;
     this.title = this.#flex_columns[0].key('title').instanceof(Text).toString();
 
     const duration_text =
@@ -147,21 +153,21 @@ class MusicResponsiveListItem extends YTNode {
       seconds: timeToSeconds(duration_text)
     });
 
-    const album = this.#flex_columns[1].key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.browse?.id.startsWith('MPR')) as TextRun ||
-      this.#flex_columns[2]?.key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.browse?.id.startsWith('MPR')) as TextRun;
+    const album = this.#flex_columns[1].key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.payload?.browseId.startsWith('MPR')) as TextRun ||
+      this.#flex_columns[2]?.key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.payload?.browseId.startsWith('MPR')) as TextRun;
     if (album) {
       this.album = {
-        id: album.endpoint?.browse?.id,
+        id: album.endpoint?.payload?.browseId,
         name: album.text,
         endpoint: album.endpoint
       };
     }
 
-    const artists = this.#flex_columns[1].key('title').instanceof(Text).runs?.filter((run) => Reflect.get(run, 'endpoint')?.browse?.id.startsWith('UC')) as TextRun[];
+    const artists = this.#flex_columns[1].key('title').instanceof(Text).runs?.filter((run) => Reflect.get(run, 'endpoint')?.payload?.browseId.startsWith('UC')) as TextRun[];
     if (artists) {
       this.artists = artists.map((artist) => ({
         name: artist.text,
-        channel_id: artist.endpoint?.browse?.id,
+        channel_id: artist.endpoint?.payload?.browseId,
         endpoint: artist.endpoint
       }));
     }
@@ -172,11 +178,11 @@ class MusicResponsiveListItem extends YTNode {
     this.title = this.#flex_columns[0].key('title').instanceof(Text).toString();
     this.views = this.#flex_columns[1].key('title').instanceof(Text).runs?.find((run) => run.text.match(/(.*?) views/))?.text;
 
-    const authors = this.#flex_columns[1].key('title').instanceof(Text).runs?.filter((run) => Reflect.get(run, 'endpoint')?.browse?.id.startsWith('UC')) as TextRun[];
+    const authors = this.#flex_columns[1].key('title').instanceof(Text).runs?.filter((run) => Reflect.get(run, 'endpoint')?.payload?.browseId.startsWith('UC')) as TextRun[];
     if (authors) {
       this.authors = authors.map((author) => ({
         name: author.text,
-        channel_id: author.endpoint?.browse?.id,
+        channel_id: author.endpoint?.payload?.browseId,
         endpoint: author.endpoint
       }));
     }
@@ -190,7 +196,7 @@ class MusicResponsiveListItem extends YTNode {
   }
 
   #parseArtist() {
-    this.id = this.endpoint?.browse?.id;
+    this.id = this.endpoint?.payload?.browseId;
     this.name = this.#flex_columns[0].key('title').instanceof(Text).toString();
     this.subtitle = this.#flex_columns[1].key('title').instanceof(Text);
     this.subscribers = this.subtitle.runs?.find((run) => (/^(\d*\.)?\d+[M|K]? subscribers?$/i).test(run.text))?.text || '';
@@ -203,13 +209,13 @@ class MusicResponsiveListItem extends YTNode {
   }
 
   #parseAlbum() {
-    this.id = this.endpoint?.browse?.id;
+    this.id = this.endpoint?.payload?.browseId;
     this.title = this.#flex_columns[0].key('title').instanceof(Text).toString();
 
-    const author = this.#flex_columns[1].key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.browse?.id.startsWith('UC')) as TextRun;
+    const author = this.#flex_columns[1].key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.payload?.browseId.startsWith('UC')) as TextRun;
     author && (this.author = {
       name: author.text,
-      channel_id: author.endpoint?.browse?.id,
+      channel_id: author.endpoint?.payload?.browseId,
       endpoint: author.endpoint
     });
 
@@ -217,7 +223,7 @@ class MusicResponsiveListItem extends YTNode {
   }
 
   #parsePlaylist() {
-    this.id = this.endpoint?.browse?.id;
+    this.id = this.endpoint?.payload?.browseId;
     this.title = this.#flex_columns[0].key('title').instanceof(Text).toString();
 
     const item_count_run = this.#flex_columns[1].key('title')
@@ -225,12 +231,12 @@ class MusicResponsiveListItem extends YTNode {
 
     this.item_count = item_count_run ? item_count_run.text : undefined;
 
-    const author = this.#flex_columns[1].key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.browse?.id.startsWith('UC')) as TextRun;
+    const author = this.#flex_columns[1].key('title').instanceof(Text).runs?.find((run) => Reflect.get(run, 'endpoint')?.payload?.browseId.startsWith('UC')) as TextRun;
 
     if (author) {
       this.author = {
         name: author.text,
-        channel_id: author.endpoint?.browse?.id,
+        channel_id: author.endpoint?.payload?.browseId,
         endpoint: author.endpoint
       };
     }

src/parser/classes/MusicSideAlignedItem.ts

@@ -6,6 +6,7 @@ class MusicSideAlignedItem extends YTNode {
   static type = 'MusicSideAlignedItem';
 
   start_items?;
+  end_items?;
 
   constructor(data: any) {
     super();
@@ -13,6 +14,10 @@ class MusicSideAlignedItem extends YTNode {
     if (data.startItems) {
       this.start_items = Parser.parseArray(data.startItems);
     }
+
+    if (data.endItems) {
+      this.end_items = Parser.parseArray(data.endItems);
+    }
   }
 }
 

src/parser/classes/MusicTwoRowItem.ts

@@ -5,6 +5,9 @@ import Text from './misc/Text';
 import TextRun from './misc/TextRun';
 import Thumbnail from './misc/Thumbnail';
 import NavigationEndpoint from './NavigationEndpoint';
+import MusicItemThumbnailOverlay from './MusicItemThumbnailOverlay';
+import Menu from './menus/Menu';
+
 import { YTNode } from '../helpers';
 
 class MusicTwoRowItem extends YTNode {
@@ -45,13 +48,15 @@ class MusicTwoRowItem extends YTNode {
     this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
 
     this.id =
-      this.endpoint?.browse?.id ||
-      this.endpoint?.watch?.video_id;
+      this.endpoint?.payload?.browseId ||
+      this.endpoint?.payload?.videoId;
 
     this.subtitle = new Text(data.subtitle);
     this.badges = Parser.parse(data.subtitleBadges);
 
-    switch (this.endpoint?.browse?.page_type) {
+    const page_type = this.endpoint?.payload?.browseEndpointContextSupportedConfigs?.browseEndpointContextMusicConfig?.pageType;
+
+    switch (page_type) {
       case 'MUSIC_PAGE_TYPE_ARTIST':
         this.item_type = 'artist';
         break;
@@ -62,7 +67,7 @@ class MusicTwoRowItem extends YTNode {
         this.item_type = 'album';
         break;
       default:
-        if (this.endpoint?.watch_playlist) {
+        if (this.endpoint?.metadata?.api_url === '/next') {
           this.item_type = 'endpoint';
         } else if (this.subtitle.runs?.[0]) {
           if (this.subtitle.runs[0].text !== 'Song') {
@@ -84,11 +89,11 @@ class MusicTwoRowItem extends YTNode {
       const item_count_run = this.subtitle.runs?.find((run) => run.text.match(/\d+ songs|song/));
       this.item_count = item_count_run ? (item_count_run as TextRun).text : null;
     } else if (this.item_type == 'album') {
-      const artists = this.subtitle.runs?.filter((run: any) => run.endpoint?.browse?.id.startsWith('UC'));
+      const artists = this.subtitle.runs?.filter((run: any) => run.endpoint?.payload?.browseId.startsWith('UC'));
       if (artists) {
         this.artists = artists.map((artist: any) => ({
           name: artist.text,
-          channel_id: artist.endpoint.browse.id,
+          channel_id: artist.endpoint?.payload?.browseId,
           endpoint: artist.endpoint
         }));
       }
@@ -98,28 +103,28 @@ class MusicTwoRowItem extends YTNode {
     } else if (this.item_type == 'video') {
       this.views = this?.subtitle.runs?.find((run) => run?.text.match(/(.*?) views/))?.text || 'N/A';
 
-      const author = this.subtitle.runs?.find((run: any) => run.endpoint?.browse?.id?.startsWith('UC'));
+      const author = this.subtitle.runs?.find((run: any) => run.endpoint?.payload?.browseId?.startsWith('UC'));
       if (author) {
         this.author = {
           name: (author as TextRun)?.text,
-          channel_id: (author as TextRun)?.endpoint?.browse?.id,
+          channel_id: (author as TextRun)?.endpoint?.payload?.browseId,
           endpoint: (author as TextRun)?.endpoint
         };
       }
     } else if (this.item_type == 'song') {
-      const artists = this.subtitle.runs?.filter((run: any) => run.endpoint?.browse?.id.startsWith('UC'));
+      const artists = this.subtitle.runs?.filter((run: any) => run.endpoint?.payload?.browseId.startsWith('UC'));
       if (artists) {
         this.artists = artists.map((artist: any) => ({
           name: (artist as TextRun)?.text,
-          channel_id: (artist as TextRun)?.endpoint?.browse?.id,
+          channel_id: (artist as TextRun)?.endpoint?.payload?.browseId,
           endpoint: (artist as TextRun)?.endpoint
         }));
       }
     }
 
     this.thumbnail = Thumbnail.fromResponse(data.thumbnailRenderer.musicThumbnailRenderer.thumbnail);
-    this.thumbnail_overlay = Parser.parse(data.thumbnailOverlay);
-    this.menu = Parser.parse(data.menu);
+    this.thumbnail_overlay = Parser.parseItem<MusicItemThumbnailOverlay>(data.thumbnailOverlay, MusicItemThumbnailOverlay);
+    this.menu = Parser.parseItem<Menu>(data.menu, Menu);
   }
 }
 

src/parser/classes/NavigationEndpoint.ts

@@ -1,7 +1,7 @@
-// TODO: refactor this
-import { YTNode } from '../helpers';
 import Parser, { ParsedResponse } from '../index';
 import Actions, { ActionsResponse } from '../../core/Actions';
+import { YTNode } from '../helpers';
+
 import CreatePlaylistDialog from './CreatePlaylistDialog';
 
 class NavigationEndpoint extends YTNode {
@@ -14,34 +14,9 @@ class NavigationEndpoint extends YTNode {
     url?: string;
     api_url?: string;
     page_type?: string;
-    send_post?: boolean; // TODO: is this a boolean?
+    send_post?: boolean;
   };
 
-  // TODO: these should be given proper types, currently infered
-  browse?: {
-    id: string,
-    params: string | null,
-    base_url: string | null,
-    page_type: string | null,
-    form_data?: {}
-  };
-  watch;
-  search;
-  subscribe;
-  unsubscribe;
-  like;
-  perform_comment_action;
-  offline_video;
-  continuation;
-  feedback;
-  watch_playlist;
-  playlist_edit;
-  add_to_playlist;
-  create_playlist;
-  get_report_form;
-  live_chat_item_context_menu;
-  send_live_chat_vote;
-
   constructor(data: any) {
     super();
 
@@ -85,156 +60,10 @@ class NavigationEndpoint extends YTNode {
       this.metadata.send_post = data.commandMetadata.webCommandMetadata.sendPost;
     }
 
-    if (data?.browseEndpoint) {
-      const configs = data?.browseEndpoint?.browseEndpointContextSupportedConfigs?.browseEndpointContextMusicConfig;
-      this.browse = {
-        id: data?.browseEndpoint?.browseId || null,
-        params: data?.browseEndpoint.params || null,
-        base_url: data?.browseEndpoint?.canonicalBaseUrl || null,
-        page_type: configs?.pageType || null
-      };
-    }
-
-    if (data?.watchEndpoint) {
-      const configs = data?.watchEndpoint?.watchEndpointMusicSupportedConfigs?.watchEndpointMusicConfig;
-      this.watch = {
-        video_id: data?.watchEndpoint?.videoId,
-        playlist_id: data?.watchEndpoint.playlistId || null,
-        params: data?.watchEndpoint.params || null,
-        index: data?.watchEndpoint.index || null,
-        supported_onesie_config: data?.watchEndpoint?.watchEndpointSupportedOnesieConfig,
-        music_video_type: configs?.musicVideoType || null
-      };
-    }
-
-    if (data?.searchEndpoint) {
-      this.search = {
-        query: data.searchEndpoint.query,
-        params: data.searchEndpoint.params
-      };
-    }
-
-    if (data?.subscribeEndpoint) {
-      this.subscribe = {
-        channel_ids: data.subscribeEndpoint.channelIds,
-        params: data.subscribeEndpoint.params
-      };
-    }
-
-    if (data?.unsubscribeEndpoint) {
-      this.unsubscribe = {
-        channel_ids: data.unsubscribeEndpoint.channelIds,
-        params: data.unsubscribeEndpoint.params
-      };
-    }
-
-    if (data?.likeEndpoint) {
-      this.like = {
-        status: data.likeEndpoint.status,
-        target: {
-          video_id: data.likeEndpoint.target.videoId,
-          playlist_id: data.likeEndpoint.target.playlistId
-        },
-        params:
-          data.likeEndpoint?.removeLikeParams ||
-          data.likeEndpoint?.likeParams ||
-          data.likeEndpoint?.dislikeParams
-      };
-    }
-
-    if (data?.performCommentActionEndpoint) {
-      this.perform_comment_action = {
-        action: data?.performCommentActionEndpoint.action
-      };
-    }
-
-    if (data?.offlineVideoEndpoint) {
-      this.offline_video = {
-        video_id: data.offlineVideoEndpoint.videoId,
-        on_add_command: {
-          get_download_action: {
-            video_id: data.offlineVideoEndpoint.videoId,
-            params: data.offlineVideoEndpoint.onAddCommand.getDownloadActionCommand.params
-          }
-        }
-      };
-    }
-
-    if (data?.continuationCommand) {
-      this.continuation = {
-        request: data?.continuationCommand?.request || null,
-        token: data?.continuationCommand?.token || null
-      };
-    }
-
-    if (data?.feedbackEndpoint) {
-      this.feedback = {
-        token: data.feedbackEndpoint.feedbackToken
-      };
-    }
-
-    if (data?.watchPlaylistEndpoint) {
-      this.watch_playlist = {
-        playlist_id: data.watchPlaylistEndpoint?.playlistId,
-        params: data.watchPlaylistEndpoint?.params || null
-      };
-    }
-
-    if (data?.playlistEditEndpoint) {
-      this.playlist_edit = {
-        playlist_id: data.playlistEditEndpoint.playlistId,
-        actions: data.playlistEditEndpoint.actions.map((item: any) => ({
-          action: item.action,
-          removed_video_id: item.removedVideoId
-        }))
-      };
-    }
-
-    if (data?.addToPlaylistEndpoint) {
-      this.add_to_playlist = {
-        video_id: data.addToPlaylistEndpoint.videoId
-      };
-    }
-
-    if (data?.addToPlaylistServiceEndpoint) {
-      this.add_to_playlist = {
-        video_id: data.addToPlaylistServiceEndpoint.videoId
-      };
-    }
-
     if (data?.createPlaylistEndpoint) {
       if (data?.createPlaylistEndpoint.createPlaylistDialog) {
         this.dialog = Parser.parseItem(data?.createPlaylistEndpoint.createPlaylistDialog, CreatePlaylistDialog);
       }
-      this.create_playlist = {
-        // Nothing to put here - data.createPlaylistEndpoint has only one prop `createPlaylistDialog`
-        // Which was already parsed and referred to by `this.dialog`. But still useful to have this as
-        // A quick indicator of what the endpoint does.
-      };
-    }
-
-    if (data?.getReportFormEndpoint) {
-      this.get_report_form = {
-        params: data.getReportFormEndpoint.params
-      };
-    }
-
-    if (data?.liveChatItemContextMenuEndpoint) {
-      this.live_chat_item_context_menu = {
-        params: data?.liveChatItemContextMenuEndpoint?.params
-      };
-    }
-
-    if (data?.sendLiveChatVoteEndpoint) {
-      this.send_live_chat_vote = {
-        params: data.sendLiveChatVoteEndpoint.params
-      };
-    }
-
-    if (data?.liveChatItemContextMenuEndpoint) {
-      this.live_chat_item_context_menu = {
-        params: data.liveChatItemContextMenuEndpoint.params
-      };
     }
   }
 
@@ -245,66 +74,24 @@ class NavigationEndpoint extends YTNode {
     switch (name) {
       case 'browseEndpoint':
         return '/browse';
+      case 'watchEndpoint':
+        return '/player';
+      case 'watchPlaylistEndpoint':
+        return '/next';
+      case 'liveChatItemContextMenuEndpoint':
+        return 'live_chat/get_item_context_menu';
     }
   }
 
-  callTest(actions: Actions, args: { [ key: string ]: any; parse: true }): Promise<ParsedResponse>;
-  callTest(actions: Actions, args?: { [ key: string ]: any; parse?: false }): Promise<ActionsResponse>;
-  callTest(actions: Actions, args?: { [ key: string ]: any; parse?: boolean }): Promise<ParsedResponse | ActionsResponse> {
+  call(actions: Actions, args: { [ key: string ]: any; parse: true }): Promise<ParsedResponse>;
+  call(actions: Actions, args?: { [ key: string ]: any; parse?: false }): Promise<ActionsResponse>;
+  call(actions: Actions, args?: { [ key: string ]: any; parse?: boolean }): Promise<ParsedResponse | ActionsResponse> {
     if (!actions)
       throw new Error('An active caller must be provided');
     if (!this.metadata.api_url)
       throw new Error('Expected an api_url, but none was found, this is a bug.');
     return actions.execute(this.metadata.api_url, { ...this.payload, ...args });
   }
-
-  // TODO: replace client with an enum or something
-  async #call(actions: Actions, client?: string) {
-    if (!actions)
-      throw new Error('An active caller must be provided');
-
-    if (this.continuation) {
-      switch (this.continuation.request) {
-        case 'CONTINUATION_REQUEST_TYPE_BROWSE': {
-          return await actions.browse(this.continuation.token, { is_ctoken: true });
-        }
-        case 'CONTINUATION_REQUEST_TYPE_SEARCH': {
-          return await actions.search({ ctoken: this.continuation.token });
-        }
-        case 'CONTINUATION_REQUEST_TYPE_WATCH_NEXT': {
-          return await actions.next({ ctoken: this.continuation.token });
-        }
-        default:
-          throw new Error(`${this.continuation.request} not implemented`);
-      }
-    }
-
-    if (this.search) {
-      return await actions.search({ query: this.search.query, params: this.search.params, client });
-    }
-
-    if (this.browse) {
-      return await actions.browse(this.browse.id, { ...this.browse, client });
-    }
-
-    if (this.like) {
-      if (!this.metadata.api_url)
-        throw new Error('Like endpoint requires an api_url, but was not parsed from the response.');
-      const response = await actions.engage(this.metadata.api_url, { video_id: this.like.target.video_id, params: this.like.params });
-      return response;
-    }
-  }
-
-  async call(actions: Actions, client: string | undefined, parse: true) : Promise<ParsedResponse | undefined>;
-  async call(actions: Actions, client?: string, parse?: false) : Promise<ActionsResponse | undefined>;
-  async call(actions: Actions, client?: string, parse?: boolean): Promise<ParsedResponse | ActionsResponse | undefined> {
-    const result = await this.#call(actions, client);
-
-    if (parse && result)
-      return Parser.parseResponse(result.data);
-
-    return this.#call(actions, client);
-  }
 }
 
 export default NavigationEndpoint;

src/parser/classes/PlayerErrorMessage.ts

@@ -1,6 +1,8 @@
 import Parser from '../index';
 import Text from './misc/Text';
 import Thumbnail from './misc/Thumbnail';
+import Button from './Button';
+
 import { YTNode } from '../helpers';
 
 class PlayerErrorMessage extends YTNode {
@@ -8,17 +10,17 @@ class PlayerErrorMessage extends YTNode {
 
   subreason: Text;
   reason: Text;
-  proceed_button;
+  proceed_button: Button | null;
   thumbnails: Thumbnail[];
-  icon_type: string;
+  icon_type: string | null;
 
   constructor(data: any) {
     super();
     this.subreason = new Text(data.subreason);
     this.reason = new Text(data.reason);
-    this.proceed_button = Parser.parse(data.proceedButton);
+    this.proceed_button = Parser.parseItem<Button>(data.proceedButton, Button);
     this.thumbnails = Thumbnail.fromResponse(data.thumbnail);
-    this.icon_type = data.icon.iconType;
+    this.icon_type = data.icon?.iconType || null;
   }
 }
 

src/parser/classes/PlayerOverlay.ts

@@ -14,6 +14,8 @@ class PlayerOverlay extends YTNode {
   share_button;
   add_to_menu;
   fullscreen_engagement;
+  actions;
+  browser_media_session;
 
   constructor(data: any) {
     super();
@@ -22,6 +24,8 @@ class PlayerOverlay extends YTNode {
     this.share_button = Parser.parseItem<Button>(data.shareButton, Button);
     this.add_to_menu = Parser.parseItem<Menu>(data.addToMenu, Menu);
     this.fullscreen_engagement = Parser.parse(data.fullscreenEngagement);
+    this.actions = Parser.parseArray(data.actions);
+    this.browser_media_session = Parser.parseItem(data.browserMediaSession);
   }
 }
 

src/parser/classes/PlaylistCustomThumbnail.ts

@@ -0,0 +1,13 @@
+import { YTNode } from '../helpers';
+import Thumbnail from './misc/Thumbnail';
+
+export default class PlaylistCustomThumbnail extends YTNode {
+  static type = 'PlaylistCustomThumbnail';
+
+  thumbnail: Thumbnail[];
+
+  constructor(data: any) {
+    super();
+    this.thumbnail = Thumbnail.fromResponse(data.thumbnail);
+  }
+}

src/parser/classes/PlaylistPanel.ts

@@ -4,6 +4,7 @@ import PlaylistPanelVideo from './PlaylistPanelVideo';
 
 import { YTNode } from '../helpers';
 import AutomixPreviewVideo from './AutomixPreviewVideo';
+import PlaylistPanelVideoWrapper from './PlaylistPanelVideoWrapper';
 
 class PlaylistPanel extends YTNode {
   static type = 'PlaylistPanel';
@@ -22,7 +23,7 @@ class PlaylistPanel extends YTNode {
     super();
     this.title = data.title;
     this.title_text = new Text(data.titleText);
-    this.contents = Parser.parseArray<PlaylistPanelVideo | AutomixPreviewVideo>(data.contents, [ PlaylistPanelVideo, AutomixPreviewVideo ]);
+    this.contents = Parser.parseArray<PlaylistPanelVideoWrapper | PlaylistPanelVideo | AutomixPreviewVideo>(data.contents);
     this.playlist_id = data.playlistId;
     this.is_infinite = data.isInfinite;
     this.continuation = data.continuations?.[0]?.nextRadioContinuationData?.continuation || data.continuations?.[0]?.nextContinuationData?.continuation;

src/parser/classes/PlaylistPanelVideo.ts

@@ -54,14 +54,14 @@ class PlaylistPanelVideo extends YTNode {
       seconds: timeToSeconds(new Text(data.lengthText).toString())
     };
 
-    const album = new Text(data.longBylineText).runs?.find((run: any) => run.endpoint?.browse?.id.startsWith('MPR'));
-    const artists = new Text(data.longBylineText).runs?.filter((run: any) => run.endpoint?.browse?.id.startsWith('UC'));
+    const album = new Text(data.longBylineText).runs?.find((run: any) => run.endpoint?.payload?.browseId?.startsWith('MPR'));
+    const artists = new Text(data.longBylineText).runs?.filter((run: any) => run.endpoint?.payload?.browseId?.startsWith('UC'));
 
     this.author = new Text(data.shortBylineText).toString();
 
     if (album) {
       this.album = {
-        id: (album as TextRun).endpoint?.browse?.id,
+        id: (album as TextRun).endpoint?.payload?.browseId,
         name: (album as TextRun).text,
         year: new Text(data.longBylineText).runs?.slice(-1)[0].text,
         endpoint: (album as TextRun).endpoint
@@ -71,7 +71,7 @@ class PlaylistPanelVideo extends YTNode {
     if (artists) {
       this.artists = artists.map((artist) => ({
         name: (artist as TextRun).text,
-        channel_id: (artist as TextRun).endpoint?.browse?.id,
+        channel_id: (artist as TextRun).endpoint?.payload?.browseId,
         endpoint: (artist as TextRun).endpoint
       }));
     }

src/parser/classes/PlaylistPanelVideoWrapper.ts

@@ -0,0 +1,18 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+import PlaylistPanelVideo from './PlaylistPanelVideo';
+
+class PlaylistPanelVideoWrapper extends YTNode {
+  static type = 'PlaylistPanelVideoWrapper';
+
+  primary: PlaylistPanelVideo | null;
+  counterpart: Array<PlaylistPanelVideo | null>;
+
+  constructor(data: any) {
+    super();
+    this.primary = Parser.parseItem<PlaylistPanelVideo>(data.primaryRenderer);
+    this.counterpart = data.counterpart?.map((item: any) => Parser.parseItem<PlaylistPanelVideo>(item.counterpartRenderer)) || [];
+  }
+}
+
+export default PlaylistPanelVideoWrapper;

src/parser/classes/ProfileColumnStats.ts

@@ -8,7 +8,7 @@ class ProfileColumnStats extends YTNode {
 
   constructor(data: any) {
     super();
-    this.items = Parser.parse(data.items);
+    this.items = Parser.parseArray(data.items);
   }
 
   // XXX: alias for consistency
@@ -17,4 +17,4 @@ class ProfileColumnStats extends YTNode {
   }
 }
 
-export default ProfileColumnStats;
+export default ProfileColumnStats;

src/parser/classes/RecognitionShelf.ts

@@ -0,0 +1,26 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+import Button from './Button';
+import Text from './misc/Text';
+import Thumbnail from './misc/Thumbnail';
+
+export default class RecognitionShelf extends YTNode {
+  static type = 'RecognitionShelf';
+
+  title: Text;
+  subtitle: Text;
+  avatars: Thumbnail[];
+  button: Button | null;
+  surface: string;
+
+  constructor(data: any) {
+    super();
+
+    this.title = new Text(data.title);
+    this.subtitle = new Text(data.subtitle);
+    this.avatars = data.avatars.map((avatar: any) => new Thumbnail(avatar));
+    this.button = Parser.parseItem<Button>(data.button, Button);
+    this.surface = data.surface;
+  }
+}

src/parser/classes/RichGrid.ts

@@ -12,8 +12,8 @@ class RichGrid extends YTNode {
     super();
     // XXX: we don't parse the masthead since it is usually an advertisement
     // XXX: reflowOptions aren't parsed, I think its only used internally for layout
-    this.header = Parser.parse(data.header);
-    this.contents = Parser.parse(data.contents);
+    this.header = Parser.parseItem(data.header);
+    this.contents = Parser.parseArray(data.contents);
   }
 }
 

src/parser/classes/RichItem.ts

@@ -8,8 +8,7 @@ class RichItem extends YTNode {
 
   constructor(data: any) {
     super();
-    // TODO: check this
-    this.content = Parser.parse(data.content);
+    this.content = Parser.parseItem(data.content);
   }
 }
 

src/parser/classes/RichListHeader.ts

@@ -5,12 +5,16 @@ class RichListHeader extends YTNode {
   static type = 'RichListHeader';
 
   title: Text;
+  subtitle: Text;
+  title_style: string | undefined;
   icon_type: string;
 
   constructor(data: any) {
     super();
     this.title = new Text(data.title);
-    this.icon_type = data.icon.iconType;
+    this.subtitle = new Text(data.subtitle);
+    this.title_style = data?.titleStyle?.style;
+    this.icon_type = data?.icon?.iconType;
   }
 }
 

src/parser/classes/RichSection.ts

@@ -4,11 +4,11 @@ import { YTNode } from '../helpers';
 class RichSection extends YTNode {
   static type = 'RichSection';
 
-  contents;
+  content;
 
   constructor(data: any) {
     super();
-    this.contents = Parser.parse(data.content);
+    this.content = Parser.parseItem(data.content);
   }
 }
 

src/parser/classes/RichShelf.ts

@@ -13,7 +13,7 @@ class RichShelf extends YTNode {
   constructor(data: any) {
     super();
     this.title = new Text(data.title);
-    this.contents = Parser.parse(data.contents);
+    this.contents = Parser.parseArray(data.contents);
     this.endpoint = data.endpoint ? new NavigationEndpoint(data.endpoint) : null;
   }
 }

src/parser/classes/SegmentedLikeDislikeButton.ts

@@ -0,0 +1,18 @@
+import Parser from '..';
+import ToggleButton from './ToggleButton';
+import { YTNode } from '../helpers';
+
+class SegmentedLikeDislikeButton extends YTNode {
+  static type = 'SegmentedLikeDislikeButton';
+
+  like_button: ToggleButton | null;
+  dislike_button: ToggleButton | null;
+
+  constructor (data: any) {
+    super();
+    this.like_button = Parser.parseItem<ToggleButton>(data.likeButton, ToggleButton);
+    this.dislike_button = Parser.parseItem<ToggleButton>(data.dislikeButton, ToggleButton);
+  }
+}
+
+export default SegmentedLikeDislikeButton;

src/parser/classes/SubscribeButton.ts

@@ -1,6 +1,7 @@
 import Parser from '../index';
 import Text from './misc/Text';
 import NavigationEndpoint from './NavigationEndpoint';
+import SubscriptionNotificationToggleButton from './SubscriptionNotificationToggleButton';
 import { YTNode } from '../helpers';
 
 class SubscribeButton extends YTNode {
@@ -14,7 +15,7 @@ class SubscribeButton extends YTNode {
   show_preferences: boolean;
   subscribed_text: Text;
   unsubscribed_text: Text;
-  notification_preference_button;
+  notification_preference_button: SubscriptionNotificationToggleButton | null;
   endpoint: NavigationEndpoint;
 
   constructor(data: any) {
@@ -27,7 +28,7 @@ class SubscribeButton extends YTNode {
     this.show_preferences = data.showPreferences;
     this.subscribed_text = new Text(data.subscribedButtonText);
     this.unsubscribed_text = new Text(data.unsubscribedButtonText);
-    this.notification_preference_button = Parser.parse(data.notificationPreferenceButton);
+    this.notification_preference_button = Parser.parseItem<SubscriptionNotificationToggleButton>(data.notificationPreferenceButton, SubscriptionNotificationToggleButton);
     this.endpoint = new NavigationEndpoint(data.serviceEndpoints?.[0] || data.onSubscribeEndpoints?.[0]);
   }
 }

src/parser/classes/ThumbnailLandscapePortrait.ts

@@ -0,0 +1,15 @@
+import { YTNode } from '../helpers';
+import Thumbnail from './misc/Thumbnail';
+
+export default class ThumbnailLandscapePortrait extends YTNode {
+  static type = 'ThumbnailLandscapePortrait';
+
+  landscape: Thumbnail[];
+  portrait: Thumbnail[];
+
+  constructor (data: any) {
+    super();
+    this.landscape = Thumbnail.fromResponse(data.landscape);
+    this.portrait = Thumbnail.fromResponse(data.portrait);
+  }
+}

src/parser/classes/TopicChannelDetails.ts

@@ -0,0 +1,27 @@
+import Parser from '..';
+import { YTNode } from '../helpers';
+
+import Text from './misc/Text';
+import Thumbnail from './misc/Thumbnail';
+import NavigationEndpoint from './NavigationEndpoint';
+import SubscribeButton from './SubscribeButton';
+
+export default class TopicChannelDetails extends YTNode {
+  static type = 'TopicChannelDetails';
+
+  title: Text;
+  avatar: Thumbnail[];
+  subtitle: Text;
+  subscribe_button: SubscribeButton | null;
+  endpoint: NavigationEndpoint;
+
+  constructor (data: any) {
+    super();
+
+    this.title = new Text(data.title);
+    this.avatar = Thumbnail.fromResponse(data.thumbnail);
+    this.subtitle = new Text(data.title);
+    this.subscribe_button = Parser.parseItem<SubscribeButton>(data.subscribeButton, SubscribeButton);
+    this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
+  }
+}

src/parser/classes/Video.ts

@@ -1,6 +1,7 @@
 import Parser from '../index';
 import Text from './misc/Text';
 import Author from './misc/Author';
+import Menu from './menus/Menu';
 import Thumbnail from './misc/Thumbnail';
 import NavigationEndpoint from './NavigationEndpoint';
 import { timeToSeconds } from '../../utils/Utils';
@@ -53,8 +54,8 @@ class Video extends YTNode {
     })) || [];
 
     this.thumbnails = Thumbnail.fromResponse(data.thumbnail);
-    this.thumbnail_overlays = Parser.parse(data.thumbnailOverlays);
-    this.rich_thumbnail = data.richThumbnail && Parser.parse(data.richThumbnail);
+    this.thumbnail_overlays = Parser.parseArray(data.thumbnailOverlays);
+    this.rich_thumbnail = data.richThumbnail ? Parser.parse(data.richThumbnail) : null;
     this.author = new Author(data.ownerText, data.ownerBadges, data.channelThumbnailSupportedRenderers?.channelThumbnailWithLinkRenderer?.thumbnail);
     this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
     this.published = new Text(data.publishedTimeText);
@@ -73,7 +74,7 @@ class Video extends YTNode {
 
     this.show_action_menu = data.showActionMenu;
     this.is_watched = data.isWatched || false;
-    this.menu = Parser.parse(data.menu);
+    this.menu = Parser.parseItem<Menu>(data.menu, Menu);
   }
 
   get description(): string {

src/parser/classes/VideoCard.ts

@@ -0,0 +1,9 @@
+import Video from './Video';
+
+export default class VideoCard extends Video {
+  static type = 'VideoCard';
+
+  constructor(data: any) {
+    super(data);
+  }
+}

src/parser/classes/VideoSecondaryInfo.ts

@@ -1,6 +1,7 @@
 import Parser from '../index';
 import Text from './misc/Text';
 import Button from './Button';
+import VideoOwner from './VideoOwner';
 import SubscribeButton from './SubscribeButton';
 import MetadataRowContainer from './MetadataRowContainer';
 import { YTNode } from '../helpers';
@@ -8,7 +9,7 @@ import { YTNode } from '../helpers';
 class VideoSecondaryInfo extends YTNode {
   static type = 'VideoSecondaryInfo';
 
-  owner; // TODO: VideoOwner?
+  owner: VideoOwner | null;// TODO: VideoOwner?
   description: Text;
   subscribe_button;
   metadata: MetadataRowContainer | null;
@@ -19,7 +20,7 @@ class VideoSecondaryInfo extends YTNode {
 
   constructor(data: any) {
     super();
-    this.owner = Parser.parse(data.owner);
+    this.owner = Parser.parseItem<VideoOwner>(data.owner);
     this.description = new Text(data.description);
     this.subscribe_button = Parser.parseItem<SubscribeButton | Button>(data.subscribeButton, [ SubscribeButton, Button ]);
     this.metadata = Parser.parseItem<MetadataRowContainer>(data.metadataRowContainer, MetadataRowContainer);

src/parser/classes/WatchCardHeroVideo.ts

@@ -15,7 +15,7 @@ class WatchCardHeroVideo extends YTNode {
     this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
     this.call_to_action_button = Parser.parse(data.callToActionButton);
     this.hero_image = Parser.parse(data.heroImage);
-    this.label = data.accessibility.accessibilityData.label;
+    this.label = data.lengthText.accessibility.accessibilityData.label;
   }
 }
 

src/parser/classes/comments/Comment.ts

@@ -82,7 +82,7 @@ class Comment extends YTNode {
     if (button.is_toggled)
       throw new InnertubeError('This comment is already liked', { comment_id: this.comment_id });
 
-    const response = await button.endpoint.callTest(this.#actions, { parse: false });
+    const response = await button.endpoint.call(this.#actions, { parse: false });
 
     return response;
   }
@@ -98,7 +98,7 @@ class Comment extends YTNode {
     if (button.is_toggled)
       throw new InnertubeError('This comment is already disliked', { comment_id: this.comment_id });
 
-    const response = await button.endpoint.callTest(this.#actions, { parse: false });
+    const response = await button.endpoint.call(this.#actions, { parse: false });
 
     return response;
   }
@@ -125,7 +125,7 @@ class Comment extends YTNode {
       commentText: text
     };
 
-    const response = await dialog_button.endpoint.callTest(this.#actions, payload);
+    const response = await dialog_button.endpoint.call(this.#actions, payload);
 
     return response;
   }

src/parser/classes/comments/CommentThread.ts

@@ -35,7 +35,7 @@ class CommentThread extends YTNode {
       throw new InnertubeError('This comment has no replies.', { comment_id: this.comment?.comment_id });
 
     const continuation = this.#replies.key('contents').parsed().array().get({ type: 'ContinuationItem' })?.as(ContinuationItem);
-    const response = await continuation?.endpoint.callTest(this.#actions, { parse: true });
+    const response = await continuation?.endpoint.call(this.#actions, { parse: true });
 
     this.replies = response?.on_response_received_endpoints_memo?.getType(Comment).map((comment) => {
       comment.setActions(this.#actions);
@@ -60,7 +60,7 @@ class CommentThread extends YTNode {
     if (!this.#actions)
       throw new InnertubeError('Actions not set for this CommentThread.');
 
-    const response = await this.#continuation.button?.item().key('endpoint').nodeOfType(NavigationEndpoint).callTest(this.#actions, { parse: true });
+    const response = await this.#continuation.button?.item().key('endpoint').nodeOfType(NavigationEndpoint).call(this.#actions, { parse: true });
 
     this.replies = response?.on_response_received_endpoints_memo.getType(Comment).map((comment) => {
       comment.setActions(this.#actions);

src/parser/classes/livechat/RemoveChatItemAction.ts

@@ -0,0 +1,14 @@
+import { YTNode } from '../../helpers';
+
+class RemoveChatItemAction extends YTNode {
+  static type = 'RemoveChatItemAction';
+
+  target_item_id: string;
+
+  constructor(data: any) {
+    super();
+    this.target_item_id = data.targetItemId;
+  }
+}
+
+export default RemoveChatItemAction;

src/parser/classes/livechat/RemoveChatItemByAuthorAction.ts

@@ -0,0 +1,14 @@
+import { YTNode } from '../../helpers';
+
+class RemoveChatItemByAuthorAction extends YTNode {
+  static type = 'RemoveChatItemByAuthorAction';
+
+  external_channel_id: string;
+
+  constructor(data: any) {
+    super();
+    this.external_channel_id = data.externalChannelId;
+  }
+}
+
+export default RemoveChatItemByAuthorAction;

src/parser/classes/livechat/items/LiveChatAutoModMessage.ts

@@ -0,0 +1,30 @@
+import Text from '../../misc/Text';
+import Parser from '../../../index';
+import { ObservedArray, YTNode } from '../../../helpers';
+import NavigationEndpoint from '../../NavigationEndpoint';
+import Button from '../../Button';
+
+class LiveChatAutoModMessage extends YTNode {
+  static type = 'LiveChatAutoModMessage';
+
+  auto_moderated_item;
+  header_text: Text;
+
+  menu_endpoint?: NavigationEndpoint;
+  moderation_buttons: ObservedArray<Button>;
+  timestamp: number;
+  id: string;
+
+  constructor(data: any) {
+    super();
+
+    this.menu_endpoint = new NavigationEndpoint(data.contextMenuEndpoint);
+    this.moderation_buttons = Parser.parseArray<Button>(data.moderationButtons, [ Button ]);
+    this.auto_moderated_item = Parser.parse(data.autoModeratedItem);
+    this.header_text = new Text(data.headerText);
+    this.timestamp = Math.floor(parseInt(data.timestampUsec) / 1000);
+    this.id = data.id;
+  }
+}
+
+export default LiveChatAutoModMessage;

src/parser/classes/livechat/items/LiveChatPaidMessage.ts

@@ -2,6 +2,7 @@ import Text from '../../misc/Text';
 import Thumbnail from '../../misc/Thumbnail';
 import NavigationEndpoint from '../../NavigationEndpoint';
 import MetadataBadge from '../../MetadataBadge';
+import LiveChatAuthorBadge from '../../LiveChatAuthorBadge';
 import Parser from '../../../index';
 import { YTNode } from '../../../helpers';
 
@@ -14,7 +15,7 @@ class LiveChatPaidMessage extends YTNode {
     id: string;
     name: Text;
     thumbnails: Thumbnail[];
-    badges: MetadataBadge[];
+    badges: LiveChatAuthorBadge[] | MetadataBadge[];
     is_moderator: boolean | null;
     is_verified: boolean | null;
     is_verified_artist: boolean | null;
@@ -38,13 +39,13 @@ class LiveChatPaidMessage extends YTNode {
       id: data.authorExternalChannelId,
       name: new Text(data.authorName),
       thumbnails: Thumbnail.fromResponse(data.authorPhoto),
-      badges: Parser.parseArray<MetadataBadge>(data.authorBadges, MetadataBadge),
+      badges: Parser.parseArray<LiveChatAuthorBadge | MetadataBadge>(data.authorBadges, [ MetadataBadge, LiveChatAuthorBadge ]),
       is_moderator: null,
       is_verified: null,
       is_verified_artist: null
     };
 
-    const badges = Parser.parseArray<MetadataBadge>(data.authorBadges, MetadataBadge);
+    const badges = Parser.parseArray<LiveChatAuthorBadge | MetadataBadge>(data.authorBadges, [ MetadataBadge, LiveChatAuthorBadge ]);
 
     this.author.badges = badges;
     this.author.is_moderator = badges?.some((badge: any) => badge.icon_type == 'MODERATOR') || null;

src/parser/classes/livechat/items/LiveChatPaidSticker.ts

@@ -23,6 +23,7 @@ class LiveChatPaidSticker extends YTNode {
   sticker: Thumbnail[];
   purchase_amount: string;
   context_menu: NavigationEndpoint;
+  menu_endpoint?: NavigationEndpoint;
   timestamp: number;
 
   constructor(data: any) {
@@ -42,7 +43,8 @@ class LiveChatPaidSticker extends YTNode {
     this.author_name_text_color = data.authorNameTextColor;
     this.sticker = Thumbnail.fromResponse(data.sticker);
     this.purchase_amount = new Text(data.purchaseAmountText).toString();
-    this.context_menu = new NavigationEndpoint(data.contextMenuEndpoint);
+    this.menu_endpoint = new NavigationEndpoint(data.contextMenuEndpoint);
+    this.context_menu = this.menu_endpoint;
     this.timestamp = Math.floor(parseInt(data.timestampUsec) / 1000);
   }
 }

src/parser/classes/livechat/items/LiveChatTextMessage.ts

@@ -2,9 +2,11 @@ import Text from '../../misc/Text';
 import Thumbnail from '../../misc/Thumbnail';
 import NavigationEndpoint from '../../NavigationEndpoint';
 import MetadataBadge from '../../MetadataBadge';
+import LiveChatAuthorBadge from '../../LiveChatAuthorBadge';
 import Parser from '../../../index';
 
-import { YTNode } from '../../../helpers';
+import { ObservedArray, YTNode } from '../../../helpers';
+import Button from '../../Button';
 
 class LiveChatTextMessage extends YTNode {
   static type = 'LiveChatTextMessage';
@@ -14,13 +16,14 @@ class LiveChatTextMessage extends YTNode {
     id: string;
     name: Text;
     thumbnails: Thumbnail[];
-    badges: MetadataBadge[];
+    badges: LiveChatAuthorBadge[] | MetadataBadge[];
     is_moderator: boolean | null;
     is_verified: boolean | null;
     is_verified_artist: boolean | null;
   };
 
   menu_endpoint?: NavigationEndpoint;
+  inline_action_buttons: ObservedArray<Button>;
   timestamp: number;
   id: string;
 
@@ -32,13 +35,13 @@ class LiveChatTextMessage extends YTNode {
       id: data.authorExternalChannelId,
       name: new Text(data.authorName),
       thumbnails: Thumbnail.fromResponse(data.authorPhoto),
-      badges: [] as MetadataBadge[],
+      badges: [] as LiveChatAuthorBadge[] | [] as MetadataBadge[],
       is_moderator: null,
       is_verified: null,
       is_verified_artist: null
     };
 
-    const badges = Parser.parseArray<MetadataBadge>(data.authorBadges, MetadataBadge);
+    const badges = Parser.parseArray<LiveChatAuthorBadge | MetadataBadge>(data.authorBadges, [ MetadataBadge, LiveChatAuthorBadge ]);
 
     this.author.badges = badges;
     this.author.is_moderator = badges ? badges.some((badge) => badge.icon_type == 'MODERATOR') : null;
@@ -46,6 +49,7 @@ class LiveChatTextMessage extends YTNode {
     this.author.is_verified_artist = badges ? badges.some((badge) => badge.style == 'BADGE_STYLE_TYPE_VERIFIED_ARTIST') : null;
 
     this.menu_endpoint = new NavigationEndpoint(data.contextMenuEndpoint);
+    this.inline_action_buttons = Parser.parseArray<Button>(data.inlineActionButtons, [ Button ]);
     this.timestamp = Math.floor(parseInt(data.timestampUsec) / 1000);
     this.id = data.id;
   }

src/parser/classes/livechat/items/LiveChatTickerPaidMessageItem.ts

@@ -2,6 +2,7 @@ import Text from '../../misc/Text';
 import Thumbnail from '../../misc/Thumbnail';
 import NavigationEndpoint from '../../NavigationEndpoint';
 import MetadataBadge from '../../MetadataBadge';
+import LiveChatAuthorBadge from '../../LiveChatAuthorBadge';
 import Parser from '../../../index';
 
 import { YTNode } from '../../../helpers';
@@ -12,7 +13,7 @@ class LiveChatTickerPaidMessageItem extends YTNode {
   author: {
     id: string;
     thumbnails: Thumbnail[];
-    badges: MetadataBadge[];
+    badges: LiveChatAuthorBadge[] | MetadataBadge[];
     is_moderator: boolean | null;
     is_verified: boolean | null;
     is_verified_artist: boolean | null;
@@ -31,13 +32,13 @@ class LiveChatTickerPaidMessageItem extends YTNode {
     this.author = {
       id: data.authorExternalChannelId,
       thumbnails: Thumbnail.fromResponse(data.authorPhoto),
-      badges: Parser.parseArray<MetadataBadge>(data.authorBadges, MetadataBadge),
+      badges: Parser.parseArray<LiveChatAuthorBadge | MetadataBadge>(data.authorBadges, [ MetadataBadge, LiveChatAuthorBadge ]),
       is_moderator: null,
       is_verified: null,
       is_verified_artist: null
     };
 
-    const badges = Parser.parseArray<MetadataBadge>(data.authorBadges, MetadataBadge);
+    const badges = Parser.parseArray<LiveChatAuthorBadge | MetadataBadge>(data.authorBadges, [ MetadataBadge, LiveChatAuthorBadge ]);
 
     this.author.badges = badges;
     this.author.is_moderator = badges?.some((badge) => badge.icon_type == 'MODERATOR') || null;

src/parser/classes/livechat/items/LiveChatTickerPaidStickerItem.ts

@@ -0,0 +1,56 @@
+import Text from '../../misc/Text';
+import Thumbnail from '../../misc/Thumbnail';
+import NavigationEndpoint from '../../NavigationEndpoint';
+import MetadataBadge from '../../MetadataBadge';
+import LiveChatAuthorBadge from '../../LiveChatAuthorBadge';
+import Parser from '../../../index';
+
+import { YTNode } from '../../../helpers';
+
+class LiveChatTickerPaidStickerItem extends YTNode {
+  static type = 'LiveChatTickerPaidStickerItem';
+
+  author: {
+    id: string;
+    thumbnails: Thumbnail[];
+    badges: LiveChatAuthorBadge[] | MetadataBadge[];
+    is_moderator: boolean | null;
+    is_verified: boolean | null;
+    is_verified_artist: boolean | null;
+  };
+
+  amount: Text;
+  duration_sec: string; // Or number?
+  full_duration_sec: string;
+  show_item;
+  show_item_endpoint: NavigationEndpoint;
+  id: string;
+
+  constructor(data: any) {
+    super();
+
+    this.author = {
+      id: data.authorExternalChannelId,
+      thumbnails: Thumbnail.fromResponse(data.authorPhoto),
+      badges: Parser.parseArray<LiveChatAuthorBadge | MetadataBadge>(data.authorBadges, [ MetadataBadge, LiveChatAuthorBadge ]),
+      is_moderator: null,
+      is_verified: null,
+      is_verified_artist: null
+    };
+
+    const badges = Parser.parseArray<LiveChatAuthorBadge | MetadataBadge>(data.authorBadges, [ MetadataBadge, LiveChatAuthorBadge ]);
+
+    this.author.badges = badges;
+    this.author.is_moderator = badges?.some((badge) => badge.icon_type == 'MODERATOR') || null;
+    this.author.is_verified = badges?.some((badge) => badge.style == 'BADGE_STYLE_TYPE_VERIFIED') || null;
+    this.author.is_verified_artist = badges?.some((badge) => badge.style == 'BADGE_STYLE_TYPE_VERIFIED_ARTIST') || null;
+    this.amount = new Text(data.amount);
+    this.duration_sec = data.durationSec;
+    this.full_duration_sec = data.fullDurationSec;
+    this.show_item = Parser.parse(data.showItemEndpoint.showLiveChatItemEndpoint.renderer);
+    this.show_item_endpoint = new NavigationEndpoint(data.showItemEndpoint);
+    this.id = data.id;
+  }
+}
+
+export default LiveChatTickerPaidStickerItem;

src/parser/classes/menus/MusicMultiSelectMenuItem.ts

@@ -8,7 +8,7 @@ class MusicMultiSelectMenuItem extends YTNode {
   title: string;
   form_item_entity_key: string;
   selected_icon_type: string;
-  endpoint?: NavigationEndpoint;
+  endpoint?: NavigationEndpoint | null;
   selected: boolean;
 
   constructor(data: any) {
@@ -17,19 +17,7 @@ class MusicMultiSelectMenuItem extends YTNode {
     this.title = new Text(data.title).text;
     this.form_item_entity_key = data.formItemEntityKey;
     this.selected_icon_type = data.selectedIcon?.iconType || null;
-    const command = data.selectedCommand?.commandExecutorCommand?.commands?.find((command: any) => command.musicBrowseFormBinderCommand?.browseEndpoint);
-    if (command) {
-      /**
-       * At this point, endpoint will still be missing `form_data` field which is required for
-       * selection to take effect. This can only be obtained from the response data which
-       * we don't have here. We shall delegate this task back to `Parser`.
-       */
-      this.endpoint = new NavigationEndpoint(command.musicBrowseFormBinderCommand);
-    }
-    /**
-     * Inferring selected state from existence of endpoint. `Parser` shall
-     * update this with the definitive value obtained from response data.
-     */
+    this.endpoint = data.selectedCommand ? new NavigationEndpoint(data.selectedCommand) : null;
     this.selected = !!this.endpoint;
   }
 }

src/parser/classes/misc/Author.ts

@@ -21,8 +21,8 @@ class Author {
     this.#nav_text = new NavigatableText(item);
 
     this.id =
-      (this.#nav_text.runs?.[0] as TextRun)?.endpoint?.browse?.id ||
-      this.#nav_text?.endpoint?.browse?.id || 'N/A';
+      (this.#nav_text.runs?.[0] as TextRun)?.endpoint?.payload?.browseId ||
+      this.#nav_text?.endpoint?.payload?.browseId || 'N/A';
 
     this.name = this.#nav_text.text || 'N/A';
     this.thumbnails = thumbs ? Thumbnail.fromResponse(thumbs) : [];
@@ -32,9 +32,9 @@ class Author {
     this.is_verified_artist = this.badges?.some((badge: any) => badge.style == 'BADGE_STYLE_TYPE_VERIFIED_ARTIST') || null;
 
     this.url =
-      (this.#nav_text?.runs?.[0] as TextRun)?.endpoint?.browse &&
-        `${Constants.URLS.YT_BASE}${(this.#nav_text?.runs?.[0] as TextRun)?.endpoint?.browse?.base_url || `/u/${(this.#nav_text?.runs?.[0] as TextRun)?.endpoint?.browse?.id}`}` ||
-        `${Constants.URLS.YT_BASE}${this.#nav_text?.endpoint?.browse?.base_url || `/u/${this.#nav_text?.endpoint?.browse?.id}`}` ||
+      (this.#nav_text?.runs?.[0] as TextRun)?.endpoint?.metadata?.api_url === '/browse' &&
+        `${Constants.URLS.YT_BASE}${(this.#nav_text?.runs?.[0] as TextRun)?.endpoint?.payload?.canonicalBaseUrl || `/u/${(this.#nav_text?.runs?.[0] as TextRun)?.endpoint?.payload?.browseId}`}` ||
+        `${Constants.URLS.YT_BASE}${this.#nav_text?.endpoint?.payload?.canonicalBaseUrl || `/u/${this.#nav_text?.endpoint?.payload?.browseId}`}` ||
         null;
   }
 

src/parser/classes/misc/NavigatableText.ts

@@ -10,12 +10,12 @@ class NavigatableText extends Text {
     super(node);
     // TODO: is this needed? Text now supports this itself
     this.endpoint =
-      node.runs?.[0]?.navigationEndpoint ?
-        new NavigationEndpoint(node.runs[0].navigationEndpoint) :
-        node.navigationEndpoint ?
-          new NavigationEndpoint(node.navigationEndpoint) :
-          node.titleNavigationEndpoint ?
-            new NavigationEndpoint(node.titleNavigationEndpoint) : null;
+      node?.runs?.[0]?.navigationEndpoint ?
+        new NavigationEndpoint(node?.runs[0].navigationEndpoint) :
+        node?.navigationEndpoint ?
+          new NavigationEndpoint(node?.navigationEndpoint) :
+          node?.titleNavigationEndpoint ?
+            new NavigationEndpoint(node?.titleNavigationEndpoint) : null;
   }
 
   toJSON(): NavigatableText {

src/parser/index.ts

@@ -15,6 +15,7 @@ import { YTNode, YTNodeConstructor, SuperParsedResult, ObservedArray, observe, M
 
 import package_json from '../../package.json';
 import MusicMultiSelectMenuItem from './classes/menus/MusicMultiSelectMenuItem';
+import AudioOnlyPlayability from './classes/AudioOnlyPlayability';
 
 export class AppendContinuationItemsAction extends YTNode {
   static readonly type = 'appendContinuationItemsAction';
@@ -49,7 +50,9 @@ export class SectionListContinuation extends YTNode {
   constructor(data: any) {
     super();
     this.contents = Parser.parse(data.contents, true);
-    this.continuation = data.continuations?.[0].nextContinuationData.continuation || null;
+    this.continuation =
+      data.continuations?.[0]?.nextContinuationData?.continuation ||
+      data.continuations?.[0]?.reloadContinuationData?.continuation || null;
   }
 }
 
@@ -169,9 +172,17 @@ export class LiveChatContinuation extends YTNode {
   }
 }
 
+export type ParserError = { classname: string, classdata: any, err: any };
+export type ParserErrorHandler = (error: ParserError) => void;
+
 export default class Parser {
+  static #errorHandler: ParserErrorHandler = Parser.#printError;
   static #memo: Memo | null = null;
 
+  static setParserErrorHandler(handler: ParserErrorHandler) {
+    this.#errorHandler = handler;
+  }
+
   static #clearMemo() {
     Parser.#memo = null;
   }
@@ -202,11 +213,11 @@ export default class Parser {
    */
   static parseResponse(data: any) {
     // Memoize the response objects by classname
+
     this.#createMemo();
     // TODO: is this parseItem?
     const contents = Parser.parse(data.contents);
     const contents_memo = this.#getMemo();
-    // End of memoization
     this.#clearMemo();
 
     this.#createMemo();
@@ -229,6 +240,24 @@ export default class Parser {
     const actions_memo = this.#getMemo();
     this.#clearMemo();
 
+    this.#createMemo();
+    const live_chat_item_context_menu_supported_renderers = data.liveChatItemContextMenuSupportedRenderers
+      ? Parser.parseItem(data.liveChatItemContextMenuSupportedRenderers)
+      : null;
+    const live_chat_item_context_menu_supported_renderers_memo = this.#getMemo();
+    this.#clearMemo();
+
+    this.#createMemo();
+    const header = data.header ? Parser.parse(data.header) : null;
+    const header_memo = this.#getMemo();
+    this.#clearMemo();
+
+    this.#createMemo();
+    const sidebar = data.sidebar ? Parser.parseItem(data.sidebar) : null;
+    const sidebar_memo = this.#getMemo();
+    this.#clearMemo();
+
+
     this.applyMutations(contents_memo, data.frameworkUpdates?.entityBatchUpdate?.mutations);
 
     return {
@@ -236,6 +265,12 @@ export default class Parser {
       actions_memo,
       contents,
       contents_memo,
+      header,
+      header_memo,
+      sidebar,
+      sidebar_memo,
+      live_chat_item_context_menu_supported_renderers,
+      live_chat_item_context_menu_supported_renderers_memo,
       on_response_received_actions,
       on_response_received_actions_memo,
       on_response_received_endpoints,
@@ -245,9 +280,7 @@ export default class Parser {
       continuation: data.continuation ? Parser.parseC(data.continuation) : null,
       continuation_contents: data.continuationContents ? Parser.parseLC(data.continuationContents) : null,
       metadata: Parser.parse(data.metadata),
-      header: Parser.parse(data.header),
       microformat: data.microformat ? Parser.parseItem(data.microformat) : null,
-      sidebar: Parser.parseItem(data.sidebar),
       overlay: Parser.parseItem(data.overlay),
       refinements: data.refinements || null,
       estimated_results: data.estimatedResults ? parseInt(data.estimatedResults) : null,
@@ -258,7 +291,8 @@ export default class Parser {
       } : null,
       playability_status: data.playabilityStatus ? {
         status: data.playabilityStatus.status as string,
-        error_screen: Parser.parse(data.playabilityStatus.errorScreen),
+        error_screen: Parser.parseItem(data.playabilityStatus.errorScreen),
+        audio_only_playablility: Parser.parseItem<AudioOnlyPlayability>(data.playabilityStatus.audioOnlyPlayability, AudioOnlyPlayability),
         embeddable: !!data.playabilityStatus.playableInEmbed || false,
         reason: data.playabilityStatus?.reason || ''
       } : undefined,
@@ -267,7 +301,7 @@ export default class Parser {
         formats: Parser.parseFormats(data.streamingData.formats),
         adaptive_formats: Parser.parseFormats(data.streamingData.adaptiveFormats),
         dash_manifest_url: data.streamingData?.dashManifestUrl || null,
-        dls_manifest_url: data.streamingData?.dashManifestUrl || null
+        hls_manifest_url: data.streamingData?.hlsManifestUrl || null
       } : undefined,
       current_video_endpoint: data.currentVideoEndpoint ? new NavigationEndpoint(data.currentVideoEndpoint) : null,
       captions: Parser.parseItem<PlayerCaptionsTracklist>(data.captions, PlayerCaptionsTracklist),
@@ -323,9 +357,13 @@ export default class Parser {
   }
 
   static parseItem<T extends YTNode = YTNode>(data: any, validTypes?: YTNodeConstructor<T> | YTNodeConstructor<T>[]) {
-    if (!data) return null;
+    if (!data ) return null;
 
     const keys = Object.keys(data);
+
+    if (!keys.length)
+      return null;
+
     const classname = this.sanitizeClassName(keys[0]);
 
     if (!this.shouldIgnore(classname)) {
@@ -345,7 +383,7 @@ export default class Parser {
 
         return result as T;
       } catch (err) {
-        this.formatError({ classname, classdata: data[keys[0]], err });
+        this.#errorHandler({ classname, classdata: data[keys[0]], err });
         return null;
       }
     }
@@ -371,12 +409,8 @@ export default class Parser {
     throw new ParsingError('Expected array but got a single item');
   }
 
-  static parse<T extends YTNode = YTNode>(data: any, requireArray: true, validTypes?: YTNodeConstructor<T> | YTNodeConstructor<T>[]) : ObservedArray<T> | null;
-  static parse<T extends YTNode = YTNode>(data: any, requireArray?: false | undefined, validTypes?: YTNodeConstructor<T> | YTNodeConstructor<T>[]) : SuperParsedResult<T>;
-
-  /**
-   * Parses the `contents` property of the response as well as its nodes.
-   */
+  static parse<T extends YTNode = YTNode>(data: any, requireArray: true, validTypes?: YTNodeConstructor<T> | YTNodeConstructor<T>[]): ObservedArray<T> | null;
+  static parse<T extends YTNode = YTNode>(data: any, requireArray?: false | undefined, validTypes?: YTNodeConstructor<T> | YTNodeConstructor<T>[]): SuperParsedResult<T>;
   static parse<T extends YTNode = YTNode>(data: any, requireArray?: boolean, validTypes?: YTNodeConstructor<T> | YTNodeConstructor<T>[]) {
     if (!data) return null;
 
@@ -402,8 +436,9 @@ export default class Parser {
 
   static applyMutations(memo: Memo, mutations: Array<any>) {
     // Apply mutations to MusicMultiSelectMenuItems
-    const musicMultiSelectMenuItems = memo.getType(MusicMultiSelectMenuItem);
-    if (musicMultiSelectMenuItems.length > 0 && !mutations) {
+    const music_multi_select_menu_items = memo.getType(MusicMultiSelectMenuItem);
+
+    if (music_multi_select_menu_items.length > 0 && !mutations) {
       console.warn(
         new InnertubeError(
           'Mutation data required for processing MusicMultiSelectMenuItems, but none found.\n' +
@@ -411,26 +446,25 @@ export default class Parser {
         )
       );
     } else {
-      const missingOrInvalidMutations = [];
-      for (const menuItem of musicMultiSelectMenuItems) {
-        const mutation = mutations.find((mutation) => mutation.payload?.musicFormBooleanChoice?.id === menuItem.form_item_entity_key);
+      const missing_or_invalid_mutations = [];
+
+      for (const menu_item of music_multi_select_menu_items) {
+        const mutation = mutations
+          .find((mutation) => mutation.payload?.musicFormBooleanChoice?.id === menu_item.form_item_entity_key);
+
         const choice = mutation?.payload.musicFormBooleanChoice;
+
         if (choice?.selected !== undefined && choice?.opaqueToken) {
-          menuItem.selected = choice.selected;
-          if (menuItem.endpoint?.browse) {
-            menuItem.endpoint.browse.form_data = {
-              selectedValues: [ choice.opaqueToken ]
-            };
-          }
+          menu_item.selected = choice.selected;
         } else {
-          missingOrInvalidMutations.push(`'${menuItem.title}'`);
+          missing_or_invalid_mutations.push(`'${menu_item.title}'`);
         }
       }
-      if (missingOrInvalidMutations.length > 0) {
+      if (missing_or_invalid_mutations.length > 0) {
         console.warn(
           new InnertubeError(
-            `Mutation data missing or invalid for ${missingOrInvalidMutations.length} out of ${musicMultiSelectMenuItems.length} MusicMultiSelectMenuItems. ` +
-            `The titles of the failed items are: ${missingOrInvalidMutations.join(', ')}.\n` +
+            `Mutation data missing or invalid for ${missing_or_invalid_mutations.length} out of ${music_multi_select_menu_items.length} MusicMultiSelectMenuItems. ` +
+            `The titles of the failed items are: ${missing_or_invalid_mutations.join(', ')}.\n` +
             `This is a bug, please report it at ${package_json.bugs.url}`
           )
         );
@@ -438,12 +472,13 @@ export default class Parser {
     }
   }
 
-  static formatError({ classname, classdata, err }: { classname: string, classdata: any, err: any }) {
+  static #printError({ classname, classdata, err }: ParserError) {
     if (err.code == 'MODULE_NOT_FOUND') {
       return console.warn(
         new InnertubeError(
           `${classname} not found!\n` +
-          `This is a bug, please report it at ${package_json.bugs.url}`, classdata)
+          `This is a bug, want to help us fix it? Follow the instructions at ${package_json.homepage.split('#')[0]}/blob/main/docs/updating-the-parser.md or report it at ${package_json.bugs.url}!`, classdata
+        )
       );
     }
 
@@ -462,6 +497,7 @@ export default class Parser {
   }
 
   static ignore_list = new Set<string>([
+    'AdSlot',
     'DisplayAd',
     'SearchPyv',
     'MealbarPromo',

src/parser/map.ts

@@ -16,16 +16,20 @@ import { default as AnalyticsVodCarouselCard } from './classes/analytics/Analyti
 import { default as CtaGoToCreatorStudio } from './classes/analytics/CtaGoToCreatorStudio';
 import { default as DataModelSection } from './classes/analytics/DataModelSection';
 import { default as StatRow } from './classes/analytics/StatRow';
+import { default as AudioOnlyPlayability } from './classes/AudioOnlyPlayability';
 import { default as AutomixPreviewVideo } from './classes/AutomixPreviewVideo';
 import { default as BackstageImage } from './classes/BackstageImage';
 import { default as BackstagePost } from './classes/BackstagePost';
 import { default as BackstagePostThread } from './classes/BackstagePostThread';
 import { default as BrowseFeedActions } from './classes/BrowseFeedActions';
+import { default as BrowserMediaSession } from './classes/BrowserMediaSession';
 import { default as Button } from './classes/Button';
 import { default as C4TabbedHeader } from './classes/C4TabbedHeader';
 import { default as CallToActionButton } from './classes/CallToActionButton';
 import { default as Card } from './classes/Card';
 import { default as CardCollection } from './classes/CardCollection';
+import { default as CarouselHeader } from './classes/CarouselHeader';
+import { default as CarouselItem } from './classes/CarouselItem';
 import { default as Channel } from './classes/Channel';
 import { default as ChannelAboutFullMetadata } from './classes/ChannelAboutFullMetadata';
 import { default as ChannelFeaturedContent } from './classes/ChannelFeaturedContent';
@@ -38,6 +42,7 @@ import { default as ChannelVideoPlayer } from './classes/ChannelVideoPlayer';
 import { default as ChildVideo } from './classes/ChildVideo';
 import { default as ChipCloud } from './classes/ChipCloud';
 import { default as ChipCloudChip } from './classes/ChipCloudChip';
+import { default as CollaboratorInfoCardContent } from './classes/CollaboratorInfoCardContent';
 import { default as CollageHeroImage } from './classes/CollageHeroImage';
 import { default as AuthorCommentBadge } from './classes/comments/AuthorCommentBadge';
 import { default as Comment } from './classes/comments/Comment';
@@ -51,10 +56,13 @@ import { default as CommentThread } from './classes/comments/CommentThread';
 import { default as CompactLink } from './classes/CompactLink';
 import { default as CompactMix } from './classes/CompactMix';
 import { default as CompactPlaylist } from './classes/CompactPlaylist';
+import { default as CompactStation } from './classes/CompactStation';
 import { default as CompactVideo } from './classes/CompactVideo';
+import { default as ConfirmDialog } from './classes/ConfirmDialog';
 import { default as ContinuationItem } from './classes/ContinuationItem';
 import { default as CopyLink } from './classes/CopyLink';
 import { default as CreatePlaylistDialog } from './classes/CreatePlaylistDialog';
+import { default as DefaultPromoPanel } from './classes/DefaultPromoPanel';
 import { default as DidYouMean } from './classes/DidYouMean';
 import { default as DownloadButton } from './classes/DownloadButton';
 import { default as Dropdown } from './classes/Dropdown';
@@ -69,6 +77,8 @@ import { default as ExpandableTab } from './classes/ExpandableTab';
 import { default as ExpandedShelfContents } from './classes/ExpandedShelfContents';
 import { default as FeedFilterChipBar } from './classes/FeedFilterChipBar';
 import { default as FeedTabbedHeader } from './classes/FeedTabbedHeader';
+import { default as GameCard } from './classes/GameCard';
+import { default as GameDetails } from './classes/GameDetails';
 import { default as Grid } from './classes/Grid';
 import { default as GridChannel } from './classes/GridChannel';
 import { default as GridHeader } from './classes/GridHeader';
@@ -79,6 +89,7 @@ import { default as HistorySuggestion } from './classes/HistorySuggestion';
 import { default as HorizontalCardList } from './classes/HorizontalCardList';
 import { default as HorizontalList } from './classes/HorizontalList';
 import { default as IconLink } from './classes/IconLink';
+import { default as InteractiveTabbedHeader } from './classes/InteractiveTabbedHeader';
 import { default as ItemSection } from './classes/ItemSection';
 import { default as ItemSectionHeader } from './classes/ItemSectionHeader';
 import { default as ItemSectionTab } from './classes/ItemSectionTab';
@@ -88,6 +99,7 @@ import { default as LiveChat } from './classes/LiveChat';
 import { default as AddBannerToLiveChatCommand } from './classes/livechat/AddBannerToLiveChatCommand';
 import { default as AddChatItemAction } from './classes/livechat/AddChatItemAction';
 import { default as AddLiveChatTickerItemAction } from './classes/livechat/AddLiveChatTickerItemAction';
+import { default as LiveChatAutoModMessage } from './classes/livechat/items/LiveChatAutoModMessage';
 import { default as LiveChatBanner } from './classes/livechat/items/LiveChatBanner';
 import { default as LiveChatBannerHeader } from './classes/livechat/items/LiveChatBannerHeader';
 import { default as LiveChatBannerPoll } from './classes/livechat/items/LiveChatBannerPoll';
@@ -98,6 +110,7 @@ import { default as LiveChatPlaceholderItem } from './classes/livechat/items/Liv
 import { default as LiveChatProductItem } from './classes/livechat/items/LiveChatProductItem';
 import { default as LiveChatTextMessage } from './classes/livechat/items/LiveChatTextMessage';
 import { default as LiveChatTickerPaidMessageItem } from './classes/livechat/items/LiveChatTickerPaidMessageItem';
+import { default as LiveChatTickerPaidStickerItem } from './classes/livechat/items/LiveChatTickerPaidStickerItem';
 import { default as LiveChatTickerSponsorItem } from './classes/livechat/items/LiveChatTickerSponsorItem';
 import { default as LiveChatViewerEngagementMessage } from './classes/livechat/items/LiveChatViewerEngagementMessage';
 import { default as PollHeader } from './classes/livechat/items/PollHeader';
@@ -105,6 +118,8 @@ import { default as LiveChatActionPanel } from './classes/livechat/LiveChatActio
 import { default as MarkChatItemAsDeletedAction } from './classes/livechat/MarkChatItemAsDeletedAction';
 import { default as MarkChatItemsByAuthorAsDeletedAction } from './classes/livechat/MarkChatItemsByAuthorAsDeletedAction';
 import { default as RemoveBannerForLiveChatCommand } from './classes/livechat/RemoveBannerForLiveChatCommand';
+import { default as RemoveChatItemAction } from './classes/livechat/RemoveChatItemAction';
+import { default as RemoveChatItemByAuthorAction } from './classes/livechat/RemoveChatItemByAuthorAction';
 import { default as ReplaceChatItemAction } from './classes/livechat/ReplaceChatItemAction';
 import { default as ReplayChatItemAction } from './classes/livechat/ReplayChatItemAction';
 import { default as ShowLiveChatActionPanelAction } from './classes/livechat/ShowLiveChatActionPanelAction';
@@ -116,6 +131,7 @@ import { default as UpdateTitleAction } from './classes/livechat/UpdateTitleActi
 import { default as UpdateToggleButtonTextAction } from './classes/livechat/UpdateToggleButtonTextAction';
 import { default as UpdateViewershipAction } from './classes/livechat/UpdateViewershipAction';
 import { default as LiveChatAuthorBadge } from './classes/LiveChatAuthorBadge';
+import { default as LiveChatDialog } from './classes/LiveChatDialog';
 import { default as LiveChatHeader } from './classes/LiveChatHeader';
 import { default as LiveChatItemList } from './classes/LiveChatItemList';
 import { default as LiveChatMessageInput } from './classes/LiveChatMessageInput';
@@ -138,6 +154,7 @@ import { default as MetadataBadge } from './classes/MetadataBadge';
 import { default as MetadataRow } from './classes/MetadataRow';
 import { default as MetadataRowContainer } from './classes/MetadataRowContainer';
 import { default as MetadataRowHeader } from './classes/MetadataRowHeader';
+import { default as MetadataScreen } from './classes/MetadataScreen';
 import { default as MicroformatData } from './classes/MicroformatData';
 import { default as Mix } from './classes/Mix';
 import { default as Movie } from './classes/Movie';
@@ -146,6 +163,7 @@ import { default as MusicCarouselShelf } from './classes/MusicCarouselShelf';
 import { default as MusicCarouselShelfBasicHeader } from './classes/MusicCarouselShelfBasicHeader';
 import { default as MusicDescriptionShelf } from './classes/MusicDescriptionShelf';
 import { default as MusicDetailHeader } from './classes/MusicDetailHeader';
+import { default as MusicDownloadStateBadge } from './classes/MusicDownloadStateBadge';
 import { default as MusicEditablePlaylistDetailHeader } from './classes/MusicEditablePlaylistDetailHeader';
 import { default as MusicElementHeader } from './classes/MusicElementHeader';
 import { default as MusicHeader } from './classes/MusicHeader';
@@ -178,11 +196,13 @@ import { default as PlayerOverlay } from './classes/PlayerOverlay';
 import { default as PlayerOverlayAutoplay } from './classes/PlayerOverlayAutoplay';
 import { default as PlayerStoryboardSpec } from './classes/PlayerStoryboardSpec';
 import { default as Playlist } from './classes/Playlist';
+import { default as PlaylistCustomThumbnail } from './classes/PlaylistCustomThumbnail';
 import { default as PlaylistHeader } from './classes/PlaylistHeader';
 import { default as PlaylistInfoCardContent } from './classes/PlaylistInfoCardContent';
 import { default as PlaylistMetadata } from './classes/PlaylistMetadata';
 import { default as PlaylistPanel } from './classes/PlaylistPanel';
 import { default as PlaylistPanelVideo } from './classes/PlaylistPanelVideo';
+import { default as PlaylistPanelVideoWrapper } from './classes/PlaylistPanelVideoWrapper';
 import { default as PlaylistSidebar } from './classes/PlaylistSidebar';
 import { default as PlaylistSidebarPrimaryInfo } from './classes/PlaylistSidebarPrimaryInfo';
 import { default as PlaylistSidebarSecondaryInfo } from './classes/PlaylistSidebarSecondaryInfo';
@@ -195,6 +215,7 @@ import { default as ProfileColumn } from './classes/ProfileColumn';
 import { default as ProfileColumnStats } from './classes/ProfileColumnStats';
 import { default as ProfileColumnStatsEntry } from './classes/ProfileColumnStatsEntry';
 import { default as ProfileColumnUserInfo } from './classes/ProfileColumnUserInfo';
+import { default as RecognitionShelf } from './classes/RecognitionShelf';
 import { default as ReelItem } from './classes/ReelItem';
 import { default as ReelShelf } from './classes/ReelShelf';
 import { default as RelatedChipCloud } from './classes/RelatedChipCloud';
@@ -209,6 +230,7 @@ import { default as SearchSuggestion } from './classes/SearchSuggestion';
 import { default as SearchSuggestionsSection } from './classes/SearchSuggestionsSection';
 import { default as SecondarySearchContainer } from './classes/SecondarySearchContainer';
 import { default as SectionList } from './classes/SectionList';
+import { default as SegmentedLikeDislikeButton } from './classes/SegmentedLikeDislikeButton';
 import { default as SettingBoolean } from './classes/SettingBoolean';
 import { default as SettingsCheckbox } from './classes/SettingsCheckbox';
 import { default as SettingsOptions } from './classes/SettingsOptions';
@@ -232,6 +254,7 @@ import { default as Tab } from './classes/Tab';
 import { default as Tabbed } from './classes/Tabbed';
 import { default as TabbedSearchResults } from './classes/TabbedSearchResults';
 import { default as TextHeader } from './classes/TextHeader';
+import { default as ThumbnailLandscapePortrait } from './classes/ThumbnailLandscapePortrait';
 import { default as ThumbnailOverlayBottomPanel } from './classes/ThumbnailOverlayBottomPanel';
 import { default as ThumbnailOverlayEndorsement } from './classes/ThumbnailOverlayEndorsement';
 import { default as ThumbnailOverlayHoverText } from './classes/ThumbnailOverlayHoverText';
@@ -248,6 +271,7 @@ import { default as TitleAndButtonListHeader } from './classes/TitleAndButtonLis
 import { default as ToggleButton } from './classes/ToggleButton';
 import { default as ToggleMenuServiceItem } from './classes/ToggleMenuServiceItem';
 import { default as Tooltip } from './classes/Tooltip';
+import { default as TopicChannelDetails } from './classes/TopicChannelDetails';
 import { default as TwoColumnBrowseResults } from './classes/TwoColumnBrowseResults';
 import { default as TwoColumnSearchResults } from './classes/TwoColumnSearchResults';
 import { default as TwoColumnWatchNextResults } from './classes/TwoColumnWatchNextResults';
@@ -255,6 +279,7 @@ import { default as UniversalWatchCard } from './classes/UniversalWatchCard';
 import { default as VerticalList } from './classes/VerticalList';
 import { default as VerticalWatchCardList } from './classes/VerticalWatchCardList';
 import { default as Video } from './classes/Video';
+import { default as VideoCard } from './classes/VideoCard';
 import { default as VideoInfoCardContent } from './classes/VideoInfoCardContent';
 import { default as VideoOwner } from './classes/VideoOwner';
 import { default as VideoPrimaryInfo } from './classes/VideoPrimaryInfo';
@@ -266,7 +291,7 @@ import { default as WatchCardSectionSequence } from './classes/WatchCardSectionS
 import { default as WatchNextEndScreen } from './classes/WatchNextEndScreen';
 import { default as WatchNextTabbedResults } from './classes/WatchNextTabbedResults';
 
-const map: Record<string, YTNodeConstructor> = {
+export const YTNodes = {
   AccountChannel,
   AccountItemSection,
   AccountItemSectionHeader,
@@ -281,16 +306,20 @@ const map: Record<string, YTNodeConstructor> = {
   CtaGoToCreatorStudio,
   DataModelSection,
   StatRow,
+  AudioOnlyPlayability,
   AutomixPreviewVideo,
   BackstageImage,
   BackstagePost,
   BackstagePostThread,
   BrowseFeedActions,
+  BrowserMediaSession,
   Button,
   C4TabbedHeader,
   CallToActionButton,
   Card,
   CardCollection,
+  CarouselHeader,
+  CarouselItem,
   Channel,
   ChannelAboutFullMetadata,
   ChannelFeaturedContent,
@@ -303,6 +332,7 @@ const map: Record<string, YTNodeConstructor> = {
   ChildVideo,
   ChipCloud,
   ChipCloudChip,
+  CollaboratorInfoCardContent,
   CollageHeroImage,
   AuthorCommentBadge,
   Comment,
@@ -316,10 +346,13 @@ const map: Record<string, YTNodeConstructor> = {
   CompactLink,
   CompactMix,
   CompactPlaylist,
+  CompactStation,
   CompactVideo,
+  ConfirmDialog,
   ContinuationItem,
   CopyLink,
   CreatePlaylistDialog,
+  DefaultPromoPanel,
   DidYouMean,
   DownloadButton,
   Dropdown,
@@ -334,6 +367,8 @@ const map: Record<string, YTNodeConstructor> = {
   ExpandedShelfContents,
   FeedFilterChipBar,
   FeedTabbedHeader,
+  GameCard,
+  GameDetails,
   Grid,
   GridChannel,
   GridHeader,
@@ -344,6 +379,7 @@ const map: Record<string, YTNodeConstructor> = {
   HorizontalCardList,
   HorizontalList,
   IconLink,
+  InteractiveTabbedHeader,
   ItemSection,
   ItemSectionHeader,
   ItemSectionTab,
@@ -353,6 +389,7 @@ const map: Record<string, YTNodeConstructor> = {
   AddBannerToLiveChatCommand,
   AddChatItemAction,
   AddLiveChatTickerItemAction,
+  LiveChatAutoModMessage,
   LiveChatBanner,
   LiveChatBannerHeader,
   LiveChatBannerPoll,
@@ -363,6 +400,7 @@ const map: Record<string, YTNodeConstructor> = {
   LiveChatProductItem,
   LiveChatTextMessage,
   LiveChatTickerPaidMessageItem,
+  LiveChatTickerPaidStickerItem,
   LiveChatTickerSponsorItem,
   LiveChatViewerEngagementMessage,
   PollHeader,
@@ -370,6 +408,8 @@ const map: Record<string, YTNodeConstructor> = {
   MarkChatItemAsDeletedAction,
   MarkChatItemsByAuthorAsDeletedAction,
   RemoveBannerForLiveChatCommand,
+  RemoveChatItemAction,
+  RemoveChatItemByAuthorAction,
   ReplaceChatItemAction,
   ReplayChatItemAction,
   ShowLiveChatActionPanelAction,
@@ -381,6 +421,7 @@ const map: Record<string, YTNodeConstructor> = {
   UpdateToggleButtonTextAction,
   UpdateViewershipAction,
   LiveChatAuthorBadge,
+  LiveChatDialog,
   LiveChatHeader,
   LiveChatItemList,
   LiveChatMessageInput,
@@ -403,6 +444,7 @@ const map: Record<string, YTNodeConstructor> = {
   MetadataRow,
   MetadataRowContainer,
   MetadataRowHeader,
+  MetadataScreen,
   MicroformatData,
   Mix,
   Movie,
@@ -411,6 +453,7 @@ const map: Record<string, YTNodeConstructor> = {
   MusicCarouselShelfBasicHeader,
   MusicDescriptionShelf,
   MusicDetailHeader,
+  MusicDownloadStateBadge,
   MusicEditablePlaylistDetailHeader,
   MusicElementHeader,
   MusicHeader,
@@ -443,11 +486,13 @@ const map: Record<string, YTNodeConstructor> = {
   PlayerOverlayAutoplay,
   PlayerStoryboardSpec,
   Playlist,
+  PlaylistCustomThumbnail,
   PlaylistHeader,
   PlaylistInfoCardContent,
   PlaylistMetadata,
   PlaylistPanel,
   PlaylistPanelVideo,
+  PlaylistPanelVideoWrapper,
   PlaylistSidebar,
   PlaylistSidebarPrimaryInfo,
   PlaylistSidebarSecondaryInfo,
@@ -460,6 +505,7 @@ const map: Record<string, YTNodeConstructor> = {
   ProfileColumnStats,
   ProfileColumnStatsEntry,
   ProfileColumnUserInfo,
+  RecognitionShelf,
   ReelItem,
   ReelShelf,
   RelatedChipCloud,
@@ -474,6 +520,7 @@ const map: Record<string, YTNodeConstructor> = {
   SearchSuggestionsSection,
   SecondarySearchContainer,
   SectionList,
+  SegmentedLikeDislikeButton,
   SettingBoolean,
   SettingsCheckbox,
   SettingsOptions,
@@ -497,6 +544,7 @@ const map: Record<string, YTNodeConstructor> = {
   Tabbed,
   TabbedSearchResults,
   TextHeader,
+  ThumbnailLandscapePortrait,
   ThumbnailOverlayBottomPanel,
   ThumbnailOverlayEndorsement,
   ThumbnailOverlayHoverText,
@@ -513,6 +561,7 @@ const map: Record<string, YTNodeConstructor> = {
   ToggleButton,
   ToggleMenuServiceItem,
   Tooltip,
+  TopicChannelDetails,
   TwoColumnBrowseResults,
   TwoColumnSearchResults,
   TwoColumnWatchNextResults,
@@ -520,6 +569,7 @@ const map: Record<string, YTNodeConstructor> = {
   VerticalList,
   VerticalWatchCardList,
   Video,
+  VideoCard,
   VideoInfoCardContent,
   VideoOwner,
   VideoPrimaryInfo,
@@ -532,7 +582,7 @@ const map: Record<string, YTNodeConstructor> = {
   WatchNextTabbedResults
 };
 
-export const YTNodes = map;
+const map: Record<string, YTNodeConstructor> = YTNodes;
 
 /**
  * @param name - Name of the node to be parsed

src/parser/youtube/AccountInfo.ts

@@ -1,5 +1,5 @@
 import Parser, { ParsedResponse } from '..';
-import { AxioslikeResponse } from '../../core/Actions';
+import { ApiResponse } from '../../core/Actions';
 
 import AccountSectionList from '../classes/AccountSectionList';
 import AccountItemSection from '../classes/AccountItemSection';
@@ -11,7 +11,7 @@ class AccountInfo {
   contents: AccountItemSection | null;
   footers: AccountChannel | null;
 
-  constructor(response: AxioslikeResponse) {
+  constructor(response: ApiResponse) {
     this.#page = Parser.parseResponse(response.data);
 
     const account_section_list = this.#page.contents.array().as(AccountSectionList)[0];

src/parser/youtube/Analytics.ts

@@ -1,12 +1,12 @@
 import Parser, { ParsedResponse } from '..';
-import { AxioslikeResponse } from '../../core/Actions';
+import { ApiResponse } from '../../core/Actions';
 import Element from '../classes/Element';
 
 class Analytics {
   #page;
   sections;
 
-  constructor(response: AxioslikeResponse) {
+  constructor(response: ApiResponse) {
     this.#page = Parser.parseResponse(response.data);
     this.sections = this.#page.contents_memo?.get('Element')
       ?.map((el) => el.as(Element).model?.item());

src/parser/youtube/Channel.ts

@@ -1,28 +1,36 @@
 import Actions from '../../core/Actions';
 import TabbedFeed from '../../core/TabbedFeed';
 import C4TabbedHeader from '../classes/C4TabbedHeader';
+import CarouselHeader from '../classes/CarouselHeader';
+import InteractiveTabbedHeader from '../classes/InteractiveTabbedHeader';
 import ChannelAboutFullMetadata from '../classes/ChannelAboutFullMetadata';
 import ChannelMetadata from '../classes/ChannelMetadata';
 import MicroformatData from '../classes/MicroformatData';
+import SubscribeButton from '../classes/SubscribeButton';
 import Tab from '../classes/Tab';
 
+import { InnertubeError } from '../../utils/Utils';
+
 class Channel extends TabbedFeed {
   header;
   metadata;
-  sponsor_button;
   subscribe_button;
   current_tab;
 
   constructor(actions: Actions, data: any, already_parsed = false) {
     super(actions, data, already_parsed);
 
-    this.header = this.page.header.item().as(C4TabbedHeader);
-    const metadata = this.page.metadata.item().as(ChannelMetadata);
+    this.header = this.page.header?.item()?.as(C4TabbedHeader, CarouselHeader, InteractiveTabbedHeader);
+
+    const metadata = this.page.metadata?.item().as(ChannelMetadata);
     const microformat = this.page.microformat?.as(MicroformatData);
 
+    if (!metadata && !this.page.contents)
+      throw new InnertubeError('Invalid channel', this);
+
     this.metadata = { ...metadata, ...(microformat || {}) };
-    this.sponsor_button = this.header.sponsor_button;
-    this.subscribe_button = this.header.subscribe_button;
+
+    this.subscribe_button = this.page.header_memo.getType(SubscribeButton)?.[0];
 
     const tab = this.page.contents.item().key('tabs').parsed().array().filterType(Tab).get({ selected: true });
 

src/parser/youtube/Comments.ts

@@ -40,19 +40,18 @@ class Comments {
 
   /**
    * Creates a top-level comment.
+   * @param text - Comment text.
    */
   async createComment(text: string): Promise<ActionsResponse> {
     if (!this.header)
-      throw new InnertubeError('Page header is missing.');
+      throw new InnertubeError('Page header is missing. Cannot create comment.');
 
-    const button = this.header.create_renderer?.as(CommentSimplebox).submit_button.item().as(Button);
+    const button = this.header.create_renderer?.as(CommentSimplebox).submit_button?.item().as(Button);
 
     if (!button)
-      throw new InnertubeError('Could not find target button.');
+      throw new InnertubeError('Could not find target button. You are probably not logged in.');
 
-    const response = await button.endpoint.callTest(this.#actions, {
-      commentText: text
-    });
+    const response = await button.endpoint.call(this.#actions, { commentText: text });
 
     return response;
   }
@@ -64,13 +63,13 @@ class Comments {
     if (!this.#continuation)
       throw new InnertubeError('Continuation not found');
 
-    const data = await this.#continuation.endpoint.callTest(this.#actions, { parse: true });
+    const data = await this.#continuation.endpoint.call(this.#actions, { parse: true });
 
     // Copy the previous page so we can keep the header.
     const page = Object.assign({}, this.#page);
 
     if (!page.on_response_received_endpoints || !data.on_response_received_endpoints)
-      throw new InnertubeError('Invalid reponse format, missing on_response_received_endpoints');
+      throw new InnertubeError('Invalid reponse format, missing on_response_received_endpoints.');
 
     // Remove previous items and append the continuation.
     page.on_response_received_endpoints.pop();

src/parser/youtube/HomeFeed.ts

@@ -0,0 +1,42 @@
+import Actions from '../../core/Actions';
+import FilterableFeed from '../../core/FilterableFeed';
+import ChipCloudChip from '../classes/ChipCloudChip';
+import FeedTabbedHeader from '../classes/FeedTabbedHeader';
+import RichGrid from '../classes/RichGrid';
+
+import { ReloadContinuationItemsCommand, AppendContinuationItemsAction } from '..';
+
+export default class HomeFeed extends FilterableFeed {
+  contents: RichGrid | AppendContinuationItemsAction | ReloadContinuationItemsCommand;
+  header: FeedTabbedHeader;
+
+  constructor(actions: Actions, data: any, already_parsed = false) {
+    super(actions, data, already_parsed);
+    this.header = this.memo.getType<FeedTabbedHeader>(FeedTabbedHeader)?.[0];
+    this.contents =
+      this.memo.getType<RichGrid>(RichGrid)?.[0] ||
+      this.page.on_response_received_actions?.[0];
+  }
+
+  /**
+   * Applies given filter to the feed.
+   * @param filter - Filter to apply.
+   */
+  async applyFilter(filter: string | ChipCloudChip): Promise<HomeFeed> {
+    const feed = await super.getFilteredFeed(filter);
+    return new HomeFeed(this.actions, feed.page, true);
+  }
+
+  /**
+   * Retrieves next batch of contents.
+   */
+  async getContinuation(): Promise<HomeFeed> {
+    const feed = await super.getContinuation();
+
+    // Keep the page header
+    feed.page.header = this.page.header;
+    feed.page.header_memo.set(this.header.type, [ this.header ]);
+
+    return new HomeFeed(this.actions, feed.page, true);
+  }
+}

src/parser/youtube/ItemMenu.ts

@@ -0,0 +1,65 @@
+import Actions from '../../core/Actions';
+
+import Menu from '../classes/menus/Menu';
+import MenuServiceItem from '../classes/menus/MenuServiceItem';
+import NavigationEndpoint from '../classes/NavigationEndpoint';
+import Button from '../classes/Button';
+
+import { ParsedResponse } from '..';
+import { InnertubeError } from '../../utils/Utils';
+import { ObservedArray, YTNode } from '../helpers';
+
+class ItemMenu {
+  #page: ParsedResponse;
+  #actions: Actions;
+  #items: ObservedArray<YTNode>;
+
+  constructor(data: ParsedResponse, actions: Actions) {
+    this.#page = data;
+    this.#actions = actions;
+
+    const menu = data?.live_chat_item_context_menu_supported_renderers;
+
+    if (!menu || !menu.is(Menu))
+      throw new InnertubeError('Response did not have a "live_chat_item_context_menu_supported_renderers" property. The call may have failed.');
+
+    this.#items = menu.as(Menu).items;
+  }
+
+  async selectItem(icon_type: string): Promise<ParsedResponse>
+  async selectItem(button: Button): Promise<ParsedResponse>
+  async selectItem(item: string | Button): Promise<ParsedResponse> {
+    let endpoint: NavigationEndpoint;
+
+    if (item instanceof Button) {
+      endpoint = item.endpoint;
+    } else {
+      const button = this.#items.find((button) => {
+        if (!button.is(MenuServiceItem)) {
+          return false;
+        }
+        const menuServiceItem = button.as(MenuServiceItem);
+        return menuServiceItem.icon_type === item;
+      });
+
+      if (!button)
+        throw new InnertubeError(`Button "${item}" not found.`);
+
+      endpoint = button.as(MenuServiceItem).endpoint;
+    }
+
+    const response = await endpoint.call(this.#actions, { parse: true });
+
+    return response;
+  }
+
+  items(): ObservedArray<YTNode> {
+    return this.#items;
+  }
+
+  page(): ParsedResponse {
+    return this.#page;
+  }
+}
+
+export default ItemMenu;

src/parser/youtube/Library.ts

@@ -1,20 +1,14 @@
 import Parser, { ParsedResponse } from '..';
-import Actions, { AxioslikeResponse } from '../../core/Actions';
+import Actions, { ApiResponse } from '../../core/Actions';
 import { InnertubeError } from '../../utils/Utils';
 
 import Feed from '../../core/Feed';
 import History from './History';
 import Playlist from './Playlist';
-
-import Tab from '../classes/Tab';
 import Menu from '../classes/menus/Menu';
 import Shelf from '../classes/Shelf';
 import Button from '../classes/Button';
-import SectionList from '../classes/SectionList';
-import ItemSection from '../classes/ItemSection';
-import TwoColumnBrowseResults from '../classes/TwoColumnBrowseResults';
 
-import ProfileColumn from '../classes/ProfileColumn';
 import ProfileColumnStats from '../classes/ProfileColumnStats';
 import ProfileColumnUserInfo from '../classes/ProfileColumnUserInfo';
 
@@ -25,34 +19,21 @@ class Library {
   profile;
   sections;
 
-  constructor(response: AxioslikeResponse, actions: Actions) {
+  constructor(response: ApiResponse, actions: Actions) {
     this.#actions = actions;
     this.#page = Parser.parseResponse(response);
 
-    const two_col = this.#page.contents.item().as(TwoColumnBrowseResults);
-
-    if (!two_col)
-      throw new InnertubeError('Response did not have a TwoColumnBrowseResults.');
-
-    const tab = two_col.tabs.array().as(Tab).get({ selected: true });
-
-    if (!tab)
-      throw new InnertubeError('Could not find target tab.');
-
-    const stats = two_col.secondary_contents.item().as(ProfileColumn).items.array().get({ type: 'ProfileColumnStats' })?.as(ProfileColumnStats) || null;
-    const user_info = two_col.secondary_contents.item().as(ProfileColumn).items.array().get({ type: 'ProfileColumnUserInfo' })?.as(ProfileColumnUserInfo) || null;
+    const stats = this.#page.contents_memo.getType(ProfileColumnStats)?.[0];
+    const user_info = this.#page.contents_memo.getType(ProfileColumnUserInfo)?.[0];
 
     this.profile = { stats, user_info };
 
-    if (!tab.content)
-      throw new InnertubeError('Target tab did not have any content.');
-
-    const shelves = tab.content.as(SectionList).contents.array().as(ItemSection).map((is: ItemSection) => is.contents?.firstOfType(Shelf));
+    const shelves = this.#page.contents_memo.getType(Shelf);
 
     this.sections = shelves.map((shelf: any) => ({
       type: shelf.icon_type,
       title: shelf.title,
-      contents: shelf.content?.item().items.array() || [],
+      contents: shelf.content?.item().items || [],
       getAll: () => this.#getAll(shelf)
     }));
   }
@@ -61,12 +42,12 @@ class Library {
     if (!shelf.menu?.item().as(Menu).hasKey('top_level_buttons'))
       throw new InnertubeError(`The ${shelf.title.text} shelf doesn't have more items`);
 
-    const button = await shelf.menu.item().as(Menu).top_level_buttons.get({ text: 'See all' });
+    const button = shelf.menu.item().as(Menu).top_level_buttons.get({ text: 'See all' });
 
     if (!button)
       throw new InnertubeError('Did not find target button.');
 
-    const page = await button.as(Button).endpoint.callTest(this.#actions, { parse: true });
+    const page = await button.as(Button).endpoint.call(this.#actions, { parse: true });
 
     switch (shelf.icon_type) {
       case 'LIKE':

src/parser/youtube/LiveChat.ts

@@ -1,4 +1,4 @@
-import Parser, { LiveChatContinuation } from '../index';
+import Parser, { LiveChatContinuation, ParsedResponse } from '../index';
 import EventEmitter from '../../utils/EventEmitterLike';
 import VideoInfo from './VideoInfo';
 
@@ -20,14 +20,26 @@ import AddBannerToLiveChatCommand from '../classes/livechat/AddBannerToLiveChatC
 import RemoveBannerForLiveChatCommand from '../classes/livechat/RemoveBannerForLiveChatCommand';
 import ShowLiveChatTooltipCommand from '../classes/livechat/ShowLiveChatTooltipCommand';
 
-import { InnertubeError } from '../../utils/Utils';
+import Proto from '../../proto/index';
+import { InnertubeError, uuidv4 } from '../../utils/Utils';
 import { ObservedArray, YTNode } from '../helpers';
 
+import LiveChatTextMessage from '../classes/livechat/items/LiveChatTextMessage';
+import LiveChatPaidMessage from '../classes/livechat/items/LiveChatPaidMessage';
+import LiveChatPaidSticker from '../classes/livechat/items/LiveChatPaidSticker';
+import LiveChatAutoModMessage from '../classes/livechat/items/LiveChatAutoModMessage';
+import LiveChatMembershipItem from '../classes/livechat/items/LiveChatMembershipItem';
+import LiveChatViewerEngagementMessage from '../classes/livechat/items/LiveChatViewerEngagementMessage';
+import ItemMenu from './ItemMenu';
+import Button from '../classes/Button';
+
 export type ChatAction =
   AddChatItemAction | AddBannerToLiveChatCommand | AddLiveChatTickerItemAction |
   MarkChatItemAsDeletedAction | MarkChatItemsByAuthorAsDeletedAction | RemoveBannerForLiveChatCommand |
   ReplaceChatItemAction | ReplayChatItemAction | ShowLiveChatActionPanelAction | ShowLiveChatTooltipCommand;
 
+export type ChatItemWithMenu = LiveChatAutoModMessage | LiveChatMembershipItem | LiveChatPaidMessage | LiveChatPaidSticker | LiveChatTextMessage | LiveChatViewerEngagementMessage;
+
 export interface LiveMetadata {
   title: UpdateTitleAction | undefined;
   description: UpdateDescriptionAction | undefined;
@@ -42,9 +54,6 @@ class LiveChat extends EventEmitter {
   #continuation;
   #mcontinuation?: string;
 
-  #lc_polling_interval_ms = 1000;
-  #md_polling_interval_ms = 5000;
-
   initial_info?: LiveChatContinuation;
   metadata?: LiveMetadata;
 
@@ -73,111 +82,130 @@ class LiveChat extends EventEmitter {
   }
 
   #pollLivechat() {
-    const lc_poller = setTimeout(() => {
-      (async () => {
-        const endpoint = this.is_replay ? 'live_chat/get_live_chat_replay' : 'live_chat/get_live_chat';
-        const response = await this.#actions.livechat(endpoint, { ctoken: this.#continuation });
+    (async () => {
+      const endpoint = this.is_replay ? 'live_chat/get_live_chat_replay' : 'live_chat/get_live_chat';
+      const response = await this.#actions.execute(endpoint, { continuation: this.#continuation });
 
-        const data = Parser.parseResponse(response.data);
-        const contents = data.continuation_contents;
+      const data = Parser.parseResponse(response.data);
+      const contents = data.continuation_contents;
 
-        if (!(contents instanceof LiveChatContinuation))
-          throw new InnertubeError('Continuation is not a LiveChatContinuation');
+      if (!(contents instanceof LiveChatContinuation))
+        throw new InnertubeError('Continuation is not a LiveChatContinuation');
 
-        this.#continuation = contents.continuation.token;
-        this.#lc_polling_interval_ms = contents.continuation.timeout_ms;
+      this.#continuation = contents.continuation.token;
 
-        // Header only exists in the first request
-        if (contents.header) {
-          this.initial_info = contents;
-          this.emit('start', contents);
-        } else {
-          await this.#emitSmoothedActions(contents.actions);
-        }
+      // Header only exists in the first request
+      if (contents.header) {
+        this.initial_info = contents;
+        this.emit('start', contents);
+      } else {
+        await this.#emitSmoothedActions(contents.actions);
+      }
 
-        clearTimeout(lc_poller);
+      // If there are no actions then we wait 1000 milliseconds, otherwise
+      // The amount of items on the action queue will determine the polling interval.
+      if (!contents.actions.length && !contents.header)
+        await this.#wait(1000);
 
-        this.running && this.#pollLivechat();
-      })().catch((err) => Promise.reject(err));
-    }, this.#lc_polling_interval_ms);
+      if (this.running)
+        this.#pollLivechat();
+    })();
   }
 
   /**
    * Ensures actions are emitted at the right speed.
-   * This was adapted from YouTube's compiled code (Android).
+   * This was adapted from YouTube's compiled code (Android & Web).
    */
-  async #emitSmoothedActions(actions: ObservedArray<YTNode>) {
+  async #emitSmoothedActions(action_queue: YTNode[]) {
     const base = 1E4;
 
-    let delay = actions.length < base / 80 ? 1 : 0;
+    let delay = action_queue.length < base / 80 ? 1 : Math.ceil(action_queue.length / (base / 80));
 
     const emit_delay_ms =
       delay == 1 ? (
-        delay = base / actions.length,
+        delay = base / action_queue.length,
         delay *= Math.random() + 0.5,
         delay = Math.min(1E3, delay),
         delay = Math.max(80, delay)
       ) : delay = 80;
 
-    for (const action of actions) {
+    for (const action of action_queue) {
       await this.#wait(emit_delay_ms);
       this.emit('chat-update', action);
     }
   }
 
   #pollMetadata() {
-    const md_poller = setTimeout(() => {
-      (async () => {
-        const payload = {
-          video_id: this.#video_info.basic_info.id,
-          ctoken: undefined as string | undefined
-        };
+    (async () => {
+      const payload: {
+        videoId: string | undefined;
+        continuation?: string;
+      } = { videoId: this.#video_info.basic_info.id };
 
-        if (this.#mcontinuation) {
-          payload.ctoken = this.#mcontinuation;
-        }
+      if (this.#mcontinuation) {
+        payload.continuation = this.#mcontinuation;
+      }
 
-        const response = await this.#actions.livechat('updated_metadata', payload);
-        const data = Parser.parseResponse(response.data);
+      const response = await this.#actions.execute('/updated_metadata', payload);
+      const data = Parser.parseResponse(response.data);
 
-        this.#mcontinuation = data.continuation?.token;
-        this.#md_polling_interval_ms = data.continuation?.timeout_ms || this.#md_polling_interval_ms;
+      this.#mcontinuation = data.continuation?.token;
 
-        this.metadata = {
-          title: data.actions?.array().firstOfType(UpdateTitleAction) || this.metadata?.title,
-          description: data.actions?.array().firstOfType(UpdateDescriptionAction) || this.metadata?.description,
-          views: data.actions?.array().firstOfType(UpdateViewershipAction) || this.metadata?.views,
-          likes: data.actions?.array().firstOfType(UpdateToggleButtonTextAction) || this.metadata?.likes,
-          date: data.actions?.array().firstOfType(UpdateDateTextAction) || this.metadata?.date
-        };
+      this.metadata = {
+        title: data.actions?.array().firstOfType(UpdateTitleAction) || this.metadata?.title,
+        description: data.actions?.array().firstOfType(UpdateDescriptionAction) || this.metadata?.description,
+        views: data.actions?.array().firstOfType(UpdateViewershipAction) || this.metadata?.views,
+        likes: data.actions?.array().firstOfType(UpdateToggleButtonTextAction) || this.metadata?.likes,
+        date: data.actions?.array().firstOfType(UpdateDateTextAction) || this.metadata?.date
+      };
 
-        this.emit('metadata-update', this.metadata);
+      this.emit('metadata-update', this.metadata);
 
-        clearTimeout(md_poller);
+      await this.#wait(5000);
 
-        this.running && this.#pollMetadata();
-      })().catch((err) => Promise.reject(err));
-    }, this.#md_polling_interval_ms);
+      if (this.running)
+        this.#pollMetadata();
+    })();
   }
 
   /**
    * Sends a message.
    */
   async sendMessage(text: string): Promise<ObservedArray<AddChatItemAction>> {
-    const response = await this.#actions.livechat('live_chat/send_message', {
-      text,
-      ...{
-        video_id: this.#video_info.basic_info.id,
-        channel_id: this.#video_info.basic_info.channel_id
-      }
+    const response = await this.#actions.execute('/live_chat/send_message', {
+      params: Proto.encodeMessageParams(this.#video_info.basic_info.channel_id as string, this.#video_info.basic_info.id as string),
+      richMessage: { textSegments: [ { text } ] },
+      clientMessageId: uuidv4(),
+      parse: true
     });
 
-    const data = Parser.parseResponse(response.data);
-
-    if (!data.actions)
+    if (!response.actions)
       throw new InnertubeError('Response did not have an "actions" property. The call may have failed.');
 
-    return data.actions.array().as(AddChatItemAction);
+    return response.actions.array().as(AddChatItemAction);
+  }
+
+  /**
+   * Retrieves given chat item's menu.
+   */
+  async getItemMenu(item: ChatItemWithMenu): Promise<ItemMenu> {
+    if (!item.menu_endpoint)
+      throw new InnertubeError('This item does not have a menu.', item);
+
+    const response = await item.menu_endpoint.call(this.#actions, { parse: true });
+
+    if (!response)
+      throw new InnertubeError('Could not retrieve item menu.', item);
+
+    return new ItemMenu(response, this.#actions);
+  }
+
+  /**
+   * Equivalent to "clicking" a button.
+   */
+  async selectButton(button: Button): Promise<ParsedResponse> {
+    const response = await button.endpoint.call(this.#actions, { parse: true });
+    return response;
   }
 
   async #wait(ms: number) {

src/parser/youtube/NotificationsMenu.ts

@@ -1,5 +1,5 @@
 import Parser from '..';
-import Actions, { AxioslikeResponse } from '../../core/Actions';
+import Actions, { ApiResponse } from '../../core/Actions';
 import { InnertubeError } from '../../utils/Utils';
 
 import Notification from '../classes/Notification';
@@ -13,7 +13,7 @@ class NotificationsMenu {
   header;
   contents;
 
-  constructor(actions: Actions, response: AxioslikeResponse) {
+  constructor(actions: Actions, response: ApiResponse) {
     this.#actions = actions;
     this.#page = Parser.parseResponse(response.data);
 
@@ -27,7 +27,7 @@ class NotificationsMenu {
     if (!continuation)
       throw new InnertubeError('Continuation not found');
 
-    const response = await continuation.endpoint.callTest(this.#actions, { parse: false });
+    const response = await continuation.endpoint.call(this.#actions, { parse: false });
     return new NotificationsMenu(this.#actions, response);
   }
 }

src/parser/youtube/Playlist.ts

@@ -4,13 +4,14 @@ import Feed from '../../core/Feed';
 import Thumbnail from '../classes/misc/Thumbnail';
 import VideoOwner from '../classes/VideoOwner';
 
-import PlaylistSidebar from '../classes/PlaylistSidebar';
 import PlaylistMetadata from '../classes/PlaylistMetadata';
 import PlaylistSidebarPrimaryInfo from '../classes/PlaylistSidebarPrimaryInfo';
 import PlaylistSidebarSecondaryInfo from '../classes/PlaylistSidebarSecondaryInfo';
 import PlaylistVideoThumbnail from '../classes/PlaylistVideoThumbnail';
 import PlaylistHeader from '../classes/PlaylistHeader';
 
+import { InnertubeError } from '../../utils/Utils';
+
 class Playlist extends Feed {
   info;
   menu;
@@ -19,9 +20,12 @@ class Playlist extends Feed {
   constructor(actions: Actions, data: any, already_parsed = false) {
     super(actions, data, already_parsed);
 
-    const header = this.page.header.item().as(PlaylistHeader);
-    const primary_info = this.page.sidebar?.as(PlaylistSidebar).contents.array().firstOfType(PlaylistSidebarPrimaryInfo);
-    const secondary_info = this.page.sidebar?.as(PlaylistSidebar).contents.array().firstOfType(PlaylistSidebarSecondaryInfo);
+    const header = this.memo.getType(PlaylistHeader)?.[0];
+    const primary_info = this.memo.getType(PlaylistSidebarPrimaryInfo)?.[0];
+    const secondary_info = this.memo.getType(PlaylistSidebarSecondaryInfo)?.[0];
+
+    if (!primary_info && !secondary_info)
+      throw new InnertubeError('This playlist does not exist');
 
     this.info = {
       ...this.page.metadata.item().as(PlaylistMetadata),
@@ -31,14 +35,14 @@ class Playlist extends Feed {
         total_items: this.#getStat(0, primary_info),
         views: this.#getStat(1, primary_info),
         last_updated: this.#getStat(2, primary_info),
-        can_share: header.can_share,
-        can_delete: header.can_delete,
-        is_editable: header.is_editable,
-        privacy: header.privacy
+        can_share: header?.can_share,
+        can_delete: header?.can_delete,
+        is_editable: header?.is_editable,
+        privacy: header?.privacy
       }
     };
 
-    this.menu = primary_info?.menu;
+    this.menu = primary_info?.menu.item();
     this.endpoint = primary_info?.endpoint;
   }
 
@@ -50,6 +54,11 @@ class Playlist extends Feed {
   get items() {
     return this.videos;
   }
+
+  async getContinuation(): Promise<Playlist> {
+    const response = await this.getContinuationData();
+    return new Playlist(this.actions, response);
+  }
 }
 
 export default Playlist;