ziplayer 0.0.1

package/README.md

@@ -0,0 +1,150 @@
+# ziplayer
+
+A modular Discord voice player with plugin system for @discordjs/voice.
+
+## Features
+
+- 🎵 **Plugin-based architecture** - Easy to extend with new sources
+- 🎶 **Multiple source support** - YouTube, SoundCloud, Spotify (with fallback)
+- 🔊 **Queue management** - Add, remove, shuffle, clear
+- 🎚️ **Volume control** - 0-200% volume range
+- ⏯️ **Playback control** - Play, pause, resume, stop, skip
+- 🔁 **Auto play** - Automatically replay the queue when it ends
+- 📊 **Progress bar** - Display playback progress with customizable icons
+- 🔔 **Event-driven** - Rich event system for all player actions
+- 🎭 **Multi-guild support** - Manage players across multiple Discord servers
+- 🗃️ **User data** - Attach custom data to each player for later use
+
+## Installation
+
+```bash
+npm install ziplayer @ziplayer/plugin @discordjs/voice discord.js
+```
+
+## Quick Start
+
+```typescript
+import { PlayerManager } from "ziplayer";
+import { SoundCloudPlugin, YouTubePlugin, SpotifyPlugin } from "@ziplayer/plugin";
+
+const soundcloudPlugin = new SoundCloudPlugin();
+const youtubePlugin = new YouTubePlugin();
+const spotifyPlugin = new SpotifyPlugin();
+
+// Create player manager with YouTube and SoundCloud plugins
+const manager = new PlayerManager({
+	plugins: [soundcloudPlugin, youtubePlugin, spotifyPlugin],
+});
+
+// Create player
+const player = manager.create(guildId, {
+	leaveOnEnd: true,
+	leaveTimeout: 30000,
+	userdata: { channel: textChannel }, // store channel for events
+});
+
+// Connect and play
+await player.connect(voiceChannel);
+await player.play("Never Gonna Give You Up", userId);
+
+// Play a full YouTube playlist
+await player.play("https://www.youtube.com/playlist?list=PL123", userId);
+
+// Enable autoplay
+player.queue.autoPlay(true);
+
+// Play a full SoundCloud playlist
+await player.play("https://soundcloud.com/artist/sets/playlist", userId);
+
+// Events
+player.on("willPlay", (track) => {
+	console.log(`Up next: ${track.title}`);
+});
+player.on("trackStart", (track) => {
+	console.log(`Now playing: ${track.title}`);
+	player.userdata?.channel?.send(`Now playing: ${track.title}`);
+});
+```
+
+## Available Plugins
+
+### YouTubePlugin
+
+Supports YouTube videos and playlists.
+
+```typescript
+import { YouTubePlugin } from "@ziplayer/plugin";
+const youtube = new YouTubePlugin();
+```
+
+### SoundCloudPlugin
+
+Supports SoundCloud tracks and playlists.
+
+```typescript
+import { SoundCloudPlugin } from "@ziplayer/plugin";
+const soundcloud = new SoundCloudPlugin();
+```
+
+### SpotifyPlugin
+
+Supports Spotify tracks, albums, and playlists (requires fallback plugin for streaming).
+
+```typescript
+import { SpotifyPlugin } from "@ziplayer/plugin";
+const spotify = new SpotifyPlugin();
+```
+
+## Creating Custom Plugins
+
+```typescript
+import { BasePlugin, Track, SearchResult, StreamInfo } from "@zibot/player";
+
+export class MyPlugin extends BasePlugin {
+	name = "myplugin";
+	version = "1.0.0";
+
+	canHandle(query: string): boolean {
+		return query.includes("mysite.com");
+	}
+
+	async search(query: string, requestedBy: string): Promise<SearchResult> {
+		// Implement search logic
+		return {
+			tracks: [
+				/* ... */
+			],
+		};
+	}
+
+	async getStream(track: Track): Promise<StreamInfo> {
+		// Return audio stream
+		return { stream, type: "arbitrary" };
+	}
+}
+```
+
+## Events
+
+All player events are forwarded through the PlayerManager:
+
+- `trackStart` - When a track starts playing
+- `willPlay` - Before a track begins playing
+- `trackEnd` - When a track finishes
+- `queueEnd` - When the queue is empty
+- `playerError` - When an error occurs
+- `queueAdd` - When a track is added
+- `volumeChange` - When volume changes
+- And more...
+
+## Progress Bar
+
+Display the current playback progress with `getProgressBar`:
+
+```typescript
+console.log(player.getProgressBar({ size: 30, barChar: "-", progressChar: "🔘" }));
+```
+
+## License
+
+MIT License

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { PlayerManager } from "./structures/PlayerManager";
+export { Player } from "./structures/Player";
+export { Queue } from "./structures/Queue";
+export { PlayerManager } from "./structures/PlayerManager";
+export * from "./types";
+export * from "./plugins";
+export default PlayerManager;
+//# 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,4BAA4B,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAG1B,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlayerManager = exports.Queue = exports.Player = void 0;
+const PlayerManager_1 = require("./structures/PlayerManager");
+var Player_1 = require("./structures/Player");
+Object.defineProperty(exports, "Player", { enumerable: true, get: function () { return Player_1.Player; } });
+var Queue_1 = require("./structures/Queue");
+Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return Queue_1.Queue; } });
+var PlayerManager_2 = require("./structures/PlayerManager");
+Object.defineProperty(exports, "PlayerManager", { enumerable: true, get: function () { return PlayerManager_2.PlayerManager; } });
+__exportStar(require("./types"), exports);
+__exportStar(require("./plugins"), exports);
+// Default export
+exports.default = PlayerManager_1.PlayerManager;
+//# 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,8DAA2D;AAE3D,8CAA6C;AAApC,gGAAA,MAAM,OAAA;AACf,4CAA2C;AAAlC,8FAAA,KAAK,OAAA;AACd,4DAA2D;AAAlD,8GAAA,aAAa,OAAA;AACtB,0CAAwB;AACxB,4CAA0B;AAE1B,iBAAiB;AACjB,kBAAe,6BAAa,CAAC"}

package/dist/plugins/BasePlugin.d.ts

@@ -0,0 +1,17 @@
+import { SourcePlugin, Track, SearchResult, StreamInfo } from "../types";
+export declare abstract class BasePlugin implements SourcePlugin {
+    abstract name: string;
+    abstract version: string;
+    abstract canHandle(query: string): boolean;
+    abstract search(query: string, requestedBy: string): Promise<SearchResult>;
+    abstract getStream(track: Track): Promise<StreamInfo>;
+    getFallback?(track: Track): Promise<StreamInfo>;
+    getRelatedTracks?(trackURL: string, opts?: {
+        limit?: number;
+        offset?: number;
+        history?: Track[];
+    }): Promise<Track[]>;
+    validate?(url: string): boolean;
+    extractPlaylist?(url: string, requestedBy: string): Promise<Track[]>;
+}
+//# sourceMappingURL=BasePlugin.d.ts.map

package/dist/plugins/BasePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/BasePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEzE,8BAAsB,UAAW,YAAW,YAAY;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAC1C,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1E,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAErD,WAAW,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/C,gBAAgB,CAAC,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;KAAE,GAC5D,OAAO,CAAC,KAAK,EAAE,CAAC;IAInB,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/B,eAAe,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAGrE"}

package/dist/plugins/BasePlugin.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePlugin = void 0;
+class BasePlugin {
+    getFallback(track) {
+        throw new Error("getFallback not implemented");
+    }
+    getRelatedTracks(trackURL, opts) {
+        return Promise.resolve([]);
+    }
+    validate(url) {
+        return this.canHandle(url);
+    }
+    extractPlaylist(url, requestedBy) {
+        return Promise.resolve([]);
+    }
+}
+exports.BasePlugin = BasePlugin;
+//# sourceMappingURL=BasePlugin.js.map

package/dist/plugins/BasePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlugin.js","sourceRoot":"","sources":["../../src/plugins/BasePlugin.ts"],"names":[],"mappings":";;;AAEA,MAAsB,UAAU;IAQ9B,WAAW,CAAE,KAAY;QACvB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,gBAAgB,CACd,QAAgB,EAChB,IAA6D;QAE7D,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAE,GAAW;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,eAAe,CAAE,GAAW,EAAE,WAAmB;QAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;CACF;AA1BD,gCA0BC"}

package/dist/plugins/SoundCloudPlugin.d.ts

@@ -0,0 +1,22 @@
+import { BasePlugin } from "./BasePlugin";
+import { Track, SearchResult, StreamInfo } from "../types";
+export declare class SoundCloudPlugin extends BasePlugin {
+    name: string;
+    version: string;
+    private client;
+    private ready;
+    constructor();
+    private init;
+    canHandle(query: string): boolean;
+    validate(url: string): boolean;
+    search(query: string, requestedBy: string): Promise<SearchResult>;
+    getStream(track: Track): Promise<StreamInfo>;
+    getRelatedTracks(trackURL: string | number, opts?: {
+        limit?: number;
+        offset?: number;
+        history?: Track[];
+    }): Promise<Track[]>;
+    getFallback(track: Track): Promise<StreamInfo>;
+    extractPlaylist(url: string, requestedBy: string): Promise<Track[]>;
+}
+//# sourceMappingURL=SoundCloudPlugin.d.ts.map

package/dist/plugins/SoundCloudPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoundCloudPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SoundCloudPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3D,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,IAAI,SAAgB;IACpB,OAAO,SAAW;IAClB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAgB;;YAOf,IAAI;IAKlB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsEjE,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB5C,gBAAgB,CACpB,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;KAAO,GAChE,OAAO,CAAC,KAAK,EAAE,CAAC;IAoCb,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAS9C,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAsB1E"}

package/dist/plugins/SoundCloudPlugin.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoundCloudPlugin = void 0;
+const BasePlugin_1 = require("./BasePlugin");
+const SoundCloud = require("@zibot/scdl");
+class SoundCloudPlugin extends BasePlugin_1.BasePlugin {
+    constructor() {
+        super();
+        this.name = "soundcloud";
+        this.version = "1.0.0";
+        this.ready = this.init();
+    }
+    async init() {
+        this.client = new SoundCloud({ init: false });
+        await this.client.init();
+    }
+    canHandle(query) {
+        return (query.includes("soundcloud.com") ||
+            (!query.startsWith("http") && !query.includes("youtube")));
+    }
+    validate(url) {
+        return url.includes("soundcloud.com");
+    }
+    async search(query, requestedBy) {
+        await this.ready;
+        try {
+            if (query.includes("soundcloud.com")) {
+                try {
+                    const info = await this.client.getTrackDetails(query);
+                    const 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 = playlist.tracks.map((t) => ({
+                        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 = results.slice(0, 10).map((track) => ({
+                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) {
+            throw new Error(`SoundCloud search failed: ${error?.message}`);
+        }
+    }
+    async getStream(track) {
+        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) {
+            throw new Error(`Failed to get SoundCloud stream: ${error.message}`);
+        }
+    }
+    async getRelatedTracks(trackURL, opts = {}) {
+        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) => !(opts?.history ?? []).some((t) => t.url === tr.permalink_url));
+            const related = relatedfilter.slice(0, opts.limit || 1);
+            return related.map((t) => ({
+                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) {
+        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, requestedBy) {
+        await this.ready;
+        try {
+            const playlist = await this.client.getPlaylistDetails(url);
+            return playlist.tracks.map((t) => ({
+                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 [];
+        }
+    }
+}
+exports.SoundCloudPlugin = SoundCloudPlugin;
+//# sourceMappingURL=SoundCloudPlugin.js.map

package/dist/plugins/SoundCloudPlugin.js.map

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

package/dist/plugins/SpotifyPlugin.d.ts

@@ -0,0 +1,26 @@
+import { BasePlugin } from "./BasePlugin";
+import { Track, SearchResult, StreamInfo } from "../types";
+/**
+ * This minimal Spotify plugin:
+ * - Parses Spotify URLs/URIs (track/playlist/album)
+ * - Uses Spotify's public oEmbed endpoint to fetch *display metadata* (no auth, no SDK)
+ * - Does NOT provide audio streams (player is expected to redirect/fallback upstream)
+ * - Does NOT expand playlists/albums (no SDK; oEmbed doesn't enumerate items)
+ */
+export declare class SpotifyPlugin extends BasePlugin {
+    name: string;
+    version: string;
+    canHandle(query: string): boolean;
+    validate(url: string): boolean;
+    search(query: string, requestedBy: string): Promise<SearchResult>;
+    extractPlaylist(_input: string, _requestedBy: string): Promise<Track[]>;
+    extractAlbum(_input: string, _requestedBy: string): Promise<Track[]>;
+    getStream(_track: Track): Promise<StreamInfo>;
+    private identifyKind;
+    private extractId;
+    private buildTrackFromUrlOrUri;
+    private buildHeaderItem;
+    private toShareUrl;
+    private fetchOEmbed;
+}
+//# sourceMappingURL=SpotifyPlugin.d.ts.map

package/dist/plugins/SpotifyPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpotifyPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SpotifyPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3D;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,IAAI,SAAa;IACjB,OAAO,SAAW;IAElB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBjE,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,KAAK,EAAE,CAAC;IAIb,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIpE,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAInD,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,SAAS;YAeH,sBAAsB;YA6BtB,eAAe;IA8B7B,OAAO,CAAC,UAAU;YAeJ,WAAW;CAkB1B"}

package/dist/plugins/SpotifyPlugin.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotifyPlugin = void 0;
+const BasePlugin_1 = require("./BasePlugin");
+/**
+ * This minimal Spotify plugin:
+ * - Parses Spotify URLs/URIs (track/playlist/album)
+ * - Uses Spotify's public oEmbed endpoint to fetch *display metadata* (no auth, no SDK)
+ * - Does NOT provide audio streams (player is expected to redirect/fallback upstream)
+ * - Does NOT expand playlists/albums (no SDK; oEmbed doesn't enumerate items)
+ */
+class SpotifyPlugin extends BasePlugin_1.BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.name = "spotify";
+        this.version = "1.1.0";
+    }
+    canHandle(query) {
+        const q = query.toLowerCase().trim();
+        if (q.startsWith("spotify:"))
+            return true;
+        try {
+            const u = new URL(q);
+            return u.hostname.includes("open.spotify.com");
+        }
+        catch {
+            return false;
+        }
+    }
+    validate(url) {
+        if (url.startsWith("spotify:"))
+            return true;
+        try {
+            const u = new URL(url);
+            return u.hostname.includes("open.spotify.com");
+        }
+        catch {
+            return false;
+        }
+    }
+    async search(query, requestedBy) {
+        if (!this.validate(query)) {
+            return { tracks: [] };
+        }
+        const kind = this.identifyKind(query);
+        if (kind === "track") {
+            const t = await this.buildTrackFromUrlOrUri(query, requestedBy);
+            return { tracks: t ? [t] : [] };
+        }
+        if (kind === "playlist") {
+            const t = await this.buildHeaderItem(query, requestedBy, "playlist");
+            return { tracks: t ? [t] : [] };
+        }
+        if (kind === "album") {
+            const t = await this.buildHeaderItem(query, requestedBy, "album");
+            return { tracks: t ? [t] : [] };
+        }
+        return { tracks: [] };
+    }
+    async extractPlaylist(_input, _requestedBy) {
+        return [];
+    }
+    async extractAlbum(_input, _requestedBy) {
+        return [];
+    }
+    async getStream(_track) {
+        throw new Error("Spotify streaming is not supported by this plugin");
+    }
+    identifyKind(input) {
+        if (input.startsWith("spotify:")) {
+            if (input.includes(":track:"))
+                return "track";
+            if (input.includes(":playlist:"))
+                return "playlist";
+            if (input.includes(":album:"))
+                return "album";
+            return "unknown";
+        }
+        try {
+            const u = new URL(input);
+            const parts = u.pathname.split("/").filter(Boolean);
+            const kind = parts[0];
+            if (kind === "track")
+                return "track";
+            if (kind === "playlist")
+                return "playlist";
+            if (kind === "album")
+                return "album";
+            return "unknown";
+        }
+        catch {
+            return "unknown";
+        }
+    }
+    extractId(input) {
+        if (!input)
+            return null;
+        if (input.startsWith("spotify:")) {
+            const parts = input.split(":");
+            return parts[2] || null;
+        }
+        try {
+            const u = new URL(input);
+            const parts = u.pathname.split("/").filter(Boolean);
+            return parts[1] || null; // /track/<id>
+        }
+        catch {
+            return null;
+        }
+    }
+    async buildTrackFromUrlOrUri(input, requestedBy) {
+        const id = this.extractId(input);
+        if (!id)
+            return null;
+        const url = this.toShareUrl(input, "track", id);
+        const meta = await this.fetchOEmbed(url).catch(() => undefined);
+        const title = meta?.title || `Spotify Track ${id}`;
+        const thumbnail = meta?.thumbnail_url;
+        const track = {
+            id,
+            title,
+            url,
+            duration: 0,
+            thumbnail,
+            requestedBy,
+            source: this.name,
+            metadata: {
+                author: meta?.author_name,
+                provider: meta?.provider_name,
+                spotify_id: id,
+            },
+        };
+        return track;
+    }
+    async buildHeaderItem(input, requestedBy, kind) {
+        const id = this.extractId(input);
+        if (!id)
+            return null;
+        const url = this.toShareUrl(input, kind, id);
+        const meta = await this.fetchOEmbed(url).catch(() => undefined);
+        const title = meta?.title || `Spotify ${kind} ${id}`;
+        const thumbnail = meta?.thumbnail_url;
+        return {
+            id,
+            title,
+            url,
+            duration: 0,
+            thumbnail,
+            requestedBy,
+            source: this.name,
+            metadata: {
+                author: meta?.author_name,
+                provider: meta?.provider_name,
+                spotify_id: id,
+                kind,
+            },
+        };
+    }
+    toShareUrl(input, expectedKind, id) {
+        if (input.startsWith("spotify:")) {
+            return `https://open.spotify.com/${expectedKind}/${id}`;
+        }
+        try {
+            const u = new URL(input);
+            const parts = u.pathname.split("/").filter(Boolean);
+            const kind = parts[0] || expectedKind;
+            const realId = parts[1] || id;
+            return `https://open.spotify.com/${kind}/${realId}`;
+        }
+        catch {
+            return `https://open.spotify.com/${expectedKind}/${id}`;
+        }
+    }
+    async fetchOEmbed(pageUrl) {
+        const endpoint = `https://open.spotify.com/oembed?url=${encodeURIComponent(pageUrl)}`;
+        const res = await fetch(endpoint);
+        if (!res.ok)
+            throw new Error(`oEmbed HTTP ${res.status}`);
+        return res.json();
+    }
+}
+exports.SpotifyPlugin = SpotifyPlugin;
+//# sourceMappingURL=SpotifyPlugin.js.map