chore(main): release 3.0.0 (#309)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.eslintignore

@@ -5,4 +5,5 @@ cache/
 src/proto/youtube.ts
 coverage/
 node_modules/
-dist/
+dist/
+src/proto/generated/

.github/labeler_config.yml

@@ -2,13 +2,7 @@ version: 1
 labels:
   - label: "breaking-change"
     title: "^refactor!:.*"
-    
-  - label: "enhancement"
-    title: "^feat:.*"
-    
-  - label: "bug"
-    title: "^fix:.*"
- 
+
   - label: "github"
     files:
       - ".github/.*"

.github/release.yml

@@ -1,20 +0,0 @@
-changelog:
-  exclude:
-    labels:
-      - ignore-for-release
-    authors:
-      - octocat
-  categories:
-    - title: Breaking Changes
-      labels:
-        - Semver-Major
-        - breaking-change
-    - title: New Features
-      labels:
-        - Semver-Minor
-        - enhancement
-    - title: Bug Fixes
-        - bug
-    - title: Other Changes
-      labels:
-        - "*"

.github/workflows/labeler.yml

@@ -5,9 +5,7 @@ on:
 
 jobs:
   build:
-
     runs-on: ubuntu-latest
-
     steps:
     - uses: srvaroa/labeler@master
       with:

.github/workflows/lint.yml

@@ -1,17 +1,18 @@
-name: Lint
+name: lint
 
-on: [push, pull_request]
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
 
 jobs:
-  eslint:
-    name: Lint
+  lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-
-      - uses: actions/setup-node@v3
-
-      - name: npm install and lint
-        run: |
-          npm install
-          npm run lint
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+      - run: npm ci
+      - run: npm run lint

.github/workflows/node.js.yml

@@ -1,26 +0,0 @@
-name: Tests
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [ 16.x, 18.x ]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-    steps:
-    - uses: actions/checkout@v2
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v1
-      with:
-        node-version: ${{ matrix.node-version }}
-    - run: npm install
-    - run: npm run test

.github/workflows/release-please.yml

@@ -0,0 +1,62 @@
+name: release-please
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release-please:
+    permissions:
+      contents: write
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: google-github-actions/release-please-action@v3
+        id: release
+        with:
+          release-type: node
+          package-name: youtubei.js
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v1
+        with:
+          node-version: "16.x"
+      - name: Build for Deno
+        run: |
+          npm ci
+          npm run build:deno
+        if: ${{ steps.release.outputs.release_created }}
+      - name: Move Deno files
+        run: |
+          mkdir build
+          mv deno build/deno
+          cp deno.ts build/deno.ts
+          cp {LICENSE,README.md} build
+        if: ${{ steps.release.outputs.release_created }}
+      - name: Push to the Deno branch
+        uses: s0/git-publish-subdir-action@develop
+        env:
+          REPO: self
+          BRANCH: deno
+          FOLDER: ./build
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SKIP_EMPTY_COMMITS: true
+          MESSAGE: "chore: ${{ steps.release.outputs.tag_name }} release"
+          TAG: ${{ steps.release.outputs.tag_name }}-deno
+        if: ${{ steps.release.outputs.release_created }}
+      - name: Remove Deno folder
+        run: rm -rf build
+        if: ${{ steps.release.outputs.release_created }}
+      - uses: actions/setup-node@v3
+        with:
+          node-version: "16.x"
+          registry-url: "https://registry.npmjs.org"
+        if: ${{ steps.release.outputs.release_created }}
+      - name: Publish package to npmjs
+        run: |
+          npm ci
+          npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        if: ${{ steps.release.outputs.release_created }}

.github/workflows/stale.yml

@@ -11,9 +11,7 @@ jobs:
     - uses: actions/stale@v3
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
-        stale-issue-message: 'This issue has been automatically marked as stale because it has not had
-  recent activity. It will be closed if no further activity occurs. Thank you
-  for your contributions.'
+        stale-issue-message: 'This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.'
         stale-pr-message: 'This PR has been automatically marked as stale because it has not had recent activity. Remove the stale label or comment or this will be closed in 2 days'
         days-before-stale: 60
         days-before-close: 4

.github/workflows/test.yml

@@ -0,0 +1,18 @@
+name: test
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+      - run: npm ci
+      - run: npm run test

.gitignore

@@ -66,6 +66,12 @@ tmp/
 dist/
 bundle/*.js.*
 bundle/*.js
+bundle/*.cjs
+bundle/*.cjs.*
+deno/
+
+# VSCode files
+.vscode/
 
 # MacOS
 .DS_Store

CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+## [3.0.0](https://github.com/LuanRT/YouTube.js/compare/v2.9.0...v3.0.0) (2023-02-17)
+
+
+### ⚠ BREAKING CHANGES
+
+* cleanup platform support ([#306](https://github.com/LuanRT/YouTube.js/issues/306))
+
+### Features
+
+* add parser support for MultiImage community posts ([#298](https://github.com/LuanRT/YouTube.js/issues/298)) ([de61782](https://github.com/LuanRT/YouTube.js/commit/de61782f1a673cbe66ae9b410341e39b7501ba84))
+* add support for hashtag feeds ([#312](https://github.com/LuanRT/YouTube.js/issues/312)) ([bf12740](https://github.com/LuanRT/YouTube.js/commit/bf12740333a82c26fe84e7c702c2fbb8859814fc))
+* add support for YouTube Kids ([#291](https://github.com/LuanRT/YouTube.js/issues/291)) ([2bbefef](https://github.com/LuanRT/YouTube.js/commit/2bbefefbb7cb061f3e7b686158b7568c32f0da5d))
+* allow checking whether a channel has optional tabs ([#296](https://github.com/LuanRT/YouTube.js/issues/296)) ([ceefbed](https://github.com/LuanRT/YouTube.js/commit/ceefbed98c70bb936e2d2df58c02834842acfdfc))
+* **Channel:** Add getters for all optional tabs ([#303](https://github.com/LuanRT/YouTube.js/issues/303)) ([b2900f4](https://github.com/LuanRT/YouTube.js/commit/b2900f48a7aa4c22635e1819ba9f636e81964f2c))
+* **Channel:** add support for sorting the playlist tab ([#295](https://github.com/LuanRT/YouTube.js/issues/295)) ([50ef712](https://github.com/LuanRT/YouTube.js/commit/50ef71284db41e5f94bb511892651d22a1d363a0))
+* extract channel error alert ([0b99180](https://github.com/LuanRT/YouTube.js/commit/0b991800a5c67f0e702251982b52eb8531f36f19))
+* **FormatUtils:** support multiple audio tracks in the DASH manifest ([#308](https://github.com/LuanRT/YouTube.js/issues/308)) ([a69e43b](https://github.com/LuanRT/YouTube.js/commit/a69e43bf3ae02f2428c4aa86f647e3e5e0db5ba6))
+* improve support for dubbed content ([#293](https://github.com/LuanRT/YouTube.js/issues/293)) ([d6c5a9b](https://github.com/LuanRT/YouTube.js/commit/d6c5a9b971444d0cd746aaf5310d3389793680ea))
+* parse isLive in CompactVideo ([#294](https://github.com/LuanRT/YouTube.js/issues/294)) ([2acb7da](https://github.com/LuanRT/YouTube.js/commit/2acb7da0198bfeca6ff911cf95cf06a220fccaa5))
+* **parser:** add `ChannelAgeGate` node ([1cdf701](https://github.com/LuanRT/YouTube.js/commit/1cdf701c8403db6b681a26ecb1df2daa51add454))
+* **parser:** Text#toHTML ([#300](https://github.com/LuanRT/YouTube.js/issues/300)) ([e82e23d](https://github.com/LuanRT/YouTube.js/commit/e82e23dfbb24dff3ddf45754c7319d783990e254))
+* **ytkids:** add `getChannel()` ([#292](https://github.com/LuanRT/YouTube.js/issues/292)) ([0fc29f0](https://github.com/LuanRT/YouTube.js/commit/0fc29f0bbf965215146a6ae192494c74e6cefcbb))
+
+
+### Bug Fixes
+
+* assign MetadataBadge's label ([#311](https://github.com/LuanRT/YouTube.js/issues/311)) ([e37cf62](https://github.com/LuanRT/YouTube.js/commit/e37cf627322f688fcef18d41345f77cbccd58829))
+* **ChannelAboutFullMetadata:** fix error when there are no primary links ([#299](https://github.com/LuanRT/YouTube.js/issues/299)) ([f62c66d](https://github.com/LuanRT/YouTube.js/commit/f62c66db396ba7d2f93007414101112b49d8375f))
+* **TopicChannelDetails:** avatar and subtitle parsing ([#302](https://github.com/LuanRT/YouTube.js/issues/302)) ([d612590](https://github.com/LuanRT/YouTube.js/commit/d612590530f5fe590fee969810b1dd44c37f0457))
+* **VideoInfo:** Gracefully handle missing watch next continuation ([#288](https://github.com/LuanRT/YouTube.js/issues/288)) ([13ad377](https://github.com/LuanRT/YouTube.js/commit/13ad3774c9783ed2a9f286aeee88110bd43b3a73))
+
+
+### Code Refactoring
+
+* cleanup platform support ([#306](https://github.com/LuanRT/YouTube.js/issues/306)) ([2ccbe2c](https://github.com/LuanRT/YouTube.js/commit/2ccbe2ce6260ace3bfac8b4b391e583fbcc4e286))

README.md

@@ -14,11 +14,11 @@
 
 <h1 align=center>YouTube.js</h1>
 
-<p align=center>A full-featured wrapper around the InnerTube API, which is what YouTube itself uses</p>
+<p align=center>A full-featured wrapper around the InnerTube API</p>
 
 <div align="center">
 
-  [![Tests](https://github.com/LuanRT/YouTube.js/actions/workflows/node.js.yml/badge.svg)][actions]
+  [![CI](https://github.com/LuanRT/YouTube.js/actions/workflows/test.yml/badge.svg)][actions]
   [![NPM Version](https://img.shields.io/npm/v/youtubei.js?color=%2335C757)][versions]
   [![Codefactor](https://www.codefactor.io/repository/github/luanrt/youtube.js/badge)][codefactor]
   [![Downloads](https://img.shields.io/npm/dt/youtubei.js)][npm]
@@ -84,7 +84,7 @@ ___
 
 ## Description
 
-InnerTube is an API used by all YouTube clients. It was created to simplify the deployment of new features and experiments across the platform[^1]. This library handles all the low-level communication with InnerTube, providing a simple, and efficient way to interact with YouTube programmatically. It is designed to emulate an actual client as closely as possible, including how API responses are [parsed](https://github.com/LuanRT/YouTube.js/tree/main/src/parser#how-it-works).
+InnerTube is an API used by all YouTube clients. It was created to simplify the deployment of new features and experiments across the platform[^1]. This library handles all the low-level communication with InnerTube, providing a simple, and efficient way to interact with YouTube programmatically. It is designed to emulate an actual client as closely as possible, including how API responses are parsed.
 
 If you have any questions or need help, feel free to reach out to us on our [Discord server][discord] or open an issue [here](https://github.com/LuanRT/YouTube.js/issues).
 
@@ -112,7 +112,7 @@ yarn add youtubei.js@latest
 npm install github:LuanRT/YouTube.js
 ```
 
-**TODO:** Deno install instructions (esm.sh possibly?)
+**TODO:** Deno install instructions (deno.land)
 
 ## Usage
 Create an InnerTube instance:
@@ -172,7 +172,8 @@ const player = dashjs.MediaPlayer().create();
 player.initialize(videoElement, uri, true);
 ```
 
-Our browser example in [`examples/browser/web`](https://github.com/LuanRT/YouTube.js/blob/main/examples/browser/web) provides a fully working example.
+A fully working example can be found in [`examples/browser/web`](https://github.com/LuanRT/YouTube.js/blob/main/examples/browser/web). Alternatively, you can view it live at [ytjsexample.pages.dev](https://ytjsexample.pages.dev/).
+
 <a name="custom-fetch"></a>
 
 ## Providing your own fetch implementation
@@ -229,6 +230,7 @@ const yt = await Innertube.create({
   * [.playlist](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/playlist.md)
   * [.music](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/music.md)
   * [.studio](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/studio.md)
+  * [.kids](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/kids.md)
  
   </p>
   </details> 
@@ -252,6 +254,7 @@ const yt = await Innertube.create({
   * [.getNotifications()](#getnotifications)
   * [.getUnseenNotificationsCount()](#getunseennotificationscount)
   * [.getPlaylist(id)](#getplaylist)
+  * [.getHashtag(hashtag)](#gethashtag)
   * [.getStreamingData(video_id, options)](#getstreamingdata)
   * [.download(video_id, options?)](#download)
   * [.resolveURL(url)](#resolveurl)
@@ -265,7 +268,7 @@ const yt = await Innertube.create({
 
 Retrieves video info, including playback data and even layout elements such as menus, buttons, etc — all nicely parsed.
 
-**Returns**: `Promise.<VideoInfo>`
+**Returns**: `Promise<VideoInfo>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -282,7 +285,7 @@ Retrieves video info, including playback data and even layout elements such as m
 - `<info>#dislike()`
   - Dislikes the video.
 
-- `<info>#removeLike()`
+- `<info>#removeRating()`
   - Removes like/dislike.
 
 - `<info>#getLiveChat()`
@@ -291,7 +294,7 @@ Retrieves video info, including playback data and even layout elements such as m
 - `<info>#chooseFormat(options)`
   - Used to choose streaming data formats.
 
-- `<info>#toDash(url_transformer)`
+- `<info>#toDash(url_transformer?, format_filter?)`
   - Converts streaming data to an MPEG-DASH manifest.
 
 - `<info>#download(options)`
@@ -320,7 +323,7 @@ Retrieves video info, including playback data and even layout elements such as m
 
 Suitable for cases where you only need basic video metadata. Also, it is faster than [`getInfo()`](#getinfo).
 
-**Returns**: `Promise.<VideoInfo>`
+**Returns**: `Promise<VideoInfo>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -332,7 +335,10 @@ Suitable for cases where you only need basic video metadata. Also, it is faster
 
 Searches the given query on YouTube.
 
-**Returns**: `Promise.<Search>`
+**Returns**: `Promise<Search>`
+
+> **Note**
+> `Search` extends the [`Feed`](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/feed.md) class.
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -359,7 +365,7 @@ Searches the given query on YouTube.
 ### getSearchSuggestions(query)
 Retrieves search suggestions for given query.
 
-**Returns**: `Promise.<string[]>`
+**Returns**: `Promise<string[]>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -369,7 +375,7 @@ Retrieves search suggestions for given query.
 ### getComments(video_id, sort_by?)
 Retrieves comments for given video.
 
-**Returns**: `Promise.<Comments>`
+**Returns**: `Promise<Comments>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -382,7 +388,10 @@ See [`./examples/comments`](https://github.com/LuanRT/YouTube.js/blob/main/examp
 ### getHomeFeed()
 Retrieves YouTube's home feed.
 
-**Returns**: `Promise.<HomeFeed>`
+**Returns**: `Promise<HomeFeed>`
+
+> **Note**
+> `HomeFeed` extends the [`FilterableFeed`](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/filterable-feed.md) class.
 
 <details>
 <summary>Methods & Getters</summary>
@@ -413,7 +422,10 @@ Retrieves YouTube's home feed.
 ### getLibrary()
 Retrieves the account's library.
 
-**Returns**: `Promise.<Library>`
+**Returns**: `Promise<Library>`
+
+> **Note**
+> `Library` extends the [`Feed`](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/feed.md) class.
 
 <details>
 <summary>Methods & Getters</summary>
@@ -422,10 +434,8 @@ Retrieves the account's library.
 - `<library>#history`
 - `<library>#watch_later`
 - `<library>#liked_videos`
-- `<library>#playlists`
+- `<library>#playlists_section`
 - `<library>#clips`
-- `<library>#page`
-  - Returns original InnerTube response (sanitized).
 
 </p>
 </details> 
@@ -434,7 +444,10 @@ Retrieves the account's library.
 ### getHistory()
 Retrieves watch history.
 
-**Returns**: `Promise.<History>`
+**Returns**: `Promise<History>`
+
+> **Note**
+> `History` extends the [`Feed`](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/feed.md) class.
 
 <details>
 <summary>Methods & Getters</summary>
@@ -450,19 +463,22 @@ Retrieves watch history.
 ### getTrending()
 Retrieves trending content.
 
-**Returns**: `Promise.<TabbedFeed>`
+**Returns**: `Promise<TabbedFeed<IBrowseResponse>>`
 
 <a name="getsubscriptionsfeed"></a>
 ### getSubscriptionsFeed()
-Retrieves subscriptions feed.
+Retrieves the subscriptions feed.
 
-**Returns**: `Promise.<Feed>`
+**Returns**: `Promise<Feed<IBrowseResponse>>`
 
 <a name="getchannel"></a>
 ### getChannel(id)
 Retrieves contents for a given channel.
 
-**Returns**: `Promise.<Channel>`
+**Returns**: `Promise<Channel>`
+
+> **Note**
+> `Channel` extends the [`TabbedFeed`](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/tabbed-feed.md) class.
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -481,8 +497,13 @@ Retrieves contents for a given channel.
 - `<channel>#getChannels()`
 - `<channel>#getAbout()`
 - `<channel>#search(query)`
+- `<channel>#applyFilter(filter)`
+- `<channel>#applyContentTypeFilter(content_type_filter)`
+- `<channel>#applySort(sort)`
 - `<channel>#getContinuation()`
 - `<channel>#filters`
+- `<channel>#content_type_filters`
+- `<channel>#sort_filters`
 - `<channel>#page`
 
 </p>
@@ -494,7 +515,7 @@ See [`./examples/channel`](https://github.com/LuanRT/YouTube.js/blob/main/exampl
 ### getNotifications()
 Retrieves notifications.
 
-**Returns**: `Promise.<NotificationsMenu>`
+**Returns**: `Promise<NotificationsMenu>`
 
 <details>
 <summary>Methods & Getter</summary>
@@ -510,13 +531,16 @@ Retrieves notifications.
 ### getUnseenNotificationsCount()
 Retrieves unseen notifications count.
 
-**Returns**: `Promise.<number>`
+**Returns**: `Promise<number>`
 
 <a name="getplaylist"></a>
 ### getPlaylist(id)
 Retrieves playlist contents.
 
-**Returns**: `Promise.<Playlist>`
+**Returns**: `Promise<Playlist>`
+
+> **Note**
+> `Playlist` extends the [`Feed`](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/feed.md) class.
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -532,19 +556,45 @@ Retrieves playlist contents.
 </p>
 </details>
 
+<a name="gethashtag"></a>
+### getHashtag(hashtag)
+Retrieves a given hashtag's page.
+
+**Returns**: `Promise<HashtagFeed>`
+
+> **Note**
+> `HashtagFeed` extends the [`FilterableFeed`](https://github.com/LuanRT/YouTube.js/blob/main/docs/API/filterable-feed.md) class.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| hashtag | `string` | The hashtag |
+
+<details>
+<summary>Methods & Getter</summary>
+<p>
+
+- `<hashtag>#applyFilter(filter)`
+  - Applies given filter and returns a new `HashtagFeed` instance.
+- `<hashtag>#getContinuation()`
+  - Retrieves next batch of contents.
+
+</p>
+</details>
+
 <a name="getstreamingdata"></a>
 ### 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:
+> **Note**
+> This will be deprecated in the future. It is recommended to retrieve streaming data from a `VideoInfo`/`TrackInfo` object instead if you want to select formats manually, see the example below.
+
 ```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>`
+**Returns**: `Promise<object>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -555,7 +605,7 @@ console.info('Playback url:', url);
 ### download(video_id, options?)
 Downloads a given video.
 
-**Returns**: `Promise.<ReadableStream<Uint8Array>>`
+**Returns**: `Promise<ReadableStream<Uint8Array>>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -568,7 +618,7 @@ See [`./examples/download`](https://github.com/LuanRT/YouTube.js/blob/main/examp
 ### resolveURL(url)
 Resolves a given url.
 
-**Returns**: `Promise.<NavigationEndpoint>`
+**Returns**: `Promise<NavigationEndpoint>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -578,7 +628,7 @@ Resolves a given url.
 ### call(endpoint, args?)
 Utility to call navigation endpoints.
 
-**Returns**: `Promise.<ActionsResponse | ParsedResponse>`
+**Returns**: `Promise<T extends IParsedResponse | IParsedResponse | ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -629,7 +679,7 @@ import { Innertube, YTNodes } from 'youtubei.js';
 
   if (button) {
     // After making sure it exists, we can call its navigation endpoint:
-    const page = await button.endpoint.call(yt.actions);
+    const page = await button.endpoint.call(yt.actions, { parse: true });
     console.info(page);
   }
 })();
@@ -661,7 +711,7 @@ console.info('Header:', header);
  * the parser to add type safety and many utility methods
  * that make working with InnerTube much easier.
  */
-const tab = page.contents.item().as(YTNodes.SingleColumnBrowseResults).tabs.firstOfType(YTNodes.Tab);
+const tab = page.contents?.item().as(YTNodes.SingleColumnBrowseResults).tabs.firstOfType(YTNodes.Tab);
 
 
 if (!tab)
@@ -670,7 +720,7 @@ if (!tab)
 if (!tab.content)
   throw new Error('Target tab appears to be empty');
   
-const sections = tab.content?.as(YTNodes.SectionList).contents.array().as(YTNodes.MusicCarouselShelf, YTNodes.MusicDescriptionShelf, YTNodes.MusicShelf);
+const sections = tab.content?.as(YTNodes.SectionList).contents.as(YTNodes.MusicCarouselShelf, YTNodes.MusicDescriptionShelf, YTNodes.MusicShelf);
 
 console.info('Sections:', sections);
 ```

browser.ts

@@ -1,11 +0,0 @@
-// Deno and browser runtimes
-
-import Innertube from './src/Innertube';
-
-export * from './src/utils';
-export { YTNodes } from './src/parser/map';
-export { default as Parser } from './src/parser';
-export { default as Innertube } from './src/Innertube';
-export { default as Session } from './src/core/Session';
-export { default as Player } from './src/core/Player';
-export default Innertube;

bundle/browser.d.ts

@@ -1 +1 @@
-export * from '../dist/browser';
+export * from '../dist/src/platform/lib.js';

bundle/node.d.cts

@@ -0,0 +1 @@
+export * from '../dist/src/platform/lib.js';

deno.ts

@@ -0,0 +1,3 @@
+export * from './deno/src/platform/deno.ts';
+import Innertube from './deno/src/platform/deno.ts';
+export default Innertube;

docs/API/account.md

@@ -46,7 +46,7 @@ Retrieves account information.
 <p>
 
 - `<accountinfo>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details>
@@ -63,7 +63,7 @@ Retrieves time watched statistics.
 <p>
 
 - `<timewatched>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details>
@@ -91,6 +91,9 @@ Retrieves YouTube settings.
 - `<settings>#sidebar_items`
   - Returns options available in the sidebar menu.
 
+- `<settings>#page`
+  - Returns the original InnerTube response(s), parsed and sanitized.
+
 </p>
 </details>
 
@@ -106,7 +109,7 @@ Retrieves basic channel analytics.
 <p>
 
 - `<analytics>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details>

docs/API/feed.md

@@ -0,0 +1,115 @@
+# Feed
+
+Represents a YouTube feed. This class provides a set of utility methods for parsing and interacting with feeds.
+
+## API 
+
+* Feed
+  * [.videos](#videos)
+  * [.posts](#posts)
+  * [.channels](#channels)
+  * [.playlists](#playlists)
+  * [.shelves](#shelves)
+  * [.memo](#memo)
+  * [.page_contents](#page_contents)
+  * [.secondary_contents](#secondary_contents)
+  * [.page](#page)
+  * [.has_continuation](#has_continuation)
+  * [.getContinuationData()](#getcontinuationdata)
+  * [.getContinuation()](#getcontinuation)
+  * [.getShelf(title)](#getshelf)
+
+<a name="videos"></a>
+### videos
+
+Returns all videos in the feed.
+
+**Returns:** `ObservedArray<Video | GridVideo | ReelItem | CompactVideo | PlaylistVideo | PlaylistPanelVideo | WatchCardCompactVideo>`
+
+<a name="posts"></a>
+### posts
+
+Returns all posts in the feed.
+
+**Returns:** `ObservedArray<Post | BackstagePost>`
+
+<a name="channels"></a>
+### channels
+
+Returns all channels in the feed.
+
+**Returns:** `ObservedArray<Channel | GridChannel>`
+
+<a name="playlists"></a>
+### playlists
+
+Returns all playlists in the feed.
+
+**Returns:** `ObservedArray<Playlist | GridPlaylist>`
+
+<a name="shelves"></a>
+### shelves
+
+Returns all shelves in the feed.
+
+**Returns:** `ObservedArray<Shelf | RichShelf | ReelShelf>`
+
+<a name="memo"></a>
+### memo
+
+Returns the memoized feed contents.
+
+**Returns:** `Memo`
+
+<a name="page_contents"></a>
+### page_contents
+
+Returns the page contents.
+
+**Returns:** `SectionList | MusicQueue | RichGrid | ReloadContinuationItemsCommand`
+
+<a name="secondary_contents"></a>
+### secondary_contents
+
+Returns the secondary contents node.
+
+**Returns:** `SuperParsedResult<YTNode> | undefined `
+
+<a name="page"></a>
+### page
+
+Returns the original InnerTube response, parsed and sanitized.
+
+**Returns:** `T extends IParsedResponse = IParsedResponse`
+
+<a name="has_continuation"></a>
+### has_continuation
+
+Returns whether the feed has a continuation.
+
+**Returns:** `boolean`
+
+<a name="getcontinuationdata"></a>
+### getContinuationData()
+
+Returns the continuation data.
+
+**Returns:** `Promise<T | undefined>`
+
+<a name="getcontinuation"></a>
+### getContinuation()
+
+Retrieves the feed's continuation.
+
+**Returns:** `Promise<Feed<T>>`
+
+<a name="getshelf"></a>
+### getShelf(title)
+
+Gets a shelf by its title.
+
+**Returns:** `Shelf | RichShelf | ReelShelf | undefined`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| title | `string` | The title of the shelf to get |

docs/API/filterable-feed.md

@@ -0,0 +1,38 @@
+# FilterableFeed
+
+Represents a feed that can be filtered. 
+
+> **Note** 
+> This class extends the [Feed](feed.md) class.
+
+## API
+
+* FilterableFeed
+  * [.filter_chips](#filter_chips)
+  * [.filters](#filters)
+  * [.getFilteredFeed(filter: string | ChipCloudChip)](#getfilteredfeed)
+
+<a name="filter_chips"></a>
+### filter_chips
+
+Returns the feed's filter chips.
+
+**Returns:** `ObservedArray<ChipCloudChip>`
+
+<a name="filters"></a>
+### filters
+
+Returns the feed's filter chips as an array of strings.
+
+**Returns:** `string[]`
+
+<a name="getfilteredfeed"></a>
+### getFilteredFeed(filter: string | ChipCloudChip)
+
+Returns a new [Feed](feed.md) with the given filter applied.
+
+**Returns:** `Promise<Feed<T>>`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| filter | `string` \| `ChipCloudChip` | The filter to apply |

docs/API/interaction-manager.md

@@ -19,7 +19,7 @@ Handles direct interactions.
 
 Likes given video.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -30,7 +30,7 @@ Likes given video.
 
 Dislikes given video.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -41,7 +41,7 @@ Dislikes given video.
 
 Remover like/dislike.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -52,7 +52,7 @@ Remover like/dislike.
 
 Subscribes to given channel.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -63,7 +63,7 @@ Subscribes to given channel.
 
 Unsubscribes from given channel.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -74,7 +74,7 @@ Unsubscribes from given channel.
 
 Posts a comment on given video.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -86,7 +86,7 @@ Posts a comment on given video.
 
 Translates given text using YouTube's comment translation feature.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -100,7 +100,7 @@ Translates given text using YouTube's comment translation feature.
 Changes notification preferences for a given channel.
 Only works with channels you are subscribed to.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |

docs/API/kids.md

@@ -0,0 +1,113 @@
+# YouTube Kids
+
+YouTube Kids is a modified version of the YouTube app, with a simplified interface and curated content. This class allows you to interact with its API.
+
+## API
+  
+* Kids
+  * [.search(query)](#search)
+  * [.getInfo(video_id)](#getinfo)
+  * [.getChannel(channel_id)](#getchannel)
+  * [.getHomeFeed()](#gethomefeed)
+
+<a name="search"></a>
+### search(query)
+
+Searches the given query on YouTube Kids.
+
+**Returns:** `Promise.<Search>`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| query | `string` | The query to search |
+
+
+<details>
+<summary>Methods & Getters</summary>
+<p>
+
+- `<search>#page`
+  - Returns the original InnerTube response(s), parsed and sanitized.
+
+</p>
+</details> 
+
+<a name="getinfo"></a>
+### getInfo(video_id)
+
+Retrieves video info.
+
+**Returns:** `Promise.<VideoInfo>`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| video_id | `string` | The video id |
+
+<details>
+<summary>Methods & Getters</summary>
+<p>
+
+- `<info>#toDash(url_transformer?, format_filter?)`
+  - Generates a DASH manifest from the streaming data.
+
+- `<info>#chooseFormat(options)`
+  - Selects the format that best matches the given options. This method is used internally by `#download`.
+
+- `<info>#download(options?)`
+  - Downloads the video.
+
+- `<info>#addToWatchHistory()`
+  - Adds the video to the watch history.
+
+- `<info>#page`
+  - Returns the original InnerTube response(s), parsed and sanitized.
+
+</p>
+</details> 
+
+<a name="getchannel"></a>
+### getChannel(channel_id)
+
+Retrieves channel info.
+
+**Returns:** `Promise.<Channel>`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| channel_id | `string` | The channel id |
+
+<details>
+<summary>Methods & Getters</summary>
+<p>
+
+- `<channel>#getContinuation()`
+  - Retrieves next batch of videos.
+
+- `<channel>#has_continuation`
+  - Returns whether there are more videos to retrieve.
+
+- `<channel>#page`
+  - Returns the original InnerTube response(s), parsed and sanitized.
+
+</p>
+</details>
+
+<a name="gethomefeed"></a>
+### getHomeFeed()
+
+Retrieves the home feed.
+
+**Returns:** `Promise.<HomeFeed>`
+
+<details>
+<summary>Methods & Getters</summary>
+<p>
+
+- `<feed>#selectCategoryTab(tab: string | KidsCategoryTab)`
+  - Selects the given category tab.
+
+- `<feed>#categories`
+  - Returns available categories.
+
+- `<feed>#page`
+  - Returns the original InnerTube response(s), parsed and sanitized.

docs/API/music.md

@@ -1,6 +1,6 @@
-# Music
+# YouTube Music
 
-YouTube Music class.
+YouTube Music is a music streaming service developed by YouTube, a subsidiary of Google. It provides a tailored interface for the service oriented towards music streaming, with a greater emphasis on browsing and discovery compared to its main service. This class allows you to interact with its API.
 
 ## API
 
@@ -49,6 +49,21 @@ Retrieves track info.
 - `<info>#available_tabs`
   - Returns available tabs.
 
+- `<info>#toDash(url_transformer?, format_filter?)`
+  - Generates a DASH manifest from the streaming data.
+
+- `<info>#chooseFormat(options)`
+  - Selects the format that best matches the given options. This method is used internally by `#download`.
+
+- `<info>#download(options?)`
+  - Downloads the track.
+
+- `<info>#addToWatchHistory()`
+  - Adds the song to the watch history.
+
+- `<info>#page`
+  - Returns the original InnerTube response(s), parsed and sanitized.
+
 </p>
 </details> 
 
@@ -99,7 +114,7 @@ Searches on YouTube Music.
   - Returns songs shelf.
 
 - `<search>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details> 
@@ -124,6 +139,9 @@ Retrieves home feed.
 - `<homefeed>#page`
   - Returns original InnerTube response (sanitized).
 
+- `<homefeed>#page`
+  - Returns the original InnerTube response(s), parsed and sanitized.
+
 </p>
 </details> 
 
@@ -139,7 +157,7 @@ Retrieves “Explore” feed.
 <p>
 
 - `<explore>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details> 
@@ -174,7 +192,7 @@ Retrieves library.
   - Returns available sort options.
 
 - `<library>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details> 
@@ -195,7 +213,7 @@ Retrieves artist's info & content.
 <p>
 
 - `<artist>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details> 
@@ -216,7 +234,7 @@ Retrieves given album.
 <p>
 
 - `<album>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details> 
@@ -249,7 +267,7 @@ Retrieves given playlist.
   - Checks if continuation is available.
 
 - `<playlist>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details> 
@@ -303,7 +321,7 @@ Retrieves your YouTube Music recap.
   - Retrieves recap playlist.
 
 - `<recap>#page`
-  - Returns original InnerTube response (sanitized).
+  - Returns the original InnerTube response(s), parsed and sanitized.
 
 </p>
 </details> 

docs/API/playlist.md

@@ -16,7 +16,7 @@ Playlist management class.
 
 Creates a playlist.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -28,7 +28,7 @@ Creates a playlist.
 
 Deletes given playlist.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |

docs/API/studio.md

@@ -14,7 +14,7 @@ YouTube Studio class (WIP).
 
 Uploads a custom thumbnail and sets it for a video.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -26,7 +26,7 @@ Uploads a custom thumbnail and sets it for a video.
 
 Updates given video's metadata.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -38,7 +38,7 @@ Updates given video's metadata.
 
 Uploads a video to YouTube.
 
-**Returns:** `Promise.<ActionsResponse>`
+**Returns:** `Promise.<ApiResponse>`
 
 | Param | Type | Description |
 | --- | --- | --- |

docs/API/tabbed-feed.md

@@ -0,0 +1,62 @@
+# TabbedFeed
+
+Represents a feed with tabs. 
+
+> **Note**
+> This class extends the [Feed](feed.md) class.
+
+## API
+
+* TabbedFeed
+  * [.tabs](#tabs)
+  * [.getTabByName(title: string)](#gettabbyname)
+  * [.getTabByURL(url: string)](#gettabbyurl)
+  * [.hasTabWithURL(url: string)](#hastabwithurl)
+  * [.title](#title)
+
+<a name="tabs"></a>
+### tabs
+
+Returns the feed's tabs as an array of strings.
+
+**Returns:** `string[]`
+
+<a name="gettabbyname"></a>
+### getTabByName(title: string)
+
+Fetches a tab by its title.
+
+**Returns:** `Promise<TabbedFeed<T>>`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| title | `string` | The title of the tab to get |
+
+<a name="gettabbyurl"></a>
+### getTabByURL(url: string)
+
+Fetches a tab by its URL.
+
+**Returns:** `Promise<TabbedFeed<T>>`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| url | `string` | The URL of the tab to get |
+
+<a name="hastabwithurl"></a>
+### hasTabWithURL(url: string)
+
+Returns whether the feed has a tab with the given URL.
+
+**Returns:** `boolean`
+
+| Param | Type | Description |
+| --- | --- | --- |
+| url | `string` | The URL to check |
+
+<a name="title"></a>
+### title
+
+Returns the currently selected tab's title.
+
+**Returns:** `string | undefined`

examples/browser/README.md

@@ -2,7 +2,7 @@
 
 YouTube.js works in the browser!
 
-## How to use
+## Usage
 
 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`.
 
@@ -54,8 +54,10 @@ const yt = await Innertube.create({
 });
 ```
 
-after that you can use the library as normal.
+After that, you can use the library as normal.
 
 ## Example
 
 We've got a full example in `examples/browser/web` using vite.
+
+If you don't want to run the example yourself, you can see it in action here: [ytjsexample.pages.dev](https://ytjsexample.pages.dev/).

examples/browser/web/index.html

@@ -1,20 +1,30 @@
 <!DOCTYPE html>
 <html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Vite + TS</title>
-  </head>
-  <body>
-    <form>
-      <input type="text" name="id" placeholder="Video ID" />
-      <input type="submit" value="Play" />
-    </form>
-    <span id="video_name">
-      Library is loading...
-    </span>
-    <video></video>
-    <script type="module" src="/src/main.ts"></script>
-  </body>
-</html>
+
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>YouTube.js Example</title>
+</head>
+
+<body>
+  <form>
+    <input type="text" name="id" placeholder="Video ID or URL" />
+    <input type="submit" value="Play" />
+  </form>
+  <div id="loader"></div>
+  <div id="video_container">
+    <video id="video"></video>
+    <h2 id="title"></h2>
+    <div id="metadata"></div>
+    <hr />
+    <div id="description"></div>
+  </div>
+  <footer>
+    <p>Powered by <a href="https://github.com/LuanRT/YouTube.js">YouTube.js</a></p>
+  </footer>
+  <script type="module" src="/src/main.ts"></script>
+</body>
+
+</html>

examples/browser/web/src/main.ts

@@ -2,15 +2,24 @@ import './style.css';
 import { Innertube, UniversalCache } from '../../../../bundle/browser';
 import dashjs from 'dashjs';
 
+const description = document.getElementById('description') as HTMLDivElement;
+const form = document.querySelector('form') as HTMLFormElement;
+const title = document.getElementById('title') as HTMLHeadingElement;
+const metadata = document.getElementById('metadata') as HTMLDivElement;
+const loader = document.getElementById('loader') as HTMLDivElement;
+const video = document.getElementById('video') as HTMLVideoElement;
+const video_container = document.getElementById('video_container') as HTMLDivElement;
+
 async function main() {
   const yt = await Innertube.create({
+    generate_session_locally: true,
     fetch: async (input: RequestInfo | URL, init?: RequestInit) => {
       // url
       const url = typeof input === 'string'
         ? new URL(input)
         : input instanceof URL
-        ? input
-        : new URL(input.url);
+          ? input
+          : new URL(input.url);
 
       // transform the url for use with our proxy
       url.searchParams.set('__host', url.host);
@@ -20,12 +29,15 @@ async function main() {
       const headers = init?.headers
         ? new Headers(init.headers)
         : input instanceof Request
-        ? input.headers
-        : new Headers();
+          ? input.headers
+          : new Headers();
 
       // now serialize the headers
       url.searchParams.set('__headers', JSON.stringify([...headers]));
 
+      // @ts-ignore
+      input.duplex = 'half';
+
       // copy over the request
       const request = new Request(
         url,
@@ -42,58 +54,105 @@ async function main() {
         headers
       });
     },
-    cache: new UniversalCache(),
+    cache: new UniversalCache(false),
   });
 
-  const span = document.getElementById('video_name') as HTMLSpanElement;
-  const form = document.querySelector('form') as HTMLFormElement;
+  form.animate({ opacity: [0, 1] }, { duration: 300, easing: 'ease-in-out' });
+  form.style.display = 'block';
 
-  span.textContent = 'Library ready';
+  showUI(false);
 
   let player: dashjs.MediaPlayerClass | undefined;
 
   form.addEventListener('submit', async (e) => {
     e.preventDefault();
 
-    span.textContent = 'Loading...';
+    if (player) {
+      player.reset();
+    }
 
-    const video_id = document.querySelector<HTMLInputElement>(
-      'input[type=text]',
-    )?.value;
-    if (!video_id) {
-      span.textContent = 'No video id';
+    hideUI();
+
+    let video_id;
+
+    const video_id_or_url = document.querySelector<HTMLInputElement>('input[type=text]')?.value;
+
+    if (!video_id_or_url) {
+      title.textContent = 'No video id or URL provided';
+      showUI(false);
       return;
     }
+
     try {
-      const video = await yt.getInfo(video_id);
+      if (video_id_or_url.match(/(http|https):\/\/([\w_-]+(?:(?:\.[\w_-]+)+))([\w.,@?^=%&:\/~+#-]*[\w@?^=%&\/~+#-])/)) {
+        const endpoint = await yt.resolveURL(video_id_or_url);
 
-      console.log(video);
-      span.textContent = video.basic_info.title || null;
+        if (!endpoint.payload.videoId) {
+          title.textContent = 'Could not resolve URL';
+          showUI(false);
+          return;
+        }
 
-      const dash = video.toDash((url) => {
+        video_id = endpoint.payload.videoId;
+      } else {
+        video_id = video_id_or_url;
+      }
+
+      const info = await yt.getInfo(video_id);
+
+      title.textContent = info.basic_info.title || null;
+      description.innerHTML = info.secondary_info?.description.toHTML() || '';
+      title.textContent = info.basic_info.title || null;
+
+      document.title = info.basic_info.title || '';
+
+      metadata!.innerHTML = '';
+      metadata!.innerHTML += `<div class="metadata_item">${info.primary_info?.published.toHTML()}</div>`;
+      metadata!.innerHTML += `<div class="metadata_item">${info.primary_info?.view_count.toHTML()}</div>`;
+      metadata!.innerHTML += `<div class="metadata_item">${info.basic_info.like_count} likes</div>`;
+
+      showUI(true);
+
+      const dash = info.toDash((url) => {
         url.searchParams.set('__host', url.host);
         url.host = 'localhost:8080';
         url.protocol = 'http';
         return url;
       });
 
-      const uri = 'data:application/dash+xml;charset=utf-8;base64,' +
-        btoa(dash);
+      const uri = 'data:application/dash+xml;charset=utf-8;base64,' + btoa(dash);
 
       // create and append video element
       const video_element = document.querySelector('video') as HTMLVideoElement;
       video_element.setAttribute('controls', 'true');
+      video_element.poster = info.basic_info.thumbnail![0].url;
+
       // use dash.js to parse the manifest
       if (player) {
         player.destroy();
       }
+
       player = dashjs.MediaPlayer().create();
       player.initialize(video_element, uri, true);
+      player.setInitialMediaSettingsFor('audio', { lang: 'en-US' });
     } catch (error) {
-      span.textContent = 'An error occurred (see console)';
+      title.textContent = 'An error occurred (see console)';
+      showUI(false);
       console.error(error);
     }
   });
 }
 
-main();
+function showUI(with_video = true) {
+  loader.style.display = 'none';
+  video.style.display = with_video ? 'block' : 'none';
+  video_container.animate({ opacity: [0, 1] }, { duration: 300, easing: 'ease-in-out' });
+  video_container.style.display = 'block';
+}
+
+function hideUI() {
+  video_container.style.display = 'none';
+  loader.style.display = 'block';
+}
+
+main();

examples/browser/web/src/style.css

@@ -3,10 +3,88 @@ body {
   flex-direction: column;
   align-items: center;
   font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+  background-color: rgb(32, 32, 32);
+  color: rgb(255, 255, 255);
+}
+
+hr {
+  height: 1px;
+  width: 100%;
+  border: 1px solid transparent;
+  background-color: rgb(68, 68, 68);
+}
+
+form {
+  margin: 0.5rem 0;
+  display: none;
+}
+
+#loader {
+  display: block;
+  border: 10px solid rgb(68, 68, 68);
+  border-top: 10px solid rgb(255, 255, 255);
+  border-radius: 50%;
+  width: 50px;
+  height: 50px;
+  align-self: center;
+  animation: spin 1s linear infinite;
+  margin: 0.5rem 0;
+}
+
+@keyframes spin {
+  0% {
+    transform: rotate(0deg);
+  }
+
+  100% {
+    transform: rotate(360deg);
+  }
+}
+
+#video_container {
+  display: none;
+  flex-direction: column;
+  position: relative;
+  width: 70vw !important;
+  margin: 0.5rem 0;
+}
+
+#metadata {
+  display: flex;
+  flex-direction: row;
+  align-self: left;
+  margin: 0.5rem 0;
+}
+
+#metadata > .metadata_item {
+  margin: 0 0.3rem;
+  background-color: beige;
+  color: black;
+  font: 1em bold;
+  padding: 0.2rem 0.5rem;
+  border-radius: 0.3rem;
+}
+
+#video_container > #description {
+  align-self: left;
+  margin-left: 0.5rem;
+  font-size: medium;
 }
 
 video {
-  max-width: calc(100vw - 1rem);
-  width: fit-content;
-  max-height: calc(90vh - 12rem);
+  width: 100%;
+  height: 40vw;
+}
+
+footer {
+  margin: 0.5rem 0;
+}
+
+@media screen and (max-width: 768px) {
+  video {
+    height: auto;
+  }
+  #video_container {
+    width: 100% !important;
+  }
 }

examples/channel/basic-info.ts

@@ -1,7 +1,7 @@
 import { Innertube, UniversalCache, YTNodes } from 'youtubei.js';
 
 (async () => {
-  const yt = await Innertube.create({ cache: new UniversalCache() });
+  const yt = await Innertube.create({ cache: new UniversalCache(), generate_session_locally: true });
 
   const channel = await yt.getChannel('UCX6OQ3DkcsbYNE6H8uQQuVA');
 

examples/comments/index.ts

@@ -1,7 +1,7 @@
 import { Innertube, UniversalCache } from 'youtubei.js';
 
 (async () => {
-  const yt = await Innertube.create({ cache: new UniversalCache() });
+  const yt = await Innertube.create({ cache: new UniversalCache(), generate_session_locally: true });
 
   const comment_section = await yt.getComments('a-rqu-hjobc');
 

examples/download/index.ts

@@ -3,7 +3,7 @@ import { readFileSync, existsSync, mkdirSync, createWriteStream } from 'fs';
 import { streamToIterable } from 'youtubei.js/dist/src/utils/Utils';
 
 (async () => {
-  const yt = await Innertube.create({ cache: new UniversalCache() });
+  const yt = await Innertube.create({ cache: new UniversalCache(), generate_session_locally: true });
 
   const search = await yt.music.search('No Copyright Background Music', { type: 'album' });
 
@@ -19,7 +19,7 @@ import { streamToIterable } from 'youtubei.js/dist/src/utils/Utils';
 
   for (const song of album.contents) {
     const stream = await yt.download(song.id as string, {
-      type: 'audio', // audio, video or audio+video
+      type: 'audio', // audio, video or video+audio
       quality: 'best', // best, bestefficiency, 144p, 240p, 480p, 720p and so on.
       format: 'mp4' // media container format 
     });

examples/parser/index.ts

@@ -13,7 +13,7 @@ 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(YTNodes.SingleColumnBrowseResults).tabs.firstOfType(YTNodes.Tab);
+const tab = page.contents?.item().as(YTNodes.SingleColumnBrowseResults).tabs.firstOfType(YTNodes.Tab);
 
 if (!tab)
   throw new Error('Target tab not found');
@@ -21,6 +21,6 @@ if (!tab)
 if (!tab.content)
   throw new Error('Target tab appears to be empty');
 
-const sections = tab.content?.as(YTNodes.SectionList).contents.array().as(YTNodes.MusicCarouselShelf, YTNodes.MusicDescriptionShelf, YTNodes.MusicShelf);
+const sections = tab.content?.as(YTNodes.SectionList).contents.as(YTNodes.MusicCarouselShelf, YTNodes.MusicDescriptionShelf, YTNodes.MusicShelf);
 
 console.info('Sections:', sections);

examples/upload/index.ts

@@ -31,5 +31,5 @@ const creds = existsSync(creds_path) ? JSON.parse(readFileSync(creds_path).toStr
     privacy: 'UNLISTED'
   });
 
-  console.info('Done!');
+  console.info('Done!', upload);
 })();

index.ts

@@ -1,28 +0,0 @@
-import { getRuntime } from './src/utils/Utils';
-
-// Polyfill fetch for node
-if (getRuntime() === 'node') {
-  // eslint-disable-next-line
-  const undici = require('undici');
-  Reflect.set(globalThis, 'fetch', undici.fetch);
-  Reflect.set(globalThis, 'Headers', undici.Headers);
-  Reflect.set(globalThis, 'Request', undici.Request);
-  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';
-
-export * from './src/utils';
-export { YTNodes } from './src/parser/map';
-export { default as Parser } from './src/parser';
-export { default as Innertube } from './src/Innertube';
-export { default as Session } from './src/core/Session';
-export { default as Player } from './src/core/Player';
-export default Innertube;

jest.config.js

@@ -1,6 +1,6 @@
 
 
-module.exports = {
+export default {
   projects: [
     {
       displayName: 'node',

package.json

@@ -1,10 +1,53 @@
 {
   "name": "youtubei.js",
-  "version": "2.9.0",
-  "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",
+  "version": "3.0.0",
+  "description": "A wrapper around YouTube's private API. Supports YouTube, YouTube Music, YouTube Kids and YouTube Studio (WIP).",
+  "type": "module",
+  "types": "./dist/src/platform/lib.d.ts",
+  "typesVersions": {
+    "*": {
+      "agnostic": [
+        "./dist/src/platform/lib.d.ts"
+      ],
+      "web": [
+        "./dist/src/platform/lib.d.ts"
+      ],
+      "web.bundle": [
+        "./dist/src/platform/lib.d.ts"
+      ],
+      "web.bundle.min": [
+        "./dist/src/platform/lib.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./dist/src/platform/node.js",
+        "require": "./bundle/node.cjs"
+      },
+      "deno": "./dist/src/platform/deno.js",
+      "types": "./dist/src/platform/lib.d.ts",
+      "browser": "./dist/src/platform/web.js",
+      "default": "./dist/src/platform/web.js"
+    },
+    "./agnostic": {
+      "types": "./dist/src/platform/lib.d.ts",
+      "default": "./dist/src/platform/lib.js"
+    },
+    "./web": {
+      "types": "./dist/src/platform/lib.d.ts",
+      "default": "./dist/src/platform/web.js"
+    },
+    "./web.bundle": {
+      "types": "./dist/src/platform/lib.d.ts",
+      "default": "./bundle/browser.js"
+    },
+    "./web.bundle.min": {
+      "types": "./dist/src/platform/lib.d.ts",
+      "default": "./bundle/browser.min.js"
+    }
+  },
   "author": "LuanRT <luan.lrt4@gmail.com> (https://github.com/LuanRT)",
   "funding": [
     "https://github.com/sponsors/LuanRT"
@@ -24,12 +67,14 @@
     "test": "npx jest --verbose",
     "lint": "npx eslint ./src",
     "lint:fix": "npx eslint --fix ./src",
-    "build": "npm run build:parser-map && npm run build:proto && npm run bundle:browser && npm run bundle:browser:prod && npm run build:node",
-    "build:node": "npx tsc",
-    "bundle:browser": "npx tsc --module esnext && npx esbuild ./dist/browser.js --banner:js=\"/* eslint-disable */\" --bundle --target=chrome58 --keep-names --format=esm --sourcemap --define:global=globalThis --outfile=./bundle/browser.js --platform=browser",
+    "build": "npm run build:parser-map && npm run build:proto && npm run build:esm && npm run bundle:node && npm run bundle:browser && npm run bundle:browser:prod",
+    "build:parser-map": "node ./scripts/build-parser-map.cjs",
+    "build:proto": "npx pb-gen-ts --entry-path=\"src/proto\" --out-dir=\"src/proto/generated\" --ext-in-import=\".js\"",
+    "build:esm": "npx tsc",
+    "build:deno": "npx cpy ./src ./deno && npx cpy ./package.json ./deno && npx replace \".js';\" \".ts';\" ./deno -r && npx replace '.js\";' '.ts\";' ./deno -r && npx replace \"'linkedom';\" \"'https://esm.sh/linkedom';\" ./deno -r && npx replace \"'jintr';\" \"'https://esm.sh/jintr';\" ./deno -r && npx replace \"new Jinter.default\" \"new Jinter\" ./deno -r",
+    "bundle:node": "npx esbuild ./dist/src/platform/node.js --bundle --target=node10 --keep-names --format=cjs --platform=node --outfile=./bundle/node.cjs --external:jintr --external:undici --external:linkedom --sourcemap --banner:js=\"/* eslint-disable */\"",
+    "bundle:browser": "npx esbuild ./dist/src/platform/web.js --banner:js=\"/* eslint-disable */\" --bundle --target=chrome58 --keep-names --format=esm --sourcemap --define:global=globalThis --outfile=./bundle/browser.js --platform=browser",
     "bundle:browser:prod": "npm run bundle:browser -- --outfile=./bundle/browser.min.js --minify",
-    "build:parser-map": "node ./scripts/build-parser-map.js",
-    "build:proto": "npx protoc --ts_out ./src/proto --proto_path ./src/proto ./src/proto/youtube.proto",
     "prepare": "npm run build",
     "watch": "npx tsc --watch"
   },
@@ -39,24 +84,25 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@protobuf-ts/runtime": "^2.7.0",
-    "jintr": "^0.3.1",
+    "jintr": "^0.4.1",
     "linkedom": "^0.14.12",
-    "undici": "^5.7.0"
+    "undici": "^5.19.1"
   },
   "devDependencies": {
-    "@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",
+    "cpy-cli": "^4.2.0",
     "esbuild": "^0.14.49",
     "eslint": "^8.19.0",
     "eslint-plugin-tsdoc": "^0.2.16",
     "glob": "^8.0.3",
     "jest": "^28.1.3",
+    "pbkit": "^0.0.59",
+    "replace": "^1.2.2",
     "ts-jest": "^28.0.8",
-    "typescript": "^4.7.4"
+    "typescript": "^4.9.5"
   },
   "bugs": {
     "url": "https://github.com/LuanRT/YouTube.js/issues"
@@ -72,7 +118,6 @@
     "youtube-downloader",
     "youtube-music",
     "youtube-studio",
-    "innertubeapi",
     "innertube",
     "unofficial",
     "downloader",
@@ -81,7 +126,6 @@
     "upload",
     "ytmusic",
     "search",
-    "comment",
     "music",
     "api"
   ]

scripts/build-parser-map.cjs

@@ -5,22 +5,30 @@ const path = require('path');
 const import_list = [];
 
 const json = [];
+const misc_exports = [];
 
 glob.sync('../src/parser/classes/**/*.{js,ts}', { cwd: __dirname })
   .forEach((file) => {
-    if (file.includes('/misc/')) return;
     // Trim path
+    const is_misc = file.includes('/misc/');
     file = file.replace('../src/parser/classes/', '').replace('.js', '').replace('.ts', '');
     const import_name = file.split('/').pop();
-    import_list.push(`import { default as ${import_name} } from './classes/${file}';`);
-    json.push(import_name);
+
+    if (is_misc) {
+      const class_name = file.split('/').pop().replace('.js', '').replace('.ts', '');
+      import_list.push(`import { default as ${class_name} } from './classes/${file}.js';`);
+      misc_exports.push(class_name);
+    } else {
+      import_list.push(`import { default as ${import_name} } from './classes/${file}.js';`);
+      json.push(import_name);
+    }
   });
 
 fs.writeFileSync(
   path.resolve(__dirname, '../src/parser/map.ts'),
   `// This file was auto generated, do not edit.
 // See ./scripts/build-parser-map.js
-import { YTNodeConstructor } from './helpers';
+import { YTNodeConstructor } from './helpers.js';
 
 ${import_list.join('\n')}
 
@@ -28,6 +36,10 @@ export const YTNodes = {
   ${json.join(',\n  ')}
 };
 
+export const Misc = {
+  ${misc_exports.join(',\n  ')}
+};
+
 const map: Record<string, YTNodeConstructor> = YTNodes;
 
 /**

scripts/get-agents.js

@@ -0,0 +1,52 @@
+import { fetch } from 'undici';
+import { gunzip } from 'zlib';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { writeFile } from 'fs/promises';
+
+(async () => {
+
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+
+  const buf = await (await fetch('https://github.com/intoli/user-agents/blob/master/src/user-agents.json.gz?raw=true')).arrayBuffer();
+  const bytes = new Uint8Array(buf);
+
+  // Only get desktop and mobile agents
+  const allowed_agents = new Set([
+    'desktop',
+    'mobile'
+  ]);
+
+  const decompressed = await new Promise((resolve, reject) => {
+    gunzip(bytes, (err, result) => {
+      if (err) {
+        reject(err);
+      } else {
+        resolve(result.buffer);
+      }
+    });
+  });
+
+  const contents = new TextDecoder().decode(decompressed);
+
+  const agents = JSON.parse(contents);
+
+  if (!Array.isArray(agents)) {
+    throw new Error('Invalid user-agents.json');
+  }
+
+  const agentsByDevice = agents.reduce((acc, agent) => {
+    const device = agent.deviceCategory;
+    if (!allowed_agents.has(device))
+      return acc;
+    if (!acc[device]) {
+      acc[device] = [];
+    }
+    // We dont want to massive of a list of agents for each device
+    if (acc[device].length <= 25) acc[device].push(agent.userAgent);
+    return acc;
+  }, {});
+
+  await writeFile(resolve(__dirname, '..', 'src', 'utils', 'user-agents.ts'), `/* eslint-disable */\n/* Generated file do not edit */\nexport default ${JSON.stringify(agentsByDevice, null, 2)} as { desktop: string[], mobile: string[] };`);
+
+})();

scripts/get-agents.mjs

@@ -1,52 +0,0 @@
-import { fetch } from "undici";
-import { gunzip } from "zlib";
-import { dirname, resolve } from 'path';
-import { fileURLToPath } from 'url';
-import { writeFile } from "fs/promises";
-
-(async () => {
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-const buf = await (await fetch('https://github.com/intoli/user-agents/blob/master/src/user-agents.json.gz?raw=true')).arrayBuffer();
-const bytes = new Uint8Array(buf);
-
-// Only get desktop and mobile agents
-const allowed_agents = new Set([
-    'desktop',
-    'mobile',
-])
-
-const decompressed = await new Promise((resolve, reject) => {
-    gunzip(bytes, (err, result) => {
-        if (err) {
-            reject(err);
-        } else {
-            resolve(result.buffer);
-        }
-    });
-});
-
-const contents = new TextDecoder().decode(decompressed);
-
-const agents = JSON.parse(contents);
-
-if (!Array.isArray(agents)) {
-    throw new Error('Invalid user-agents.json');
-}
-
-const agentsByDevice = agents.reduce((acc, agent) => {
-    const device = agent.deviceCategory;
-    if (!allowed_agents.has(device)) 
-        return acc;
-    if (!acc[device]) {
-        acc[device] = [];
-    }
-    // we dont want to massive of a list of agents for each device
-    if (acc[device].length <= 25) acc[device].push(agent.userAgent);
-    return acc;
-}, {});
-
-await writeFile(resolve(__dirname, '..', 'src', 'utils', 'user-agents.json'), JSON.stringify(agentsByDevice, null, 2));
-
-})();

src/Innertube.ts

@@ -1,33 +1,36 @@
 
-import Session, { SessionOptions } from './core/Session';
-import type { ParsedResponse } from './parser';
-import type { ActionsResponse } from './core/Actions';
+import Session, { SessionOptions } from './core/Session.js';
 
-import NavigationEndpoint from './parser/classes/NavigationEndpoint';
-import Channel from './parser/youtube/Channel';
-import Comments from './parser/youtube/Comments';
-import History from './parser/youtube/History';
-import Library from './parser/youtube/Library';
-import NotificationsMenu from './parser/youtube/NotificationsMenu';
-import Playlist from './parser/youtube/Playlist';
-import Search from './parser/youtube/Search';
-import VideoInfo, { DownloadOptions, FormatOptions } from './parser/youtube/VideoInfo';
+import NavigationEndpoint from './parser/classes/NavigationEndpoint.js';
+import Channel from './parser/youtube/Channel.js';
+import Comments from './parser/youtube/Comments.js';
+import History from './parser/youtube/History.js';
+import Library from './parser/youtube/Library.js';
+import NotificationsMenu from './parser/youtube/NotificationsMenu.js';
+import Playlist from './parser/youtube/Playlist.js';
+import Search from './parser/youtube/Search.js';
+import VideoInfo from './parser/youtube/VideoInfo.js';
+import HashtagFeed from './parser/youtube/HashtagFeed.js';
 
-import AccountManager from './core/AccountManager';
-import Feed from './core/Feed';
-import InteractionManager from './core/InteractionManager';
-import YTMusic from './core/Music';
-import PlaylistManager from './core/PlaylistManager';
-import Studio from './core/Studio';
-import TabbedFeed from './core/TabbedFeed';
-import HomeFeed from './parser/youtube/HomeFeed';
-import Proto from './proto/index';
-import Constants from './utils/Constants';
+import AccountManager from './core/AccountManager.js';
+import Feed from './core/Feed.js';
+import InteractionManager from './core/InteractionManager.js';
+import YTKids from './core/Kids.js';
+import YTMusic from './core/Music.js';
+import PlaylistManager from './core/PlaylistManager.js';
+import YTStudio from './core/Studio.js';
+import TabbedFeed from './core/TabbedFeed.js';
+import HomeFeed from './parser/youtube/HomeFeed.js';
+import Proto from './proto/index.js';
+import Constants from './utils/Constants.js';
 
-import type Actions from './core/Actions';
-import type Format from './parser/classes/misc/Format';
+import type Actions from './core/Actions.js';
+import type Format from './parser/classes/misc/Format.js';
 
-import { generateRandomString, throwIfMissing } from './utils/Utils';
+import type { ApiResponse } from './core/Actions.js';
+import type { IBrowseResponse, IParsedResponse } from './parser/types/index.js';
+import type { DownloadOptions, FormatOptions } from './utils/FormatUtils.js';
+import { generateRandomString, throwIfMissing } from './utils/Utils.js';
 
 export type InnertubeConfig = SessionOptions;
 
@@ -39,7 +42,7 @@ export interface SearchFilters {
   features?: ('hd' | 'subtitles' | 'creative_commons' | '3d' | 'live' | 'purchased' | '4k' | '360' | 'location' | 'hdr' | 'vr180')[];
 }
 
-export type InnerTubeClient = 'WEB' | 'ANDROID' | 'YTMUSIC_ANDROID' | 'YTMUSIC' | 'YTSTUDIO_ANDROID' | 'TV_EMBEDDED';
+export type InnerTubeClient = 'WEB' | 'ANDROID' | 'YTMUSIC_ANDROID' | 'YTMUSIC' | 'YTSTUDIO_ANDROID' | 'TV_EMBEDDED' | 'YTKIDS'
 
 class Innertube {
   session: Session;
@@ -47,7 +50,8 @@ class Innertube {
   playlist: PlaylistManager;
   interact: InteractionManager;
   music: YTMusic;
-  studio: Studio;
+  studio: YTStudio;
+  kids: YTKids;
   actions: Actions;
 
   constructor(session: Session) {
@@ -56,7 +60,8 @@ class Innertube {
     this.playlist = new PlaylistManager(this.session.actions);
     this.interact = new InteractionManager(this.session.actions);
     this.music = new YTMusic(this.session);
-    this.studio = new Studio(this.session);
+    this.studio = new YTStudio(this.session);
+    this.kids = new YTKids(this.session);
     this.actions = this.session.actions;
   }
 
@@ -112,7 +117,7 @@ class Innertube {
 
     const response = await this.actions.execute('/search', args);
 
-    return new Search(this.actions, response.data);
+    return new Search(this.actions, response);
   }
 
   /**
@@ -162,7 +167,7 @@ class Innertube {
    */
   async getHomeFeed(): Promise<HomeFeed> {
     const response = await this.actions.execute('/browse', { browseId: 'FEwhat_to_watch' });
-    return new HomeFeed(this.actions, response.data);
+    return new HomeFeed(this.actions, response);
   }
 
   /**
@@ -170,7 +175,7 @@ class Innertube {
    */
   async getLibrary(): Promise<Library> {
     const response = await this.actions.execute('/browse', { browseId: 'FElibrary' });
-    return new Library(response.data, this.actions);
+    return new Library(this.actions, response);
   }
 
   /**
@@ -179,23 +184,23 @@ class Innertube {
    */
   async getHistory(): Promise<History> {
     const response = await this.actions.execute('/browse', { browseId: 'FEhistory' });
-    return new History(this.actions, response.data);
+    return new History(this.actions, response);
   }
 
   /**
    * Retrieves trending content.
    */
-  async getTrending(): Promise<TabbedFeed> {
-    const response = await this.actions.execute('/browse', { browseId: 'FEtrending' });
-    return new TabbedFeed(this.actions, response.data);
+  async getTrending(): Promise<TabbedFeed<IBrowseResponse>> {
+    const response = await this.actions.execute('/browse', { browseId: 'FEtrending', parse: true });
+    return new TabbedFeed(this.actions, response);
   }
 
   /**
    * Retrieves subscriptions feed.
    */
-  async getSubscriptionsFeed(): Promise<Feed> {
-    const response = await this.actions.execute('/browse', { browseId: 'FEsubscriptions' });
-    return new Feed(this.actions, response.data);
+  async getSubscriptionsFeed(): Promise<Feed<IBrowseResponse>> {
+    const response = await this.actions.execute('/browse', { browseId: 'FEsubscriptions', parse: true });
+    return new Feed(this.actions, response);
   }
 
   /**
@@ -205,7 +210,7 @@ class Innertube {
   async getChannel(id: string): Promise<Channel> {
     throwIfMissing({ id });
     const response = await this.actions.execute('/browse', { browseId: id });
-    return new Channel(this.actions, response.data);
+    return new Channel(this.actions, response);
   }
 
   /**
@@ -237,7 +242,21 @@ class Innertube {
     }
 
     const response = await this.actions.execute('/browse', { browseId: id });
-    return new Playlist(this.actions, response.data);
+
+    return new Playlist(this.actions, response);
+  }
+
+  /**
+   * Retrieves a given hashtag's page.
+   * @param hashtag - The hashtag to fetch.
+   */
+  async getHashtag(hashtag: string): Promise<HashtagFeed> {
+    throwIfMissing({ hashtag });
+
+    const params = Proto.encodeHashtag(hashtag);
+    const response = await this.actions.execute('/browse', { browseId: 'FEhashtag', params });
+
+    return new HashtagFeed(this.actions, response);
   }
 
   /**
@@ -270,7 +289,7 @@ class Innertube {
    */
   async resolveURL(url: string): Promise<NavigationEndpoint> {
     const response = await this.actions.execute('/navigation/resolve_url', { url, parse: true });
-    return response.endpoint as NavigationEndpoint;
+    return response.endpoint;
   }
 
   /**
@@ -278,9 +297,9 @@ class Innertube {
    * @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> {
+  call<T extends IParsedResponse>(endpoint: NavigationEndpoint, args: { [key: string]: any; parse: true }): Promise<T>;
+  call(endpoint: NavigationEndpoint, args?: { [key: string]: any; parse?: false }): Promise<ApiResponse>;
+  call(endpoint: NavigationEndpoint, args?: object): Promise<IParsedResponse | ApiResponse> {
     return endpoint.call(this.actions, args);
   }
 }

src/core/AccountManager.ts

@@ -1,20 +1,20 @@
-import Proto from '../proto/index';
-import type Actions from './Actions';
-import type { ActionsResponse } from './Actions';
+import Proto from '../proto/index.js';
+import type Actions from './Actions.js';
+import type { ApiResponse } from './Actions.js';
 
-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 Analytics from '../parser/youtube/Analytics.js';
+import TimeWatched from '../parser/youtube/TimeWatched.js';
+import AccountInfo from '../parser/youtube/AccountInfo.js';
+import Settings from '../parser/youtube/Settings.js';
 
-import { InnertubeError } from '../utils/Utils';
+import { InnertubeError } from '../utils/Utils.js';
 
 class AccountManager {
   #actions: Actions;
 
   channel: {
-    editName: (new_name: string) => Promise<ActionsResponse>;
-    editDescription: (new_description: string) => Promise<ActionsResponse>;
+    editName: (new_name: string) => Promise<ApiResponse>;
+    editDescription: (new_description: string) => Promise<ApiResponse>;
     getBasicAnalytics: () => Promise<Analytics>;
   };
 

src/core/Actions.ts

@@ -1,14 +1,32 @@
-import Parser, { ParsedResponse } from '../parser/index';
-import { InnertubeError } from '../utils/Utils';
-import type Session from './Session';
+import Parser, { NavigateAction } from '../parser/index.js';
+import { InnertubeError } from '../utils/Utils.js';
+
+import type Session from './Session.js';
+
+import type {
+  IBrowseResponse, IGetNotificationsMenuResponse,
+  INextResponse, IPlayerResponse, IResolveURLResponse,
+  ISearchResponse, IUpdatedMetadataResponse,
+  IParsedResponse, IRawResponse
+} from '../parser/types/index.js';
 
 export interface ApiResponse {
   success: boolean;
   status_code: number;
-  data: any;
+  data: IRawResponse;
 }
 
-export type ActionsResponse = Promise<ApiResponse>;
+export type InnertubeEndpoint = '/player' | '/search' | '/browse' | '/next' | '/updated_metadata' | '/notification/get_notification_menu' | string;
+
+export type ParsedResponse<T> =
+  T extends '/player' ? IPlayerResponse :
+  T extends '/search' ? ISearchResponse :
+  T extends '/browse' ? IBrowseResponse :
+  T extends '/next' ? INextResponse :
+  T extends '/updated_metadata' ? IUpdatedMetadataResponse :
+  T extends '/navigation/resolve_url' ? IResolveURLResponse :
+  T extends '/notification/get_notification_menu' ? IGetNotificationsMenuResponse :
+  IParsedResponse;
 
 class Actions {
   #session: Session;
@@ -40,7 +58,7 @@ class Actions {
    * @param client - The client to use.
    * @param playlist_id - The playlist ID.
    */
-  async getVideoInfo(id: string, cpn?: string, client?: string, playlist_id?: string): Promise<ActionsResponse> {
+  async getVideoInfo(id: string, cpn?: string, client?: string, playlist_id?: string): Promise<ApiResponse> {
     const data: Record<string, any> = {
       playbackContext: {
         contentPlaybackContext: {
@@ -48,7 +66,7 @@ class Actions {
           splay: false,
           referer: 'https://www.youtube.com',
           currentUrl: `/watch?v=${id}`,
-          autonavState: 'STATE_OFF',
+          autonavState: 'STATE_NONE',
           signatureTimestamp: this.#session.player?.sts || 0,
           autoCaptionsDefaultOn: false,
           html5Preference: 'HTML5_PREF_WANTS',
@@ -109,12 +127,12 @@ class Actions {
 
   /**
    * Executes an API call.
-   * @param action - The endpoint to call.
+   * @param endpoint - 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<T extends InnertubeEndpoint>(endpoint: T, args: { [key: string]: any; parse: true; protobuf?: false; serialized_data?: any }): Promise<ParsedResponse<T>>;
+  async execute<T extends InnertubeEndpoint>(endpoint: T, args?: { [key: string]: any; parse?: false; protobuf?: true; serialized_data?: any }): Promise<ApiResponse>;
+  async execute<T extends InnertubeEndpoint>(endpoint: T, args?: { [key: string]: any; parse?: boolean; protobuf?: boolean; serialized_data?: any }): Promise<ParsedResponse<T> | ApiResponse> {
     let data;
 
     if (args && !args.protobuf) {
@@ -162,9 +180,9 @@ class Actions {
       data = args.serialized_data;
     }
 
-    const endpoint = Reflect.has(args || {}, 'override_endpoint') ? args?.override_endpoint : action;
+    const target_endpoint = Reflect.has(args || {}, 'override_endpoint') ? args?.override_endpoint : endpoint;
 
-    const response = await this.#session.http.fetch(endpoint, {
+    const response = await this.#session.http.fetch(target_endpoint, {
       method: 'POST',
       body: args?.protobuf ? data : JSON.stringify((data || {})),
       headers: {
@@ -175,12 +193,26 @@ class Actions {
     });
 
     if (args?.parse) {
-      return Parser.parseResponse(await response.json());
+      let parsed_response = Parser.parseResponse<ParsedResponse<T>>(await response.json());
+
+      // Handle redirects
+      if (this.#isBrowse(parsed_response) && parsed_response.on_response_received_actions?.first()?.type === 'navigateAction') {
+        const navigate_action = parsed_response.on_response_received_actions.firstOfType(NavigateAction);
+        if (navigate_action) {
+          parsed_response = await navigate_action.endpoint.call(this, { parse: true });
+        }
+      }
+
+      return parsed_response;
     }
 
     return this.#wrap(response);
   }
 
+  #isBrowse(response: IParsedResponse): response is IBrowseResponse {
+    return 'on_response_received_actions' in response;
+  }
+
   #needsLogin(id: string) {
     return [
       'FElibrary',

src/core/Feed.ts

@@ -1,56 +1,60 @@
-import type { Memo, ObservedArray, SuperParsedResult, YTNode } from '../parser/helpers';
-import Parser, { ParsedResponse, ReloadContinuationItemsCommand } from '../parser/index';
-import { concatMemos, InnertubeError } from '../utils/Utils';
-import type Actions from './Actions';
+import type { Memo, ObservedArray, SuperParsedResult, YTNode } from '../parser/helpers.js';
+import Parser, { ReloadContinuationItemsCommand } from '../parser/index.js';
+import { concatMemos, InnertubeError } from '../utils/Utils.js';
+import type Actions from './Actions.js';
 
-import BackstagePost from '../parser/classes/BackstagePost';
-import Channel from '../parser/classes/Channel';
-import CompactVideo from '../parser/classes/CompactVideo';
-import GridChannel from '../parser/classes/GridChannel';
-import GridPlaylist from '../parser/classes/GridPlaylist';
-import GridVideo from '../parser/classes/GridVideo';
-import Playlist from '../parser/classes/Playlist';
-import PlaylistPanelVideo from '../parser/classes/PlaylistPanelVideo';
-import PlaylistVideo from '../parser/classes/PlaylistVideo';
-import Post from '../parser/classes/Post';
-import ReelItem from '../parser/classes/ReelItem';
-import ReelShelf from '../parser/classes/ReelShelf';
-import RichShelf from '../parser/classes/RichShelf';
-import Shelf from '../parser/classes/Shelf';
-import Tab from '../parser/classes/Tab';
-import Video from '../parser/classes/Video';
+import BackstagePost from '../parser/classes/BackstagePost.js';
+import Channel from '../parser/classes/Channel.js';
+import CompactVideo from '../parser/classes/CompactVideo.js';
+import GridChannel from '../parser/classes/GridChannel.js';
+import GridPlaylist from '../parser/classes/GridPlaylist.js';
+import GridVideo from '../parser/classes/GridVideo.js';
+import Playlist from '../parser/classes/Playlist.js';
+import PlaylistPanelVideo from '../parser/classes/PlaylistPanelVideo.js';
+import PlaylistVideo from '../parser/classes/PlaylistVideo.js';
+import Post from '../parser/classes/Post.js';
+import ReelItem from '../parser/classes/ReelItem.js';
+import ReelShelf from '../parser/classes/ReelShelf.js';
+import RichShelf from '../parser/classes/RichShelf.js';
+import Shelf from '../parser/classes/Shelf.js';
+import Tab from '../parser/classes/Tab.js';
+import Video from '../parser/classes/Video.js';
 
-import AppendContinuationItemsAction from '../parser/classes/actions/AppendContinuationItemsAction';
-import ContinuationItem from '../parser/classes/ContinuationItem';
-import TwoColumnBrowseResults from '../parser/classes/TwoColumnBrowseResults';
-import TwoColumnSearchResults from '../parser/classes/TwoColumnSearchResults';
-import WatchCardCompactVideo from '../parser/classes/WatchCardCompactVideo';
+import AppendContinuationItemsAction from '../parser/classes/actions/AppendContinuationItemsAction.js';
+import ContinuationItem from '../parser/classes/ContinuationItem.js';
+import TwoColumnBrowseResults from '../parser/classes/TwoColumnBrowseResults.js';
+import TwoColumnSearchResults from '../parser/classes/TwoColumnSearchResults.js';
+import WatchCardCompactVideo from '../parser/classes/WatchCardCompactVideo.js';
 
-import type MusicQueue from '../parser/classes/MusicQueue';
-import type RichGrid from '../parser/classes/RichGrid';
-import type SectionList from '../parser/classes/SectionList';
+import type MusicQueue from '../parser/classes/MusicQueue.js';
+import type RichGrid from '../parser/classes/RichGrid.js';
+import type SectionList from '../parser/classes/SectionList.js';
 
-class Feed {
-  #page: ParsedResponse;
+import type { IParsedResponse } from '../parser/types/index.js';
+import type { ApiResponse } from './Actions.js';
+
+class Feed<T extends IParsedResponse = IParsedResponse> {
+  #page: T;
   #continuation?: ObservedArray<ContinuationItem>;
   #actions: Actions;
   #memo: Memo;
 
-  constructor(actions: Actions, data: any, already_parsed = false) {
-    if (data.on_response_received_actions || data.on_response_received_endpoints || already_parsed) {
-      this.#page = data;
+  constructor(actions: Actions, response: ApiResponse | IParsedResponse, already_parsed = false) {
+    if (this.#isParsed(response) || already_parsed) {
+      this.#page = response as T;
     } else {
-      this.#page = Parser.parseResponse(data);
+      this.#page = Parser.parseResponse<T>(response.data);
     }
 
-    const memo = concatMemos(
+    const memo = concatMemos(...[
       this.#page.contents_memo,
+      this.#page.continuation_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');
@@ -59,6 +63,10 @@ class Feed {
     this.#actions = actions;
   }
 
+  #isParsed(response: IParsedResponse | ApiResponse): response is IParsedResponse {
+    return !('data' in response);
+  }
+
   /**
    * Get all videos on a given page via memo
    */
@@ -117,9 +125,9 @@ class Feed {
    * Returns contents from the page.
    */
   get page_contents(): SectionList | MusicQueue | RichGrid | ReloadContinuationItemsCommand {
-    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];
+    const tab_content = this.#memo.getType(Tab)?.first().content;
+    const reload_continuation_items = this.#memo.getType(ReloadContinuationItemsCommand).first();
+    const append_continuation_items = this.#memo.getType(AppendContinuationItemsAction).first();
 
     return tab_content || reload_continuation_items || append_continuation_items;
   }
@@ -142,10 +150,10 @@ class Feed {
    * Returns secondary contents from the page.
    */
   get secondary_contents(): SuperParsedResult<YTNode> | undefined {
-    if (!this.#page.contents.is_node)
+    if (!this.#page.contents?.is_node)
       return undefined;
 
-    const node = this.#page.contents.item();
+    const node = this.#page.contents?.item();
 
     if (!node.is(TwoColumnBrowseResults, TwoColumnSearchResults))
       return undefined;
@@ -160,7 +168,7 @@ class Feed {
   /**
    * Get the original page data
    */
-  get page(): ParsedResponse {
+  get page(): T {
     return this.#page;
   }
 
@@ -174,14 +182,14 @@ class Feed {
   /**
    * Retrieves continuation data as it is.
    */
-  async getContinuationData(): Promise<ParsedResponse | undefined> {
+  async getContinuationData(): Promise<T | undefined> {
     if (this.#continuation) {
       if (this.#continuation.length > 1)
         throw new InnertubeError('There are too many continuations, you\'ll need to find the correct one yourself in this.page');
       if (this.#continuation.length === 0)
         throw new InnertubeError('There are no continuations');
 
-      const response = await this.#continuation[0].endpoint.call(this.#actions, { parse: true });
+      const response = await this.#continuation[0].endpoint.call<T>(this.#actions, { parse: true });
 
       return response;
     }
@@ -195,9 +203,11 @@ class Feed {
   /**
    * Retrieves next batch of contents and returns a new {@link Feed} object.
    */
-  async getContinuation(): Promise<Feed> {
+  async getContinuation(): Promise<Feed<T>> {
     const continuation_data = await this.getContinuationData();
-    return new Feed(this.actions, continuation_data, true);
+    if (!continuation_data)
+      throw new InnertubeError('Could not get continuation data');
+    return new Feed<T>(this.actions, continuation_data, true);
   }
 }
 

src/core/FilterableFeed.ts

@@ -1,15 +1,17 @@
-import ChipCloudChip from '../parser/classes/ChipCloudChip';
-import FeedFilterChipBar from '../parser/classes/FeedFilterChipBar';
-import Feed from './Feed';
+import ChipCloudChip from '../parser/classes/ChipCloudChip.js';
+import FeedFilterChipBar from '../parser/classes/FeedFilterChipBar.js';
+import { InnertubeError } from '../utils/Utils.js';
+import Feed from './Feed.js';
 
-import type { ObservedArray } from '../parser/helpers';
-import { InnertubeError } from '../utils/Utils';
-import type Actions from './Actions';
+import type { ObservedArray } from '../parser/helpers.js';
+import type { IParsedResponse } from '../parser/types/ParsedResponse.js';
+import type Actions from './Actions.js';
+import type { ApiResponse } from './Actions.js';
 
-class FilterableFeed extends Feed {
+class FilterableFeed<T extends IParsedResponse> extends Feed<T> {
   #chips?: ObservedArray<ChipCloudChip>;
 
-  constructor(actions: Actions, data: any, already_parsed = false) {
+  constructor(actions: Actions, data: ApiResponse | T, already_parsed = false) {
     super(actions, data, already_parsed);
   }
 
@@ -41,7 +43,7 @@ class FilterableFeed extends Feed {
   /**
    * Applies given filter and returns a new {@link Feed} object.
    */
-  async getFilteredFeed(filter: string | ChipCloudChip): Promise<Feed> {
+  async getFilteredFeed(filter: string | ChipCloudChip): Promise<Feed<T>> {
     let target_filter: ChipCloudChip | undefined;
 
     if (typeof filter === 'string') {
@@ -62,6 +64,9 @@ class FilterableFeed extends Feed {
 
     const response = await target_filter.endpoint?.call(this.actions, { parse: true });
 
+    if (!response)
+      throw new InnertubeError('Failed to get filtered feed');
+
     return new Feed(this.actions, response, true);
   }
 }

src/core/InteractionManager.ts

@@ -1,7 +1,7 @@
-import Proto from '../proto';
-import type Actions from './Actions';
-import type { ApiResponse } from './Actions';
-import { throwIfMissing } from '../utils/Utils';
+import Proto from '../proto/index.js';
+import type Actions from './Actions.js';
+import type { ApiResponse } from './Actions.js';
+import { throwIfMissing } from '../utils/Utils.js';
 
 class InteractionManager {
   #actions: Actions;

src/core/Kids.ts

@@ -0,0 +1,68 @@
+import Search from '../parser/ytkids/Search.js';
+import HomeFeed from '../parser/ytkids/HomeFeed.js';
+import VideoInfo from '../parser/ytkids/VideoInfo.js';
+import Channel from '../parser/ytkids/Channel.js';
+import type Session from './Session.js';
+
+import { generateRandomString } from '../utils/Utils.js';
+
+class Kids {
+  #session: Session;
+
+  constructor(session: Session) {
+    this.#session = session;
+  }
+
+  /**
+   * Searches the given query.
+   * @param query - The query.
+   */
+  async search(query: string): Promise<Search> {
+    const response = await this.#session.actions.execute('/search', { query, client: 'YTKIDS' });
+    return new Search(this.#session.actions, response);
+  }
+
+  /**
+   * Retrieves video info.
+   * @param video_id - The video id.
+   */
+  async getInfo(video_id: string): Promise<VideoInfo> {
+    const cpn = generateRandomString(16);
+
+    const initial_info = this.#session.actions.execute('/player', {
+      cpn,
+      client: 'YTKIDS',
+      videoId: video_id,
+      playbackContext: {
+        contentPlaybackContext: {
+          signatureTimestamp: this.#session.player?.sts || 0
+        }
+      }
+    });
+
+    const continuation = this.#session.actions.execute('/next', { videoId: video_id, client: 'YTKIDS' });
+
+    const response = await Promise.all([ initial_info, continuation ]);
+
+    return new VideoInfo(response, this.#session.actions, cpn);
+  }
+
+  /**
+   * Retrieves the contents of the given channel.
+  * @param channel_id - The channel id.
+   */
+  async getChannel(channel_id: string): Promise<Channel> {
+    const response = await this.#session.actions.execute('/browse', { browseId: channel_id, client: 'YTKIDS' });
+    return new Channel(this.#session.actions, response);
+  }
+
+  /**
+   * Retrieves the home feed.
+   */
+  async getHomeFeed(): Promise<HomeFeed> {
+    const response = await this.#session.actions.execute('/browse', { browseId: 'FEkids_home', client: 'YTKIDS' });
+    return new HomeFeed(this.#session.actions, response);
+  }
+}
+
+export default Kids;

src/core/Music.ts

@@ -1,32 +1,32 @@
 
-import Album from '../parser/ytmusic/Album';
-import Artist from '../parser/ytmusic/Artist';
-import Explore from '../parser/ytmusic/Explore';
-import HomeFeed from '../parser/ytmusic/HomeFeed';
-import Library from '../parser/ytmusic/Library';
-import Playlist from '../parser/ytmusic/Playlist';
-import Recap from '../parser/ytmusic/Recap';
-import Search from '../parser/ytmusic/Search';
-import TrackInfo from '../parser/ytmusic/TrackInfo';
+import Album from '../parser/ytmusic/Album.js';
+import Artist from '../parser/ytmusic/Artist.js';
+import Explore from '../parser/ytmusic/Explore.js';
+import HomeFeed from '../parser/ytmusic/HomeFeed.js';
+import Library from '../parser/ytmusic/Library.js';
+import Playlist from '../parser/ytmusic/Playlist.js';
+import Recap from '../parser/ytmusic/Recap.js';
+import Search from '../parser/ytmusic/Search.js';
+import TrackInfo from '../parser/ytmusic/TrackInfo.js';
 
-import AutomixPreviewVideo from '../parser/classes/AutomixPreviewVideo';
-import Message from '../parser/classes/Message';
-import MusicCarouselShelf from '../parser/classes/MusicCarouselShelf';
-import MusicDescriptionShelf from '../parser/classes/MusicDescriptionShelf';
-import MusicQueue from '../parser/classes/MusicQueue';
-import MusicTwoRowItem from '../parser/classes/MusicTwoRowItem';
-import PlaylistPanel from '../parser/classes/PlaylistPanel';
-import SearchSuggestionsSection from '../parser/classes/SearchSuggestionsSection';
-import SectionList from '../parser/classes/SectionList';
-import Tab from '../parser/classes/Tab';
+import AutomixPreviewVideo from '../parser/classes/AutomixPreviewVideo.js';
+import Message from '../parser/classes/Message.js';
+import MusicCarouselShelf from '../parser/classes/MusicCarouselShelf.js';
+import MusicDescriptionShelf from '../parser/classes/MusicDescriptionShelf.js';
+import MusicQueue from '../parser/classes/MusicQueue.js';
+import MusicTwoRowItem from '../parser/classes/MusicTwoRowItem.js';
+import PlaylistPanel from '../parser/classes/PlaylistPanel.js';
+import SearchSuggestionsSection from '../parser/classes/SearchSuggestionsSection.js';
+import SectionList from '../parser/classes/SectionList.js';
+import Tab from '../parser/classes/Tab.js';
 
-import { observe } from '../parser/helpers';
-import Proto from '../proto';
-import { generateRandomString, InnertubeError, throwIfMissing } from '../utils/Utils';
+import { observe } from '../parser/helpers.js';
+import Proto from '../proto/index.js';
+import { generateRandomString, InnertubeError, throwIfMissing } from '../utils/Utils.js';
 
-import type { ObservedArray, YTNode } from '../parser/helpers';
-import type Actions from './Actions';
-import type Session from './Session';
+import type { ObservedArray, YTNode } from '../parser/helpers.js';
+import type Actions from './Actions.js';
+import type Session from './Session.js';
 
 class Music {
   #session: Session;
@@ -125,7 +125,7 @@ class Music {
 
     const response = await this.#actions.execute('/search', payload);
 
-    return new Search(response, this.#actions, { is_filtered: Reflect.has(filters, 'type') && filters.type !== 'all' });
+    return new Search(response, this.#actions, Reflect.has(filters, 'type') && filters.type !== 'all');
   }
 
   /**
@@ -198,7 +198,7 @@ class Music {
       browseId: album_id
     });
 
-    return new Album(response, this.#actions);
+    return new Album(response);
   }
 
   /**
@@ -234,9 +234,9 @@ class Music {
       parse: true
     });
 
-    const tabs = data.contents_memo.getType(Tab);
+    const tabs = data.contents_memo?.getType(Tab);
 
-    const tab = tabs?.[0];
+    const tab = tabs?.first();
 
     if (!tab)
       throw new InnertubeError('Could not find target tab.');
@@ -260,10 +260,10 @@ class Music {
         parse: true
       });
 
-      if (!page)
+      if (!page || !page.contents_memo)
         throw new InnertubeError('Could not fetch automix');
 
-      return page.contents_memo.getType(PlaylistPanel)?.[0];
+      return page.contents_memo.getType(PlaylistPanel).first();
     }
 
     return playlist_panel;
@@ -282,7 +282,7 @@ class Music {
       parse: true
     });
 
-    const tabs = data.contents_memo.getType(Tab);
+    const tabs = data.contents_memo?.getType(Tab);
 
     const tab = tabs?.matchCondition((tab) => tab.endpoint.payload.browseEndpointContextSupportedConfigs?.browseEndpointContextMusicConfig?.pageType === 'MUSIC_PAGE_TYPE_TRACK_RELATED');
 
@@ -291,6 +291,9 @@ class Music {
 
     const page = await tab.endpoint.call(this.#actions, { client: 'YTMUSIC', parse: true });
 
+    if (!page.contents)
+      throw new InnertubeError('Unexpected response', page);
+
     const shelves = page.contents.item().as(SectionList).contents.as(MusicCarouselShelf, MusicDescriptionShelf);
 
     return shelves;
@@ -309,7 +312,7 @@ class Music {
       parse: true
     });
 
-    const tabs = data.contents_memo.getType(Tab);
+    const tabs = data.contents_memo?.getType(Tab);
 
     const tab = tabs?.matchCondition((tab) => tab.endpoint.payload.browseEndpointContextSupportedConfigs?.browseEndpointContextMusicConfig?.pageType === 'MUSIC_PAGE_TYPE_TRACK_LYRICS');
 
@@ -318,10 +321,14 @@ class Music {
 
     const page = await tab.endpoint.call(this.#actions, { client: 'YTMUSIC', parse: true });
 
+    if (!page.contents)
+      throw new InnertubeError('Unexpected response', page);
+
     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;
+
     return section_list.firstOfType(MusicDescriptionShelf);
   }
 
@@ -348,7 +355,7 @@ class Music {
       client: 'YTMUSIC'
     });
 
-    const search_suggestions_section = response.contents_memo.getType(SearchSuggestionsSection)?.[0];
+    const search_suggestions_section = response.contents_memo?.getType(SearchSuggestionsSection)?.[0];
 
     if (!search_suggestions_section?.contents.is_array)
       return observe([] as YTNode[]);

src/core/OAuth.ts

@@ -1,6 +1,6 @@
-import Constants from '../utils/Constants';
-import { OAuthError, uuidv4 } from '../utils/Utils';
-import type Session from './Session';
+import Constants from '../utils/Constants.js';
+import { OAuthError, Platform } from '../utils/Utils.js';
+import type Session from './Session.js';
 
 export interface Credentials {
   /**
@@ -95,7 +95,7 @@ class OAuth {
     const data = {
       client_id: this.#identity.client_id,
       scope: Constants.OAUTH.SCOPE,
-      device_id: uuidv4(),
+      device_id: Platform.shim.uuidv4(),
       model_name: Constants.OAUTH.MODEL_NAME
     };
 

src/core/Player.ts

@@ -1,12 +1,9 @@
-import { getRandomUserAgent, getStringBetweenStrings, PlayerError } from '../utils/Utils';
+import { Platform, getRandomUserAgent, getStringBetweenStrings, PlayerError } from '../utils/Utils.js';
 
-import Constants from '../utils/Constants';
-import UniversalCache from '../utils/Cache';
+import Constants from '../utils/Constants.js';
 
-// See: https://github.com/LuanRT/Jinter
-import Jinter from 'jintr';
-
-import type { FetchFunction } from '../utils/HTTPClient';
+import { ICache } from '../types/Cache.js';
+import { FetchFunction } from '../types/PlatformShim.js';
 
 export default class Player {
   #nsig_sc;
@@ -23,7 +20,7 @@ export default class Player {
     this.#player_id = player_id;
   }
 
-  static async create(cache: UniversalCache | undefined, fetch: FetchFunction = globalThis.fetch): Promise<Player> {
+  static async create(cache: ICache | undefined, fetch: FetchFunction = Platform.shim.fetch): Promise<Player> {
     const url = new URL('/iframe_api', Constants.URLS.YT_BASE);
     const res = await fetch(url);
 
@@ -75,13 +72,13 @@ export default class Player {
     const args = new URLSearchParams(url);
     const url_components = new URL(args.get('url') || url);
 
-    url_components.searchParams.set('ratebypass', 'yes');
-
     if (signature_cipher || cipher) {
-      const sig_decipher = new Jinter(this.#sig_sc);
-      sig_decipher.scope.set('sig', args.get('s'));
+      const signature = Platform.shim.eval(this.#sig_sc, {
+        sig: args.get('s')
+      });
 
-      const signature = sig_decipher.interpret();
+      if (typeof signature !== 'string')
+        throw new PlayerError('Failed to decipher signature');
 
       const sp = args.get('sp');
 
@@ -93,10 +90,12 @@ export default class Player {
     const n = url_components.searchParams.get('n');
 
     if (n) {
-      const nsig_decipher = new Jinter(this.#nsig_sc);
-      nsig_decipher.scope.set('nsig', n);
+      const nsig = Platform.shim.eval(this.#nsig_sc, {
+        nsig: n
+      });
 
-      const nsig = nsig_decipher.interpret();
+      if (typeof nsig !== 'string')
+        throw new PlayerError('Failed to decipher nsig');
 
       if (nsig.startsWith('enhanced_except_')) {
         console.warn('Warning:\nCould not transform nsig, download may be throttled.\nChanging the InnerTube client to "ANDROID" might help!');
@@ -108,7 +107,7 @@ export default class Player {
     return url_components.toString();
   }
 
-  static async fromCache(cache: UniversalCache, player_id: string): Promise<Player | null> {
+  static async fromCache(cache: ICache, player_id: string): Promise<Player | null> {
     const buffer = await cache.get(player_id);
 
     if (!buffer)
@@ -134,13 +133,13 @@ export default class Player {
     return new Player(sig_timestamp, sig_sc, nsig_sc, player_id);
   }
 
-  static async fromSource(cache: UniversalCache | undefined, sig_timestamp: number, sig_sc: string, nsig_sc: string, player_id: string): Promise<Player> {
+  static async fromSource(cache: ICache | undefined, sig_timestamp: number, sig_sc: string, nsig_sc: string, player_id: string): Promise<Player> {
     const player = new Player(sig_timestamp, sig_sc, nsig_sc, player_id);
     await player.cache(cache);
     return player;
   }
 
-  async cache(cache?: UniversalCache): Promise<void> {
+  async cache(cache?: ICache): Promise<void> {
     if (!cache) return;
 
     const encoder = new TextEncoder();

src/core/PlaylistManager.ts

@@ -1,8 +1,8 @@
-import type Feed from './Feed';
-import type Actions from './Actions';
-import Playlist from '../parser/youtube/Playlist';
+import type Feed from './Feed.js';
+import type Actions from './Actions.js';
+import Playlist from '../parser/youtube/Playlist.js';
 
-import { InnertubeError, throwIfMissing } from '../utils/Utils';
+import { InnertubeError, throwIfMissing } from '../utils/Utils.js';
 
 class PlaylistManager {
   #actions: Actions;
@@ -16,7 +16,7 @@ class PlaylistManager {
    * @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[]): Promise<{ success: boolean; status_code: number; playlist_id: string; data: any }> {
+  async create(title: string, video_ids: string[]): Promise<{ success: boolean; status_code: number; playlist_id?: string; data: any }> {
     throwIfMissing({ title, video_ids });
 
     if (!this.#actions.session.logged_in)

src/core/Session.ts

@@ -1,16 +1,18 @@
-import UniversalCache from '../utils/Cache';
-import Constants, { CLIENTS } from '../utils/Constants';
-import EventEmitterLike from '../utils/EventEmitterLike';
-import Actions from './Actions';
-import Player from './Player';
+import Constants, { CLIENTS } from '../utils/Constants.js';
+import EventEmitterLike from '../utils/EventEmitterLike.js';
+import Actions from './Actions.js';
+import Player from './Player.js';
 
-import HTTPClient, { FetchFunction } from '../utils/HTTPClient';
-import { DeviceCategory, generateRandomString, getRandomUserAgent, InnertubeError, SessionError } from '../utils/Utils';
-import OAuth, { Credentials, OAuthAuthErrorEventHandler, OAuthAuthEventHandler, OAuthAuthPendingEventHandler } from './OAuth';
-import Proto from '../proto';
+import HTTPClient from '../utils/HTTPClient.js';
+import { Platform, DeviceCategory, generateRandomString, getRandomUserAgent, InnertubeError, SessionError } from '../utils/Utils.js';
+import OAuth, { Credentials, OAuthAuthErrorEventHandler, OAuthAuthEventHandler, OAuthAuthPendingEventHandler } from './OAuth.js';
+import Proto from '../proto/index.js';
+import { ICache } from '../types/Cache.js';
+import { FetchFunction } from '../types/PlatformShim.js';
 
 export enum ClientType {
   WEB = 'WEB',
+  KIDS = 'WEB_KIDS',
   MUSIC = 'WEB_REMIX',
   ANDROID = 'ANDROID',
   ANDROID_MUSIC = 'ANDROID_MUSIC',
@@ -45,6 +47,15 @@ export interface Context {
     deviceMake: string;
     deviceModel: string;
     utcOffsetMinutes: number;
+    kidsAppInfo?: {
+      categorySettings: {
+        enabledCategories: string[];
+      };
+      contentSettings: {
+        corpusPreference: string;
+        kidsNoSearchMode: string;
+      };
+    };
   };
   user: {
     enableSafetyMode: boolean;
@@ -102,7 +113,7 @@ export interface SessionOptions {
   /**
    * Used to cache the deciphering functions from the JS player.
    */
-  cache?: UniversalCache;
+  cache?: ICache;
   /**
    * YouTube cookies.
    */
@@ -130,9 +141,9 @@ export default class Session extends EventEmitterLike {
   http: HTTPClient;
   logged_in: boolean;
   actions: Actions;
-  cache?: UniversalCache;
+  cache?: ICache;
 
-  constructor(context: Context, api_key: string, api_version: string, account_index: number, 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?: ICache) {
     super();
     this.#context = context;
     this.#account_index = account_index;
@@ -192,7 +203,7 @@ export default class Session extends EventEmitterLike {
     device_category: DeviceCategory = 'desktop',
     client_name: ClientType = ClientType.WEB,
     tz: string = Intl.DateTimeFormat().resolvedOptions().timeZone,
-    fetch: FetchFunction = globalThis.fetch
+    fetch: FetchFunction = Platform.shim.fetch
   ) {
     let session_data: SessionData;
 
@@ -212,7 +223,7 @@ export default class Session extends EventEmitterLike {
     device_category: string;
     client_name: string;
     enable_safety_mode: boolean;
-  }, fetch: FetchFunction = globalThis.fetch): Promise<SessionData> {
+  }, fetch: FetchFunction = Platform.shim.fetch): Promise<SessionData> {
     const url = new URL('/sw.js_data', Constants.URLS.YT_BASE);
 
     const res = await fetch(url, {

src/core/Studio.ts

@@ -1,9 +1,9 @@
-import Proto from '../proto';
-import { Constants } from '../utils';
-import { InnertubeError, MissingParamError, uuidv4 } from '../utils/Utils';
+import Proto from '../proto/index.js';
+import { Constants } from '../utils/index.js';
+import { InnertubeError, MissingParamError, Platform } from '../utils/Utils.js';
 
-import type { ApiResponse } from './Actions';
-import type Session from './Session';
+import type { ApiResponse } from './Actions.js';
+import type Session from './Session.js';
 
 interface UploadResult {
   status: string;
@@ -120,12 +120,12 @@ class Studio {
   }
 
   async #getInitialUploadData(): Promise<InitialUploadData> {
-    const frontend_upload_id = `innertube_android:${uuidv4()}:0:v=3,api=1,cf=3`;
+    const frontend_upload_id = `innertube_android:${Platform.shim.uuidv4()}:0:v=3,api=1,cf=3`;
 
     const payload = {
       frontendUploadId: frontend_upload_id,
       deviceDisplayName: 'Pixel 6 Pro',
-      fileId: `goog-edited-video://generated?videoFileUri=content://media/external/video/media/${uuidv4()}`,
+      fileId: `goog-edited-video://generated?videoFileUri=content://media/external/video/media/${Platform.shim.uuidv4()}`,
       mp4MoovAtomRelocationStatus: 'UNSUPPORTED',
       transcodeResult: 'DISABLED',
       connectionType: 'WIFI'

src/core/TabbedFeed.ts

@@ -1,26 +1,28 @@
-import Tab from '../parser/classes/Tab';
-import Feed from './Feed';
-import { InnertubeError } from '../utils/Utils';
+import Tab from '../parser/classes/Tab.js';
+import Feed from './Feed.js';
+import { InnertubeError } from '../utils/Utils.js';
 
-import type Actions from './Actions';
-import type { ObservedArray } from '../parser/helpers';
+import type Actions from './Actions.js';
+import type { ObservedArray } from '../parser/helpers.js';
+import type { IParsedResponse } from '../parser/types/ParsedResponse.js';
+import type { ApiResponse } from './Actions.js';
 
-class TabbedFeed extends Feed {
-  #tabs: ObservedArray<Tab>;
+class TabbedFeed<T extends IParsedResponse> extends Feed<T> {
+  #tabs?: ObservedArray<Tab>;
   #actions: Actions;
 
-  constructor(actions: Actions, data: any, already_parsed = false) {
+  constructor(actions: Actions, data: ApiResponse | IParsedResponse, already_parsed = false) {
     super(actions, data, already_parsed);
     this.#actions = actions;
-    this.#tabs = this.page.contents_memo.getType(Tab);
+    this.#tabs = this.page.contents_memo?.getType(Tab);
   }
 
   get tabs(): string[] {
-    return this.#tabs.map((tab) => tab.title.toString());
+    return this.#tabs?.map((tab) => tab.title.toString()) ?? [];
   }
 
-  async getTabByName(title: string): Promise<TabbedFeed> {
-    const tab = this.#tabs.find((tab) => tab.title.toLowerCase() === title.toLowerCase());
+  async getTabByName(title: string): Promise<TabbedFeed<T>> {
+    const tab = this.#tabs?.find((tab) => tab.title.toLowerCase() === title.toLowerCase());
 
     if (!tab)
       throw new InnertubeError(`Tab "${title}" not found`);
@@ -30,11 +32,11 @@ class TabbedFeed extends Feed {
 
     const response = await tab.endpoint.call(this.#actions);
 
-    return new TabbedFeed(this.#actions, response.data, false);
+    return new TabbedFeed<T>(this.#actions, response, false);
   }
 
-  async getTabByURL(url: string): Promise<TabbedFeed> {
-    const tab = this.#tabs.find((tab) => tab.endpoint.metadata.url?.split('/').pop() === url);
+  async getTabByURL(url: string): Promise<TabbedFeed<T>> {
+    const tab = this.#tabs?.find((tab) => tab.endpoint.metadata.url?.split('/').pop() === url);
 
     if (!tab)
       throw new InnertubeError(`Tab "${url}" not found`);
@@ -44,11 +46,15 @@ class TabbedFeed extends Feed {
 
     const response = await tab.endpoint.call(this.#actions);
 
-    return new TabbedFeed(this.#actions, response.data, false);
+    return new TabbedFeed<T>(this.#actions, response, false);
+  }
+
+  hasTabWithURL(url: string): boolean {
+    return this.#tabs?.some((tab) => tab.endpoint.metadata.url?.split('/').pop() === url) ?? false;
   }
 
   get title(): string | undefined {
-    return this.page.contents_memo.getType(Tab)?.find((tab) => tab.selected)?.title.toString();
+    return this.page.contents_memo?.getType(Tab)?.find((tab) => tab.selected)?.title.toString();
   }
 }
 

src/core/index.ts

@@ -0,0 +1,38 @@
+export { default as AccountManager } from './AccountManager.js';
+export * from './AccountManager.js';
+
+export { default as Actions } from './Actions.js';
+export * from './Actions.js';
+
+export { default as Feed } from './Feed.js';
+export * from './Feed.js';
+
+export { default as FilterableFeed } from './FilterableFeed.js';
+export * from './FilterableFeed.js';
+
+export { default as InteractionManager } from './InteractionManager.js';
+export * from './InteractionManager.js';
+
+export { default as Kids } from './Kids.js';
+export * from './Kids.js';
+
+export { default as Music } from './Music.js';
+export * from './Music.js';
+
+export { default as OAuth } from './OAuth.js';
+export * from './OAuth.js';
+
+export { default as Player } from './Player.js';
+export * from './Player.js';
+
+export { default as PlaylistManager } from './PlaylistManager.js';
+export * from './PlaylistManager.js';
+
+export { default as Session } from './Session.js';
+export * from './Session.js';
+
+export { default as Studio } from './Studio.js';
+export * from './Studio.js';
+
+export { default as TabbedFeed } from './TabbedFeed.js';
+export * from './TabbedFeed.js';

src/parser/README.md

@@ -1,6 +1,19 @@
 # Parser
 
-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. 
+Sanitizes and standardizes InnerTube responses while maintaining the integrity of the data. 
+
+Structure:
+
+* [`/classes`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/classes) - InnerTube nodes.
+* [`/types`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/types) - General response types.
+* [`/youtube`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/youtube) - Contains the logic for parsing YouTube responses.
+* [`/ytmusic`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/ytmusic) - Contains the logic for parsing YouTube Music responses.
+* [`/ytkids`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/ytkids) - Contains the logic for parsing YouTube Kids responses.
+* [`helpers.ts`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/helpers.ts) - Helper functions/classes for the parser.
+* [`parser.ts`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/parser.ts) - The core of the parser.
+* [`map.ts`](https://github.com/LuanRT/YouTube.js/blob/main/src/parser/map.ts) - A list of all InnerTube nodes, it is used to determine which node to use for a given renderer. Note that this file is auto-generated and should not be edited manually.
+
+## Table of Contents
 
 <ol>
   <li>
@@ -328,4 +341,4 @@ And what we get after parsing it:
 ```
 
 </p>
-</details> 
+</details> 

src/parser/classes/AccountChannel.ts

@@ -1,6 +1,6 @@
-import Text from './misc/Text';
-import NavigationEndpoint from './NavigationEndpoint';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import { YTNode } from '../helpers.js';
 
 class AccountChannel extends YTNode {
   static type = 'AccountChannel';

src/parser/classes/AccountItemSection.ts

@@ -1,11 +1,11 @@
-import Parser from '..';
+import Parser from '../index.js';
 
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
-import NavigationEndpoint from './NavigationEndpoint';
-import AccountItemSectionHeader from './AccountItemSectionHeader';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import AccountItemSectionHeader from './AccountItemSectionHeader.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class AccountItem {
   static type = 'AccountItem';

src/parser/classes/AccountItemSectionHeader.ts

@@ -1,5 +1,5 @@
-import Text from './misc/Text';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import { YTNode } from '../helpers.js';
 
 class AccountItemSectionHeader extends YTNode {
   static type = 'AccountItemSectionHeader';

src/parser/classes/AccountSectionList.ts

@@ -1,8 +1,8 @@
-import Parser from '..';
-import AccountChannel from './AccountChannel';
-import AccountItemSection from './AccountItemSection';
+import Parser from '../index.js';
+import AccountChannel from './AccountChannel.js';
+import AccountItemSection from './AccountItemSection.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class AccountSectionList extends YTNode {
   static type = 'AccountSectionList';

src/parser/classes/Alert.ts

@@ -0,0 +1,17 @@
+import Text from './misc/Text.js';
+import { YTNode } from '../helpers.js';
+
+class Alert extends YTNode {
+  static type = 'Alert';
+
+  text: Text;
+  alert_type: string;
+
+  constructor(data: any) {
+    super();
+    this.text = new Text(data.text);
+    this.alert_type = data.type;
+  }
+}
+
+export default Alert;

src/parser/classes/AudioOnlyPlayability.ts

@@ -1,4 +1,4 @@
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class AudioOnlyPlayability extends YTNode {
   static type = 'AudioOnlyPlayability';

src/parser/classes/AutomixPreviewVideo.ts

@@ -1,5 +1,5 @@
-import { YTNode } from '../helpers';
-import NavigationEndpoint from './NavigationEndpoint';
+import { YTNode } from '../helpers.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
 
 class AutomixPreviewVideo extends YTNode {
   static type = 'AutomixPreviewVideo';

src/parser/classes/BackstageImage.ts

@@ -1,14 +1,17 @@
-import Thumbnail from './misc/Thumbnail';
-import { YTNode } from '../helpers';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import { YTNode } from '../helpers.js';
 
 class BackstageImage extends YTNode {
   static type = 'BackstageImage';
 
   image: Thumbnail[];
+  endpoint: NavigationEndpoint;
 
   constructor(data: any) {
     super();
     this.image = Thumbnail.fromResponse(data.image);
+    this.endpoint = new NavigationEndpoint(data.command);
   }
 }
 

src/parser/classes/BackstagePost.ts

@@ -1,9 +1,11 @@
-import Parser from '../index';
-import Author from './misc/Author';
-import Text from './misc/Text';
-import NavigationEndpoint from './NavigationEndpoint';
+import Parser from '../index.js';
+import Author from './misc/Author.js';
+import Text from './misc/Text.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import type CommentActionButtons from './comments/CommentActionButtons.js';
+import type Menu from './menus/Menu.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class BackstagePost extends YTNode {
   static type = 'BackstagePost';
@@ -12,19 +14,18 @@ class BackstagePost extends YTNode {
   author: Author;
   content: Text;
   published: Text;
-  poll_status: string;
-  vote_status: string;
-  likes: Text;
-  menu;
-  actions;
+  poll_status?: string;
+  vote_status?: string;
+  vote_count?: Text;
+  menu?: Menu | null;
+  action_buttons;
   vote_button;
   surface: string;
-  endpoint: NavigationEndpoint;
+  endpoint?: NavigationEndpoint;
   attachment;
 
   constructor(data: any) {
     super();
-
     this.id = data.postId;
 
     this.author = new Author({
@@ -34,15 +35,40 @@ class BackstagePost extends YTNode {
 
     this.content = new Text(data.contentText);
     this.published = new Text(data.publishedTimeText);
-    this.poll_status = data.pollStatus;
-    this.vote_status = data.voteStatus;
-    this.likes = new Text(data.voteCount);
-    this.menu = Parser.parse(data.actionMenu) || null;
-    this.actions = Parser.parse(data.actionButtons);
-    this.vote_button = Parser.parse(data.voteButton);
+
+    if (data.pollStatus) {
+      this.poll_status = data.pollStatus;
+    }
+
+    if (data.voteStatus) {
+      this.vote_status = data.voteStatus;
+    }
+
+    if (data.voteCount) {
+      this.vote_count = new Text(data.voteCount);
+    }
+
+    if (data.actionMenu) {
+      this.menu = Parser.parseItem<Menu>(data.actionMenu);
+    }
+
+    if (data.actionButtons) {
+      this.action_buttons = Parser.parseItem<CommentActionButtons>(data.actionButtons);
+    }
+
+    if (data.voteButton) {
+      this.vote_button = Parser.parseItem(data.voteButton);
+    }
+
+    if (data.navigationEndpoint) {
+      this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
+    }
+
+    if (data.backstageAttachment) {
+      this.attachment = Parser.parseItem(data.backstageAttachment);
+    }
+
     this.surface = data.surface;
-    this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
-    this.attachment = Parser.parse(data.backstageAttachment) || null;
   }
 }
 

src/parser/classes/BackstagePostThread.ts

@@ -1,5 +1,5 @@
-import Parser from '../index';
-import { YTNode } from '../helpers';
+import Parser from '../index.js';
+import { YTNode } from '../helpers.js';
 
 class BackstagePostThread extends YTNode {
   static type = 'BackstagePostThread';
@@ -8,7 +8,7 @@ class BackstagePostThread extends YTNode {
 
   constructor(data: any) {
     super();
-    this.post = Parser.parse(data.post);
+    this.post = Parser.parseItem(data.post);
   }
 }
 

src/parser/classes/BrowseFeedActions.ts

@@ -1,5 +1,5 @@
-import Parser from '../index';
-import { YTNode } from '../helpers';
+import Parser from '../index.js';
+import { YTNode } from '../helpers.js';
 
 class BrowseFeedActions extends YTNode {
   static type = 'BrowseFeedActions';

src/parser/classes/BrowserMediaSession.ts

@@ -1,6 +1,6 @@
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import { YTNode } from '../helpers.js';
 
 class BrowserMediaSession extends YTNode {
   static type = 'BrowserMediaSession';

src/parser/classes/Button.ts

@@ -1,7 +1,7 @@
-import Text from './misc/Text';
-import NavigationEndpoint from './NavigationEndpoint';
+import Text from './misc/Text.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class Button extends YTNode {
   static type = 'Button';

src/parser/classes/C4TabbedHeader.ts

@@ -1,28 +1,28 @@
-import Parser from '../index';
-import Author from './misc/Author';
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
+import Parser from '../index.js';
+import Author from './misc/Author.js';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
 
-import type Button from './Button';
-import type ChannelHeaderLinks from './ChannelHeaderLinks';
-import type SubscribeButton from './SubscribeButton';
+import type Button from './Button.js';
+import type ChannelHeaderLinks from './ChannelHeaderLinks.js';
+import type SubscribeButton from './SubscribeButton.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class C4TabbedHeader extends YTNode {
   static type = 'C4TabbedHeader';
 
   author: Author;
-  banner: Thumbnail[];
-  tv_banner: Thumbnail[];
-  mobile_banner: Thumbnail[];
-  subscribers: Text;
-  videos_count: Text;
-  sponsor_button: Button | null;
-  subscribe_button: SubscribeButton | null;
-  header_links: ChannelHeaderLinks | null;
-  channel_handle: Text;
-  channel_id: string;
+  banner?: Thumbnail[];
+  tv_banner?: Thumbnail[];
+  mobile_banner?: Thumbnail[];
+  subscribers?: Text;
+  videos_count?: Text;
+  sponsor_button?: Button | null;
+  subscribe_button?: SubscribeButton | null;
+  header_links?: ChannelHeaderLinks | null;
+  channel_handle?: Text;
+  channel_id?: string;
 
   constructor(data: any) {
     super();
@@ -31,16 +31,45 @@ class C4TabbedHeader extends YTNode {
       navigationEndpoint: data.navigationEndpoint
     }, data.badges, data.avatar);
 
-    this.banner = Thumbnail.fromResponse(data.banner);
-    this.tv_banner = Thumbnail.fromResponse(data.tvBanner);
-    this.mobile_banner = Thumbnail.fromResponse(data.mobileBanner);
-    this.subscribers = new Text(data.subscriberCountText);
-    this.videos_count = new Text(data.videosCountText);
-    this.sponsor_button = Parser.parseItem<Button>(data.sponsorButton);
-    this.subscribe_button = Parser.parseItem<SubscribeButton>(data.subscribeButton);
-    this.header_links = Parser.parseItem<ChannelHeaderLinks>(data.headerLinks);
-    this.channel_handle = new Text(data.channelHandleText);
-    this.channel_id = data.channelId;
+    if (data.banner) {
+      this.banner = Thumbnail.fromResponse(data.banner);
+    }
+
+    if (data.tv_banner) {
+      this.tv_banner = Thumbnail.fromResponse(data.tvBanner);
+    }
+
+    if (data.mobile_banner) {
+      this.mobile_banner = Thumbnail.fromResponse(data.mobileBanner);
+    }
+
+    if (data.subscriberCountText) {
+      this.subscribers = new Text(data.subscriberCountText);
+    }
+
+    if (data.videosCountText) {
+      this.videos_count = new Text(data.videosCountText);
+    }
+
+    if (data.sponsorButton) {
+      this.sponsor_button = Parser.parseItem<Button>(data.sponsorButton);
+    }
+
+    if (data.subscribeButton) {
+      this.subscribe_button = Parser.parseItem<SubscribeButton>(data.subscribeButton);
+    }
+
+    if (data.headerLinks) {
+      this.header_links = Parser.parseItem<ChannelHeaderLinks>(data.headerLinks);
+    }
+
+    if (data.channelHandleText) {
+      this.channel_handle = new Text(data.channelHandleText);
+    }
+
+    if (data.channelId) {
+      this.channel_id = data.channelId;
+    }
   }
 }
 

src/parser/classes/CallToActionButton.ts

@@ -1,5 +1,5 @@
-import Text from './misc/Text';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import { YTNode } from '../helpers.js';
 
 class CallToActionButton extends YTNode {
   static type = 'CallToActionButton';

src/parser/classes/Card.ts

@@ -1,5 +1,5 @@
-import Parser from '../index';
-import { YTNode } from '../helpers';
+import Parser from '../index.js';
+import { YTNode } from '../helpers.js';
 
 class Card extends YTNode {
   static type = 'Card';

src/parser/classes/CardCollection.ts

@@ -1,6 +1,6 @@
-import Parser from '../index';
-import Text from './misc/Text';
-import { YTNode } from '../helpers';
+import Parser from '../index.js';
+import Text from './misc/Text.js';
+import { YTNode } from '../helpers.js';
 
 class CardCollection extends YTNode {
   static type = 'CardCollection';

src/parser/classes/CarouselHeader.ts

@@ -1,5 +1,5 @@
-import Parser from '..';
-import { YTNode } from '../helpers';
+import Parser from '../index.js';
+import { YTNode } from '../helpers.js';
 
 class CarouselHeader extends YTNode {
   static type = 'CarouselHeader';

src/parser/classes/CarouselItem.ts

@@ -1,7 +1,7 @@
-import Parser from '..';
-import { YTNode } from '../helpers';
+import Parser from '../index.js';
+import { YTNode } from '../helpers.js';
 
-import Thumbnail from './misc/Thumbnail';
+import Thumbnail from './misc/Thumbnail.js';
 
 class CarouselItem extends YTNode {
   static type = 'CarouselItem';

src/parser/classes/Channel.ts

@@ -1,12 +1,12 @@
-import Parser from '..';
+import Parser from '../index.js';
 
-import Text from './misc/Text';
-import Author from './misc/Author';
-import NavigationEndpoint from './NavigationEndpoint';
+import Text from './misc/Text.js';
+import Author from './misc/Author.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
 
-import type SubscribeButton from './SubscribeButton';
+import type SubscribeButton from './SubscribeButton.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class Channel extends YTNode {
   static type = 'Channel';

src/parser/classes/ChannelAboutFullMetadata.ts

@@ -1,12 +1,12 @@
-import Parser from '../index';
+import Parser from '../index.js';
 
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
-import NavigationEndpoint from './NavigationEndpoint';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
 
-import type Button from './Button';
+import type Button from './Button.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class ChannelAboutFullMetadata extends YTNode {
   static type = 'ChannelAboutFullMetadata';
@@ -37,11 +37,11 @@ class ChannelAboutFullMetadata extends YTNode {
     this.avatar = Thumbnail.fromResponse(data.avatar);
     this.canonical_channel_url = data.canonicalChannelUrl;
 
-    this.primary_links = data.primaryLinks.map((link: any) => ({
+    this.primary_links = data.primaryLinks?.map((link: any) => ({
       endpoint: new NavigationEndpoint(link.navigationEndpoint),
       icon: Thumbnail.fromResponse(link.icon),
       title: new Text(link.title)
-    }));
+    })) ?? [];
 
     this.views = new Text(data.viewCountText);
     this.joined = new Text(data.joinedDateText);

src/parser/classes/ChannelAgeGate.ts

@@ -0,0 +1,30 @@
+import { Parser } from '../index.js';
+import Button from './Button.js';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+
+import { YTNode } from '../helpers.js';
+import type { RawNode } from '../index.js';
+
+class ChannelAgeGate extends YTNode {
+  static type = 'ChannelAgeGate';
+
+  channel_title: string;
+  avatar: Thumbnail[];
+  header: Text;
+  main_text: Text;
+  sign_in_button: Button | null;
+  secondary_text: Text;
+
+  constructor(data: RawNode) {
+    super();
+    this.channel_title = data.channelTitle;
+    this.avatar = Thumbnail.fromResponse(data.avatar);
+    this.header = new Text(data.header);
+    this.main_text = new Text(data.mainText);
+    this.sign_in_button = Parser.parseItem<Button>(data.signInButton, Button);
+    this.secondary_text = new Text(data.secondaryText);
+  }
+}
+
+export default ChannelAgeGate;

src/parser/classes/ChannelFeaturedContent.ts

@@ -1,6 +1,6 @@
-import Parser from '../index';
-import Text from './misc/Text';
-import { YTNode } from '../helpers';
+import Parser from '../index.js';
+import Text from './misc/Text.js';
+import { YTNode } from '../helpers.js';
 
 class ChannelFeaturedContent extends YTNode {
   static type = 'ChannelFeaturedContent';

src/parser/classes/ChannelHeaderLinks.ts

@@ -1,7 +1,7 @@
-import NavigationEndpoint from './NavigationEndpoint';
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
-import { YTNode } from '../helpers';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import { YTNode } from '../helpers.js';
 
 class HeaderLink {
   endpoint: NavigationEndpoint;

src/parser/classes/ChannelMetadata.ts

@@ -1,5 +1,5 @@
-import Thumbnail from './misc/Thumbnail';
-import { YTNode } from '../helpers';
+import Thumbnail from './misc/Thumbnail.js';
+import { YTNode } from '../helpers.js';
 
 class ChannelMetadata extends YTNode {
   static type = 'ChannelMetadata';

src/parser/classes/ChannelMobileHeader.ts

@@ -1,5 +1,5 @@
-import Text from './misc/Text';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import { YTNode } from '../helpers.js';
 
 class ChannelMobileHeader extends YTNode {
   static type = 'ChannelMobileHeader';

src/parser/classes/ChannelOptions.ts

@@ -1,8 +1,8 @@
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
-import NavigationEndpoint from './NavigationEndpoint';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class ChannelOptions extends YTNode {
   static type = 'ChannelOptions';

src/parser/classes/ChannelSubMenu.ts

@@ -0,0 +1,27 @@
+import Parser from '../index.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import { YTNode } from '../helpers.js';
+
+class ChannelSubMenu extends YTNode {
+  static type = 'ChannelSubMenu';
+
+  content_type_sub_menu_items: {
+    endpoint: NavigationEndpoint;
+    selected: boolean;
+    title: string;
+  }[];
+
+  sort_setting;
+
+  constructor(data: any) {
+    super();
+    this.content_type_sub_menu_items = data.contentTypeSubMenuItems.map((item: any) => ({
+      endpoint: new NavigationEndpoint(item.navigationEndpoint || item.endpoint),
+      selected: item.selected,
+      title: item.title
+    }));
+    this.sort_setting = Parser.parseItem(data.sortSetting);
+  }
+}
+
+export default ChannelSubMenu;

src/parser/classes/ChannelThumbnailWithLink.ts

@@ -1,6 +1,6 @@
-import Thumbnail from './misc/Thumbnail';
-import NavigationEndpoint from './NavigationEndpoint';
-import { YTNode } from '../helpers';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import { YTNode } from '../helpers.js';
 
 class ChannelThumbnailWithLink extends YTNode {
   static type = 'ChannelThumbnailWithLink';

src/parser/classes/ChannelVideoPlayer.ts

@@ -1,5 +1,5 @@
-import Text from './misc/Text';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import { YTNode } from '../helpers.js';
 
 class ChannelVideoPlayer extends YTNode {
   static type = 'ChannelVideoPlayer';

src/parser/classes/Chapter.ts

@@ -1,7 +1,7 @@
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class Chapter extends YTNode {
   static type = 'Chapter';

src/parser/classes/ChildVideo.ts

@@ -1,8 +1,8 @@
-import NavigationEndpoint from './NavigationEndpoint';
-import Text from './misc/Text';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import Text from './misc/Text.js';
 
-import { timeToSeconds } from '../../utils/Utils';
-import { YTNode } from '../helpers';
+import { timeToSeconds } from '../../utils/Utils.js';
+import { YTNode } from '../helpers.js';
 
 class ChildVideo extends YTNode {
   static type = 'ChildVideo';

src/parser/classes/ChipCloud.ts

@@ -1,8 +1,8 @@
-import Parser from '../index';
-import Button from './Button';
-import ChipCloudChip from './ChipCloudChip';
+import Parser from '../index.js';
+import Button from './Button.js';
+import ChipCloudChip from './ChipCloudChip.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class ChipCloud extends YTNode {
   static type = 'ChipCloud';

src/parser/classes/ChipCloudChip.ts

@@ -1,6 +1,6 @@
-import Text from './misc/Text';
-import NavigationEndpoint from './NavigationEndpoint';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import { YTNode } from '../helpers.js';
 
 class ChipCloudChip extends YTNode {
   static type = 'ChipCloudChip';

src/parser/classes/CollaboratorInfoCardContent.ts

@@ -1,8 +1,8 @@
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
-import NavigationEndpoint from './NavigationEndpoint';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class CollaboratorInfoCardContent extends YTNode {
   static type = 'CollaboratorInfoCardContent';

src/parser/classes/CollageHeroImage.ts

@@ -1,6 +1,6 @@
-import NavigationEndpoint from './NavigationEndpoint';
-import Thumbnail from './misc/Thumbnail';
-import { YTNode } from '../helpers';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import Thumbnail from './misc/Thumbnail.js';
+import { YTNode } from '../helpers.js';
 
 class CollageHeroImage extends YTNode {
   static type = 'CollageHeroImage';

src/parser/classes/CompactChannel.ts

@@ -0,0 +1,35 @@
+import Parser from '../index.js';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import type Menu from './menus/Menu.js';
+import { YTNode } from '../helpers.js';
+
+class CompactChannel extends YTNode {
+  static type = 'CompactChannel';
+
+  title: Text;
+  channel_id: string;
+  thumbnail: Thumbnail[];
+  display_name: Text;
+  video_count: Text;
+  subscriber_count: Text;
+  endpoint: NavigationEndpoint;
+  tv_banner: Thumbnail[];
+  menu: Menu | null;
+
+  constructor(data: any) {
+    super();
+    this.title = new Text(data.title);
+    this.channel_id = data.channelId;
+    this.thumbnail = Thumbnail.fromResponse(data.thumbnail);
+    this.display_name = new Text(data.displayName);
+    this.video_count = new Text(data.videoCountText);
+    this.subscriber_count = new Text(data.subscriberCountText);
+    this.endpoint = new NavigationEndpoint(data.navigationEndpoint);
+    this.tv_banner = Thumbnail.fromResponse(data.tvBanner);
+    this.menu = Parser.parseItem<Menu>(data.menu);
+  }
+}
+
+export default CompactChannel;

src/parser/classes/CompactLink.ts

@@ -1,6 +1,6 @@
-import Text from './misc/Text';
-import NavigationEndpoint from './NavigationEndpoint';
-import { YTNode } from '../helpers';
+import Text from './misc/Text.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import { YTNode } from '../helpers.js';
 
 class CompactLink extends YTNode {
   static type = 'CompactLink';

src/parser/classes/CompactMix.ts

@@ -1,4 +1,4 @@
-import Playlist from './Playlist';
+import Playlist from './Playlist.js';
 
 class CompactMix extends Playlist {
   static type = 'CompactMix';

src/parser/classes/CompactPlaylist.ts

@@ -1,4 +1,4 @@
-import Playlist from './Playlist';
+import Playlist from './Playlist.js';
 
 class CompactPlaylist extends Playlist {
   static type = 'CompactPlaylist';

src/parser/classes/CompactStation.ts

@@ -1,8 +1,8 @@
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
-import Text from './misc/Text';
-import Thumbnail from './misc/Thumbnail';
-import NavigationEndpoint from './NavigationEndpoint';
+import Text from './misc/Text.js';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
 
 class CompactStation extends YTNode {
   static type = 'CompactStation';

src/parser/classes/CompactVideo.ts

@@ -1,12 +1,13 @@
-import Parser from '../index';
-import Text from './misc/Text';
-import Author from './misc/Author';
-import { timeToSeconds } from '../../utils/Utils';
-import Thumbnail from './misc/Thumbnail';
-import NavigationEndpoint from './NavigationEndpoint';
-import type Menu from './menus/Menu';
+import Parser from '../index.js';
+import Text from './misc/Text.js';
+import Author from './misc/Author.js';
+import { timeToSeconds } from '../../utils/Utils.js';
+import Thumbnail from './misc/Thumbnail.js';
+import NavigationEndpoint from './NavigationEndpoint.js';
+import type Menu from './menus/Menu.js';
+import MetadataBadge from './MetadataBadge.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class CompactVideo extends YTNode {
   static type = 'CompactVideo';
@@ -19,6 +20,7 @@ class CompactVideo extends YTNode {
   view_count: Text;
   short_view_count: Text;
   published: Text;
+  badges: MetadataBadge[];
 
   duration: {
     text: string;
@@ -39,6 +41,7 @@ class CompactVideo extends YTNode {
     this.view_count = new Text(data.viewCountText);
     this.short_view_count = new Text(data.shortViewCountText);
     this.published = new Text(data.publishedTimeText);
+    this.badges = Parser.parseArray(data.badges, MetadataBadge);
 
     this.duration = {
       text: new Text(data.lengthText).toString(),
@@ -53,6 +56,25 @@ class CompactVideo extends YTNode {
   get best_thumbnail() {
     return this.thumbnails[0];
   }
+
+  get is_fundraiser(): boolean {
+    return this.badges.some((badge) => badge.label === 'Fundraiser');
+  }
+
+  get is_live(): boolean {
+    return this.badges.some((badge) => {
+      if (badge.style === 'BADGE_STYLE_TYPE_LIVE_NOW' || badge.label === 'LIVE')
+        return true;
+    });
+  }
+
+  get is_new(): boolean {
+    return this.badges.some((badge) => badge.label === 'New');
+  }
+
+  get is_premiere(): boolean {
+    return this.badges.some((badge) => badge.style === 'PREMIERE');
+  }
 }
 
 export default CompactVideo;

src/parser/classes/ConfirmDialog.ts

@@ -1,8 +1,8 @@
-import Parser from '..';
-import Text from './misc/Text';
-import Button from './Button';
+import Parser from '../index.js';
+import Text from './misc/Text.js';
+import Button from './Button.js';
 
-import { YTNode } from '../helpers';
+import { YTNode } from '../helpers.js';
 
 class ConfirmDialog extends YTNode {
   static type = 'ConfirmDialog';