distube-invidious 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 techtimefor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,157 @@
+# DisTube Invidious Plugin
+
+A [DisTube](https://github.com/skick1234/DisTube) extractor plugin that routes all YouTube URLs through an [Invidious](https://invidious.io/) instance for privacy-friendly music playback.
+
+This is an ExtractorPlugin, find out more about it [here](https://github.com/skick1234/DisTube/wiki/Projects-Hub#extractorplugin).
+
+## Features
+
+- 🎵 Play YouTube videos through any Invidious instance
+- 🔒 Privacy-friendly - no direct YouTube API calls
+- 📝 Playlist support
+- 🔍 Search functionality
+- 🎼 Related songs recommendations
+- ⚙️ Configurable timeout
+- 🌐 Supports all YouTube URL formats (watch, shorts, live, embed, youtu.be, playlists)
+
+## Installation
+
+```bash
+npm install distube-invidious
+```
+
+## Usage
+
+```typescript
+import { DisTube } from "distube";
+import { InvidiousPlugin } from "distube-invidious";
+
+const distube = new DisTube({
+  plugins: [
+    new InvidiousPlugin({
+      instance: "yewtu.be", // or any other Invidious instance
+    }),
+  ],
+});
+```
+
+### Basic Example
+
+```typescript
+import { DisTube } from "distube";
+import { InvidiousPlugin } from "distube-invidious";
+
+// Initialize DisTube with Invidious plugin
+const distube = new DisTube({
+  plugins: [
+    new InvidiousPlugin({
+      instance: "yewtu.be",
+      timeout: 10000, // Optional: request timeout in milliseconds (default: 10000)
+    }),
+  ],
+});
+
+// Play a YouTube video
+distube.play(voiceChannel, "https://youtube.com/watch?v=dQw4w9WgXcQ");
+
+// Play a playlist
+distube.play(voiceChannel, "https://youtube.com/playlist?list=PLxyz123");
+
+// Search for a song
+distube.play(voiceChannel, "never gonna give you up");
+```
+
+## Configuration Options
+
+### `InvidiousPluginOptions`
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `instance` | `string` | Yes | - | Invidious instance URL (e.g., "yewtu.be", "https://yewtu.be", "http://localhost:8095") |
+| `timeout` | `number` | No | `10000` | Request timeout in milliseconds |
+
+### Public Invidious Instances
+
+You can find a list of public Invidious instances at:
+- https://docs.invidious.io/instances/
+
+
+## Supported YouTube URLs
+
+The plugin supports all YouTube URL formats:
+
+- **Videos**: `youtube.com/watch?v=ID`
+- **Short URLs**: `youtu.be/ID`
+- **Shorts**: `youtube.com/shorts/ID`
+- **Live**: `youtube.com/live/ID`
+- **Embed**: `youtube.com/embed/ID`
+- **Playlists**: `youtube.com/playlist?list=ID`
+- **Channels**: `youtube.com/channel/UCxxxx`, `youtube.com/@handle`, `youtube.com/c/CustomName`, `youtube.com/user/username`
+
+It also handles shared YouTube links with tracking parameters:
+- `https://youtu.be/ID?si=xxx` ✅
+
+## Advanced Usage
+
+### Direct Playlist Resolution
+
+```typescript
+import { InvidiousPlugin } from "distube-invidious";
+
+const plugin = new InvidiousPlugin({ instance: "yewtu.be" });
+
+// Resolve a playlist directly
+const playlist = await plugin.playlist(
+  "https://youtube.com/playlist?list=PLxyz123",
+  {}
+);
+
+console.log(`Playlist: ${playlist.name}`);
+console.log(`Songs: ${playlist.songs.length}`);
+```
+
+### Stream URL Extraction
+
+```typescript
+// Get the audio stream URL for a song
+const streamUrl = await plugin.getStreamURL(song);
+console.log(`Stream URL: ${streamUrl}`);
+```
+
+### Related Songs
+
+```typescript
+// Get related songs for a video
+const relatedSongs = await plugin.getRelatedSongs(song);
+console.log(`Found ${relatedSongs.length} related songs`);
+```
+
+## API
+
+### `InvidiousPlugin`
+
+#### Methods
+
+- **`validate(url: string): boolean`** - Checks if a URL is a valid YouTube URL
+- **`resolve(url, options): Promise<Song \| Playlist>`** - Resolves a URL to a Song or Playlist
+- **`searchSong(query, options): Promise<Song \| null>`** - Searches for a song
+- **`getStreamURL(song): Promise<string>`** - Gets the audio stream URL
+- **`getRelatedSongs(song): Promise<Song[]>`** - Gets related songs
+- **`playlist(url, options): Promise<Playlist>`** - Resolves a playlist directly
+
+## Requirements
+
+- Node.js 16+
+- DisTube 4.0.0 or 5.0.0+
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Disclaimer
+
+This plugin is not affiliated with, endorsed by, or connected to YouTube, DisTube or Invidious. Also this plugin is an unofficial plugin to help enhance your DisTube experience!

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { ExtractorPlugin, Playlist, ResolveOptions, Song } from "distube";
+import type { InvidiousPluginOptions } from "./types.js";
+export declare class InvidiousPlugin extends ExtractorPlugin {
+    readonly instance: string;
+    private readonly timeout;
+    constructor(options: InvidiousPluginOptions);
+    /**
+     * Validates if URL is a YouTube URL.
+     * Calls stripQuery() first to remove tracking parameters.
+     */
+    validate(url: string): boolean;
+    /**
+     * Resolves a URL to a Song or Playlist.
+     * Calls stripQuery() first to remove tracking parameters.
+     */
+    resolve<T>(url: string, options: ResolveOptions<T>): Promise<Song<T> | Playlist<T>>;
+    /**
+     * Searches for a song and returns the first result.
+     */
+    searchSong<T>(query: string, options: ResolveOptions<T>): Promise<Song<T> | null>;
+    /**
+     * Gets the stream URL for a song.
+     * Fetches fresh video data and extracts highest-quality audio stream.
+     */
+    getStreamURL(song: Song): Promise<string>;
+    /**
+     * Gets related songs for a given song.
+     */
+    getRelatedSongs(song: Song): Promise<Song[]>;
+    /**
+     * Public method for direct playlist resolution.
+     */
+    playlist<T>(url: string, options: ResolveOptions<T>): Promise<Playlist<T>>;
+    /**
+     * Wraps fetch with AbortController for timeout handling.
+     */
+    private fetchWithTimeout;
+    /**
+     * Returns highest-resolution thumbnail URL.
+     */
+    private getBestThumbnail;
+    /**
+     * Creates a Song object from Invidious video data.
+     */
+    private createSong;
+    /**
+     * Creates a Song object from video data (for related videos).
+     */
+    private createSongFromData;
+}
+export default InvidiousPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,QAAQ,EACR,cAAc,EACd,IAAI,EAEL,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EACV,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAWpB,qBAAa,eAAgB,SAAQ,eAAe;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,sBAAsB;IAe3C;;;OAGG;IAEH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B;;;OAGG;IAEG,OAAO,CAAC,CAAC,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAsBjC;;OAEG;IAEG,UAAU,CAAC,CAAC,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAsB1B;;;OAGG;IAEG,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IA2C/C;;OAEG;IAEG,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAgBlD;;OAEG;IAEG,QAAQ,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAsDvB;;OAEG;YAEW,gBAAgB;IA2B9B;;OAEG;IAEH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IAEH,OAAO,CAAC,UAAU;IA4BlB;;OAEG;IAEH,OAAO,CAAC,kBAAkB;CAqB3B;AAED,eAAe,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,248 @@
+import { ExtractorPlugin, Playlist, Song, DisTubeError, } from "distube";
+import fetch from "node-fetch";
+import { stripQuery, isYouTubeUrl, extractVideoId, extractPlaylistId, } from "./url-utils.js";
+// InvidiousPlugin Class
+export class InvidiousPlugin extends ExtractorPlugin {
+    instance;
+    timeout;
+    constructor(options) {
+        super();
+        // Normalize instance:
+        // 1. Remove trailing slash
+        // 2. Prepend "https://" if missing
+        let normalized = options.instance.replace(/\/+$/, "");
+        if (!normalized.startsWith("http://") && !normalized.startsWith("https://")) {
+            normalized = "https://" + normalized;
+        }
+        this.instance = normalized;
+        this.timeout = options.timeout ?? 10000;
+    }
+    // Required ExtractorPlugin Methods
+    /**
+     * Validates if URL is a YouTube URL.
+     * Calls stripQuery() first to remove tracking parameters.
+     */
+    validate(url) {
+        return isYouTubeUrl(url);
+    }
+    /**
+     * Resolves a URL to a Song or Playlist.
+     * Calls stripQuery() first to remove tracking parameters.
+     */
+    async resolve(url, options) {
+        const cleanUrl = stripQuery(url);
+        // Check if it's a playlist URL
+        if (cleanUrl.includes("list=") && !cleanUrl.includes("v=")) {
+            return this.playlist(url, options);
+        }
+        // Extract video ID
+        const videoId = extractVideoId(cleanUrl);
+        if (!videoId) {
+            throw new DisTubeError("CANNOT_RESOLVE_SONG", "Invalid YouTube URL");
+        }
+        // Fetch video data from Invidious API
+        const apiUrl = `${this.instance}/api/v1/videos/${videoId}`;
+        const data = (await this.fetchWithTimeout(apiUrl));
+        // Convert to Song
+        return this.createSong(data, options);
+    }
+    /**
+     * Searches for a song and returns the first result.
+     */
+    async searchSong(query, options) {
+        const apiUrl = `${this.instance}/api/v1/search?q=${encodeURIComponent(query)}&type=video`;
+        const data = (await this.fetchWithTimeout(apiUrl));
+        if (!data || data.length === 0) {
+            return null;
+        }
+        const firstResult = data[0];
+        if (!firstResult.videoId) {
+            return null;
+        }
+        // Fetch full video data
+        const videoUrl = `${this.instance}/api/v1/videos/${firstResult.videoId}`;
+        const videoData = (await this.fetchWithTimeout(videoUrl));
+        return this.createSong(videoData, options);
+    }
+    /**
+     * Gets the stream URL for a song.
+     * Fetches fresh video data and extracts highest-quality audio stream.
+     */
+    async getStreamURL(song) {
+        const apiUrl = `${this.instance}/api/v1/videos/${song.id}`;
+        const data = (await this.fetchWithTimeout(apiUrl));
+        // Priority 1: Audio-only from adaptiveFormats
+        // Check both 'type' and 'mimeType' fields as different instances may use either
+        if (data.adaptiveFormats && data.adaptiveFormats.length > 0) {
+            // First try to find opus audio
+            let bestAudio = data.adaptiveFormats.find((format) => {
+                const mimeType = format.mimeType || format.type || "";
+                return mimeType.includes("audio") && mimeType.includes("opus");
+            });
+            // If no opus, try AAC
+            if (!bestAudio) {
+                bestAudio = data.adaptiveFormats.find((format) => {
+                    const mimeType = format.mimeType || format.type || "";
+                    return mimeType.includes("audio") && mimeType.includes("mp4");
+                });
+            }
+            // If still no audio, find any audio format
+            if (!bestAudio) {
+                bestAudio = data.adaptiveFormats.find((format) => {
+                    const mimeType = format.mimeType || format.type || "";
+                    return mimeType.includes("audio");
+                });
+            }
+            if (bestAudio && bestAudio.url) {
+                return bestAudio.url;
+            }
+        }
+        // Priority 2: Fallback to first entry in formatStreams
+        if (data.formatStreams && data.formatStreams.length > 0) {
+            return data.formatStreams[0].url;
+        }
+        // Priority 3: Throw error if no valid stream found
+        throw new DisTubeError("CANNOT_GET_STREAM_URL", "No playable stream found");
+    }
+    /**
+     * Gets related songs for a given song.
+     */
+    async getRelatedSongs(song) {
+        const apiUrl = `${this.instance}/api/v1/videos/${song.id}`;
+        const data = (await this.fetchWithTimeout(apiUrl));
+        if (!data.recommendedVideos || data.recommendedVideos.length === 0) {
+            return [];
+        }
+        // Return up to 10 related songs
+        return data.recommendedVideos.slice(0, 10).map((video) => this.createSongFromData(video));
+    }
+    // Playlist Resolution
+    /**
+     * Public method for direct playlist resolution.
+     */
+    async playlist(url, options) {
+        const cleanUrl = stripQuery(url);
+        const playlistId = extractPlaylistId(cleanUrl);
+        if (!playlistId) {
+            throw new DisTubeError("CANNOT_RESOLVE_SONG", "Invalid playlist URL");
+        }
+        const apiUrl = `${this.instance}/api/v1/playlists/${playlistId}`;
+        const data = (await this.fetchWithTimeout(apiUrl));
+        // Create Song objects from playlist videos
+        const songs = data.videos.map((video) => this.createSongFromData({
+            videoId: video.videoId,
+            title: video.title,
+            author: video.author,
+            authorId: data.authorId,
+            authorUrl: `/channel/${data.authorId}`,
+            lengthSeconds: video.lengthSeconds,
+            videoThumbnails: video.videoThumbnails.map((t) => ({
+                quality: "",
+                url: t.url,
+                width: t.width,
+                height: t.height,
+            })),
+            viewCount: 0,
+            likeCount: 0,
+            liveNow: false,
+            recommendedVideos: [],
+            formatStreams: [],
+            adaptiveFormats: [],
+        }));
+        // Create Playlist object
+        const playlist = new Playlist({
+            source: "youtube",
+            name: data.title,
+            id: data.playlistId,
+            url: `${this.instance}/playlist?list=${data.playlistId}`,
+            thumbnail: this.getBestThumbnail(data.videos[0]?.videoThumbnails || []),
+            songs,
+        }, options);
+        return playlist;
+    }
+    // Private Helper Methods
+    /**
+     * Wraps fetch with AbortController for timeout handling.
+     */
+    async fetchWithTimeout(url) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new DisTubeError("CANNOT_RESOLVE_SONG", `HTTP ${response.status}: ${response.statusText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error.name === "AbortError") {
+                throw new DisTubeError("CANNOT_RESOLVE_SONG", "Request timeout");
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Returns highest-resolution thumbnail URL.
+     */
+    getBestThumbnail(thumbnails) {
+        if (!thumbnails || thumbnails.length === 0) {
+            return "";
+        }
+        // Sort by resolution (width * height) and return the highest
+        const sorted = [...thumbnails].sort((a, b) => b.width * b.height - a.width * a.height);
+        return sorted[0].url;
+    }
+    /**
+     * Creates a Song object from Invidious video data.
+     */
+    createSong(data, options) {
+        const song = new Song({
+            plugin: this,
+            source: "youtube",
+            playFromSource: true,
+            id: data.videoId,
+            name: data.title,
+            url: `${this.instance}/watch?v=${data.videoId}`,
+            thumbnail: this.getBestThumbnail(data.videoThumbnails),
+            duration: data.lengthSeconds,
+            isLive: data.liveNow,
+            views: data.viewCount,
+            likes: data.likeCount,
+            uploader: {
+                name: data.author,
+                url: `${this.instance}${data.authorUrl}`,
+            },
+        }, options);
+        return song;
+    }
+    /**
+     * Creates a Song object from video data (for related videos).
+     */
+    createSongFromData(data) {
+        const song = new Song({
+            plugin: this,
+            source: "youtube",
+            playFromSource: true,
+            id: data.videoId,
+            name: data.title,
+            url: `${this.instance}/watch?v=${data.videoId}`,
+            thumbnail: this.getBestThumbnail(data.videoThumbnails),
+            duration: data.lengthSeconds,
+            isLive: data.liveNow,
+            views: data.viewCount,
+            likes: data.likeCount,
+            uploader: {
+                name: data.author,
+                url: `${this.instance}/channel/${data.authorId}`,
+            },
+        });
+        return song;
+    }
+}
+export default InvidiousPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+export interface InvidiousPluginOptions {
+    instance: string;
+    timeout?: number;
+}
+export interface InvidiousVideoResponse {
+    videoId: string;
+    title: string;
+    videoThumbnails: Array<{
+        quality: string;
+        url: string;
+        width: number;
+        height: number;
+    }>;
+    lengthSeconds: number;
+    author: string;
+    authorId: string;
+    authorUrl: string;
+    viewCount: number;
+    likeCount: number;
+    liveNow: boolean;
+    recommendedVideos: InvidiousVideoResponse[];
+    formatStreams: Array<{
+        url: string;
+        type: string;
+        mimeType?: string;
+        quality: string;
+    }>;
+    adaptiveFormats: Array<{
+        url: string;
+        type: string;
+        mimeType?: string;
+        encoding?: string;
+    }>;
+    hlsUrl?: string;
+    dashUrl?: string;
+}
+export interface InvidiousPlaylistResponse {
+    title: string;
+    playlistId: string;
+    author: string;
+    authorId: string;
+    videoCount: number;
+    videos: Array<{
+        title: string;
+        videoId: string;
+        author: string;
+        lengthSeconds: number;
+        videoThumbnails: Array<{
+            url: string;
+            width: number;
+            height: number;
+        }>;
+    }>;
+}
+export interface InvidiousSearchResponse {
+    type: string;
+    title: string;
+    videoId?: string;
+    author: string;
+    videoThumbnails: Array<{
+        url: string;
+        width: number;
+        height: number;
+    }>;
+    lengthSeconds?: number;
+}
+export interface InvidiousChannelResponse {
+    author: string;
+    authorId: string;
+    latestVideos: InvidiousVideoResponse[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,KAAK,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,aAAa,EAAE,KAAK,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,eAAe,EAAE,KAAK,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxE,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,sBAAsB,EAAE,CAAC;CACxC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// TypeScript interfaces for Invidious API responses
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oDAAoD"}

package/dist/url-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Strips query parameters from URL (everything from "?" onward).
+ * Must be called FIRST in all URL parsing functions to handle shared
+ * YouTube links with tracking parameters (e.g., https://youtu.be/ID?si=xxx).
+ */
+export declare function stripQuery(url: string): string;
+/**
+ * Tests if URL matches any YouTube URL pattern.
+ */
+export declare function isYouTubeUrl(url: string): boolean;
+/**
+ * Extracts video ID from URL patterns.
+ */
+export declare function extractVideoId(url: string): string | null;
+/**
+ * Extracts playlist ID using pattern: [?&]list=
+ */
+export declare function extractPlaylistId(url: string): string | null;
+/**
+ * Extracts channel identifier from patterns.
+ */
+export declare function extractChannel(url: string): string | null;
+/**
+ * Converts any YouTube URL to Invidious equivalent using normalized instance URL.
+ */
+export declare function toInvidious(url: string, instance: string): string;
+//# sourceMappingURL=url-utils.d.ts.map

package/dist/url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../src/url-utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAejD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqDjE"}

package/dist/url-utils.js

@@ -0,0 +1,143 @@
+// URL Parser Helper Functions for YouTube/Invidious URLs
+/**
+ * Strips query parameters from URL (everything from "?" onward).
+ * Must be called FIRST in all URL parsing functions to handle shared
+ * YouTube links with tracking parameters (e.g., https://youtu.be/ID?si=xxx).
+ */
+export function stripQuery(url) {
+    const q = url.indexOf("?");
+    return q === -1 ? url : url.substring(0, q);
+}
+/**
+ * Tests if URL matches any YouTube URL pattern.
+ */
+export function isYouTubeUrl(url) {
+    const cleanUrl = stripQuery(url);
+    const patterns = [
+        /^https?:\/\/(www\.)?youtube\.com\/watch\?v=/,
+        /^https?:\/\/youtu\.be\//,
+        /^https?:\/\/(www\.)?youtube\.com\/shorts\//,
+        /^https?:\/\/(www\.)?youtube\.com\/live\//,
+        /^https?:\/\/(www\.)?youtube\.com\/embed\//,
+        /^https?:\/\/(www\.)?youtube\.com\/playlist/,
+        /^https?:\/\/(www\.)?youtube\.com\/channel\//,
+        /^https?:\/\/(www\.)?youtube\.com\/c\//,
+        /^https?:\/\/(www\.)?youtube\.com\/user\//,
+        /^https?:\/\/(www\.)?youtube\.com\/@/,
+    ];
+    return patterns.some((pattern) => pattern.test(cleanUrl));
+}
+/**
+ * Extracts video ID from URL patterns.
+ */
+export function extractVideoId(url) {
+    const cleanUrl = stripQuery(url);
+    // Standard watch URL: ?v=ID
+    const watchMatch = cleanUrl.match(/[?&]v=([^&]+)/);
+    if (watchMatch)
+        return watchMatch[1];
+    // Short URL: youtu.be/ID
+    const shortMatch = cleanUrl.match(/youtu\.be\/([^/?]+)/);
+    if (shortMatch)
+        return shortMatch[1];
+    // Shorts: /shorts/ID
+    const shortsMatch = cleanUrl.match(/youtube\.com\/shorts\/([^/?]+)/);
+    if (shortsMatch)
+        return shortsMatch[1];
+    // Live: /live/ID
+    const liveMatch = cleanUrl.match(/youtube\.com\/live\/([^/?]+)/);
+    if (liveMatch)
+        return liveMatch[1];
+    // Embed: /embed/ID
+    const embedMatch = cleanUrl.match(/youtube\.com\/embed\/([^/?]+)/);
+    if (embedMatch)
+        return embedMatch[1];
+    return null;
+}
+/**
+ * Extracts playlist ID using pattern: [?&]list=
+ */
+export function extractPlaylistId(url) {
+    const cleanUrl = stripQuery(url);
+    const match = cleanUrl.match(/[?&]list=([^&]+)/);
+    return match ? match[1] : null;
+}
+/**
+ * Extracts channel identifier from patterns.
+ */
+export function extractChannel(url) {
+    const cleanUrl = stripQuery(url);
+    // /channel/UCxxxx
+    const channelMatch = cleanUrl.match(/\/channel\/([^/?]+)/);
+    if (channelMatch)
+        return channelMatch[1];
+    // /c/CustomName
+    const customMatch = cleanUrl.match(/\/c\/([^/?]+)/);
+    if (customMatch)
+        return customMatch[1];
+    // /user/username
+    const userMatch = cleanUrl.match(/\/user\/([^/?]+)/);
+    if (userMatch)
+        return userMatch[1];
+    // /@handle
+    const handleMatch = cleanUrl.match(/\/@([^/?]+)/);
+    if (handleMatch)
+        return handleMatch[1];
+    return null;
+}
+/**
+ * Converts any YouTube URL to Invidious equivalent using normalized instance URL.
+ */
+export function toInvidious(url, instance) {
+    const cleanUrl = stripQuery(url);
+    const patterns = [
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/watch\?v=([^&]+)/,
+            replace: `${instance}/watch?v=$2`,
+        },
+        {
+            regex: /^https?:\/\/youtu\.be\/([^/?]+)/,
+            replace: `${instance}/watch?v=$1`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/shorts\/([^/?]+)/,
+            replace: `${instance}/watch?v=$2`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/live\/([^/?]+)/,
+            replace: `${instance}/watch?v=$2`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/embed\/([^/?]+)/,
+            replace: `${instance}/watch?v=$2`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/playlist\?list=([^&]+)/,
+            replace: `${instance}/playlist?list=$2`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/channel\/([^/?]+)/,
+            replace: `${instance}/channel/$2`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/c\/([^/?]+)/,
+            replace: `${instance}/channel/$2`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/user\/([^/?]+)/,
+            replace: `${instance}/user/$2`,
+        },
+        {
+            regex: /^https?:\/\/(www\.)?youtube\.com\/@([^/?]+)/,
+            replace: `${instance}/@$2`,
+        },
+    ];
+    for (const pattern of patterns) {
+        const match = cleanUrl.match(pattern.regex);
+        if (match) {
+            return pattern.replace;
+        }
+    }
+    return url;
+}
+//# sourceMappingURL=url-utils.js.map

package/dist/url-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.js","sourceRoot":"","sources":["../src/url-utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "distube-invidious",
+  "version": "1.0.0",
+  "author": "techtimefor",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/techtimefor/distube-invidious.git"
+  },
+  "description": "An unofficial Invidious extractor plugin for DisTube",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "directories": {
+    "lib": "src"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run typecheck",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "distube",
+    "invidious",
+    "youtube",
+    "music",
+    "bot",
+    "plugin",
+    "discord",
+    "distube-invidious",
+    "distube-invidious-plugin",
+    "invidious-plugin"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "distube": "^4.0.0 || ^5.0.0"
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}