youtubei 1.3.7 → 1.4.1

package/dist/esm/youtube/BaseVideo/VideoCaptions.js

@@ -0,0 +1,133 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { Base } from "../Base";
+import { Caption, CaptionLanguage } from "../Caption";
+/**
+ * Captions of a video
+ *
+ * @example
+ * ```js
+ *
+ * console.log(video.captions.languages.map((l) => `${l.code} - ${l.name}`)); // printing out available languages for captions
+ *
+ * console.log(await video.captions.get("en")); // printing out captions of a specific language using language code
+ * ```
+ */
+var VideoCaptions = /** @class */ (function (_super) {
+    __extends(VideoCaptions, _super);
+    /** @hidden */
+    function VideoCaptions(_a) {
+        var video = _a.video, client = _a.client;
+        var _this = _super.call(this, client) || this;
+        _this.video = video;
+        _this.languages = [];
+        return _this;
+    }
+    /**
+     * Load this instance with raw data from Youtube
+     *
+     * @hidden
+     */
+    VideoCaptions.prototype.load = function (data) {
+        var _this = this;
+        var captionTracks = data.captionTracks;
+        if (captionTracks) {
+            this.languages = captionTracks.map(function (track) {
+                return new CaptionLanguage({
+                    captions: _this,
+                    name: track.name.simpleText,
+                    code: track.languageCode,
+                    isTranslatable: !!track.isTranslatable,
+                    url: track.baseUrl,
+                });
+            });
+        }
+        return this;
+    };
+    /**
+     * Get captions of a specific language or a translation of a specific language
+     */
+    VideoCaptions.prototype.get = function (languageCode, translationLanguageCode) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function () {
+            var url, params, response, captions;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        if (!languageCode)
+                            languageCode = this.client.options.youtubeClientOptions.hl;
+                        url = (_a = this.languages.find(function (l) { return l.code.toUpperCase() === (languageCode === null || languageCode === void 0 ? void 0 : languageCode.toUpperCase()); })) === null || _a === void 0 ? void 0 : _a.url;
+                        if (!url)
+                            return [2 /*return*/, undefined];
+                        params = { fmt: "json3" };
+                        if (translationLanguageCode)
+                            params["tlang"] = translationLanguageCode;
+                        return [4 /*yield*/, this.client.http.get(url, { params: params })];
+                    case 1:
+                        response = _c.sent();
+                        captions = (_b = response.data.events) === null || _b === void 0 ? void 0 : _b.reduce(function (curr, e) {
+                            var _a;
+                            if (e.segs === undefined)
+                                return curr;
+                            curr.push(new Caption({
+                                duration: e.dDurationMs,
+                                start: e.tStartMs,
+                                text: (_a = e.segs) === null || _a === void 0 ? void 0 : _a.map(function (s) { return Object.values(s).join(""); }).join(" "),
+                            }));
+                            return curr;
+                        }, []);
+                        return [2 /*return*/, captions];
+                }
+            });
+        });
+    };
+    return VideoCaptions;
+}(Base));
+export { VideoCaptions };

package/dist/esm/youtube/BaseVideo/index.js

@@ -1,3 +1,4 @@
 export * from "./BaseVideo";
 export * from "./BaseVideoParser";
+export * from "./VideoCaptions";
 export * from "./VideoRelated";

package/dist/esm/youtube/Caption/Caption.js

@@ -0,0 +1,19 @@
+/**
+ * Represent a single video caption entry
+ */
+var Caption = /** @class */ (function () {
+    /** @hidden */
+    function Caption(attr) {
+        Object.assign(this, attr);
+    }
+    Object.defineProperty(Caption.prototype, "end", {
+        /** transcript end time in milliseconds */
+        get: function () {
+            return this.start + this.duration;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    return Caption;
+}());
+export { Caption };

package/dist/esm/youtube/Caption/CaptionLanguage.js

@@ -0,0 +1,15 @@
+/**
+ * Represents a caption language option
+ */
+var CaptionLanguage = /** @class */ (function () {
+    /** @hidden */
+    function CaptionLanguage(attr) {
+        Object.assign(this, attr);
+    }
+    /** Get the captions of this language using the url */
+    CaptionLanguage.prototype.get = function (translationLanguageCode) {
+        return this.captions.get(this.code, translationLanguageCode);
+    };
+    return CaptionLanguage;
+}());
+export { CaptionLanguage };

package/dist/esm/youtube/Caption/index.js

@@ -0,0 +1,2 @@
+export * from "./Caption";
+export * from "./CaptionLanguage";

package/dist/esm/youtube/Channel/ChannelParser.js

@@ -17,16 +17,37 @@ var ChannelParser = /** @class */ (function () {
     function ChannelParser() {
     }
     ChannelParser.loadChannel = function (target, data) {
-        var _a = data.header.c4TabbedHeaderRenderer, channelId = _a.channelId, title = _a.title, avatar = _a.avatar, subscriberCountText = _a.subscriberCountText;
+        var _a, _b, _c;
+        var channelId, title, avatar, subscriberCountText, tvBanner, mobileBanner, banner;
+        var _d = data.header, c4TabbedHeaderRenderer = _d.c4TabbedHeaderRenderer, pageHeaderRenderer = _d.pageHeaderRenderer;
+        if (c4TabbedHeaderRenderer) {
+            channelId = c4TabbedHeaderRenderer.channelId;
+            title = c4TabbedHeaderRenderer.title;
+            subscriberCountText = (_a = c4TabbedHeaderRenderer.subscriberCountText) === null || _a === void 0 ? void 0 : _a.simpleText;
+            avatar = (_b = c4TabbedHeaderRenderer.avatar) === null || _b === void 0 ? void 0 : _b.thumbnails;
+            tvBanner = (_c = c4TabbedHeaderRenderer.tvBanner) === null || _c === void 0 ? void 0 : _c.thumbnails;
+            mobileBanner = c4TabbedHeaderRenderer.mobileBanner.thumbnails;
+            banner = c4TabbedHeaderRenderer.banner.thumbnails;
+        }
+        else {
+            channelId =
+                data.contents.twoColumnBrowseResultsRenderer.tabs[0].tabRenderer.endpoint
+                    .browseEndpoint.browseId;
+            title = pageHeaderRenderer.pageTitle;
+            var _e = pageHeaderRenderer.content.pageHeaderViewModel, metadata = _e.metadata, imageModel = _e.image, bannerModel = _e.banner;
+            subscriberCountText =
+                metadata.contentMetadataViewModel.metadataRows[1].metadataParts[0].text.content;
+            avatar = imageModel.decoratedAvatarViewModel.avatar.avatarViewModel.image.sources;
+            banner = bannerModel.imageBannerViewModel.image.sources;
+        }
         target.id = channelId;
         target.name = title;
-        target.thumbnails = new Thumbnails().load(avatar.thumbnails);
+        target.thumbnails = new Thumbnails().load(avatar);
         target.videoCount = 0; // data not available
-        target.subscriberCount = subscriberCountText === null || subscriberCountText === void 0 ? void 0 : subscriberCountText.simpleText;
-        var _b = data.header.c4TabbedHeaderRenderer, tvBanner = _b.tvBanner, mobileBanner = _b.mobileBanner, banner = _b.banner;
-        target.banner = new Thumbnails().load((banner === null || banner === void 0 ? void 0 : banner.thumbnails) || []);
-        target.tvBanner = new Thumbnails().load((tvBanner === null || tvBanner === void 0 ? void 0 : tvBanner.thumbnails) || []);
-        target.mobileBanner = new Thumbnails().load((mobileBanner === null || mobileBanner === void 0 ? void 0 : mobileBanner.thumbnails) || []);
+        target.subscriberCount = subscriberCountText;
+        target.banner = new Thumbnails().load(banner || []);
+        target.tvBanner = new Thumbnails().load(tvBanner || []);
+        target.mobileBanner = new Thumbnails().load(mobileBanner || []);
         target.shelves = ChannelParser.parseShelves(target, data);
         return target;
     };

package/dist/esm/youtube/Client/Client.js

@@ -51,15 +51,14 @@ import { LiveVideo } from "../LiveVideo";
 import { MixPlaylist } from "../MixPlaylist";
 import { Playlist } from "../Playlist";
 import { SearchResult } from "../SearchResult";
-import { Transcript, TranscriptParamsProto } from "../Transcript";
 import { Video } from "../Video";
 import { BASE_URL, INNERTUBE_API_KEY, INNERTUBE_CLIENT_NAME, INNERTUBE_CLIENT_VERSION, I_END_POINT, WATCH_END_POINT, } from "../constants";
 /** Youtube Client */
 var Client = /** @class */ (function () {
     function Client(options) {
         if (options === void 0) { options = {}; }
-        var fullOptions = __assign(__assign({ initialCookie: "", fetchOptions: {} }, options), { youtubeClientOptions: __assign({ hl: "en", gl: "US" }, options.youtubeClientOptions) });
-        this.http = new HTTP(__assign({ apiKey: INNERTUBE_API_KEY, baseUrl: BASE_URL, clientName: INNERTUBE_CLIENT_NAME, clientVersion: INNERTUBE_CLIENT_VERSION }, fullOptions));
+        this.options = __assign(__assign({ initialCookie: "", fetchOptions: {} }, options), { youtubeClientOptions: __assign({ hl: "en", gl: "US" }, options.youtubeClientOptions) });
+        this.http = new HTTP(__assign({ apiKey: INNERTUBE_API_KEY, baseUrl: BASE_URL, clientName: INNERTUBE_CLIENT_NAME, clientVersion: INNERTUBE_CLIENT_VERSION }, this.options));
     }
     /**
      * Searches for videos / playlists / channels
@@ -177,23 +176,19 @@ var Client = /** @class */ (function () {
             });
         });
     };
-    Client.prototype.getVideoTranscript = function (videoId) {
+    /**
+     * Get video transcript / caption by video id
+     */
+    Client.prototype.getVideoTranscript = function (videoId, languageCode) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var bufferParams, response;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        bufferParams = TranscriptParamsProto.encode({ videoId: videoId }).finish();
-                        return [4 /*yield*/, this.http.post(I_END_POINT + "/get_transcript", {
-                                data: { params: Buffer.from(bufferParams).toString("base64") },
-                            })];
+            var video;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0: return [4 /*yield*/, this.getVideo(videoId)];
                     case 1:
-                        response = _a.sent();
-                        if (!response.data.actions)
-                            return [2 /*return*/, undefined];
-                        return [2 /*return*/, response.data.actions[0].updateEngagementPanelAction.content.transcriptRenderer.body.transcriptBodyRenderer.cueGroups
-                                .map(function (t) { return t.transcriptCueGroupRenderer.cues[0].transcriptCueRenderer; })
-                                .map(function (t) { return new Transcript().load(t); })];
+                        video = _b.sent();
+                        return [2 /*return*/, (_a = video === null || video === void 0 ? void 0 : video.captions) === null || _a === void 0 ? void 0 : _a.get(languageCode)];
                 }
             });
         });

package/dist/esm/youtube/Comment/CommentParser.js

@@ -5,25 +5,24 @@ var CommentParser = /** @class */ (function () {
     function CommentParser() {
     }
     CommentParser.loadComment = function (target, data) {
-        var _a = data.comment.commentRenderer, authorText = _a.authorText, authorThumbnail = _a.authorThumbnail, authorEndpoint = _a.authorEndpoint, contentText = _a.contentText, publishedTimeText = _a.publishedTimeText, commentId = _a.commentId, voteCount = _a.voteCount, authorIsChannelOwner = _a.authorIsChannelOwner, pinnedCommentBadge = _a.pinnedCommentBadge, replyCount = _a.replyCount;
+        var properties = data.properties, toolbar = data.toolbar, author = data.author, avatar = data.avatar;
         // Basic information
-        target.id = commentId;
-        target.content = contentText.runs.map(function (r) { return r.text; }).join("");
-        target.publishDate = publishedTimeText.runs.shift().text;
-        target.likeCount = +((voteCount === null || voteCount === void 0 ? void 0 : voteCount.simpleText) || 0);
-        target.isAuthorChannelOwner = authorIsChannelOwner;
-        target.isPinned = !!pinnedCommentBadge;
-        target.replyCount = replyCount;
+        target.id = properties.commentId;
+        target.content = properties.content.content;
+        target.publishDate = properties.publishedTime;
+        target.likeCount = +toolbar.likeCountLiked; // probably broken
+        target.isAuthorChannelOwner = !!author.isCreator;
+        target.isPinned = false; // TODO fix this
+        target.replyCount = +toolbar.replyCount;
         // Reply Continuation
         target.replies.continuation = data.replies
             ? getContinuationFromItems(data.replies.commentRepliesRenderer.contents)
             : undefined;
         // Author
-        var browseId = authorEndpoint.browseEndpoint.browseId;
         target.author = new BaseChannel({
-            id: browseId,
-            name: authorText.simpleText,
-            thumbnails: new Thumbnails().load(authorThumbnail.thumbnails),
+            id: author.id,
+            name: author.displayName,
+            thumbnails: new Thumbnails().load(avatar.image.sources),
             client: target.client,
         });
         return target;

package/dist/esm/youtube/LiveVideo/LiveVideo.js

@@ -70,10 +70,10 @@ var LiveVideo = /** @class */ (function (_super) {
     /** @hidden */
     function LiveVideo(attr) {
         var _this = _super.call(this, attr) || this;
-        _this._delay = 0;
-        _this._timeoutMs = 0;
-        _this._isChatPlaying = false;
-        _this._chatQueue = [];
+        _this.delay = 0;
+        _this.timeoutMs = 0;
+        _this.isChatPlaying = false;
+        _this.chatQueue = [];
         Object.assign(_this, attr);
         return _this;
     }
@@ -94,18 +94,18 @@ var LiveVideo = /** @class */ (function (_super) {
      */
     LiveVideo.prototype.playChat = function (delay) {
         if (delay === void 0) { delay = 0; }
-        if (this._isChatPlaying)
+        if (this.isChatPlaying)
             return;
-        this._delay = delay;
-        this._isChatPlaying = true;
+        this.delay = delay;
+        this.isChatPlaying = true;
         this.pollChatContinuation();
     };
     /** Stop request polling for live chat */
     LiveVideo.prototype.stopChat = function () {
-        if (!this._chatRequestPoolingTimeout)
+        if (!this.chatRequestPoolingTimeout)
             return;
-        this._isChatPlaying = false;
-        clearTimeout(this._chatRequestPoolingTimeout);
+        this.isChatPlaying = false;
+        clearTimeout(this.chatRequestPoolingTimeout);
     };
     /** Start request polling */
     LiveVideo.prototype.pollChatContinuation = function () {
@@ -125,10 +125,10 @@ var LiveVideo = /** @class */ (function (_super) {
                         chats = LiveVideoParser.parseChats(response.data);
                         _loop_1 = function (c) {
                             var chat = new Chat({ client: this_1.client }).load(c);
-                            if (this_1._chatQueue.find(function (c) { return c.id === chat.id; }))
+                            if (this_1.chatQueue.find(function (c) { return c.id === chat.id; }))
                                 return "continue";
-                            this_1._chatQueue.push(chat);
-                            var timeout_1 = chat.timestamp / 1000 - (new Date().getTime() - this_1._delay);
+                            this_1.chatQueue.push(chat);
+                            var timeout_1 = chat.timestamp / 1000 - (new Date().getTime() - this_1.delay);
                             setTimeout(function () { return _this.emit("chat", chat); }, timeout_1);
                         };
                         this_1 = this;
@@ -146,9 +146,9 @@ var LiveVideo = /** @class */ (function (_super) {
                             finally { if (e_1) throw e_1.error; }
                         }
                         _a = LiveVideoParser.parseContinuation(response.data), timeout = _a.timeout, continuation = _a.continuation;
-                        this._timeoutMs = timeout;
+                        this.timeoutMs = timeout;
                         this.chatContinuation = continuation;
-                        this._chatRequestPoolingTimeout = setTimeout(function () { return _this.pollChatContinuation(); }, this._timeoutMs);
+                        this.chatRequestPoolingTimeout = setTimeout(function () { return _this.pollChatContinuation(); }, this.timeoutMs);
                         return [2 /*return*/];
                 }
             });

package/dist/esm/youtube/Video/Video.js

@@ -73,15 +73,13 @@ var Video = /** @class */ (function (_super) {
     /**
      * Get Video transcript (if exists)
      *
-     * Equivalent to
-     * ```js
-     * client.getVideoTranscript(video.id);
-     * ```
+     * @deprecated use `video.captions.get()` instead
      */
-    Video.prototype.getTranscript = function () {
+    Video.prototype.getTranscript = function (languageCode) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.client.getVideoTranscript(this.id)];
+            return __generator(this, function (_b) {
+                return [2 /*return*/, (_a = this.captions) === null || _a === void 0 ? void 0 : _a.get(languageCode)];
             });
         });
     };

package/dist/esm/youtube/Video/VideoParser.js

@@ -1,4 +1,4 @@
-import { getContinuationFromItems, mapFilter, Thumbnails } from "../../common";
+import { getContinuationFromItems, Thumbnails } from "../../common";
 import { BaseVideoParser } from "../BaseVideo";
 import { Comment } from "../Comment";
 var VideoParser = /** @class */ (function () {
@@ -25,9 +25,9 @@ var VideoParser = /** @class */ (function () {
         return target;
     };
     VideoParser.parseComments = function (data, video) {
-        var endpoints = data.onResponseReceivedEndpoints.at(-1);
-        var continuationItems = (endpoints.reloadContinuationItemsCommand || endpoints.appendContinuationItemsAction).continuationItems;
-        var comments = mapFilter(continuationItems, "commentThreadRenderer");
+        var comments = data.frameworkUpdates.entityBatchUpdate.mutations
+            .filter(function (m) { return m.payload.commentEntityPayload; })
+            .map(function (m) { return m.payload.commentEntityPayload; });
         return comments.map(function (c) {
             return new Comment({ video: video, client: video.client }).load(c);
         });

package/dist/esm/youtube/VideoCompact/VideoCompact.js

@@ -101,10 +101,10 @@ var VideoCompact = /** @class */ (function (_super) {
      * client.getVideoTranscript(video.id);
      * ```
      */
-    VideoCompact.prototype.getTranscript = function () {
+    VideoCompact.prototype.getTranscript = function (languageCode) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                return [2 /*return*/, this.client.getVideoTranscript(this.id)];
+                return [2 /*return*/, this.client.getVideoTranscript(this.id, languageCode)];
             });
         });
     };

package/dist/esm/youtube/VideoCompact/VideoCompactParser.js

@@ -4,7 +4,7 @@ var VideoCompactParser = /** @class */ (function () {
     function VideoCompactParser() {
     }
     VideoCompactParser.loadVideoCompact = function (target, data) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         var videoId = data.videoId, title = data.title, headline = data.headline, lengthText = data.lengthText, thumbnail = data.thumbnail, ownerText = data.ownerText, shortBylineText = data.shortBylineText, publishedTimeText = data.publishedTimeText, viewCountText = data.viewCountText, badges = data.badges, thumbnailOverlays = data.thumbnailOverlays, channelThumbnailSupportedRenderers = data.channelThumbnailSupportedRenderers, detailedMetadataSnippets = data.detailedMetadataSnippets;
         target.id = videoId;
         target.title = headline
@@ -17,7 +17,9 @@ var VideoCompactParser = /** @class */ (function () {
         target.duration =
             getDuration((lengthText === null || lengthText === void 0 ? void 0 : lengthText.simpleText) || ((_d = thumbnailOverlays === null || thumbnailOverlays === void 0 ? void 0 : thumbnailOverlays[0].thumbnailOverlayTimeStatusRenderer) === null || _d === void 0 ? void 0 : _d.text.simpleText) ||
                 "") || null;
-        target.isLive = !!((badges === null || badges === void 0 ? void 0 : badges[0].metadataBadgeRenderer.style) === "BADGE_STYLE_TYPE_LIVE_NOW");
+        target.isLive =
+            !!((badges === null || badges === void 0 ? void 0 : badges[0].metadataBadgeRenderer.style) === "BADGE_STYLE_TYPE_LIVE_NOW") ||
+                ((_e = thumbnailOverlays === null || thumbnailOverlays === void 0 ? void 0 : thumbnailOverlays[0].thumbnailOverlayTimeStatusRenderer) === null || _e === void 0 ? void 0 : _e.style) === "LIVE";
         // Channel
         if (ownerText || shortBylineText) {
             var browseEndpoint = (ownerText || shortBylineText).runs[0].navigationEndpoint

package/dist/esm/youtube/index.js

@@ -1,6 +1,7 @@
 export * from "./Base";
 export * from "./BaseChannel";
 export * from "./BaseVideo";
+export * from "./Caption";
 export * from "./Channel";
 export * from "./Chat";
 export * from "./Client";
@@ -12,6 +13,5 @@ export * from "./Playlist";
 export * from "./PlaylistCompact";
 export * from "./Reply";
 export * from "./SearchResult";
-export * from "./Transcript";
 export * from "./Video";
 export * from "./VideoCompact";

package/dist/typings/common/shared/HTTP/HTTP.d.ts

@@ -28,8 +28,8 @@ export declare class HTTP {
     private defaultFetchOptions;
     private defaultClientOptions;
     constructor(options: HTTPOptions);
-    get(url: string, options?: Partial<Options>): Promise<Response>;
-    post(url: string, options?: Partial<Options>): Promise<Response>;
+    get(path: string, options?: Partial<Options>): Promise<Response>;
+    post(path: string, options?: Partial<Options>): Promise<Response>;
     private request;
     private parseCookie;
 }

package/dist/typings/youtube/BaseVideo/BaseVideo.d.ts

@@ -3,6 +3,7 @@ import { Base, BaseProperties } from "../Base";
 import { BaseChannel } from "../BaseChannel";
 import { PlaylistCompact } from "../PlaylistCompact";
 import { VideoCompact } from "../VideoCompact";
+import { VideoCaptions } from "./VideoCaptions";
 import { VideoRelated } from "./VideoRelated";
 /** @hidden */
 export interface BaseVideoProperties extends BaseProperties {
@@ -40,6 +41,8 @@ export declare class BaseVideo extends Base implements BaseVideoProperties {
     tags: string[];
     /** Continuable of videos / playlists related to this video  */
     related: VideoRelated;
+    /** Captions helper class of this video (if caption exists in this video) */
+    captions: VideoCaptions | null;
     /** @hidden */
     constructor(attr: BaseVideoProperties);
     /**

package/dist/typings/youtube/BaseVideo/VideoCaptions.d.ts

@@ -0,0 +1,40 @@
+import { YoutubeRawData } from "../../common";
+import { Base } from "../Base";
+import { BaseVideo } from "../BaseVideo";
+import { Caption, CaptionLanguage } from "../Caption";
+import { Client } from "../Client";
+/** @hidden */
+interface ConstructorParams {
+    client: Client;
+    video?: BaseVideo;
+}
+/**
+ * Captions of a video
+ *
+ * @example
+ * ```js
+ *
+ * console.log(video.captions.languages.map((l) => `${l.code} - ${l.name}`)); // printing out available languages for captions
+ *
+ * console.log(await video.captions.get("en")); // printing out captions of a specific language using language code
+ * ```
+ */
+export declare class VideoCaptions extends Base {
+    /** The video this captions belongs to */
+    video?: BaseVideo;
+    /** List of available languages for this video */
+    languages: Array<CaptionLanguage>;
+    /** @hidden */
+    constructor({ video, client }: ConstructorParams);
+    /**
+     * Load this instance with raw data from Youtube
+     *
+     * @hidden
+     */
+    load(data: YoutubeRawData): VideoCaptions;
+    /**
+     * Get captions of a specific language or a translation of a specific language
+     */
+    get(languageCode?: string, translationLanguageCode?: string): Promise<Caption[] | undefined>;
+}
+export {};

package/dist/typings/youtube/BaseVideo/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./BaseVideo";
 export * from "./BaseVideoParser";
+export * from "./VideoCaptions";
 export * from "./VideoRelated";

package/dist/typings/youtube/Caption/Caption.d.ts

@@ -0,0 +1,22 @@
+/** @hidden */
+interface CaptionProperties {
+    text?: string;
+    start?: number;
+    duration?: number;
+}
+/**
+ * Represent a single video caption entry
+ */
+export declare class Caption implements CaptionProperties {
+    /** caption content */
+    text: string;
+    /** caption start time in milliseconds */
+    start: number;
+    /** caption duration in milliseconds */
+    duration: number;
+    /** @hidden */
+    constructor(attr?: CaptionProperties);
+    /** transcript end time in milliseconds */
+    get end(): number;
+}
+export {};

package/dist/typings/youtube/Caption/CaptionLanguage.d.ts

@@ -0,0 +1,30 @@
+import { VideoCaptions } from "../BaseVideo";
+import { Caption } from "./Caption";
+/** @hidden */
+interface CaptionLanguageProperties {
+    name?: string;
+    code?: string;
+    isTranslatable?: boolean;
+    url?: string;
+    captions?: VideoCaptions;
+}
+/**
+ * Represents a caption language option
+ */
+export declare class CaptionLanguage implements CaptionLanguageProperties {
+    /** Caption language name */
+    name: string;
+    /** Caption language code */
+    code: string;
+    /** Whether this language is translatable */
+    isTranslatable: boolean;
+    /** Caption language url */
+    url: string;
+    /** @hidden */
+    captions: VideoCaptions;
+    /** @hidden */
+    constructor(attr?: CaptionLanguageProperties);
+    /** Get the captions of this language using the url */
+    get(translationLanguageCode?: string): Promise<Caption[] | undefined>;
+}
+export {};

package/dist/typings/youtube/Caption/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./Caption";
+export * from "./CaptionLanguage";