ziplayer 0.1.3 → 0.1.4

package/README.md

@@ -1,212 +1,212 @@
-<img width="1175" height="305" alt="logo" src="https://github.com/user-attachments/assets/d4db4892-9c3d-4314-9228-701629555380" />
-
-# 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
-- 🔂 **Loop control** - Repeat a single track or the entire queue
-- 📊 **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
-- 🔌 **Lavalink** - Support manage an external Lavalink JVM node
-
-## Installation
-
-```bash
-npm install ziplayer @ziplayer/plugin @ziplayer/extension @discordjs/voice discord.js
-```
-
-## Quick Start
-
-```typescript
-import { PlayerManager } from "ziplayer";
-import { SoundCloudPlugin, YouTubePlugin, SpotifyPlugin } from "@ziplayer/plugin";
-import { voiceExt } from "@ziplayer/extension";
-
-const manager = new PlayerManager({
-	plugins: [new SoundCloudPlugin(), new YouTubePlugin(), new SpotifyPlugin()],
-	extensions: [
-		new voiceExt(null, {
-			lang: "vi-VN",
-			minimalVoiceMessageDuration: 1,
-			postSilenceDelayMs: 2000,
-		}),
-	],
-});
-
-// Create player
-const player = manager.create(guildId, {
-	leaveOnEnd: true,
-	leaveTimeout: 30000,
-	userdata: { channel: textChannel }, // store channel for events
-	// Choose extensions for this player (by name or instances)
-	extensions: ["voiceExt"],
-});
-
-// 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", (player, track) => {
-	console.log(`Up next: ${track.title}`);
-});
-player.on("trackStart", (player, track) => {
-	console.log(`Now playing: ${track.title}`);
-	player.userdata?.channel?.send(`Now playing: ${track.title}`);
-});
-
-// Receive transcripts
-manager.on("voiceCreate", (player, evt) => {
-	console.log(`User ${evt.userId} said: ${evt.content}`);
-});
-```
-
-### TTS (Interrupt Mode)
-
-Play short text-to-speech messages without losing music progress. The player pauses music, plays TTS on a dedicated AudioPlayer,
-then resumes.
-
-- Requirements: `@ziplayer/plugin` with `TTSPlugin` installed and registered in `PlayerManager`.
-
-```ts
-import { PlayerManager } from "ziplayer";
-import { TTSPlugin, YouTubePlugin, SoundCloudPlugin, SpotifyPlugin } from "@ziplayer/plugin";
-
-const manager = new PlayerManager({
-	plugins: [new TTSPlugin({ defaultLang: "vi" }), new YouTubePlugin(), new SoundCloudPlugin(), new SpotifyPlugin()],
-});
-
-// Create a player with TTS interrupt enabled
-const player = manager.create(guildId, {
-	tts: {
-		createPlayer: true, // pre-create the internal TTS AudioPlayer
-		interrupt: true, // pause music, swap to TTS, then resume
-		volume: 1, // 1 => 100%
-	},
-});
-
-await player.connect(voiceChannel);
-
-// Trigger TTS by playing a TTS query (depends on your TTS plugin)
-await player.play("tts: xin chào mọi người", userId);
-
-// Listen to TTS lifecycle events
-manager.on("ttsStart", (plr, { track }) => console.log("TTS start", track?.title));
-manager.on("ttsEnd", (plr) => console.log("TTS end"));
-```
-
-Notes
-
-- The detection uses track.source that includes "tts" or query starting with `tts:`.
-- If you need more control, call `player.interruptWithTTSTrack(track)` after building a TTS track via your plugin.
-- For CPU-heavy TTS generation, consider offloading to `worker_threads` or a separate process and pass a stream/buffer to the
-  plugin.
-
-### Player Lifecycle Overview
-
-```
-PlayerManager.create(guild, opts)
-        │
-        ▼
-[Player constructor]
- - setup event listeners
- - freeze ExtensionContext { player, manager }
- - register plugins
-        │
-        ▼
-attachExtension(ext)
- - set ext.player
- - ext.onRegister?(context)
- - ext.active?(...) → false ⇒ detach
-        │
-        ▼
-player.play(query, by)
- - runBeforePlayHooks → extensions may mutate query/tracks/start Lavalink
- - resolve track list / queue updates / TTS interrupt check
- - extensionsProvideStream → extension stream overrides plugin pipeline
- - plugin.getStream / getFallback
-        │
-        ▼
-Audio playback
- - trackStart / queue events emitted
- - runAfterPlayHooks with final outcome
-        │
-        ▼
-player.destroy()
- - stop audio/voice / clear queue & plugins
- - ext.onDestroy?(context) for each attached extension
- - emit playerDestroy & cleanup references
-```
-
-This diagram shows how custom extensions (voice, lyrics, Lavalink, etc.) integrate across the full player lifecycle and where
-their hooks are invoked.
-
-### Lavalink Process
-
-Use `lavalinkExt` when you need ZiPlayer to manage an external Lavalink JVM node. The extension starts, stops, and optionally
-restarts the Lavalink jar and forwards lifecycle events through the manager/player.
-
-```ts
-import { PlayerManager } from "ziplayer";
-import { lavalinkExt } from "@ziplayer/extension";
-
-const lavalink = new lavalinkExt(null, {
-	nodes: [
-		{
-			identifier: "locallavalink",
-			password: "youshallnotpass",
-			host: "localhost",
-			port: 2333,
-			secure: false,
-		},
-	],
-	client: client,
-	searchPrefix: "scsearch",
-});
-
-const manager = new PlayerManager({
-	extensions: ["lavalinkExt"],
-});
-```
-
-## 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...
-
-## Useful Links
-
-[Example](https://github.com/ZiProject/ZiPlayer/tree/main/examples) | [Repo](https://github.com/ZiProject/ZiPlayer) |
-[Package](https://www.npmjs.com/package/ziplayer) | [Plugin](https://www.npmjs.com/package/@ziplayer/plugin) |
-[Extension](https://www.npmjs.com/package/@ziplayer/extension)
-
-## License
-
-MIT License
+<img width="1175" height="305" alt="logo" src="https://raw.githubusercontent.com/ZiProject/ZiPlayer/refs/heads/main/publish/logo.png" />
+
+# 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
+- 🔂 **Loop control** - Repeat a single track or the entire queue
+- 📊 **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
+- 🔌 **Lavalink** - Support manage an external Lavalink JVM node
+
+## Installation
+
+```bash
+npm install ziplayer @ziplayer/plugin @ziplayer/extension @discordjs/voice discord.js
+```
+
+## Quick Start
+
+```typescript
+import { PlayerManager } from "ziplayer";
+import { SoundCloudPlugin, YouTubePlugin, SpotifyPlugin } from "@ziplayer/plugin";
+import { voiceExt } from "@ziplayer/extension";
+
+const manager = new PlayerManager({
+	plugins: [new SoundCloudPlugin(), new YouTubePlugin(), new SpotifyPlugin()],
+	extensions: [
+		new voiceExt(null, {
+			lang: "vi-VN",
+			minimalVoiceMessageDuration: 1,
+			postSilenceDelayMs: 2000,
+		}),
+	],
+});
+
+// Create player
+const player = await manager.create(guildId, {
+	leaveOnEnd: true,
+	leaveTimeout: 30000,
+	userdata: { channel: textChannel }, // store channel for events
+	// Choose extensions for this player (by name or instances)
+	extensions: ["voiceExt"],
+});
+
+// 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", (player, track) => {
+	console.log(`Up next: ${track.title}`);
+});
+player.on("trackStart", (player, track) => {
+	console.log(`Now playing: ${track.title}`);
+	player.userdata?.channel?.send(`Now playing: ${track.title}`);
+});
+
+// Receive transcripts
+manager.on("voiceCreate", (player, evt) => {
+	console.log(`User ${evt.userId} said: ${evt.content}`);
+});
+```
+
+### TTS (Interrupt Mode)
+
+Play short text-to-speech messages without losing music progress. The player pauses music, plays TTS on a dedicated AudioPlayer,
+then resumes.
+
+- Requirements: `@ziplayer/plugin` with `TTSPlugin` installed and registered in `PlayerManager`.
+
+```ts
+import { PlayerManager } from "ziplayer";
+import { TTSPlugin, YouTubePlugin, SoundCloudPlugin, SpotifyPlugin } from "@ziplayer/plugin";
+
+const manager = new PlayerManager({
+	plugins: [new TTSPlugin({ defaultLang: "vi" }), new YouTubePlugin(), new SoundCloudPlugin(), new SpotifyPlugin()],
+});
+
+// Create a player with TTS interrupt enabled
+const player = await manager.create(guildId, {
+	tts: {
+		createPlayer: true, // pre-create the internal TTS AudioPlayer
+		interrupt: true, // pause music, swap to TTS, then resume
+		volume: 1, // 1 => 100%
+	},
+});
+
+await player.connect(voiceChannel);
+
+// Trigger TTS by playing a TTS query (depends on your TTS plugin)
+await player.play("tts: xin chào mọi người", userId);
+
+// Listen to TTS lifecycle events
+manager.on("ttsStart", (plr, { track }) => console.log("TTS start", track?.title));
+manager.on("ttsEnd", (plr) => console.log("TTS end"));
+```
+
+Notes
+
+- The detection uses track.source that includes "tts" or query starting with `tts:`.
+- If you need more control, call `player.interruptWithTTSTrack(track)` after building a TTS track via your plugin.
+- For CPU-heavy TTS generation, consider offloading to `worker_threads` or a separate process and pass a stream/buffer to the
+  plugin.
+
+### Player Lifecycle Overview
+
+```
+PlayerManager.create(guild, opts)
+        │
+        ▼
+[Player constructor]
+ - setup event listeners
+ - freeze ExtensionContext { player, manager }
+ - register plugins
+        │
+        ▼
+attachExtension(ext)
+ - set ext.player
+ - ext.onRegister?(context)
+ - ext.active?(...) → false ⇒ detach
+        │
+        ▼
+player.play(query, by)
+ - runBeforePlayHooks → extensions may mutate query/tracks/start Lavalink
+ - resolve track list / queue updates / TTS interrupt check
+ - extensionsProvideStream → extension stream overrides plugin pipeline
+ - plugin.getStream / getFallback
+        │
+        ▼
+Audio playback
+ - trackStart / queue events emitted
+ - runAfterPlayHooks with final outcome
+        │
+        ▼
+player.destroy()
+ - stop audio/voice / clear queue & plugins
+ - ext.onDestroy?(context) for each attached extension
+ - emit playerDestroy & cleanup references
+```
+
+This diagram shows how custom extensions (voice, lyrics, Lavalink, etc.) integrate across the full player lifecycle and where
+their hooks are invoked.
+
+### Lavalink Process
+
+Use `lavalinkExt` when you need ZiPlayer to manage an external Lavalink JVM node. The extension starts, stops, and optionally
+restarts the Lavalink jar and forwards lifecycle events through the manager/player.
+
+```ts
+import { PlayerManager } from "ziplayer";
+import { lavalinkExt } from "@ziplayer/extension";
+
+const lavalink = new lavalinkExt(null, {
+	nodes: [
+		{
+			identifier: "locallavalink",
+			password: "youshallnotpass",
+			host: "localhost",
+			port: 2333,
+			secure: false,
+		},
+	],
+	client: client,
+	searchPrefix: "scsearch",
+});
+
+const manager = new PlayerManager({
+	extensions: ["lavalinkExt"],
+});
+```
+
+## 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...
+
+## Useful Links
+
+[Example](https://github.com/ZiProject/ZiPlayer/tree/main/examples) | [Repo](https://github.com/ZiProject/ZiPlayer) |
+[Package](https://www.npmjs.com/package/ziplayer) | [Plugin](https://www.npmjs.com/package/@ziplayer/plugin) |
+[Extension](https://www.npmjs.com/package/@ziplayer/extension)
+
+## License
+
+MIT License

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"}