soundcloud-api-ts-next 1.0.0 → 1.1.0

package/README.md

@@ -1,38 +1,56 @@
 # soundcloud-api-ts-next
 
-React hooks and Next.js API route handlers for the SoundCloud API. Client secrets stay on the server.
+Next.js integration for [soundcloud-api-ts](https://github.com/twin-paws/soundcloud-api-ts) — React hooks + secure API route handlers.
 
-Built on top of [`soundcloud-api-ts`](https://github.com/twin-paws/soundcloud-api-ts).
-
-## Install
+## Installation
 
 ```bash
-pnpm add soundcloud-api-ts-next soundcloud-api-ts
+npm install soundcloud-api-ts-next
+# or
+pnpm add soundcloud-api-ts-next
 ```
 
-## Quick Start
+## Setup
+
+### 1. Server Routes
+
+Create an API route handler that proxies SoundCloud requests (keeps your credentials server-side).
 
-### 1. Set up the API route (App Router)
+**App Router** (`app/api/soundcloud/[...route]/route.ts`):
 
 ```ts
-// app/api/soundcloud/[...route]/route.ts
 import { createSoundCloudRoutes } from "soundcloud-api-ts-next/server";
 
 const sc = createSoundCloudRoutes({
-  clientId: process.env.SC_CLIENT_ID!,
-  clientSecret: process.env.SC_CLIENT_SECRET!,
+  clientId: process.env.SOUNDCLOUD_CLIENT_ID!,
+  clientSecret: process.env.SOUNDCLOUD_CLIENT_SECRET!,
 });
 
-export const GET = sc.handler();
+const handler = sc.handler();
+export const GET = handler;
 ```
 
-### 2. Wrap your app with the provider
+**Pages Router** (`pages/api/soundcloud/[...route].ts`):
+
+```ts
+import { createSoundCloudRoutes } from "soundcloud-api-ts-next/server";
+
+const sc = createSoundCloudRoutes({
+  clientId: process.env.SOUNDCLOUD_CLIENT_ID!,
+  clientSecret: process.env.SOUNDCLOUD_CLIENT_SECRET!,
+});
+
+export default sc.pagesHandler();
+```
+
+### 2. Client Provider
+
+Wrap your app with the `SoundCloudProvider`:
 
 ```tsx
-// app/layout.tsx
 import { SoundCloudProvider } from "soundcloud-api-ts-next";
 
-export default function RootLayout({ children }) {
+export default function Layout({ children }) {
   return (
     <SoundCloudProvider apiPrefix="/api/soundcloud">
       {children}
@@ -41,94 +59,100 @@ export default function RootLayout({ children }) {
 }
 ```
 
-### 3. Use hooks in your components
-
-```tsx
-"use client";
-import { useTrackSearch } from "soundcloud-api-ts-next";
+## Hooks
 
-export function Search() {
-  const { data, loading, error } = useTrackSearch("lofi beats", { limit: 10 });
+All hooks return `{ data, loading, error }`.
 
-  if (loading) return <p>Loading...</p>;
-  if (error) return <p>Error: {error.message}</p>;
+### Tracks
 
-  return (
-    <ul>
-      {data?.map((track) => (
-        <li key={track.id}>{track.title}</li>
-      ))}
-    </ul>
-  );
-}
-```
+| Hook | Arguments | Description |
+|------|-----------|-------------|
+| `useTrack(trackId)` | `string \| number \| undefined` | Fetch a single track |
+| `useTrackSearch(query, options?)` | `string`, `{ limit? }` | Search tracks |
+| `useTrackComments(trackId)` | `string \| number \| undefined` | Get track comments |
+| `useTrackLikes(trackId)` | `string \| number \| undefined` | Get users who liked a track |
+| `useRelatedTracks(trackId)` | `string \| number \| undefined` | Get related tracks |
 
-## Pages Router Setup
+### Users
 
-```ts
-// pages/api/soundcloud/[...route].ts
-import { createSoundCloudRoutes } from "soundcloud-api-ts-next/server";
+| Hook | Arguments | Description |
+|------|-----------|-------------|
+| `useUser(userId)` | `string \| number \| undefined` | Fetch a single user |
+| `useUserSearch(query)` | `string` | Search users |
+| `useUserTracks(userId)` | `string \| number \| undefined` | Get a user's tracks |
+| `useUserPlaylists(userId)` | `string \| number \| undefined` | Get a user's playlists |
+| `useUserLikes(userId)` | `string \| number \| undefined` | Get a user's liked tracks |
+| `useUserFollowers(userId)` | `string \| number \| undefined` | Get a user's followers |
+| `useUserFollowings(userId)` | `string \| number \| undefined` | Get a user's followings |
 
-const sc = createSoundCloudRoutes({
-  clientId: process.env.SC_CLIENT_ID!,
-  clientSecret: process.env.SC_CLIENT_SECRET!,
-});
+### Playlists
 
-export default sc.pagesHandler();
-```
+| Hook | Arguments | Description |
+|------|-----------|-------------|
+| `usePlaylist(playlistId)` | `string \| number \| undefined` | Fetch a single playlist |
+| `usePlaylistTracks(playlistId)` | `string \| number \| undefined` | Get tracks in a playlist |
+| `usePlaylistSearch(query)` | `string` | Search playlists |
 
-## Hooks
+### Player
 
-### `useTrackSearch(query: string, options?: { limit?: number })`
+| Hook | Arguments | Description |
+|------|-----------|-------------|
+| `usePlayer(streamUrl)` | `string \| undefined` | Audio player with play/pause/seek |
 
-Search for tracks. Returns `{ data: SoundCloudTrack[] | null, loading, error }`.
+## Server Routes
 
-### `useTrack(trackId: string | number)`
+All routes are available via the catch-all handler and as individual methods on the routes object.
 
-Fetch a single track by ID. Returns `{ data: SoundCloudTrack | null, loading, error }`.
+### Search
 
-### `useUser(userId: string | number)`
+| Route | Method | Description |
+|-------|--------|-------------|
+| `GET /search/tracks?q=...` | `searchTracks(q, page?)` | Search tracks |
+| `GET /search/users?q=...` | `searchUsers(q)` | Search users |
+| `GET /search/playlists?q=...` | `searchPlaylists(q)` | Search playlists |
 
-Fetch a single user by ID. Returns `{ data: SoundCloudUser | null, loading, error }`.
+### Tracks
 
-### `usePlayer(trackId: string | number)`
+| Route | Method | Description |
+|-------|--------|-------------|
+| `GET /tracks/:id` | `getTrack(id)` | Get track details |
+| `GET /tracks/:id/stream` | `getTrackStreams(id)` | Get stream URLs |
+| `GET /tracks/:id/comments` | `getTrackComments(id)` | Get track comments |
+| `GET /tracks/:id/likes` | `getTrackLikes(id)` | Get track likes |
+| `GET /tracks/:id/related` | `getRelatedTracks(id)` | Get related tracks |
 
-Manages an HTML5 Audio element for streaming. Returns:
+### Users
 
-```ts
-{
-  playing: boolean;
-  progress: number;  // current time in seconds
-  duration: number;  // total duration in seconds
-  play(): void;
-  pause(): void;
-  toggle(): void;
-  seek(time: number): void;
-}
-```
+| Route | Method | Description |
+|-------|--------|-------------|
+| `GET /users/:id` | `getUser(id)` | Get user details |
+| `GET /users/:id/tracks` | `getUserTracks(id, limit?)` | Get user's tracks |
+| `GET /users/:id/playlists` | `getUserPlaylists(id)` | Get user's playlists |
+| `GET /users/:id/likes/tracks` | `getUserLikesTracks(id)` | Get user's liked tracks |
+| `GET /users/:id/followers` | `getFollowers(id)` | Get user's followers |
+| `GET /users/:id/followings` | `getFollowings(id)` | Get user's followings |
 
-## API Routes
+### Playlists
 
-The server handler supports these routes:
+| Route | Method | Description |
+|-------|--------|-------------|
+| `GET /playlists/:id` | `getPlaylist(id)` | Get playlist details |
+| `GET /playlists/:id/tracks` | `getPlaylistTracks(id)` | Get playlist tracks |
 
-| Route | Description |
-|---|---|
-| `/search/tracks?q=...&page=...` | Search tracks |
-| `/tracks/:id` | Get track by ID |
-| `/tracks/:id/stream` | Get stream URLs for a track |
-| `/users/:id` | Get user by ID |
-| `/users/:id/tracks` | Get user's tracks |
+## Types
 
-## Provider
+All SoundCloud types are re-exported from `soundcloud-api-ts`:
 
-```tsx
-<SoundCloudProvider apiPrefix="/api/soundcloud">
-  {children}
-</SoundCloudProvider>
+```ts
+import type {
+  SoundCloudTrack,
+  SoundCloudUser,
+  SoundCloudPlaylist,
+  SoundCloudComment,
+  SoundCloudStreams,
+} from "soundcloud-api-ts-next";
 ```
 
-The `apiPrefix` prop configures where the hooks send requests. Default: `"/api/soundcloud"`.
-
 ## License
 
 MIT

package/dist/index.cjs

@@ -170,10 +170,336 @@ function usePlayer(trackId) {
   return { playing, progress, duration, play, pause, toggle, seek };
 }
 
+// src/client/hooks/useUserTracks.ts
+
+function useUserTracks(userId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (userId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/users/${userId}/tracks`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [userId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useUserPlaylists.ts
+
+function useUserPlaylists(userId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (userId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/users/${userId}/playlists`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [userId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useUserLikes.ts
+
+function useUserLikes(userId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (userId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/users/${userId}/likes/tracks`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [userId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useUserFollowers.ts
+
+function useUserFollowers(userId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (userId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/users/${userId}/followers`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [userId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useUserFollowings.ts
+
+function useUserFollowings(userId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (userId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/users/${userId}/followings`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [userId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useTrackComments.ts
+
+function useTrackComments(trackId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (trackId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/tracks/${trackId}/comments`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [trackId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useTrackLikes.ts
+
+function useTrackLikes(trackId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (trackId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/tracks/${trackId}/likes`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [trackId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useRelatedTracks.ts
+
+function useRelatedTracks(trackId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (trackId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/tracks/${trackId}/related`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [trackId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/usePlaylist.ts
+
+function usePlaylist(playlistId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (playlistId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/playlists/${playlistId}`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then(setData).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [playlistId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/usePlaylistTracks.ts
+
+function usePlaylistTracks(playlistId) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (playlistId == null) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetch(`${apiPrefix}/playlists/${playlistId}/tracks`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [playlistId, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/usePlaylistSearch.ts
+
+function usePlaylistSearch(query) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (!query) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    const params = new URLSearchParams({ q: query });
+    fetch(`${apiPrefix}/search/playlists?${params}`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [query, apiPrefix]);
+  return { data, loading, error };
+}
+
+// src/client/hooks/useUserSearch.ts
+
+function useUserSearch(query) {
+  const { apiPrefix } = useSoundCloudContext();
+  const [data, setData] = _react.useState.call(void 0, null);
+  const [loading, setLoading] = _react.useState.call(void 0, false);
+  const [error, setError] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (!query) {
+      setData(null);
+      return;
+    }
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    const params = new URLSearchParams({ q: query });
+    fetch(`${apiPrefix}/search/users?${params}`, { signal: controller.signal }).then((res) => {
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    }).then((json) => setData(_nullishCoalesce(json.collection, () => ( json)))).catch((err) => {
+      if (err.name !== "AbortError") setError(err);
+    }).finally(() => setLoading(false));
+    return () => controller.abort();
+  }, [query, apiPrefix]);
+  return { data, loading, error };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 
 
 
 
 
-exports.SoundCloudProvider = SoundCloudProvider; exports.usePlayer = usePlayer; exports.useSoundCloudContext = useSoundCloudContext; exports.useTrack = useTrack; exports.useTrackSearch = useTrackSearch; exports.useUser = useUser;
+exports.SoundCloudProvider = SoundCloudProvider; exports.usePlayer = usePlayer; exports.usePlaylist = usePlaylist; exports.usePlaylistSearch = usePlaylistSearch; exports.usePlaylistTracks = usePlaylistTracks; exports.useRelatedTracks = useRelatedTracks; exports.useSoundCloudContext = useSoundCloudContext; exports.useTrack = useTrack; exports.useTrackComments = useTrackComments; exports.useTrackLikes = useTrackLikes; exports.useTrackSearch = useTrackSearch; exports.useUser = useUser; exports.useUserFollowers = useUserFollowers; exports.useUserFollowings = useUserFollowings; exports.useUserLikes = useUserLikes; exports.useUserPlaylists = useUserPlaylists; exports.useUserSearch = useUserSearch; exports.useUserTracks = useUserTracks;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { SoundCloudTrack, SoundCloudUser } from 'soundcloud-api-ts';
+import { SoundCloudTrack, SoundCloudUser, SoundCloudPlaylist, SoundCloudComment } from 'soundcloud-api-ts';
 export { SoundCloudActivitiesResponse, SoundCloudActivity, SoundCloudComment, SoundCloudMe, SoundCloudPaginatedResponse, SoundCloudPlaylist, SoundCloudStreams, SoundCloudTrack, SoundCloudUser, SoundCloudWebProfile } from 'soundcloud-api-ts';
 
 interface SoundCloudContextValue {
@@ -49,4 +49,28 @@ declare function useUser(userId: string | number | undefined): HookResult<SoundC
 
 declare function usePlayer(trackId: string | number | undefined): PlayerState;
 
-export { type HookResult, type PlayerState, SoundCloudProvider, type SoundCloudProviderProps, type SoundCloudRoutesConfig, type UseTrackSearchOptions, usePlayer, useSoundCloudContext, useTrack, useTrackSearch, useUser };
+declare function useUserTracks(userId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function useUserPlaylists(userId: string | number | undefined): HookResult<SoundCloudPlaylist[]>;
+
+declare function useUserLikes(userId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function useUserFollowers(userId: string | number | undefined): HookResult<SoundCloudUser[]>;
+
+declare function useUserFollowings(userId: string | number | undefined): HookResult<SoundCloudUser[]>;
+
+declare function useTrackComments(trackId: string | number | undefined): HookResult<SoundCloudComment[]>;
+
+declare function useTrackLikes(trackId: string | number | undefined): HookResult<SoundCloudUser[]>;
+
+declare function useRelatedTracks(trackId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function usePlaylist(playlistId: string | number | undefined): HookResult<SoundCloudPlaylist>;
+
+declare function usePlaylistTracks(playlistId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function usePlaylistSearch(query: string): HookResult<SoundCloudPlaylist[]>;
+
+declare function useUserSearch(query: string): HookResult<SoundCloudUser[]>;
+
+export { type HookResult, type PlayerState, SoundCloudProvider, type SoundCloudProviderProps, type SoundCloudRoutesConfig, type UseTrackSearchOptions, usePlayer, usePlaylist, usePlaylistSearch, usePlaylistTracks, useRelatedTracks, useSoundCloudContext, useTrack, useTrackComments, useTrackLikes, useTrackSearch, useUser, useUserFollowers, useUserFollowings, useUserLikes, useUserPlaylists, useUserSearch, useUserTracks };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { SoundCloudTrack, SoundCloudUser } from 'soundcloud-api-ts';
+import { SoundCloudTrack, SoundCloudUser, SoundCloudPlaylist, SoundCloudComment } from 'soundcloud-api-ts';
 export { SoundCloudActivitiesResponse, SoundCloudActivity, SoundCloudComment, SoundCloudMe, SoundCloudPaginatedResponse, SoundCloudPlaylist, SoundCloudStreams, SoundCloudTrack, SoundCloudUser, SoundCloudWebProfile } from 'soundcloud-api-ts';
 
 interface SoundCloudContextValue {
@@ -49,4 +49,28 @@ declare function useUser(userId: string | number | undefined): HookResult<SoundC
 
 declare function usePlayer(trackId: string | number | undefined): PlayerState;
 
-export { type HookResult, type PlayerState, SoundCloudProvider, type SoundCloudProviderProps, type SoundCloudRoutesConfig, type UseTrackSearchOptions, usePlayer, useSoundCloudContext, useTrack, useTrackSearch, useUser };
+declare function useUserTracks(userId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function useUserPlaylists(userId: string | number | undefined): HookResult<SoundCloudPlaylist[]>;
+
+declare function useUserLikes(userId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function useUserFollowers(userId: string | number | undefined): HookResult<SoundCloudUser[]>;
+
+declare function useUserFollowings(userId: string | number | undefined): HookResult<SoundCloudUser[]>;
+
+declare function useTrackComments(trackId: string | number | undefined): HookResult<SoundCloudComment[]>;
+
+declare function useTrackLikes(trackId: string | number | undefined): HookResult<SoundCloudUser[]>;
+
+declare function useRelatedTracks(trackId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function usePlaylist(playlistId: string | number | undefined): HookResult<SoundCloudPlaylist>;
+
+declare function usePlaylistTracks(playlistId: string | number | undefined): HookResult<SoundCloudTrack[]>;
+
+declare function usePlaylistSearch(query: string): HookResult<SoundCloudPlaylist[]>;
+
+declare function useUserSearch(query: string): HookResult<SoundCloudUser[]>;
+
+export { type HookResult, type PlayerState, SoundCloudProvider, type SoundCloudProviderProps, type SoundCloudRoutesConfig, type UseTrackSearchOptions, usePlayer, usePlaylist, usePlaylistSearch, usePlaylistTracks, useRelatedTracks, useSoundCloudContext, useTrack, useTrackComments, useTrackLikes, useTrackSearch, useUser, useUserFollowers, useUserFollowings, useUserLikes, useUserPlaylists, useUserSearch, useUserTracks };