feat: finalize comment section nodes (#280)

* fix: comment translation proto missing channel id

* feat: finalize nodes

* docs: update API ref

* chore: update tests

examples/comments/Comment.md

@@ -1,5 +1,5 @@
 ## Comment
-Contains information about a single comment. A [`Comment`](../../lib/parser/contents/classes/Comment.js) can be a top-level comment or a reply to a top-level comment.
+Contains information about a single comment. A [`Comment`](../../src/parser/classes/comments/Comment.ts) can be a top-level comment or a reply to a top-level comment.
 
 ## API
 

examples/comments/CommentThread.md

@@ -9,27 +9,42 @@ A `CommentThread` represents a top-level comment and its replies.
   * [.replies](#replies) ⇒ `Comment[]`
   * [.getReplies](#getreplies) ⇒ `function`
   * [.getContinuation](#getcontinuation) ⇒ `function`
+  * [.has_continuation](#hascontinuation) ⇒ `boolean`
+  * [.has_replies](#hasreplies) ⇒ `boolean`
 
 <a name="comment"></a>
 ### comment
 The top-level comment. **Note:** More about `Comment` [here](./Comment.md).
 
-**Type:** [`Comment`](../../lib/parser/contents/classes/Comment.js)
+**Type:** [`Comment`](../../src/parser/classes/comments/Comment.ts)
 
 <a name="replies"></a>
 ### replies
 An array of replies to the top-level comment. (not populated until [`getReplies()`](#getreplies) is called).
 
-**Type:** [`Comment[]`](../../lib/parser/contents/classes/Comment.js)
+**Type:** [`Comment[]`](../../src/parser/classes/comments/Comment.ts)
 
 <a name="getreplies"></a>
 ### getReplies()
 Retrieves replies to the top-level comment and attaches a [`replies`](#replies) array to the original `CommentThread` object and returns it.
 
-**Returns:** [`Promise.<CommentThread>`](../../lib/parser/contents/classes/CommentThread.js)
+**Returns:** [`Promise.<CommentThread>`](../../src/parser/classes/comments/CommentThread.ts)
 
 <a name="getcontinuation"></a>
 ### getContinuation()
 Retrieves next batch of replies and adds them to the [`replies`](#replies) array. **Note:** [`getReplies()`](#getreplies) must be called before using this.
 
-**Returns:** [`Promise.<CommentThread>`](../../lib/parser/contents/classes/CommentThread.js)
+**Returns:** [`Promise.<CommentThread>`](../../src/parser/classes/comments/CommentThread.ts)
+
+<a name="hascontinuation"></a>
+### has_continuation
+Whether there are more replies to be retrieved.
+
+**Type:** `boolean`
+
+<a name="hasreplies"></a>
+### has_replies
+
+Whether there are replies to the top-level comment.
+
+**Type:** `boolean`

examples/comments/README.md

@@ -1,8 +1,8 @@
 ## Comments
-YouTube.js has full support for comments, including comment actions such as liking, disliking, replying etc.
+YouTube.js has full support for comments, including comment actions such as translating, liking, disliking and replying.
 
 ## Usage
-Get a [`Comments`](../../lib/parser/youtube/Comments.js) instance:
+Get a [`Comments`](../../src/parser/youtube/Comments.ts) instance:
 
 ```js
 const comments = await yt.getComments(VIDEO_ID);
@@ -11,15 +11,27 @@ const comments = await yt.getComments(VIDEO_ID);
 ## API
 * Comments
   * [.contents](#commentthread) ⇒ `CommentThread[]`
+  * [.applySort](#applysort) ⇒ `function`
   * [.createComment](#createComment) ⇒ `function`
   * [.getContinuation](#getc) ⇒ `function`
+  * [.has_continuation](#has_continuation) ⇒ `getter`
   * [.page](#page) ⇒ `getter`
 
 <a name="commentthread"></a>
 ### contents
 A list of comment threads. **Note:** More about comment threads [**here**](./CommentThread.md).
 
-**Type:** [`CommentThread[]`](../../lib/parser/contents/classes/CommentThread.js)
+**Type:** [`CommentThread[]`](../../src/parser/classes/comments/CommentThread.ts)
+
+<a name="applysort"></a>
+### applySort(sort)
+Sorts the comments with the given sort type.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| sort | `string` | Sort type. Can be `TOP_COMMENTS`, `NEWEST_FIRST` |
+
+**Returns:** [`Promise.<Comments>`](../../src/parser/youtube/Comments.ts)
 
 <a name="createComment"></a>
 ### createComment(text)
@@ -35,7 +47,13 @@ Creates a top-level comment.
 ### getContinuation()
 Retrieves next batch of comment threads.
 
-**Returns:** [`Promise.<Comments>`](../../lib/parser/youtube/Comments.ts)
+**Returns:** [`Promise.<Comments>`](../../src/parser/youtube/Comments.ts)
+
+<a name="has_continuation"></a>
+### has_continuation
+Returns whether there are more comments to be fetched.
+
+**Type:** `boolean`
 
 <a name="page"></a>
 ### page

examples/comments/index.ts

@@ -3,37 +3,43 @@ import { Innertube, UniversalCache } from 'youtubei.js';
 (async () => {
   const yt = await Innertube.create({ cache: new UniversalCache() });
 
-  const comments = await yt.getComments('a-rqu-hjobc');
- 
-  console.info(`This video has ${comments.header?.comments_count.toString() || 'N/A'} comments.\n`);
+  const comment_section = await yt.getComments('a-rqu-hjobc');
 
-  for (const thread of comments.contents) {
+  console.info(`This video has ${comment_section.header?.comments_count.toString() || 'N/A'} comments.\n`);
+
+  for (const thread of comment_section.contents) {
     const comment = thread.comment;
-    
+
     if (comment) {
       console.info(
+        `${comment.is_pinned ? '[Pinned]' : ''}`,
+        `${comment.is_member ? `${comment.sponsor_comment_badge?.tooltip}` : ''}`,
         `${comment.author.name} • ${comment.published}\n`,
         `${comment.content.toString()}`, '\n',
-        `Likes: ${comment.vote_count.short_text}`, '\n'
+        `Likes: ${comment.vote_count}`, '\n'
       );
-     
-      if (comment.reply_count > 0) {
+
+      if (thread.has_replies) {
         console.info('Replies:', '\n');
 
-        const comment_thread = await thread.getReplies();
-       
-        if (comment_thread.replies) {
-          for (const reply of comment_thread.replies) {
+        let comment_thread = await thread.getReplies();
+
+        while (true) {
+          for (const reply of comment_thread?.replies || []) {
             console.info(
               `> ${reply.author.name} • ${reply.published}\n`,
               `${reply.content.toString()}`, '\n',
-              `Likes: ${reply.vote_count.short_text}`, '\n'
+              `Likes: ${reply.vote_count}`, '\n'
             );
           }
+
+          try {
+            comment_thread = await comment_thread.getContinuation();
+          } catch { break; };
         }
       }
     }
-    
+
     console.log('\n');
   }
 })();