@benliam12/spotify-api-helper 1.0.0-DEV.4 → 1.0.0-DEV.6

package/dist/core/SpotifyHelper.d.ts

@@ -1,5 +1,5 @@
 import { SpotifyConfiguration } from "./SpotifyConfiguration.js";
-import { Album, Track, Artist } from "./SpotifyTypes.js";
+import { Album, Track, Artist, SearchType } from "./SpotifyTypes.js";
 /**
  * Result wrapper for operations that can fail
  */
@@ -70,12 +70,12 @@ export declare class SpotifyHelper {
      * Handle errors consistently - log and/or call callback
      */
     private handleError;
-    test(): string;
     /**
      * Get an album by ID.
      * Returns null if the request fails.
      */
     getAlbum(albumId: string): Promise<Album | null>;
+    getAlbums(albumIds: string[]): Promise<(Album | null)[]>;
     /**
      * Get a track by ID.
      * Returns null if the request fails.
@@ -96,6 +96,7 @@ export declare class SpotifyHelper {
      * Returns empty array if the request fails.
      */
     getAvailableMarkets(): Promise<string[]>;
+    search(query: string, type: SearchType, limit?: number, offset?: number): Promise<any | null>;
     /**
      * Check if the helper is properly authenticated.
      * Useful for health checks.
@@ -105,6 +106,10 @@ export declare class SpotifyHelper {
      * Manually clear the token (useful for testing or forcing a refresh).
      */
     clearToken(): void;
+    /**
+     * Get the current configuration.
+     */
+    getConfig(): SpotifyConfiguration;
     /**
      * Get token info for debugging (without exposing the actual token).
      */

package/dist/core/SpotifyHelper.js

@@ -165,9 +165,6 @@ export class SpotifyHelper {
         }
         this.options.onError(error);
     }
-    test() {
-        return "SpotifyHelper is working!";
-    }
     /**
      * Get an album by ID.
      * Returns null if the request fails.
@@ -181,13 +178,38 @@ export class SpotifyHelper {
         const album = {
             id: data.id,
             name: data.name,
-            market: data.market,
             album_type: data.album_type,
             total_tracks: data.total_tracks,
-            available_markets: data.available_markets
+            data: data.data
         };
         return album;
     }
+    async getAlbums(albumIds) {
+        const idsParam = albumIds.join(",");
+        if (albumIds.length === 0) {
+            return [];
+        }
+        if (albumIds.length > 20) {
+            throw new Error("Spotify API allows a maximum of 20 album IDs per request.");
+        }
+        const result = await this.makeAuthenticatedRequest(`https://api.spotify.com/v1/albums?ids=${idsParam}`, "getAlbums", { method: "GET" });
+        if (result.success) {
+            return result.data.map((data) => {
+                if (!data) {
+                    return null;
+                }
+                const album = {
+                    id: data.id,
+                    name: data.name,
+                    album_type: data.album_type,
+                    total_tracks: data.total_tracks,
+                    data: data.data
+                };
+                return album;
+            });
+        }
+        return [];
+    }
     /**
      * Get a track by ID.
      * Returns null if the request fails.
@@ -197,9 +219,33 @@ export class SpotifyHelper {
         if (!result.success) {
             return null;
         }
-        // Map to your Track type based on your type definition
-        // For now returning null as placeholder
-        return null;
+        else {
+            const { id, name, album_type, total_tracks, ...data } = result.data.album;
+            const trackAlbumData = {
+                id: id,
+                name: name,
+                album_type: album_type,
+                total_tracks: total_tracks,
+                data: data
+            };
+            const trackArtistData = result.data.artists.map((artistData) => {
+                const { id, name, ...data } = artistData;
+                const artist = {
+                    id: id,
+                    name: name,
+                    data: data
+                };
+                return artist;
+            });
+            const trackData = {
+                id: result.data.id,
+                name: result.data.name,
+                artists: trackArtistData,
+                album: trackAlbumData,
+                data: result.data
+            };
+            return trackData;
+        }
     }
     /**
      * Get an artist by ID.
@@ -236,6 +282,13 @@ export class SpotifyHelper {
         }
         return result.data.markets || [];
     }
+    async search(query, type, limit = 20, offset = 0) {
+        const result = await this.makeAuthenticatedRequest(`https://api.spotify.com/v1/search?q=${encodeURIComponent(query)}&type=${type}&limit=${limit}&offset=${offset}`, "search", { method: "GET" });
+        if (!result.success) {
+            return null;
+        }
+        return result.data;
+    }
     /**
      * Check if the helper is properly authenticated.
      * Useful for health checks.
@@ -250,6 +303,12 @@ export class SpotifyHelper {
     clearToken() {
         this.clientToken = null;
     }
+    /**
+     * Get the current configuration.
+     */
+    getConfig() {
+        return this.config;
+    }
     /**
      * Get token info for debugging (without exposing the actual token).
      */

package/dist/core/SpotifyTypes.d.ts

@@ -1,17 +1,30 @@
 export interface Album {
     id: string;
     name: string;
-    market: string;
     album_type: string;
     total_tracks: number;
-    available_markets: string[];
+    data: any;
 }
 export interface Track {
+    id: string;
+    name: string;
+    artists: Artist[];
+    album: Album;
+    data: any;
 }
 export interface Artist {
+    id: string;
+    name: string;
+    data: any;
 }
 export interface ClientToken {
     access_token: string;
     token_type: string;
     expires_at: Date;
 }
+export declare enum SearchType {
+    ALBUM = "album",
+    ARTIST = "artist",
+    TRACK = "track",
+    PLAYLIST = "playlist"
+}

package/dist/core/SpotifyTypes.js

@@ -1 +1,7 @@
-export {};
+export var SearchType;
+(function (SearchType) {
+    SearchType["ALBUM"] = "album";
+    SearchType["ARTIST"] = "artist";
+    SearchType["TRACK"] = "track";
+    SearchType["PLAYLIST"] = "playlist";
+})(SearchType || (SearchType = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@benliam12/spotify-api-helper",
-  "version": "1.0.0-DEV.4",
+  "version": "1.0.0-DEV.6",
   "description": "A utility package for Node.js",
   "type": "module",
   "main": "dist/index.js",
@@ -10,12 +10,14 @@
   ],
   "scripts": {
     "build": "npm run clean && tsc",
-    "test": "jest",
+    "test": "node --experimental-vm-modules --no-warnings --env-file=.env.test.local node_modules/jest/bin/jest.js",
+    "test:watch": "node --experimental-vm-modules --no-warnings --env-file=.env.test.local node_modules/jest/bin/jest.js --watch",
+    "test:coverage": "node --experimental-vm-modules --no-warnings --env-file=.env.test.local node_modules/jest/bin/jest.js --coverage",
     "clean": "rimraf dist",
     "lint": "eslint src --ext .ts",
     "prepare": "npm run build",
-    "release": "semantic-release --no-ci",
-    "release:dry": "semantic-release --dry-run --no-ci"
+    "release": "dotenv -e .env -- semantic-release --no-ci --dry-run=false",
+    "release:dry": "dotenv -e .env semantic-release --dry-run --no-ci"
   },
   "keywords": [
     "utility",
@@ -36,6 +38,8 @@
     "@types/node": "^22.19.3",
     "@typescript-eslint/eslint-plugin": "^8.50.1",
     "@typescript-eslint/parser": "^8.50.1",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "dotenv-cli": "^11.0.0",
     "eslint": "^9.39.2",
     "jest": "^29.7.0",
     "rimraf": "^6.1.2",