soundcloud-api-ts 1.4.0 → 1.4.2

package/dist/index.d.mts

@@ -58,7 +58,7 @@ interface AutoRefreshContext {
  *
  * @example
  * ```ts
- * import { scFetch } from 'tsd-soundcloud';
+ * import { scFetch } from 'soundcloud-api-ts';
  *
  * const track = await scFetch<SoundCloudTrack>({
  *   path: '/tracks/123456',
@@ -83,7 +83,7 @@ declare function scFetch<T>(options: RequestOptions, refreshCtx?: AutoRefreshCon
  *
  * @example
  * ```ts
- * import { scFetchUrl } from 'tsd-soundcloud';
+ * import { scFetchUrl } from 'soundcloud-api-ts';
  *
  * const nextPage = await scFetchUrl<SoundCloudPaginatedResponse<SoundCloudTrack>>(
  *   response.next_href,
@@ -143,7 +143,7 @@ interface UpdateTrackParams {
  *
  * @example
  * ```ts
- * import { updateTrack } from 'tsd-soundcloud';
+ * import { updateTrack } from 'soundcloud-api-ts';
  *
  * const updated = await updateTrack(token, 123456, {
  *   title: 'New Title',
@@ -203,7 +203,7 @@ interface CreatePlaylistParams {
  *
  * @example
  * ```ts
- * import { createPlaylist } from 'tsd-soundcloud';
+ * import { createPlaylist } from 'soundcloud-api-ts';
  *
  * const playlist = await createPlaylist(token, {
  *   title: 'My Favorites',
@@ -265,7 +265,7 @@ interface UpdatePlaylistParams {
  *
  * @example
  * ```ts
- * import { updatePlaylist } from 'tsd-soundcloud';
+ * import { updatePlaylist } from 'soundcloud-api-ts';
  *
  * const updated = await updatePlaylist(token, 123456, {
  *   title: 'Updated Title',
@@ -317,7 +317,7 @@ type TokenGetter = () => string | undefined;
  *
  * @example
  * ```ts
- * import { SoundCloudClient } from 'tsd-soundcloud';
+ * import { SoundCloudClient } from 'soundcloud-api-ts';
  *
  * const sc = new SoundCloudClient({
  *   clientId: 'YOUR_CLIENT_ID',
@@ -1297,7 +1297,7 @@ declare namespace SoundCloudClient {
  *
  * @example
  * ```ts
- * import { paginate, searchTracks, scFetchUrl } from 'tsd-soundcloud';
+ * import { paginate, searchTracks, scFetchUrl } from 'soundcloud-api-ts';
  *
  * const pages = paginate(
  *   () => searchTracks(token, 'lofi'),
@@ -1322,7 +1322,7 @@ declare function paginate<T>(firstPage: () => Promise<SoundCloudPaginatedRespons
  *
  * @example
  * ```ts
- * import { paginateItems, searchTracks, scFetchUrl } from 'tsd-soundcloud';
+ * import { paginateItems, searchTracks, scFetchUrl } from 'soundcloud-api-ts';
  *
  * const tracks = paginateItems(
  *   () => searchTracks(token, 'lofi'),
@@ -1348,7 +1348,7 @@ declare function paginateItems<T>(firstPage: () => Promise<SoundCloudPaginatedRe
  *
  * @example
  * ```ts
- * import { fetchAll, searchTracks, scFetchUrl } from 'tsd-soundcloud';
+ * import { fetchAll, searchTracks, scFetchUrl } from 'soundcloud-api-ts';
  *
  * const allTracks = await fetchAll(
  *   () => searchTracks(token, 'lofi'),
@@ -1376,7 +1376,7 @@ declare function fetchAll<T>(firstPage: () => Promise<SoundCloudPaginatedRespons
  *
  * @example
  * ```ts
- * import { getClientToken } from 'tsd-soundcloud';
+ * import { getClientToken } from 'soundcloud-api-ts';
  *
  * const token = await getClientToken('YOUR_CLIENT_ID', 'YOUR_CLIENT_SECRET');
  * console.log(token.access_token);
@@ -1401,7 +1401,7 @@ declare const getClientToken: (clientId: string, clientSecret: string) => Promis
  *
  * @example
  * ```ts
- * import { getUserToken } from 'tsd-soundcloud';
+ * import { getUserToken } from 'soundcloud-api-ts';
  *
  * const token = await getUserToken(
  *   'YOUR_CLIENT_ID',
@@ -1431,7 +1431,7 @@ declare const getUserToken: (clientId: string, clientSecret: string, redirectUri
  *
  * @example
  * ```ts
- * import { refreshUserToken } from 'tsd-soundcloud';
+ * import { refreshUserToken } from 'soundcloud-api-ts';
  *
  * const newToken = await refreshUserToken(
  *   'YOUR_CLIENT_ID',
@@ -1457,7 +1457,7 @@ declare const refreshUserToken: (clientId: string, clientSecret: string, redirec
  *
  * @example
  * ```ts
- * import { signOut } from 'tsd-soundcloud';
+ * import { signOut } from 'soundcloud-api-ts';
  *
  * await signOut('your-access-token');
  * ```
@@ -1478,7 +1478,7 @@ declare const signOut: (accessToken: string) => Promise<void>;
  *
  * @example
  * ```ts
- * import { getAuthorizationUrl, generateCodeVerifier, generateCodeChallenge } from 'tsd-soundcloud';
+ * import { getAuthorizationUrl, generateCodeVerifier, generateCodeChallenge } from 'soundcloud-api-ts';
  *
  * const verifier = generateCodeVerifier();
  * const challenge = await generateCodeChallenge(verifier);
@@ -1505,7 +1505,7 @@ declare function getAuthorizationUrl(clientId: string, redirectUri: string, opti
  *
  * @example
  * ```ts
- * import { generateCodeVerifier, generateCodeChallenge } from 'tsd-soundcloud';
+ * import { generateCodeVerifier, generateCodeChallenge } from 'soundcloud-api-ts';
  *
  * const verifier = generateCodeVerifier();
  * const challenge = await generateCodeChallenge(verifier);
@@ -1526,7 +1526,7 @@ declare function generateCodeVerifier(): string;
  *
  * @example
  * ```ts
- * import { generateCodeVerifier, generateCodeChallenge } from 'tsd-soundcloud';
+ * import { generateCodeVerifier, generateCodeChallenge } from 'soundcloud-api-ts';
  *
  * const verifier = generateCodeVerifier();
  * const challenge = await generateCodeChallenge(verifier);
@@ -1546,7 +1546,7 @@ declare function generateCodeChallenge(verifier: string): Promise<string>;
  *
  * @example
  * ```ts
- * import { getMe } from 'tsd-soundcloud';
+ * import { getMe } from 'soundcloud-api-ts';
  *
  * const me = await getMe(token);
  * console.log(me.username, me.private_tracks_count);
@@ -1566,7 +1566,7 @@ declare const getMe: (token: string) => Promise<SoundCloudMe>;
  *
  * @example
  * ```ts
- * import { getUser } from 'tsd-soundcloud';
+ * import { getUser } from 'soundcloud-api-ts';
  *
  * const user = await getUser(token, 123456);
  * console.log(user.username);
@@ -1587,7 +1587,7 @@ declare const getUser: (token: string, userId: string | number) => Promise<Sound
  *
  * @example
  * ```ts
- * import { getFollowers } from 'tsd-soundcloud';
+ * import { getFollowers } from 'soundcloud-api-ts';
  *
  * const result = await getFollowers(token, 123456, 50);
  * result.collection.forEach(u => console.log(u.username));
@@ -1608,7 +1608,7 @@ declare const getFollowers: (token: string, userId: string | number, limit?: num
  *
  * @example
  * ```ts
- * import { getFollowings } from 'tsd-soundcloud';
+ * import { getFollowings } from 'soundcloud-api-ts';
  *
  * const result = await getFollowings(token, 123456, 50);
  * result.collection.forEach(u => console.log(u.username));
@@ -1629,7 +1629,7 @@ declare const getFollowings: (token: string, userId: string | number, limit?: nu
  *
  * @example
  * ```ts
- * import { getUserTracks } from 'tsd-soundcloud';
+ * import { getUserTracks } from 'soundcloud-api-ts';
  *
  * const result = await getUserTracks(token, 123456, 25);
  * result.collection.forEach(t => console.log(t.title));
@@ -1650,7 +1650,7 @@ declare const getUserTracks: (token: string, userId: string | number, limit?: nu
  *
  * @example
  * ```ts
- * import { getUserPlaylists } from 'tsd-soundcloud';
+ * import { getUserPlaylists } from 'soundcloud-api-ts';
  *
  * const result = await getUserPlaylists(token, 123456, 10);
  * result.collection.forEach(p => console.log(p.title));
@@ -1672,7 +1672,7 @@ declare const getUserPlaylists: (token: string, userId: string | number, limit?:
  *
  * @example
  * ```ts
- * import { getUserLikesTracks } from 'tsd-soundcloud';
+ * import { getUserLikesTracks } from 'soundcloud-api-ts';
  *
  * const result = await getUserLikesTracks(token, 123456, 50);
  * result.collection.forEach(t => console.log(t.title));
@@ -1693,7 +1693,7 @@ declare const getUserLikesTracks: (token: string, userId: string | number, limit
  *
  * @example
  * ```ts
- * import { getUserLikesPlaylists } from 'tsd-soundcloud';
+ * import { getUserLikesPlaylists } from 'soundcloud-api-ts';
  *
  * const result = await getUserLikesPlaylists(token, 123456, 10);
  * result.collection.forEach(p => console.log(p.title));
@@ -1713,7 +1713,7 @@ declare const getUserLikesPlaylists: (token: string, userId: string | number, li
  *
  * @example
  * ```ts
- * import { getUserWebProfiles } from 'tsd-soundcloud';
+ * import { getUserWebProfiles } from 'soundcloud-api-ts';
  *
  * const profiles = await getUserWebProfiles(token, 123456);
  * profiles.forEach(p => console.log(p.service, p.url));
@@ -1733,7 +1733,7 @@ declare const getUserWebProfiles: (token: string, userId: string | number) => Pr
  *
  * @example
  * ```ts
- * import { getTrack } from 'tsd-soundcloud';
+ * import { getTrack } from 'soundcloud-api-ts';
  *
  * const track = await getTrack(token, 123456);
  * console.log(track.title, track.duration);
@@ -1754,7 +1754,7 @@ declare const getTrack: (token: string, trackId: string | number) => Promise<Sou
  *
  * @example
  * ```ts
- * import { getTrackComments } from 'tsd-soundcloud';
+ * import { getTrackComments } from 'soundcloud-api-ts';
  *
  * const result = await getTrackComments(token, 123456, 20);
  * result.collection.forEach(c => console.log(c.body));
@@ -1776,7 +1776,7 @@ declare const getTrackComments: (token: string, trackId: string | number, limit?
  *
  * @example
  * ```ts
- * import { createTrackComment } from 'tsd-soundcloud';
+ * import { createTrackComment } from 'soundcloud-api-ts';
  *
  * const comment = await createTrackComment(token, 123456, 'Great drop!', 60000);
  * console.log(comment.id);
@@ -1797,7 +1797,7 @@ declare const createTrackComment: (token: string, trackId: string | number, body
  *
  * @example
  * ```ts
- * import { getTrackLikes } from 'tsd-soundcloud';
+ * import { getTrackLikes } from 'soundcloud-api-ts';
  *
  * const result = await getTrackLikes(token, 123456, 50);
  * result.collection.forEach(u => console.log(u.username));
@@ -1818,7 +1818,7 @@ declare const getTrackLikes: (token: string, trackId: string | number, limit?: n
  *
  * @example
  * ```ts
- * import { getTrackReposts } from 'tsd-soundcloud';
+ * import { getTrackReposts } from 'soundcloud-api-ts';
  *
  * const result = await getTrackReposts(token, 123456, 50);
  * result.collection.forEach(u => console.log(u.username));
@@ -1839,7 +1839,7 @@ declare const getTrackReposts: (token: string, trackId: string | number, limit?:
  *
  * @example
  * ```ts
- * import { getRelatedTracks } from 'tsd-soundcloud';
+ * import { getRelatedTracks } from 'soundcloud-api-ts';
  *
  * const related = await getRelatedTracks(token, 123456, 5);
  * related.forEach(t => console.log(t.title));
@@ -1859,7 +1859,7 @@ declare const getRelatedTracks: (token: string, trackId: string | number, limit?
  *
  * @example
  * ```ts
- * import { getTrackStreams } from 'tsd-soundcloud';
+ * import { getTrackStreams } from 'soundcloud-api-ts';
  *
  * const streams = await getTrackStreams(token, 123456);
  * console.log(streams.hls_mp3_128_url);
@@ -1878,7 +1878,7 @@ declare const getTrackStreams: (token: string, trackId: string | number) => Prom
  *
  * @example
  * ```ts
- * import { likeTrack } from 'tsd-soundcloud';
+ * import { likeTrack } from 'soundcloud-api-ts';
  *
  * const success = await likeTrack(token, 123456);
  * ```
@@ -1896,7 +1896,7 @@ declare const likeTrack: (token: string, trackId: string | number) => Promise<bo
  *
  * @example
  * ```ts
- * import { unlikeTrack } from 'tsd-soundcloud';
+ * import { unlikeTrack } from 'soundcloud-api-ts';
  *
  * const success = await unlikeTrack(token, 123456);
  * ```
@@ -1914,7 +1914,7 @@ declare const unlikeTrack: (token: string, trackId: string | number) => Promise<
  *
  * @example
  * ```ts
- * import { deleteTrack } from 'tsd-soundcloud';
+ * import { deleteTrack } from 'soundcloud-api-ts';
  *
  * await deleteTrack(token, 123456);
  * ```
@@ -1933,7 +1933,7 @@ declare const deleteTrack: (token: string, trackId: string | number) => Promise<
  *
  * @example
  * ```ts
- * import { getPlaylist } from 'tsd-soundcloud';
+ * import { getPlaylist } from 'soundcloud-api-ts';
  *
  * const playlist = await getPlaylist(token, 123456);
  * console.log(playlist.title, playlist.track_count);
@@ -1955,7 +1955,7 @@ declare const getPlaylist: (token: string, playlistId: string | number) => Promi
  *
  * @example
  * ```ts
- * import { getPlaylistTracks } from 'tsd-soundcloud';
+ * import { getPlaylistTracks } from 'soundcloud-api-ts';
  *
  * const result = await getPlaylistTracks(token, 123456, 25);
  * result.collection.forEach(t => console.log(t.title));
@@ -1976,7 +1976,7 @@ declare const getPlaylistTracks: (token: string, playlistId: string | number, li
  *
  * @example
  * ```ts
- * import { getPlaylistReposts } from 'tsd-soundcloud';
+ * import { getPlaylistReposts } from 'soundcloud-api-ts';
  *
  * const result = await getPlaylistReposts(token, 123456, 50);
  * result.collection.forEach(u => console.log(u.username));
@@ -1995,7 +1995,7 @@ declare const getPlaylistReposts: (token: string, playlistId: string | number, l
  *
  * @example
  * ```ts
- * import { deletePlaylist } from 'tsd-soundcloud';
+ * import { deletePlaylist } from 'soundcloud-api-ts';
  *
  * await deletePlaylist(token, 123456);
  * ```
@@ -2015,7 +2015,7 @@ declare const deletePlaylist: (token: string, playlistId: string | number) => Pr
  *
  * @example
  * ```ts
- * import { searchTracks } from 'tsd-soundcloud';
+ * import { searchTracks } from 'soundcloud-api-ts';
  *
  * const result = await searchTracks(token, 'lofi hip hop');
  * result.collection.forEach(t => console.log(t.title));
@@ -2036,7 +2036,7 @@ declare const searchTracks: (token: string, query: string, pageNumber?: number)
  *
  * @example
  * ```ts
- * import { searchUsers } from 'tsd-soundcloud';
+ * import { searchUsers } from 'soundcloud-api-ts';
  *
  * const result = await searchUsers(token, 'deadmau5');
  * result.collection.forEach(u => console.log(u.username));
@@ -2057,7 +2057,7 @@ declare const searchUsers: (token: string, query: string, pageNumber?: number) =
  *
  * @example
  * ```ts
- * import { searchPlaylists } from 'tsd-soundcloud';
+ * import { searchPlaylists } from 'soundcloud-api-ts';
  *
  * const result = await searchPlaylists(token, 'chill vibes');
  * result.collection.forEach(p => console.log(p.title));
@@ -2079,7 +2079,7 @@ declare const searchPlaylists: (token: string, query: string, pageNumber?: numbe
  *
  * @example
  * ```ts
- * import { resolveUrl } from 'tsd-soundcloud';
+ * import { resolveUrl } from 'soundcloud-api-ts';
  *
  * const apiUrl = await resolveUrl(token, 'https://soundcloud.com/deadmau5/strobe');
  * console.log(apiUrl); // "https://api.soundcloud.com/tracks/..."
@@ -2099,7 +2099,7 @@ declare const resolveUrl: (token: string, url: string) => Promise<string>;
  *
  * @example
  * ```ts
- * import { getMeActivities } from 'tsd-soundcloud';
+ * import { getMeActivities } from 'soundcloud-api-ts';
  *
  * const activities = await getMeActivities(token, 25);
  * activities.collection.forEach(a => console.log(a.type));
@@ -2116,6 +2116,14 @@ declare const getMeActivities: (token: string, limit?: number) => Promise<SoundC
  * @returns Activities response
  * @throws {SoundCloudError} When the API returns an error
  *
+ * @example
+ * ```ts
+ * import { getMeActivitiesOwn } from 'soundcloud-api-ts';
+ *
+ * const activities = await getMeActivitiesOwn(token, 25);
+ * activities.collection.forEach(a => console.log(a.type));
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/me/get_me_activities_all_own
  */
 declare const getMeActivitiesOwn: (token: string, limit?: number) => Promise<SoundCloudActivitiesResponse>;
@@ -2127,6 +2135,14 @@ declare const getMeActivitiesOwn: (token: string, limit?: number) => Promise<Sou
  * @returns Activities response filtered to track activities
  * @throws {SoundCloudError} When the API returns an error
  *
+ * @example
+ * ```ts
+ * import { getMeActivitiesTracks } from 'soundcloud-api-ts';
+ *
+ * const activities = await getMeActivitiesTracks(token, 25);
+ * activities.collection.forEach(a => console.log(a.type));
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/me/get_me_activities_tracks
  */
 declare const getMeActivitiesTracks: (token: string, limit?: number) => Promise<SoundCloudActivitiesResponse>;
@@ -2141,7 +2157,7 @@ declare const getMeActivitiesTracks: (token: string, limit?: number) => Promise<
  *
  * @example
  * ```ts
- * import { getMeLikesTracks } from 'tsd-soundcloud';
+ * import { getMeLikesTracks } from 'soundcloud-api-ts';
  *
  * const result = await getMeLikesTracks(token, 50);
  * result.collection.forEach(t => console.log(t.title));
@@ -2158,6 +2174,14 @@ declare const getMeLikesTracks: (token: string, limit?: number) => Promise<Sound
  * @returns Paginated list of liked playlists
  * @throws {SoundCloudError} When the API returns an error
  *
+ * @example
+ * ```ts
+ * import { getMeLikesPlaylists } from 'soundcloud-api-ts';
+ *
+ * const result = await getMeLikesPlaylists(token, 50);
+ * result.collection.forEach(p => console.log(p.title));
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/me/get_me_likes_playlists
  */
 declare const getMeLikesPlaylists: (token: string, limit?: number) => Promise<SoundCloudPaginatedResponse<SoundCloudPlaylist>>;
@@ -2170,6 +2194,14 @@ declare const getMeLikesPlaylists: (token: string, limit?: number) => Promise<So
  * @returns Paginated list of followed users
  * @throws {SoundCloudError} When the API returns an error
  *
+ * @example
+ * ```ts
+ * import { getMeFollowings } from 'soundcloud-api-ts';
+ *
+ * const result = await getMeFollowings(token, 50);
+ * result.collection.forEach(u => console.log(u.username));
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/me/get_me_followings
  */
 declare const getMeFollowings: (token: string, limit?: number) => Promise<SoundCloudPaginatedResponse<SoundCloudUser>>;
@@ -2181,6 +2213,14 @@ declare const getMeFollowings: (token: string, limit?: number) => Promise<SoundC
  * @returns Paginated list of tracks from followed users
  * @throws {SoundCloudError} When the API returns an error
  *
+ * @example
+ * ```ts
+ * import { getMeFollowingsTracks } from 'soundcloud-api-ts';
+ *
+ * const result = await getMeFollowingsTracks(token, 50);
+ * result.collection.forEach(t => console.log(t.title));
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/me/get_me_followings_tracks
  */
 declare const getMeFollowingsTracks: (token: string, limit?: number) => Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>;
@@ -2193,7 +2233,7 @@ declare const getMeFollowingsTracks: (token: string, limit?: number) => Promise<
  *
  * @example
  * ```ts
- * import { followUser } from 'tsd-soundcloud';
+ * import { followUser } from 'soundcloud-api-ts';
  *
  * await followUser(token, 123456);
  * ```
@@ -2210,7 +2250,7 @@ declare const followUser: (token: string, userUrn: string | number) => Promise<v
  *
  * @example
  * ```ts
- * import { unfollowUser } from 'tsd-soundcloud';
+ * import { unfollowUser } from 'soundcloud-api-ts';
  *
  * await unfollowUser(token, 123456);
  * ```
@@ -2229,7 +2269,7 @@ declare const unfollowUser: (token: string, userUrn: string | number) => Promise
  *
  * @example
  * ```ts
- * import { getMeFollowers } from 'tsd-soundcloud';
+ * import { getMeFollowers } from 'soundcloud-api-ts';
  *
  * const result = await getMeFollowers(token, 50);
  * result.collection.forEach(u => console.log(u.username));
@@ -2249,7 +2289,7 @@ declare const getMeFollowers: (token: string, limit?: number) => Promise<SoundCl
  *
  * @example
  * ```ts
- * import { getMePlaylists } from 'tsd-soundcloud';
+ * import { getMePlaylists } from 'soundcloud-api-ts';
  *
  * const result = await getMePlaylists(token, 10);
  * result.collection.forEach(p => console.log(p.title));
@@ -2259,7 +2299,24 @@ declare const getMeFollowers: (token: string, limit?: number) => Promise<SoundCl
  */
 declare const getMePlaylists: (token: string, limit?: number) => Promise<SoundCloudPaginatedResponse<SoundCloudPlaylist>>;
 
-/** GET /me/tracks */
+/**
+ * Fetch tracks uploaded by the authenticated user.
+ *
+ * @param token - OAuth access token
+ * @param limit - Maximum number of tracks per page
+ * @returns Paginated list of the user's tracks
+ * @throws {SoundCloudError} When the API returns an error
+ *
+ * @example
+ * ```ts
+ * import { getMeTracks } from 'soundcloud-api-ts';
+ *
+ * const result = await getMeTracks(token, 50);
+ * result.collection.forEach(t => console.log(t.title));
+ * ```
+ *
+ * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/me/get_me_tracks
+ */
 declare const getMeTracks: (token: string, limit?: number) => Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>;
 
 /**
@@ -2269,6 +2326,13 @@ declare const getMeTracks: (token: string, limit?: number) => Promise<SoundCloud
  * @param playlistId - The playlist's numeric ID or URN
  * @returns `true` if the like was successful, `false` on failure
  *
+ * @example
+ * ```ts
+ * import { likePlaylist } from 'soundcloud-api-ts';
+ *
+ * const success = await likePlaylist(token, 789012);
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/likes/post_likes_playlists__playlist_id_
  */
 declare const likePlaylist: (token: string, playlistId: string | number) => Promise<boolean>;
@@ -2279,6 +2343,13 @@ declare const likePlaylist: (token: string, playlistId: string | number) => Prom
  * @param playlistId - The playlist's numeric ID or URN
  * @returns `true` if the unlike was successful, `false` on failure
  *
+ * @example
+ * ```ts
+ * import { unlikePlaylist } from 'soundcloud-api-ts';
+ *
+ * const success = await unlikePlaylist(token, 789012);
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/likes/delete_likes_playlists__playlist_id_
  */
 declare const unlikePlaylist: (token: string, playlistId: string | number) => Promise<boolean>;
@@ -2292,7 +2363,7 @@ declare const unlikePlaylist: (token: string, playlistId: string | number) => Pr
  *
  * @example
  * ```ts
- * import { repostTrack } from 'tsd-soundcloud';
+ * import { repostTrack } from 'soundcloud-api-ts';
  *
  * const success = await repostTrack(token, 123456);
  * ```
@@ -2307,6 +2378,13 @@ declare const repostTrack: (token: string, trackId: string | number) => Promise<
  * @param trackId - The track's numeric ID or URN
  * @returns `true` if the unrepost was successful, `false` on failure
  *
+ * @example
+ * ```ts
+ * import { unrepostTrack } from 'soundcloud-api-ts';
+ *
+ * const success = await unrepostTrack(token, 123456);
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/reposts/delete_reposts_tracks__track_id_
  */
 declare const unrepostTrack: (token: string, trackId: string | number) => Promise<boolean>;
@@ -2317,6 +2395,13 @@ declare const unrepostTrack: (token: string, trackId: string | number) => Promis
  * @param playlistId - The playlist's numeric ID or URN
  * @returns `true` if the repost was successful, `false` on failure
  *
+ * @example
+ * ```ts
+ * import { repostPlaylist } from 'soundcloud-api-ts';
+ *
+ * const success = await repostPlaylist(token, 789012);
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/reposts/post_reposts_playlists__playlist_id_
  */
 declare const repostPlaylist: (token: string, playlistId: string | number) => Promise<boolean>;
@@ -2327,12 +2412,30 @@ declare const repostPlaylist: (token: string, playlistId: string | number) => Pr
  * @param playlistId - The playlist's numeric ID or URN
  * @returns `true` if the unrepost was successful, `false` on failure
  *
+ * @example
+ * ```ts
+ * import { unrepostPlaylist } from 'soundcloud-api-ts';
+ *
+ * const success = await unrepostPlaylist(token, 789012);
+ * ```
+ *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/reposts/delete_reposts_playlists__playlist_id_
  */
 declare const unrepostPlaylist: (token: string, playlistId: string | number) => Promise<boolean>;
 
 /**
  * Returns an encoded SoundCloud widget embed URL for a given track ID.
+ *
+ * @param trackId - The track's numeric ID or string identifier
+ * @returns URL-encoded widget embed URL string
+ *
+ * @example
+ * ```ts
+ * import { getSoundCloudWidgetUrl } from 'soundcloud-api-ts';
+ *
+ * const widgetUrl = getSoundCloudWidgetUrl(123456);
+ * console.log(widgetUrl);
+ * ```
  */
 declare const getSoundCloudWidgetUrl: (trackId: string | number) => string;