@ziplayer/plugin 0.0.1

package/dist/YouTubePlugin.js

@@ -0,0 +1,302 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YouTubePlugin = void 0;
+const ziplayer_1 = require("ziplayer");
+const youtubei_js_1 = require("youtubei.js");
+class YouTubePlugin extends ziplayer_1.BasePlugin {
+    constructor() {
+        super();
+        this.name = "youtube";
+        this.version = "1.0.0";
+        this.ready = this.init();
+    }
+    async init() {
+        this.client = await youtubei_js_1.Innertube.create({
+            client_type: "ANDROID",
+            retrieve_player: false,
+        });
+        // Use a separate web client for search to avoid mobile parser issues
+        this.searchClient = await youtubei_js_1.Innertube.create({
+            client_type: "WEB",
+            retrieve_player: false,
+        });
+        youtubei_js_1.Log.setLevel(0);
+    }
+    canHandle(query) {
+        const q = query.toLowerCase();
+        const isUrl = q.startsWith("http://") || q.startsWith("https://");
+        return q.includes("youtube.com") || q.includes("youtu.be") || (!isUrl && q.includes("youtube"));
+    }
+    validate(url) {
+        const u = url.toLowerCase();
+        return u.includes("youtube.com") || u.includes("youtu.be");
+    }
+    async search(query, requestedBy) {
+        await this.ready;
+        if (this.validate(query)) {
+            const listId = this.extractListId(query);
+            if (listId) {
+                try {
+                    const playlist = await this.client.getPlaylist(listId);
+                    const videos = playlist?.videos || playlist?.items || [];
+                    const tracks = videos.map((v) => {
+                        const id = v.id || v.video_id || v.videoId;
+                        const title = v.title?.text ?? v.title;
+                        const duration = toSeconds(v.duration?.text ?? v.duration);
+                        const thumb = v.thumbnails?.[0]?.url || v.thumbnail?.url;
+                        const author = v.author?.name ?? v.channel?.name;
+                        const views = v.view_count ?? v.views;
+                        return {
+                            id: String(id),
+                            title,
+                            url: `https://www.youtube.com/watch?v=${id}`,
+                            duration: Number(duration) || 0,
+                            thumbnail: thumb,
+                            requestedBy,
+                            source: this.name,
+                            metadata: { author, views, playlist: listId },
+                        };
+                    });
+                    return {
+                        tracks,
+                        playlist: {
+                            name: playlist?.title || playlist?.metadata?.title || `Playlist ${listId}`,
+                            url: query,
+                            thumbnail: playlist?.thumbnails?.[0]?.url || playlist?.thumbnail?.url,
+                        },
+                    };
+                }
+                catch {
+                    const withoutList = query.replace(/[?&]list=[^&]+/, "").replace(/[?&]$/, "");
+                    return await this.search(withoutList, requestedBy);
+                }
+            }
+            const videoId = this.extractVideoId(query);
+            if (!videoId)
+                throw new Error("Invalid YouTube URL");
+            const info = await this.client.getBasicInfo(videoId);
+            const basic = info.basic_info ?? {};
+            const track = {
+                id: videoId,
+                title: basic.title ?? info.title ?? "Unknown title",
+                url: `https://www.youtube.com/watch?v=${videoId}`,
+                duration: toSeconds(basic.duration ?? info.duration) ?? 0,
+                thumbnail: basic.thumbnail?.[0]?.url || basic.thumbnail?.[basic.thumbnail?.length - 1]?.url || info.thumbnails?.[0]?.url,
+                requestedBy,
+                source: this.name,
+                metadata: {
+                    author: basic.author ?? info.author?.name,
+                    views: info.basic_info?.view_count ?? info.view_count,
+                },
+            };
+            return { tracks: [track] };
+        }
+        // Text search → return up to 10 video tracks
+        const res = await this.searchClient.search(query, {
+            type: "video",
+        });
+        const items = res?.items || res?.videos || res?.results || [];
+        const tracks = items.slice(0, 10).map((v) => {
+            const id = v.id || v.video_id || v.videoId || v.identifier;
+            const title = v.title?.text ?? v.title ?? v.headline ?? "Unknown title";
+            const duration = toSeconds(v.duration?.text ?? v.duration?.seconds ?? v.duration ?? v.length_text);
+            const thumbnail = v.thumbnails?.[0]?.url || v.thumbnail?.url || v.thumbnail?.thumbnails?.[0]?.url;
+            const author = v.author?.name ?? v.channel?.name ?? v.owner?.name;
+            const views = v.view_count ?? v.views ?? v.short_view_count ?? v.stats?.view_count;
+            const track = {
+                id: String(id),
+                title,
+                url: `https://www.youtube.com/watch?v=${id}`,
+                duration: Number(duration) || 0,
+                thumbnail,
+                requestedBy,
+                source: this.name,
+                metadata: { author, views },
+            };
+            return track;
+        });
+        return { tracks };
+    }
+    async extractPlaylist(url, requestedBy) {
+        await this.ready;
+        const listId = this.extractListId(url);
+        if (!listId)
+            return [];
+        try {
+            const playlist = await this.client.getPlaylist(listId);
+            const videos = playlist?.videos || playlist?.items || [];
+            return videos.map((v) => {
+                const id = v.id || v.video_id || v.videoId;
+                const title = v.title?.text ?? v.title;
+                const duration = toSeconds(v.duration?.text ?? v.duration);
+                const thumb = v.thumbnails?.[0]?.url || v.thumbnail?.url;
+                const author = v.author?.name ?? v.channel?.name;
+                const views = v.view_count ?? v.views;
+                const track = {
+                    id: String(id),
+                    title,
+                    url: `https://www.youtube.com/watch?v=${id}`,
+                    duration: Number(duration) || 0,
+                    thumbnail: thumb,
+                    requestedBy,
+                    source: this.name,
+                    metadata: { author, views, playlist: listId },
+                };
+                return track;
+            });
+        }
+        catch {
+            // If playlist fetch fails, return empty to keep optional contract intact
+            return [];
+        }
+    }
+    async getStream(track) {
+        await this.ready;
+        const id = this.extractVideoId(track.url) || track.id;
+        if (!id)
+            throw new Error("Invalid track id");
+        try {
+            const stream = await this.client.download(id, {
+                type: "audio",
+                quality: "best",
+            });
+            return {
+                stream,
+                type: "arbitrary",
+                metadata: track.metadata,
+            };
+        }
+        catch (e) {
+            try {
+                const info = await this.client.getBasicInfo(id);
+                // Prefer m4a audio-only formats first
+                let format = info?.chooseFormat?.({
+                    type: "audio",
+                    quality: "best",
+                });
+                if (!format && info?.formats?.length) {
+                    const audioOnly = info.formats.filter((f) => f.mime_type?.includes("audio"));
+                    audioOnly.sort((a, b) => (b.bitrate || 0) - (a.bitrate || 0));
+                    format = audioOnly[0];
+                }
+                if (!format)
+                    throw new Error("No audio format available");
+                let url = undefined;
+                if (typeof format.decipher === "function") {
+                    url = format.decipher(this.client.session.player);
+                }
+                if (!url)
+                    url = format.url;
+                if (!url)
+                    throw new Error("No valid URL to decipher");
+                const res = await fetch(url);
+                if (!res.ok || !res.body) {
+                    throw new Error(`HTTP ${res.status}`);
+                }
+                return {
+                    stream: res.body,
+                    type: "arbitrary",
+                    metadata: {
+                        ...track.metadata,
+                        itag: format.itag,
+                        mime: format.mime_type,
+                    },
+                };
+            }
+            catch (inner) {
+                throw new Error(`Failed to get YouTube stream: ${inner?.message || inner}`);
+            }
+        }
+    }
+    async getRelatedTracks(trackURL, opts = {}) {
+        await this.ready;
+        const videoId = this.extractVideoId(trackURL);
+        const info = await await this.searchClient.getInfo(videoId);
+        const related = info?.watch_next_feed || [];
+        const offset = opts.offset ?? 0;
+        const limit = opts.limit ?? 5;
+        const relatedfilter = related.filter((tr) => !(opts?.history ?? []).some((t) => t.url === tr.url));
+        return relatedfilter.slice(offset, offset + limit).map((v) => {
+            const id = v.id || v.video_id || v.videoId || v.content_id;
+            const videometa = v?.metadata;
+            return {
+                id: String(id),
+                title: videometa.title.text ?? "Unknown title",
+                url: `https://www.youtube.com/watch?v=${id}`,
+                duration: Number(v.length_seconds || toSeconds(v.duration)) || 0,
+                thumbnail: v.thumbnails?.[0]?.url || v.thumbnail?.url || v.content_image?.image?.[0]?.url,
+                requestedBy: "auto",
+                source: this.name,
+                metadata: { author: v.author, views: v.view_count },
+            };
+        });
+    }
+    async getFallback(track) {
+        try {
+            const result = await this.search(track.title, track.requestedBy);
+            const first = result.tracks[0];
+            if (!first)
+                throw new Error("No fallback track found");
+            return await this.getStream(first);
+        }
+        catch (e) {
+            throw new Error(`YouTube fallback search failed: ${e?.message || e}`);
+        }
+    }
+    extractVideoId(input) {
+        try {
+            const u = new URL(input);
+            if (u.hostname.includes("youtu.be")) {
+                return u.pathname.split("/").filter(Boolean)[0] || null;
+            }
+            if (u.hostname.includes("youtube.com")) {
+                // watch?v=, shorts/, embed/
+                if (u.searchParams.get("v"))
+                    return u.searchParams.get("v");
+                const path = u.pathname;
+                if (path.startsWith("/shorts/"))
+                    return path.replace("/shorts/", "");
+                if (path.startsWith("/embed/"))
+                    return path.replace("/embed/", "");
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    extractListId(input) {
+        try {
+            const u = new URL(input);
+            return u.searchParams.get("list");
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.YouTubePlugin = YouTubePlugin;
+function toSeconds(d) {
+    if (typeof d === "number")
+        return d;
+    if (typeof d === "string") {
+        // mm:ss or hh:mm:ss
+        const parts = d.split(":").map(Number);
+        if (parts.some((n) => Number.isNaN(n)))
+            return undefined;
+        if (parts.length === 3)
+            return parts[0] * 3600 + parts[1] * 60 + parts[2];
+        if (parts.length === 2)
+            return parts[0] * 60 + parts[1];
+        const asNum = Number(d);
+        return Number.isFinite(asNum) ? asNum : undefined;
+    }
+    if (d && typeof d === "object") {
+        if (typeof d.seconds === "number")
+            return d.seconds;
+        if (typeof d.milliseconds === "number")
+            return Math.floor(d.milliseconds / 1000);
+    }
+    return undefined;
+}
+//# sourceMappingURL=YouTubePlugin.js.map

package/dist/YouTubePlugin.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { YouTubePlugin } from "./YouTubePlugin";
+export { SoundCloudPlugin } from "./SoundCloudPlugin";
+export { SpotifyPlugin } from "./SpotifyPlugin";
+//# 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,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotifyPlugin = exports.SoundCloudPlugin = exports.YouTubePlugin = void 0;
+var YouTubePlugin_1 = require("./YouTubePlugin");
+Object.defineProperty(exports, "YouTubePlugin", { enumerable: true, get: function () { return YouTubePlugin_1.YouTubePlugin; } });
+var SoundCloudPlugin_1 = require("./SoundCloudPlugin");
+Object.defineProperty(exports, "SoundCloudPlugin", { enumerable: true, get: function () { return SoundCloudPlugin_1.SoundCloudPlugin; } });
+var SpotifyPlugin_1 = require("./SpotifyPlugin");
+Object.defineProperty(exports, "SpotifyPlugin", { enumerable: true, get: function () { return SpotifyPlugin_1.SpotifyPlugin; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/package.json

@@ -0,0 +1,21 @@
+{
+	"name": "@ziplayer/plugin",
+	"version": "0.0.1",
+	"description": "A modular Discord voice player with plugin system",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"prepare": "npm run build"
+	},
+	"dependencies": {
+		"@zibot/scdl": "^0.0.5",
+		"youtubei.js": "^15.0.1",
+		"ziplayer": "^0.0.1"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"typescript": "^5.0.0"
+	}
+}

package/src/SoundCloudPlugin.ts

@@ -0,0 +1,191 @@
+import { BasePlugin, Track, SearchResult, StreamInfo } from "ziplayer";
+
+const SoundCloud = require("@zibot/scdl");
+
+export class SoundCloudPlugin extends BasePlugin {
+  name = "soundcloud";
+  version = "1.0.0";
+  private client: any;
+  private ready: Promise<void>;
+
+  constructor() {
+    super();
+    this.ready = this.init();
+  }
+
+  private async init(): Promise<void> {
+    this.client = new SoundCloud({ init: false });
+    await this.client.init();
+  }
+
+  canHandle(query: string): boolean {
+    return (
+      query.includes("soundcloud.com") ||
+      (!query.startsWith("http") && !query.includes("youtube"))
+    );
+  }
+
+  validate(url: string): boolean {
+    return url.includes("soundcloud.com");
+  }
+
+  async search(query: string, requestedBy: string): Promise<SearchResult> {
+    await this.ready;
+
+    try {
+      if (query.includes("soundcloud.com")) {
+        try {
+          const info = await this.client.getTrackDetails(query);
+          const track: Track = {
+            id: info.id.toString(),
+            title: info.title,
+            url: info.permalink_url || query,
+            duration: info.duration,
+            thumbnail: info.artwork_url,
+            requestedBy,
+            source: this.name,
+            metadata: {
+              author: info.user?.username,
+              plays: info.playback_count,
+            },
+          };
+          return { tracks: [track] };
+        } catch {
+          const playlist = await this.client.getPlaylistDetails(query);
+          const tracks: Track[] = playlist.tracks.map((t: any) => ({
+            id: t.id.toString(),
+            title: t.title,
+            url: t.permalink_url,
+            duration: t.duration,
+            thumbnail: t.artwork_url || playlist.artwork_url,
+            requestedBy,
+            source: this.name,
+            metadata: {
+              author: t.user?.username,
+              plays: t.playback_count,
+              playlist: playlist.id?.toString(),
+            },
+          }));
+
+          return {
+            tracks,
+            playlist: {
+              name: playlist.title,
+              url: playlist.permalink_url || query,
+              thumbnail: playlist.artwork_url,
+            },
+          };
+        }
+      }
+
+      const results = await this.client.searchTracks({ query, limit: 15 });
+      const tracks: Track[] = results.slice(0, 10).map((track: any) => ({
+        id: track.id.toString(),
+        title: track.title,
+        url: track.permalink_url,
+        duration: track.duration,
+        thumbnail: track.artwork_url,
+        requestedBy,
+        source: this.name,
+        metadata: {
+          author: track.user?.username,
+          plays: track.playback_count,
+        },
+      }));
+
+      return { tracks };
+    } catch (error: any) {
+      throw new Error(`SoundCloud search failed: ${error?.message}`);
+    }
+  }
+
+  async getStream(track: Track): Promise<StreamInfo> {
+    await this.ready;
+
+    try {
+      const stream = await this.client.downloadTrack(track.url);
+      if (!stream) {
+        throw new Error("SoundCloud download returned null");
+      }
+
+      return {
+        stream,
+        type: "arbitrary",
+        metadata: track.metadata,
+      };
+    } catch (error: any) {
+      throw new Error(`Failed to get SoundCloud stream: ${error.message}`);
+    }
+  }
+
+  async getRelatedTracks(
+    trackURL: string | number,
+    opts: { limit?: number; offset?: number; history?: Track[] } = {}
+  ): Promise<Track[]> {
+    await this.ready;
+    try {
+      const tracks = await this.client.getRelatedTracks(trackURL, {
+        limit: 30,
+        filter: "tracks",
+      });
+
+      if (!tracks || !tracks?.length) {
+        return [];
+      }
+      const relatedfilter = tracks.filter(
+        (tr: any) =>
+          !(opts?.history ?? []).some((t) => t.url === tr.permalink_url)
+      );
+
+      const related = relatedfilter.slice(0, opts.limit || 1);
+
+      return related.map((t: any) => ({
+        id: t.id.toString(),
+        title: t.title,
+        url: t.permalink_url,
+        duration: t.duration,
+        thumbnail: t.artwork_url,
+        requestedBy: "auto",
+        source: this.name,
+        metadata: {
+          author: t.user?.username,
+          plays: t.playback_count,
+        },
+      }));
+    } catch {
+      return [];
+    }
+  }
+
+  async getFallback(track: Track): Promise<StreamInfo> {
+    const trackfall = await this.search(track.title, track.requestedBy);
+    const fallbackTrack = trackfall.tracks?.[0];
+    if (!fallbackTrack) {
+      throw new Error(`No fallback track found for ${track.title}`);
+    }
+    return await this.getStream(fallbackTrack);
+  }
+
+  async extractPlaylist(url: string, requestedBy: string): Promise<Track[]> {
+    await this.ready;
+    try {
+      const playlist = await this.client.getPlaylistDetails(url);
+      return playlist.tracks.map((t: any) => ({
+        id: t.id.toString(),
+        title: t.title,
+        url: t.permalink_url,
+        duration: t.duration,
+        thumbnail: t.artwork_url || playlist.artwork_url,
+        requestedBy,
+        source: this.name,
+        metadata: {
+          author: t.user?.username,
+          plays: t.playback_count,
+          playlist: playlist.id?.toString(),
+        },
+      }));
+    } catch {
+      return [];
+    }
+  }
+}