@ziplayer/plugin 0.0.5 → 0.1.0

package/dist/SoundCloudPlugin.d.ts

@@ -1,21 +1,170 @@
 import { BasePlugin, Track, SearchResult, StreamInfo } from "ziplayer";
+/**
+ * A plugin for handling SoundCloud audio content including tracks, playlists, and search functionality.
+ *
+ * This plugin provides comprehensive support for:
+ * - SoundCloud track URLs (soundcloud.com)
+ * - SoundCloud playlist URLs
+ * - SoundCloud search queries
+ * - Audio stream extraction from SoundCloud tracks
+ * - Related track recommendations
+ *
+ * @example
+ *
+ * const soundcloudPlugin = new SoundCloudPlugin();
+ *
+ * // Add to PlayerManager
+ * const manager = new PlayerManager({
+ *   plugins: [soundcloudPlugin]
+ * });
+ *
+ * // Search for tracks
+ * const result = await soundcloudPlugin.search("chill music", "user123");
+ *
+ * // Get audio stream
+ * const stream = await soundcloudPlugin.getStream(result.tracks[0]);
+ *
+ * @since 1.0.0
+ */
 export declare class SoundCloudPlugin extends BasePlugin {
     name: string;
     version: string;
     private client;
     private ready;
+    /**
+     * Creates a new SoundCloudPlugin instance.
+     *
+     * The plugin will automatically initialize the SoundCloud client for track
+     * and playlist operations. Initialization is asynchronous and handled internally.
+     *
+     * @example
+     * const plugin = new SoundCloudPlugin();
+     * // Plugin is ready to use after initialization completes
+     */
     constructor();
     private init;
+    /**
+     * Determines if this plugin can handle the given query.
+     *
+     * @param query - The search query or URL to check
+     * @returns `true` if the plugin can handle the query, `false` otherwise
+     *
+     * @example
+     * plugin.canHandle("https://soundcloud.com/artist/track"); // true
+     * plugin.canHandle("chill music"); // true
+     * plugin.canHandle("spotify:track:123"); // false
+     */
     canHandle(query: string): boolean;
+    /**
+     * Validates if a URL is a valid SoundCloud URL.
+     *
+     * @param url - The URL to validate
+     * @returns `true` if the URL is a valid SoundCloud URL, `false` otherwise
+     *
+     * @example
+     * plugin.validate("https://soundcloud.com/artist/track"); // true
+     * plugin.validate("https://www.soundcloud.com/artist/track"); // true
+     * plugin.validate("https://youtube.com/watch?v=123"); // false
+     */
     validate(url: string): boolean;
+    /**
+     * Searches for SoundCloud content based on the given query.
+     *
+     * This method handles both URL-based queries (direct track/playlist links) and
+     * text-based search queries. For URLs, it will extract track or playlist information.
+     * For text queries, it will perform a SoundCloud search and return up to 10 results.
+     *
+     * @param query - The search query (URL or text)
+     * @param requestedBy - The user ID who requested the search
+     * @returns A SearchResult containing tracks and optional playlist information
+     *
+     * @example
+     * // Search by URL
+     * const result = await plugin.search("https://soundcloud.com/artist/track", "user123");
+     *
+     * // Search by text
+     * const searchResult = await plugin.search("chill music", "user123");
+     * console.log(searchResult.tracks); // Array of Track objects
+     */
     search(query: string, requestedBy: string): Promise<SearchResult>;
+    /**
+     * Retrieves the audio stream for a SoundCloud track.
+     *
+     * This method downloads the audio stream from SoundCloud using the track's URL.
+     * It handles the SoundCloud-specific download process and returns the stream
+     * in a format compatible with the player.
+     *
+     * @param track - The Track object to get the stream for
+     * @returns A StreamInfo object containing the audio stream and metadata
+     * @throws {Error} If the track URL is invalid or stream download fails
+     *
+     * @example
+     * const track = { id: "123", title: "Track Title", url: "https://soundcloud.com/artist/track", ... };
+     * const streamInfo = await plugin.getStream(track);
+     * console.log(streamInfo.type); // "arbitrary"
+     * console.log(streamInfo.stream); // Readable stream
+     */
     getStream(track: Track): Promise<StreamInfo>;
+    /**
+     * Gets related tracks for a given SoundCloud track.
+     *
+     * This method fetches related tracks from SoundCloud's recommendation system
+     * based on the provided track URL or ID. It can filter out tracks that are
+     * already in the history to avoid duplicates.
+     *
+     * @param trackURL - The SoundCloud track URL or ID to get related tracks for
+     * @param opts - Options for filtering and limiting results
+     * @param opts.limit - Maximum number of related tracks to return (default: 1)
+     * @param opts.offset - Number of tracks to skip from the beginning (default: 0)
+     * @param opts.history - Array of tracks to exclude from results
+     * @returns An array of related Track objects
+     *
+     * @example
+     * const related = await plugin.getRelatedTracks(
+     *   "https://soundcloud.com/artist/track",
+     *   { limit: 3, history: [currentTrack] }
+     * );
+     * console.log(`Found ${related.length} related tracks`);
+     */
     getRelatedTracks(trackURL: string | number, opts?: {
         limit?: number;
         offset?: number;
         history?: Track[];
     }): Promise<Track[]>;
+    /**
+     * Provides a fallback stream by searching for the track title.
+     *
+     * This method is used when the primary stream extraction fails. It performs
+     * a search using the track's title and attempts to get a stream from the
+     * first search result.
+     *
+     * @param track - The Track object to get a fallback stream for
+     * @returns A StreamInfo object containing the fallback audio stream
+     * @throws {Error} If no fallback track is found or stream extraction fails
+     *
+     * @example
+     * try {
+     *   const stream = await plugin.getStream(track);
+     * } catch (error) {
+     *   // Try fallback
+     *   const fallbackStream = await plugin.getFallback(track);
+     * }
+     */
     getFallback(track: Track): Promise<StreamInfo>;
+    /**
+     * Extracts tracks from a SoundCloud playlist URL.
+     *
+     * @param url - The SoundCloud playlist URL
+     * @param requestedBy - The user ID who requested the extraction
+     * @returns An array of Track objects from the playlist
+     *
+     * @example
+     * const tracks = await plugin.extractPlaylist(
+     *   "https://soundcloud.com/artist/sets/playlist-name",
+     *   "user123"
+     * );
+     * console.log(`Found ${tracks.length} tracks in playlist`);
+     */
     extractPlaylist(url: string, requestedBy: string): Promise<Track[]>;
 }
 //# sourceMappingURL=SoundCloudPlugin.d.ts.map

package/dist/SoundCloudPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoundCloudPlugin.d.ts","sourceRoot":"","sources":["../src/SoundCloudPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAgBvE,qBAAa,gBAAiB,SAAQ,UAAU;IAC/C,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;IAgBjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgFjE,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB5C,gBAAgB,CACrB,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,GAC/D,OAAO,CAAC,KAAK,EAAE,CAAC;IAiCb,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;CAsBzE"}
+{"version":3,"file":"SoundCloudPlugin.d.ts","sourceRoot":"","sources":["../src/SoundCloudPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAgBvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC/C,IAAI,SAAgB;IACpB,OAAO,SAAW;IAClB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAgB;IAE7B;;;;;;;;;OASG;;YAMW,IAAI;IAKlB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAgBjC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgFvE;;;;;;;;;;;;;;;;OAgBG;IACG,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAmBlD;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,gBAAgB,CACrB,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,GAC/D,OAAO,CAAC,KAAK,EAAE,CAAC;IAiCnB;;;;;;;;;;;;;;;;;;OAkBG;IACG,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IASpD;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAsBzE"}

package/dist/SoundCloudPlugin.js

@@ -15,7 +15,44 @@ function isValidSoundCloudHost(maybeUrl) {
         return false;
     }
 }
+/**
+ * A plugin for handling SoundCloud audio content including tracks, playlists, and search functionality.
+ *
+ * This plugin provides comprehensive support for:
+ * - SoundCloud track URLs (soundcloud.com)
+ * - SoundCloud playlist URLs
+ * - SoundCloud search queries
+ * - Audio stream extraction from SoundCloud tracks
+ * - Related track recommendations
+ *
+ * @example
+ *
+ * const soundcloudPlugin = new SoundCloudPlugin();
+ *
+ * // Add to PlayerManager
+ * const manager = new PlayerManager({
+ *   plugins: [soundcloudPlugin]
+ * });
+ *
+ * // Search for tracks
+ * const result = await soundcloudPlugin.search("chill music", "user123");
+ *
+ * // Get audio stream
+ * const stream = await soundcloudPlugin.getStream(result.tracks[0]);
+ *
+ * @since 1.0.0
+ */
 class SoundCloudPlugin extends ziplayer_1.BasePlugin {
+    /**
+     * Creates a new SoundCloudPlugin instance.
+     *
+     * The plugin will automatically initialize the SoundCloud client for track
+     * and playlist operations. Initialization is asynchronous and handled internally.
+     *
+     * @example
+     * const plugin = new SoundCloudPlugin();
+     * // Plugin is ready to use after initialization completes
+     */
     constructor() {
         super();
         this.name = "soundcloud";
@@ -26,6 +63,17 @@ class SoundCloudPlugin extends ziplayer_1.BasePlugin {
         this.client = new SoundCloud({ init: false });
         await this.client.init();
     }
+    /**
+     * Determines if this plugin can handle the given query.
+     *
+     * @param query - The search query or URL to check
+     * @returns `true` if the plugin can handle the query, `false` otherwise
+     *
+     * @example
+     * plugin.canHandle("https://soundcloud.com/artist/track"); // true
+     * plugin.canHandle("chill music"); // true
+     * plugin.canHandle("spotify:track:123"); // false
+     */
     canHandle(query) {
         const q = (query || "").trim().toLowerCase();
         const isUrl = q.startsWith("http://") || q.startsWith("https://");
@@ -42,9 +90,39 @@ class SoundCloudPlugin extends ziplayer_1.BasePlugin {
         // Treat remaining non-URL free text as searchable
         return true;
     }
+    /**
+     * Validates if a URL is a valid SoundCloud URL.
+     *
+     * @param url - The URL to validate
+     * @returns `true` if the URL is a valid SoundCloud URL, `false` otherwise
+     *
+     * @example
+     * plugin.validate("https://soundcloud.com/artist/track"); // true
+     * plugin.validate("https://www.soundcloud.com/artist/track"); // true
+     * plugin.validate("https://youtube.com/watch?v=123"); // false
+     */
     validate(url) {
         return isValidSoundCloudHost(url);
     }
+    /**
+     * Searches for SoundCloud content based on the given query.
+     *
+     * This method handles both URL-based queries (direct track/playlist links) and
+     * text-based search queries. For URLs, it will extract track or playlist information.
+     * For text queries, it will perform a SoundCloud search and return up to 10 results.
+     *
+     * @param query - The search query (URL or text)
+     * @param requestedBy - The user ID who requested the search
+     * @returns A SearchResult containing tracks and optional playlist information
+     *
+     * @example
+     * // Search by URL
+     * const result = await plugin.search("https://soundcloud.com/artist/track", "user123");
+     *
+     * // Search by text
+     * const searchResult = await plugin.search("chill music", "user123");
+     * console.log(searchResult.tracks); // Array of Track objects
+     */
     async search(query, requestedBy) {
         await this.ready;
         // If the query is a URL but not a SoundCloud URL, do not handle it here
@@ -122,6 +200,23 @@ class SoundCloudPlugin extends ziplayer_1.BasePlugin {
             throw new Error(`SoundCloud search failed: ${error?.message}`);
         }
     }
+    /**
+     * Retrieves the audio stream for a SoundCloud track.
+     *
+     * This method downloads the audio stream from SoundCloud using the track's URL.
+     * It handles the SoundCloud-specific download process and returns the stream
+     * in a format compatible with the player.
+     *
+     * @param track - The Track object to get the stream for
+     * @returns A StreamInfo object containing the audio stream and metadata
+     * @throws {Error} If the track URL is invalid or stream download fails
+     *
+     * @example
+     * const track = { id: "123", title: "Track Title", url: "https://soundcloud.com/artist/track", ... };
+     * const streamInfo = await plugin.getStream(track);
+     * console.log(streamInfo.type); // "arbitrary"
+     * console.log(streamInfo.stream); // Readable stream
+     */
     async getStream(track) {
         await this.ready;
         try {
@@ -139,6 +234,27 @@ class SoundCloudPlugin extends ziplayer_1.BasePlugin {
             throw new Error(`Failed to get SoundCloud stream: ${error.message}`);
         }
     }
+    /**
+     * Gets related tracks for a given SoundCloud track.
+     *
+     * This method fetches related tracks from SoundCloud's recommendation system
+     * based on the provided track URL or ID. It can filter out tracks that are
+     * already in the history to avoid duplicates.
+     *
+     * @param trackURL - The SoundCloud track URL or ID to get related tracks for
+     * @param opts - Options for filtering and limiting results
+     * @param opts.limit - Maximum number of related tracks to return (default: 1)
+     * @param opts.offset - Number of tracks to skip from the beginning (default: 0)
+     * @param opts.history - Array of tracks to exclude from results
+     * @returns An array of related Track objects
+     *
+     * @example
+     * const related = await plugin.getRelatedTracks(
+     *   "https://soundcloud.com/artist/track",
+     *   { limit: 3, history: [currentTrack] }
+     * );
+     * console.log(`Found ${related.length} related tracks`);
+     */
     async getRelatedTracks(trackURL, opts = {}) {
         await this.ready;
         try {
@@ -169,6 +285,25 @@ class SoundCloudPlugin extends ziplayer_1.BasePlugin {
             return [];
         }
     }
+    /**
+     * Provides a fallback stream by searching for the track title.
+     *
+     * This method is used when the primary stream extraction fails. It performs
+     * a search using the track's title and attempts to get a stream from the
+     * first search result.
+     *
+     * @param track - The Track object to get a fallback stream for
+     * @returns A StreamInfo object containing the fallback audio stream
+     * @throws {Error} If no fallback track is found or stream extraction fails
+     *
+     * @example
+     * try {
+     *   const stream = await plugin.getStream(track);
+     * } catch (error) {
+     *   // Try fallback
+     *   const fallbackStream = await plugin.getFallback(track);
+     * }
+     */
     async getFallback(track) {
         const trackfall = await this.search(track.title, track.requestedBy);
         const fallbackTrack = trackfall.tracks?.[0];
@@ -177,6 +312,20 @@ class SoundCloudPlugin extends ziplayer_1.BasePlugin {
         }
         return await this.getStream(fallbackTrack);
     }
+    /**
+     * Extracts tracks from a SoundCloud playlist URL.
+     *
+     * @param url - The SoundCloud playlist URL
+     * @param requestedBy - The user ID who requested the extraction
+     * @returns An array of Track objects from the playlist
+     *
+     * @example
+     * const tracks = await plugin.extractPlaylist(
+     *   "https://soundcloud.com/artist/sets/playlist-name",
+     *   "user123"
+     * );
+     * console.log(`Found ${tracks.length} tracks in playlist`);
+     */
     async extractPlaylist(url, requestedBy) {
         await this.ready;
         try {

package/dist/SoundCloudPlugin.js.map

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

package/dist/SpotifyPlugin.d.ts

@@ -1,19 +1,141 @@
 import { BasePlugin, Track, SearchResult, StreamInfo } from "ziplayer";
 /**
- * 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)
+ * A minimal Spotify plugin for metadata extraction and display purposes.
+ *
+ * This plugin provides support for:
+ * - Spotify track URLs/URIs (spotify:track:...)
+ * - Spotify playlist URLs/URIs (spotify:playlist:...)
+ * - Spotify album URLs/URIs (spotify:album:...)
+ * - Metadata extraction using Spotify's public oEmbed endpoint
+ *
+ * **Important Notes:**
+ * - This plugin does NOT provide audio streams (player is expected to redirect/fallback upstream)
+ * - This plugin does NOT expand playlists/albums (no SDK; oEmbed doesn't enumerate items)
+ * - This plugin only provides display metadata for Spotify content
+ *
+ * @example
+ *
+ * const spotifyPlugin = new SpotifyPlugin();
+ *
+ * // Add to PlayerManager
+ * const manager = new PlayerManager({
+ *   plugins: [spotifyPlugin]
+ * });
+ *
+ * // Get metadata for a Spotify track
+ * const result = await spotifyPlugin.search("spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "user123");
+ * console.log(result.tracks[0].metadata); // Contains Spotify metadata
+ *
+ *
+ * @since 1.1.0
  */
 export declare class SpotifyPlugin extends BasePlugin {
     name: string;
     version: string;
+    /**
+     * Determines if this plugin can handle the given query.
+     *
+     * @param query - The search query or URL to check
+     * @returns `true` if the query is a Spotify URL/URI, `false` otherwise
+     *
+     * @example
+     *
+     * plugin.canHandle("spotify:track:4iV5W9uYEdYUVa79Axb7Rh"); // true
+     * plugin.canHandle("https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh"); // true
+     * plugin.canHandle("youtube.com/watch?v=123"); // false
+     *
+     */
     canHandle(query: string): boolean;
+    /**
+     * Validates if a URL/URI is a valid Spotify URL/URI.
+     *
+     * @param url - The URL/URI to validate
+     * @returns `true` if the URL/URI is a valid Spotify URL/URI, `false` otherwise
+     *
+     * @example
+     *
+     * plugin.validate("spotify:track:4iV5W9uYEdYUVa79Axb7Rh"); // true
+     * plugin.validate("https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh"); // true
+     * plugin.validate("https://youtube.com/watch?v=123"); // false
+     *
+     */
     validate(url: string): boolean;
+    /**
+     * Extracts metadata from Spotify URLs/URIs using the oEmbed API.
+     *
+     * This method handles Spotify track, playlist, and album URLs/URIs by fetching
+     * display metadata from Spotify's public oEmbed endpoint. It does not provide
+     * audio streams or expand playlists/albums.
+     *
+     * @param query - The Spotify URL/URI to extract metadata from
+     * @param requestedBy - The user ID who requested the extraction
+     * @returns A SearchResult containing a single track with metadata (no audio stream)
+     *
+     * @example
+     *
+     * // Extract track metadata
+     * const result = await plugin.search("spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "user123");
+     * console.log(result.tracks[0].metadata); // Contains Spotify metadata
+     *
+     * // Extract playlist metadata
+     * const playlistResult = await plugin.search("https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "user123");
+     * console.log(playlistResult.tracks[0].metadata.kind); // "playlist"
+     *
+     */
     search(query: string, requestedBy: string): Promise<SearchResult>;
+    /**
+     * Extracts tracks from a Spotify playlist URL.
+     *
+     * **Note:** This method is not implemented as this plugin does not support
+     * playlist expansion. It always returns an empty array.
+     *
+     * @param _input - The Spotify playlist URL (unused)
+     * @param _requestedBy - The user ID who requested the extraction (unused)
+     * @returns An empty array (playlist expansion not supported)
+     *
+     * @example
+     *
+     * const tracks = await plugin.extractPlaylist("spotify:playlist:123", "user123");
+     * console.log(tracks); // [] - empty array
+     *
+     */
     extractPlaylist(_input: string, _requestedBy: string): Promise<Track[]>;
+    /**
+     * Extracts tracks from a Spotify album URL.
+     *
+     * **Note:** This method is not implemented as this plugin does not support
+     * album expansion. It always returns an empty array.
+     *
+     * @param _input - The Spotify album URL (unused)
+     * @param _requestedBy - The user ID who requested the extraction (unused)
+     * @returns An empty array (album expansion not supported)
+     *
+     * @example
+     *
+     * const tracks = await plugin.extractAlbum("spotify:album:123", "user123");
+     * console.log(tracks); // [] - empty array
+     *
+     */
     extractAlbum(_input: string, _requestedBy: string): Promise<Track[]>;
+    /**
+     * Attempts to get an audio stream for a Spotify track.
+     *
+     * **Note:** This method always throws an error as this plugin does not support
+     * audio streaming. The player is expected to redirect to other plugins or
+     * use fallback mechanisms for actual audio playback.
+     *
+     * @param _track - The Track object (unused)
+     * @throws {Error} Always throws "Spotify streaming is not supported by this plugin"
+     *
+     * @example
+     *
+     * try {
+     *   const stream = await plugin.getStream(track);
+     * } catch (error) {
+     *   console.log(error.message); // "Spotify streaming is not supported by this plugin"
+     * }
+     *
+     */
     getStream(_track: Track): Promise<StreamInfo>;
     private identifyKind;
     private extractId;

package/dist/SpotifyPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpotifyPlugin.d.ts","sourceRoot":"","sources":["../src/SpotifyPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvE;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC5C,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,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIvE,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;IAoBpB,OAAO,CAAC,SAAS;YAeH,sBAAsB;YA0BtB,eAAe;IA0B7B,OAAO,CAAC,UAAU;YAeJ,WAAW;CAgBzB"}
+{"version":3,"file":"SpotifyPlugin.d.ts","sourceRoot":"","sources":["../src/SpotifyPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC5C,IAAI,SAAa;IACjB,OAAO,SAAW;IAElB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWjC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAU9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBvE;;;;;;;;;;;;;;;OAeG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI7E;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI1E;;;;;;;;;;;;;;;;;;OAkBG;IACG,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC;IAInD,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,SAAS;YAeH,sBAAsB;YA0BtB,eAAe;IA0B7B,OAAO,CAAC,UAAU;YAeJ,WAAW;CAgBzB"}