@zibot/scdl 0.0.1 → 0.0.3

package/index.d.ts

@@ -1,78 +1,73 @@
-declare module "@zibot/scdl" {
-	import { Readable } from "stream";
+import { Readable } from "stream";
 
-	// Types
-	export interface SearchOptions {
-		query: string;
-		limit?: number;
-		offset?: number;
-		type?: "all" | "tracks" | "playlists" | "users";
-	}
-
-	export interface DownloadOptions {
-		quality?: "high" | "low";
-	}
+// Types
+interface SearchOptions {
+	query: string;
+	limit?: number;
+	offset?: number;
+	type?: "all" | "tracks" | "playlists" | "users";
+}
 
-	export interface Track {
-		id: number;
-		title: string;
-		url: string;
-		user: { id: number; username: string };
-		media: {
-			transcodings: {
-				url: string;
-				format: { protocol: string; mime_type: string };
-			}[];
-		};
-	}
+interface DownloadOptions {
+	quality?: "high" | "low";
+}
 
-	export interface Playlist {
-		id: number;
-		title: string;
-		tracks: Track[];
-	}
+interface Track {
+	id: number;
+	title: string;
+	url: string;
+	user: { id: number; username: string };
+	media: {
+		transcodings: {
+			url: string;
+			format: { protocol: string; mime_type: string };
+		}[];
+	};
+}
 
-	export interface User {
-		id: number;
-		username: string;
-		followers_count: number;
-		track_count: number;
-	}
+interface Playlist {
+	id: number;
+	title: string;
+	tracks: Track[];
+}
 
-	export interface SearchResponse {
-		collection: (Track | Playlist | User)[];
-		next_href?: string;
-	}
+interface User {
+	id: number;
+	username: string;
+	followers_count: number;
+	track_count: number;
+}
 
-	export class SoundCloud {
-		clientId: string | null;
-		apiBaseUrl: string;
+declare class SoundCloud {
+	clientId: string | null;
+	apiBaseUrl: string;
 
-		constructor(options?: { init?: boolean });
+	constructor(options?: { init?: boolean });
 
-		/**
-		 * Initialize the SoundCloud client to retrieve clientId.
-		 */
-		init(): Promise<void>;
+	/**
+	 * Initialize the SoundCloud client to retrieve clientId.
+	 */
+	init(): Promise<void>;
 
-		/**
-		 * Search for tracks, playlists, or users on SoundCloud.
-		 */
-		searchTracks(options: SearchOptions): Promise<SearchResponse>;
+	/**
+	 * Search for tracks, playlists, or users on SoundCloud.
+	 */
+	searchTracks(options: SearchOptions): Promise<(Track | Playlist | User)[]>;
 
-		/**
-		 * Retrieve detailed information about a single track.
-		 */
-		getTrack(url: string): Promise<Track>;
+	/**
+	 * Retrieve detailed information about a single track.
+	 */
+	getTrackDetails(url: string): Promise<Track>;
 
-		/**
-		 * Retrieve detailed information about a playlist.
-		 */
-		getPlaylist(url: string): Promise<Playlist>;
+	/**
+	 * Retrieve detailed information about a playlist.
+	 */
+	getPlaylistDetails(url: string): Promise<Playlist>;
 
-		/**
-		 * Download a track as a stream.
-		 */
-		downloadTrack(url: string, options?: DownloadOptions): Promise<Readable>;
-	}
+	/**
+	 * Download a track as a stream.
+	 */
+	downloadTrack(url: string, options?: DownloadOptions): Promise<Readable>;
 }
+
+export = SoundCloud;

package/index.js

@@ -31,15 +31,22 @@ class SoundCloud {
 	}
 
 	// Search SoundCloud
-	async searchTracks({ query, limit = 20, offset = 0, type = "all" }) {
+	async searchTracks({ query, limit = 30, offset = 0, type = "all" }) {
 		const path = type === "all" ? "" : `/${type}`;
 		const url = `${this.apiBaseUrl}/search${path}?q=${encodeURIComponent(
 			query,
 		)}&limit=${limit}&offset=${offset}&access=playable&client_id=${this.clientId}`;
-		console.log(url);
 		try {
 			const { data } = await axios.get(url);
-			return data;
+
+			if (!data || !data?.collection?.length) {
+				return [];
+			}
+
+			return data.collection.filter((track) => {
+				if (!track.permalink_url || !track.title || !track.duration) return false;
+				return true;
+			});
 		} catch (error) {
 			console.error("Search error:", error.message || error);
 			throw new Error("Search failed");
@@ -77,13 +84,18 @@ class SoundCloud {
 
 	// Download track stream
 	async downloadTrack(trackUrl, options = {}) {
-		const track = await this.getTrackDetails(trackUrl);
-		const transcoding = track.media.transcodings.find((t) => t.format.protocol === "hls");
+		try {
+			const track = await this.getTrackDetails(trackUrl);
+			const transcoding = track?.media?.transcodings?.find((t) => t.format.protocol === "hls");
 
-		if (!transcoding) throw new Error("No valid HLS stream found");
+			if (!transcoding) throw new Error("No valid HLS stream found");
 
-		const m3u8Url = await this.getStreamUrl(transcoding.url);
-		return m3u8stream(m3u8Url, options);
+			const m3u8Url = await this.getStreamUrl(transcoding.url);
+			return m3u8stream(m3u8Url, options);
+		} catch (e) {
+			console.error("Failed to download track");
+			return null;
+		}
 	}
 
 	// Fetch single item (track/playlist/user)

package/package.json

@@ -1,8 +1,9 @@
 {
 	"name": "@zibot/scdl",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"description": "Soucloud download",
 	"main": "index.js",
+	"types": "index.d.ts",
 	"scripts": {
 		"test": "echo \"Error: no test specified\" && exit 1"
 	},