youtube-transcript-plus 1.0.2 → 1.0.4

package/README.md

@@ -42,6 +42,20 @@ fetchTranscript('videoId_or_URL', {
   .catch(console.error);
 ```
 
+### HTTP Support
+
+You can disable HTTPS and use HTTP instead for YouTube requests by setting the `disableHttps` option to `true`. This might be necessary in certain environments where HTTPS connections are restricted.
+
+```javascript
+fetchTranscript('videoId_or_URL', {
+  disableHttps: true, // Use HTTP instead of HTTPS
+})
+  .then(console.log)
+  .catch(console.error);
+```
+
+**Security Warning:** Using HTTP instead of HTTPS removes transport layer security and is not recommended for production environments. Only use this option when absolutely necessary.
+
 ### Custom Fetch Functions
 
 You can inject custom `videoFetch` and `transcriptFetch` functions to modify the fetch behavior, such as using a proxy or custom headers.
@@ -188,6 +202,7 @@ Fetches the transcript for a YouTube video.
   - **`userAgent`**: Custom User-Agent string.
   - **`cache`**: Custom caching strategy.
   - **`cacheTTL`**: Time-to-live for cache entries in milliseconds.
+  - **`disableHttps`**: Set to `true` to use HTTP instead of HTTPS for YouTube requests.
   - **`videoFetch`**: Custom fetch function for the video page request.
   - **`transcriptFetch`**: Custom fetch function for the transcript request.
 

package/dist/index.d.ts

@@ -9,4 +9,5 @@ export declare class YoutubeTranscript {
 }
 export type { CacheStrategy } from './types';
 export { InMemoryCache, FsCache } from './cache';
+export * from './errors';
 export declare const fetchTranscript: typeof YoutubeTranscript.fetchTranscript;

package/dist/types.d.ts

@@ -7,6 +7,7 @@ export interface TranscriptConfig {
     userAgent?: string;
     cache?: CacheStrategy;
     cacheTTL?: number;
+    disableHttps?: boolean;
     videoFetch?: (params: {
         url: string;
         lang?: string;

package/dist/youtube-transcript-plus.js

@@ -85,7 +85,7 @@ function retrieveVideoId(videoId) {
     throw new YoutubeTranscriptInvalidVideoIdError();
 }
 function defaultFetch(_a) {
-    return __awaiter(this, arguments, undefined, function* ({ url, lang, userAgent, }) {
+    return __awaiter(this, arguments, void 0, function* ({ url, lang, userAgent, }) {
         return fetch(url, {
             headers: Object.assign(Object.assign({}, (lang && { 'Accept-Language': lang })), { 'User-Agent': userAgent || DEFAULT_USER_AGENT }),
         });
@@ -99,7 +99,7 @@ class FsCache {
         fs.mkdir(cacheDir, { recursive: true }).catch(() => { });
     }
     get(key) {
-        return __awaiter(this, undefined, undefined, function* () {
+        return __awaiter(this, void 0, void 0, function* () {
             const filePath = path.join(this.cacheDir, key);
             try {
                 const data = yield fs.readFile(filePath, 'utf-8');
@@ -114,9 +114,9 @@ class FsCache {
         });
     }
     set(key, value, ttl) {
-        return __awaiter(this, undefined, undefined, function* () {
+        return __awaiter(this, void 0, void 0, function* () {
             const filePath = path.join(this.cacheDir, key);
-            const expires = Date.now() + (ttl !== null && ttl !== undefined ? ttl : this.defaultTTL);
+            const expires = Date.now() + (ttl !== null && ttl !== void 0 ? ttl : this.defaultTTL);
             yield fs.writeFile(filePath, JSON.stringify({ value, expires }), 'utf-8');
         });
     }
@@ -129,7 +129,7 @@ class InMemoryCache {
         this.defaultTTL = defaultTTL;
     }
     get(key) {
-        return __awaiter(this, undefined, undefined, function* () {
+        return __awaiter(this, void 0, void 0, function* () {
             const entry = this.cache.get(key);
             if (entry && entry.expires > Date.now()) {
                 return entry.value;
@@ -139,8 +139,8 @@ class InMemoryCache {
         });
     }
     set(key, value, ttl) {
-        return __awaiter(this, undefined, undefined, function* () {
-            const expires = Date.now() + (ttl !== null && ttl !== undefined ? ttl : this.defaultTTL);
+        return __awaiter(this, void 0, void 0, function* () {
+            const expires = Date.now() + (ttl !== null && ttl !== void 0 ? ttl : this.defaultTTL);
             this.cache.set(key, { value, expires });
         });
     }
@@ -151,26 +151,27 @@ class YoutubeTranscript {
         this.config = config;
     }
     fetchTranscript(videoId) {
-        return __awaiter(this, undefined, undefined, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
             const identifier = retrieveVideoId(videoId);
-            const userAgent = ((_a = this.config) === null || _a === undefined ? undefined : _a.userAgent) || DEFAULT_USER_AGENT;
+            const userAgent = ((_a = this.config) === null || _a === void 0 ? void 0 : _a.userAgent) || DEFAULT_USER_AGENT;
             // Use custom fetch functions if provided, otherwise use defaultFetch
-            const videoFetch = ((_b = this.config) === null || _b === undefined ? undefined : _b.videoFetch) || defaultFetch;
-            const transcriptFetch = ((_c = this.config) === null || _c === undefined ? undefined : _c.transcriptFetch) || defaultFetch;
+            const videoFetch = ((_b = this.config) === null || _b === void 0 ? void 0 : _b.videoFetch) || defaultFetch;
+            const transcriptFetch = ((_c = this.config) === null || _c === void 0 ? void 0 : _c.transcriptFetch) || defaultFetch;
             // Cache key based on video ID and language
-            const cacheKey = `transcript:${identifier}:${((_d = this.config) === null || _d === undefined ? undefined : _d.lang) || 'default'}`;
+            const cacheKey = `transcript:${identifier}:${((_d = this.config) === null || _d === void 0 ? void 0 : _d.lang) || 'default'}`;
             // Check cache first
-            if ((_e = this.config) === null || _e === undefined ? undefined : _e.cache) {
+            if ((_e = this.config) === null || _e === void 0 ? void 0 : _e.cache) {
                 const cachedTranscript = yield this.config.cache.get(cacheKey);
                 if (cachedTranscript) {
                     return JSON.parse(cachedTranscript);
                 }
             }
+            const protocol = ((_f = this.config) === null || _f === void 0 ? void 0 : _f.disableHttps) ? 'http' : 'https';
             // Fetch the video page
             const videoPageResponse = yield videoFetch({
-                url: `https://www.youtube.com/watch?v=${identifier}`,
-                lang: (_f = this.config) === null || _f === undefined ? undefined : _f.lang,
+                url: `${protocol}://www.youtube.com/watch?v=${identifier}`,
+                lang: (_g = this.config) === null || _g === void 0 ? void 0 : _g.lang,
                 userAgent,
             });
             if (!videoPageResponse.ok) {
@@ -188,31 +189,34 @@ class YoutubeTranscript {
                 }
                 throw new YoutubeTranscriptDisabledError(identifier);
             }
-            const captions = (_g = (() => {
+            const captions = (_h = (() => {
                 try {
                     return JSON.parse(splittedHTML[1].split(',"videoDetails')[0].replace('\n', ''));
                 }
                 catch (e) {
                     return undefined;
                 }
-            })()) === null || _g === undefined ? undefined : _g['playerCaptionsTracklistRenderer'];
+            })()) === null || _h === void 0 ? void 0 : _h['playerCaptionsTracklistRenderer'];
             if (!captions) {
                 throw new YoutubeTranscriptDisabledError(identifier);
             }
             if (!('captionTracks' in captions)) {
                 throw new YoutubeTranscriptNotAvailableError(identifier);
             }
-            if (((_h = this.config) === null || _h === undefined ? undefined : _h.lang) &&
-                !captions.captionTracks.some((track) => { var _a; return track.languageCode === ((_a = this.config) === null || _a === undefined ? undefined : _a.lang); })) {
-                throw new YoutubeTranscriptNotAvailableLanguageError((_j = this.config) === null || _j === undefined ? undefined : _j.lang, captions.captionTracks.map((track) => track.languageCode), identifier);
+            if (((_j = this.config) === null || _j === void 0 ? void 0 : _j.lang) &&
+                !captions.captionTracks.some((track) => { var _a; return track.languageCode === ((_a = this.config) === null || _a === void 0 ? void 0 : _a.lang); })) {
+                throw new YoutubeTranscriptNotAvailableLanguageError((_k = this.config) === null || _k === void 0 ? void 0 : _k.lang, captions.captionTracks.map((track) => track.languageCode), identifier);
             }
-            const transcriptURL = (((_k = this.config) === null || _k === undefined ? undefined : _k.lang)
-                ? captions.captionTracks.find((track) => { var _a; return track.languageCode === ((_a = this.config) === null || _a === undefined ? undefined : _a.lang); })
+            const captionURL = (((_l = this.config) === null || _l === void 0 ? void 0 : _l.lang)
+                ? captions.captionTracks.find((track) => { var _a; return track.languageCode === ((_a = this.config) === null || _a === void 0 ? void 0 : _a.lang); })
                 : captions.captionTracks[0]).baseUrl;
+            const transcriptURL = ((_m = this.config) === null || _m === void 0 ? void 0 : _m.disableHttps)
+                ? captionURL.replace('https://', 'http://')
+                : captionURL;
             // Fetch the transcript
             const transcriptResponse = yield transcriptFetch({
                 url: transcriptURL,
-                lang: (_l = this.config) === null || _l === undefined ? undefined : _l.lang,
+                lang: (_o = this.config) === null || _o === void 0 ? void 0 : _o.lang,
                 userAgent,
             });
             if (!transcriptResponse.ok) {
@@ -226,11 +230,11 @@ class YoutubeTranscript {
                     text: result[3],
                     duration: parseFloat(result[2]),
                     offset: parseFloat(result[1]),
-                    lang: (_b = (_a = this.config) === null || _a === undefined ? undefined : _a.lang) !== null && _b !== undefined ? _b : captions.captionTracks[0].languageCode,
+                    lang: (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.lang) !== null && _b !== void 0 ? _b : captions.captionTracks[0].languageCode,
                 });
             });
             // Store in cache if a strategy is provided
-            if ((_m = this.config) === null || _m === undefined ? undefined : _m.cache) {
+            if ((_p = this.config) === null || _p === void 0 ? void 0 : _p.cache) {
                 yield this.config.cache.set(cacheKey, JSON.stringify(transcript), this.config.cacheTTL);
             }
             return transcript;
@@ -238,7 +242,7 @@ class YoutubeTranscript {
     }
     // Add static method for new usage pattern
     static fetchTranscript(videoId, config) {
-        return __awaiter(this, undefined, undefined, function* () {
+        return __awaiter(this, void 0, void 0, function* () {
             const instance = new YoutubeTranscript(config);
             return instance.fetchTranscript(videoId);
         });
@@ -247,4 +251,4 @@ class YoutubeTranscript {
 // Export the static method directly for convenience
 const fetchTranscript = YoutubeTranscript.fetchTranscript;
 
-export { FsCache, InMemoryCache, YoutubeTranscript, fetchTranscript };
+export { FsCache, InMemoryCache, YoutubeTranscript, YoutubeTranscriptDisabledError, YoutubeTranscriptInvalidVideoIdError, YoutubeTranscriptNotAvailableError, YoutubeTranscriptNotAvailableLanguageError, YoutubeTranscriptTooManyRequestError, YoutubeTranscriptVideoUnavailableError, fetchTranscript };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "youtube-transcript-plus",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Fetch transcript from a YouTube video",
   "type": "module",
   "main": "dist/youtube-transcript-plus.js",
@@ -11,7 +11,7 @@
     "format": "prettier --write 'src/**/*.ts'",
     "test": "jest",
     "test:watch": "jest --watch",
-    "prepare": "husky install"
+    "prepare": "husky"
   },
   "author": "ericmmartin",
   "keywords": [
@@ -33,14 +33,14 @@
     "https-proxy-agent": "^7.0.6",
     "husky": "^9.1.7",
     "jest": "^29.7.0",
-    "lint-staged": "^15.3.0",
-    "prettier": "^3.4.2",
-    "rollup": "^4.30.1",
+    "lint-staged": "^15.5.0",
+    "prettier": "^3.5.3",
+    "rollup": "^4.37.0",
     "rollup-plugin-typescript": "^1.0.1",
     "rollup-plugin-typescript2": "^0.36.0",
-    "ts-jest": "^29.2.5",
+    "ts-jest": "^29.3.0",
     "tslib": "^2.8.1",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.2"
   },
   "files": [
     "dist/*"