tunzo-player 1.0.22 → 1.0.24

package/dist/core/api-calles.d.ts

@@ -6,4 +6,29 @@ export declare class TunzoPlayerAPI {
      * @returns Array of song result objects
      */
     searchSongs(query: string, limit?: number): Promise<any[]>;
+    /**
+     * Search for playlists
+     * @param query Search keyword
+     * @param limit Number of results (default: 1000)
+     */
+    searchPlaylists(query: string, limit?: number): Promise<any[]>;
+    /**
+     * Get playlist details
+     * @param id Playlist ID
+     * @param link Playlist URL/Link (optional but recommended if available)
+     * @param limit Number of songs to return (default: 1000)
+     */
+    getPlaylistDetails(id: string, link?: string, limit?: number): Promise<any>;
+    /**
+     * Search for albums
+     * @param query Search keyword
+     * @param limit Number of results (default: 1000)
+     */
+    searchAlbums(query: string, limit?: number): Promise<any[]>;
+    /**
+     * Get album details
+     * @param id Album ID
+     * @param link Album URL/Link (optional but recommended if available)
+     */
+    getAlbumDetails(id: string, link?: string): Promise<any>;
 }

package/dist/core/api-calles.js

@@ -34,5 +34,100 @@ class TunzoPlayerAPI {
             }
         });
     }
+    /**
+     * Search for playlists
+     * @param query Search keyword
+     * @param limit Number of results (default: 1000)
+     */
+    searchPlaylists(query_1) {
+        return __awaiter(this, arguments, void 0, function* (query, limit = 1000) {
+            var _a;
+            try {
+                const response = yield fetch(`https://saavn.sumit.co/api/search/playlists?query=${encodeURIComponent(query)}&limit=${limit}`);
+                if (!response.ok) {
+                    throw new Error(`HTTP error! status: ${response.status}`);
+                }
+                const json = yield response.json();
+                return ((_a = json === null || json === void 0 ? void 0 : json.data) === null || _a === void 0 ? void 0 : _a.results) || [];
+            }
+            catch (error) {
+                console.error("TunzoPlayerAPI Error (searchPlaylists):", error);
+                return [];
+            }
+        });
+    }
+    /**
+     * Get playlist details
+     * @param id Playlist ID
+     * @param link Playlist URL/Link (optional but recommended if available)
+     * @param limit Number of songs to return (default: 1000)
+     */
+    getPlaylistDetails(id_1) {
+        return __awaiter(this, arguments, void 0, function* (id, link = "", limit = 1000) {
+            try {
+                let url = `https://saavn.sumit.co/api/playlists?id=${id}&limit=${limit}`;
+                if (link) {
+                    url += `&link=${encodeURIComponent(link)}`;
+                }
+                const response = yield fetch(url);
+                if (!response.ok) {
+                    throw new Error(`HTTP error! status: ${response.status}`);
+                }
+                const json = yield response.json();
+                return (json === null || json === void 0 ? void 0 : json.data) || null;
+            }
+            catch (error) {
+                console.error("TunzoPlayerAPI Error (getPlaylistDetails):", error);
+                return null;
+            }
+        });
+    }
+    /**
+     * Search for albums
+     * @param query Search keyword
+     * @param limit Number of results (default: 1000)
+     */
+    searchAlbums(query_1) {
+        return __awaiter(this, arguments, void 0, function* (query, limit = 1000) {
+            var _a;
+            try {
+                const response = yield fetch(`https://saavn.sumit.co/api/search/albums?query=${encodeURIComponent(query)}&limit=${limit}`);
+                if (!response.ok) {
+                    throw new Error(`HTTP error! status: ${response.status}`);
+                }
+                const json = yield response.json();
+                return ((_a = json === null || json === void 0 ? void 0 : json.data) === null || _a === void 0 ? void 0 : _a.results) || [];
+            }
+            catch (error) {
+                console.error("TunzoPlayerAPI Error (searchAlbums):", error);
+                return [];
+            }
+        });
+    }
+    /**
+     * Get album details
+     * @param id Album ID
+     * @param link Album URL/Link (optional but recommended if available)
+     */
+    getAlbumDetails(id_1) {
+        return __awaiter(this, arguments, void 0, function* (id, link = "") {
+            try {
+                let url = `https://saavn.sumit.co/api/albums?id=${id}`;
+                if (link) {
+                    url += `&link=${encodeURIComponent(link)}`;
+                }
+                const response = yield fetch(url);
+                if (!response.ok) {
+                    throw new Error(`HTTP error! status: ${response.status}`);
+                }
+                const json = yield response.json();
+                return (json === null || json === void 0 ? void 0 : json.data) || null;
+            }
+            catch (error) {
+                console.error("TunzoPlayerAPI Error (getAlbumDetails):", error);
+                return null;
+            }
+        });
+    }
 }
 exports.TunzoPlayerAPI = TunzoPlayerAPI;

package/dist/core/player.d.ts

@@ -37,4 +37,7 @@ export declare class Player {
     static setQuality(index: number): void;
     static getQueue(): any[];
     static getPlaylist(): any[];
+    private static setupMediaSession;
+    private static updateMediaSessionMetadata;
+    private static updatePositionState;
 }

package/dist/core/player.js

@@ -7,6 +7,7 @@ class Player {
     static initialize(playlist, quality = 3) {
         this.playlist = playlist;
         this.selectedQuality = quality;
+        this.setupMediaSession();
     }
     /** Call this once on user gesture to unlock audio in WebView */
     static unlockAudio() {
@@ -27,9 +28,14 @@ class Player {
             url = url.replace('http://', 'https://');
         }
         this.audio.src = url;
+        this.audio.preload = 'auto'; // Improve loading
         this.audio.load(); // Ensure audio is loaded before play
         this.audio.play().then(() => {
             this.isPlaying = true;
+            this.updateMediaSessionMetadata(song);
+            if ('mediaSession' in navigator) {
+                navigator.mediaSession.playbackState = 'playing';
+            }
         }).catch((err) => {
             this.isPlaying = false;
             console.warn('Audio play failed:', err);
@@ -37,6 +43,7 @@ class Player {
         // Set duration
         this.audio.onloadedmetadata = () => {
             this.duration = this.audio.duration;
+            this.updatePositionState();
         };
         // Set current time
         this.audio.ontimeupdate = () => {
@@ -54,10 +61,16 @@ class Player {
     static pause() {
         this.audio.pause();
         this.isPlaying = false;
+        if ('mediaSession' in navigator) {
+            navigator.mediaSession.playbackState = 'paused';
+        }
     }
     static resume() {
         this.audio.play();
         this.isPlaying = true;
+        if ('mediaSession' in navigator) {
+            navigator.mediaSession.playbackState = 'playing';
+        }
     }
     static togglePlayPause() {
         if (this.isPlaying) {
@@ -88,6 +101,7 @@ class Player {
     }
     static seek(seconds) {
         this.audio.currentTime = seconds;
+        this.updatePositionState();
     }
     static autoNext() {
         this.next();
@@ -148,6 +162,57 @@ class Player {
     static getPlaylist() {
         return this.playlist;
     }
+    // -------------------------------------------------------------------------
+    // Native Media Session (Lock Screen Controls)
+    // -------------------------------------------------------------------------
+    static setupMediaSession() {
+        if ('mediaSession' in navigator) {
+            navigator.mediaSession.setActionHandler('play', () => this.resume());
+            navigator.mediaSession.setActionHandler('pause', () => this.pause());
+            navigator.mediaSession.setActionHandler('previoustrack', () => this.prev());
+            navigator.mediaSession.setActionHandler('nexttrack', () => this.next());
+            navigator.mediaSession.setActionHandler('seekto', (details) => {
+                if (details.seekTime !== undefined) {
+                    this.seek(details.seekTime);
+                }
+            });
+        }
+    }
+    static updateMediaSessionMetadata(song) {
+        var _a;
+        if ('mediaSession' in navigator) {
+            const artwork = [];
+            if (song.image) {
+                if (Array.isArray(song.image)) {
+                    // Assuming image array contains objects with url/link and quality
+                    song.image.forEach((img) => {
+                        const src = img.link || img.url || (typeof img === 'string' ? img : '');
+                        if (src) {
+                            artwork.push({ src, sizes: '500x500', type: 'image/jpeg' });
+                        }
+                    });
+                }
+                else if (typeof song.image === 'string') {
+                    artwork.push({ src: song.image, sizes: '500x500', type: 'image/jpeg' });
+                }
+            }
+            navigator.mediaSession.metadata = new MediaMetadata({
+                title: song.name || song.title || 'Unknown Title',
+                artist: song.primaryArtists || song.artist || 'Unknown Artist',
+                album: ((_a = song.album) === null || _a === void 0 ? void 0 : _a.name) || song.album || '',
+                artwork: artwork.length > 0 ? artwork : undefined
+            });
+        }
+    }
+    static updatePositionState() {
+        if ('mediaSession' in navigator && this.duration > 0) {
+            navigator.mediaSession.setPositionState({
+                duration: this.duration,
+                playbackRate: this.audio.playbackRate,
+                position: this.audio.currentTime
+            });
+        }
+    }
 }
 exports.Player = Player;
 Player.audio = new Audio();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tunzo-player",
-    "version": "1.0.22",
+    "version": "1.0.24",
     "description": "A music playback service for Angular and Ionic apps with native audio control support.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/src/core/api-calles.ts

@@ -1,26 +1,124 @@
 export class TunzoPlayerAPI {
-    /**
-     * Search for songs using the saavn.dev API
-     * @param query Search keyword (e.g., artist name, song name)
-     * @param limit Number of results to return (default: 250)
-     * @returns Array of song result objects
-     */
-    async searchSongs(query: string, limit: number = 250): Promise<any[]> {
-      try {
-        const response = await fetch(
-          `https://saavn.sumit.co/api/search/songs?query=${encodeURIComponent(query)}&limit=${limit}`
-        );
-  
-        if (!response.ok) {
-          throw new Error(`HTTP error! status: ${response.status}`);
-        }
-  
-        const json = await response.json();
-        return json?.data?.results || [];
-      } catch (error) {
-        console.error("TunzoPlayerAPI Error:", error);
-        return [];
+  /**
+   * Search for songs using the saavn.dev API
+   * @param query Search keyword (e.g., artist name, song name)
+   * @param limit Number of results to return (default: 250)
+   * @returns Array of song result objects
+   */
+  async searchSongs(query: string, limit: number = 250): Promise<any[]> {
+    try {
+      const response = await fetch(
+        `https://saavn.sumit.co/api/search/songs?query=${encodeURIComponent(query)}&limit=${limit}`
+      );
+
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
       }
+
+      const json = await response.json();
+      return json?.data?.results || [];
+    } catch (error) {
+      console.error("TunzoPlayerAPI Error:", error);
+      return [];
     }
   }
-  
+
+  /**
+   * Search for playlists
+   * @param query Search keyword
+   * @param limit Number of results (default: 1000)
+   */
+  async searchPlaylists(query: string, limit: number = 1000): Promise<any[]> {
+    try {
+      const response = await fetch(
+        `https://saavn.sumit.co/api/search/playlists?query=${encodeURIComponent(query)}&limit=${limit}`
+      );
+
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+
+      const json = await response.json();
+      return json?.data?.results || [];
+    } catch (error) {
+      console.error("TunzoPlayerAPI Error (searchPlaylists):", error);
+      return [];
+    }
+  }
+
+  /**
+   * Get playlist details
+   * @param id Playlist ID
+   * @param link Playlist URL/Link (optional but recommended if available)
+   * @param limit Number of songs to return (default: 1000)
+   */
+  async getPlaylistDetails(id: string, link: string = "", limit: number = 1000): Promise<any> {
+    try {
+      let url = `https://saavn.sumit.co/api/playlists?id=${id}&limit=${limit}`;
+      if (link) {
+        url += `&link=${encodeURIComponent(link)}`;
+      }
+
+      const response = await fetch(url);
+
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+
+      const json = await response.json();
+      return json?.data || null;
+    } catch (error) {
+      console.error("TunzoPlayerAPI Error (getPlaylistDetails):", error);
+      return null;
+    }
+  }
+
+  /**
+   * Search for albums
+   * @param query Search keyword
+   * @param limit Number of results (default: 1000)
+   */
+  async searchAlbums(query: string, limit: number = 1000): Promise<any[]> {
+    try {
+      const response = await fetch(
+        `https://saavn.sumit.co/api/search/albums?query=${encodeURIComponent(query)}&limit=${limit}`
+      );
+
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+
+      const json = await response.json();
+      return json?.data?.results || [];
+    } catch (error) {
+      console.error("TunzoPlayerAPI Error (searchAlbums):", error);
+      return [];
+    }
+  }
+
+  /**
+   * Get album details
+   * @param id Album ID
+   * @param link Album URL/Link (optional but recommended if available)
+   */
+  async getAlbumDetails(id: string, link: string = ""): Promise<any> {
+    try {
+      let url = `https://saavn.sumit.co/api/albums?id=${id}`;
+      if (link) {
+        url += `&link=${encodeURIComponent(link)}`;
+      }
+
+      const response = await fetch(url);
+
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+
+      const json = await response.json();
+      return json?.data || null;
+    } catch (error) {
+      console.error("TunzoPlayerAPI Error (getAlbumDetails):", error);
+      return null;
+    }
+  }
+}

package/src/core/player.ts

@@ -17,6 +17,7 @@ export class Player {
   static initialize(playlist: any[], quality = 3) {
     this.playlist = playlist;
     this.selectedQuality = quality;
+    this.setupMediaSession();
   }
 
   /** Call this once on user gesture to unlock audio in WebView */
@@ -41,9 +42,14 @@ export class Player {
     }
 
     this.audio.src = url;
+    this.audio.preload = 'auto'; // Improve loading
     this.audio.load(); // Ensure audio is loaded before play
     this.audio.play().then(() => {
       this.isPlaying = true;
+      this.updateMediaSessionMetadata(song);
+      if ('mediaSession' in navigator) {
+        navigator.mediaSession.playbackState = 'playing';
+      }
     }).catch((err) => {
       this.isPlaying = false;
       console.warn('Audio play failed:', err);
@@ -52,6 +58,7 @@ export class Player {
     // Set duration
     this.audio.onloadedmetadata = () => {
       this.duration = this.audio.duration;
+      this.updatePositionState();
     };
 
     // Set current time
@@ -74,11 +81,17 @@ export class Player {
   static pause() {
     this.audio.pause();
     this.isPlaying = false;
+    if ('mediaSession' in navigator) {
+      navigator.mediaSession.playbackState = 'paused';
+    }
   }
 
   static resume() {
     this.audio.play();
     this.isPlaying = true;
+    if ('mediaSession' in navigator) {
+      navigator.mediaSession.playbackState = 'playing';
+    }
   }
 
   static togglePlayPause() {
@@ -110,6 +123,7 @@ export class Player {
 
   static seek(seconds: number) {
     this.audio.currentTime = seconds;
+    this.updatePositionState();
   }
 
   static autoNext() {
@@ -186,4 +200,58 @@ export class Player {
   static getPlaylist(): any[] {
     return this.playlist;
   }
+
+  // -------------------------------------------------------------------------
+  // Native Media Session (Lock Screen Controls)
+  // -------------------------------------------------------------------------
+
+  private static setupMediaSession() {
+    if ('mediaSession' in navigator) {
+      navigator.mediaSession.setActionHandler('play', () => this.resume());
+      navigator.mediaSession.setActionHandler('pause', () => this.pause());
+      navigator.mediaSession.setActionHandler('previoustrack', () => this.prev());
+      navigator.mediaSession.setActionHandler('nexttrack', () => this.next());
+      navigator.mediaSession.setActionHandler('seekto', (details) => {
+        if (details.seekTime !== undefined) {
+          this.seek(details.seekTime);
+        }
+      });
+    }
+  }
+
+  private static updateMediaSessionMetadata(song: any) {
+    if ('mediaSession' in navigator) {
+      const artwork = [];
+      if (song.image) {
+        if (Array.isArray(song.image)) {
+          // Assuming image array contains objects with url/link and quality
+          song.image.forEach((img: any) => {
+            const src = img.link || img.url || (typeof img === 'string' ? img : '');
+            if (src) {
+              artwork.push({ src, sizes: '500x500', type: 'image/jpeg' });
+            }
+          });
+        } else if (typeof song.image === 'string') {
+          artwork.push({ src: song.image, sizes: '500x500', type: 'image/jpeg' });
+        }
+      }
+
+      navigator.mediaSession.metadata = new MediaMetadata({
+        title: song.name || song.title || 'Unknown Title',
+        artist: song.primaryArtists || song.artist || 'Unknown Artist',
+        album: song.album?.name || song.album || '',
+        artwork: artwork.length > 0 ? artwork : undefined
+      });
+    }
+  }
+
+  private static updatePositionState() {
+    if ('mediaSession' in navigator && this.duration > 0) {
+      navigator.mediaSession.setPositionState({
+        duration: this.duration,
+        playbackRate: this.audio.playbackRate,
+        position: this.audio.currentTime
+      });
+    }
+  }
 }