@saavn-labs/sdk 0.1.0

package/dist/saavn/operations/get-trending/index.d.ts

@@ -0,0 +1,288 @@
+import { SaavnGetTrendingSchema } from './schema.ops';
+export declare const SaavnGetTrending: {
+    all: {
+        call: string;
+        schema: {
+            readonly params: import("zod").ZodObject<{}, import("zod/v4/core").$strict>;
+            readonly response: import("zod").ZodArray<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                subtitle: import("zod").ZodString;
+                header_desc: import("zod").ZodString;
+                perma_url: import("zod").ZodString;
+                image: import("zod").ZodString;
+                language: import("zod").ZodString;
+                year: import("zod").ZodString;
+                play_count: import("zod").ZodString;
+                explicit_content: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"album">;
+                more_info: import("zod").ZodObject<{
+                    release_date: import("zod").ZodString;
+                    song_count: import("zod").ZodString;
+                    artistMap: import("zod").ZodObject<{
+                        primary_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        featured_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                    }, import("zod/v4/core").$loose>;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>, import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                subtitle: import("zod").ZodString;
+                header_desc: import("zod").ZodString;
+                perma_url: import("zod").ZodString;
+                image: import("zod").ZodString;
+                language: import("zod").ZodString;
+                year: import("zod").ZodString;
+                play_count: import("zod").ZodString;
+                explicit_content: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"playlist">;
+                more_info: import("zod").ZodObject<{
+                    listid: import("zod").ZodString;
+                    isWeekly: import("zod").ZodString;
+                    listname: import("zod").ZodString;
+                    firstname: import("zod").ZodString;
+                    song_count: import("zod").ZodString;
+                    follower_count: import("zod").ZodString;
+                    fan_count: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>, import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                subtitle: import("zod").ZodString;
+                header_desc: import("zod").ZodString;
+                perma_url: import("zod").ZodString;
+                image: import("zod").ZodString;
+                language: import("zod").ZodString;
+                year: import("zod").ZodString;
+                play_count: import("zod").ZodString;
+                explicit_content: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"song">;
+                more_info: import("zod").ZodObject<{
+                    music: import("zod").ZodString;
+                    album_id: import("zod").ZodString;
+                    album: import("zod").ZodString;
+                    label: import("zod").ZodString;
+                    label_id: import("zod").ZodNullable<import("zod").ZodString>;
+                    origin: import("zod").ZodString;
+                    is_dolby_content: import("zod").ZodBoolean;
+                    encrypted_media_url: import("zod").ZodString;
+                    encrypted_drm_media_url: import("zod").ZodString;
+                    album_url: import("zod").ZodString;
+                    duration: import("zod").ZodString;
+                    has_lyrics: import("zod").ZodString;
+                    lyrics_snippet: import("zod").ZodString;
+                    lyrics_id: import("zod").ZodOptional<import("zod").ZodString>;
+                    copyright_text: import("zod").ZodString;
+                    release_date: import("zod").ZodNullable<import("zod").ZodString>;
+                    artistMap: import("zod").ZodLazy<import("zod").ZodObject<{
+                        primary_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        featured_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                    }, import("zod/v4/core").$loose>>;
+                    vcode: import("zod").ZodOptional<import("zod").ZodString>;
+                    vlink: import("zod").ZodOptional<import("zod").ZodString>;
+                    label_url: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>], "type">>;
+        };
+        mapper: (data: import("zod").infer<typeof SaavnGetTrendingSchema.all.response>) => (import("../../../core/models").Album | import("../../../core/models").Song | import("../../../core/models").Playlist)[];
+    };
+    albums: {
+        call: string;
+        schema: {
+            readonly params: import("zod").ZodObject<{
+                entity_type: import("zod").ZodLiteral<"album">;
+                entity_language: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            readonly response: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                subtitle: import("zod").ZodString;
+                header_desc: import("zod").ZodString;
+                perma_url: import("zod").ZodString;
+                image: import("zod").ZodString;
+                language: import("zod").ZodString;
+                year: import("zod").ZodString;
+                play_count: import("zod").ZodString;
+                explicit_content: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"album">;
+                more_info: import("zod").ZodObject<{
+                    release_date: import("zod").ZodString;
+                    song_count: import("zod").ZodString;
+                    artistMap: import("zod").ZodObject<{
+                        primary_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        featured_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                    }, import("zod/v4/core").$loose>;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>>;
+        };
+        mapper: (data: import("zod").infer<typeof SaavnGetTrendingSchema.albums.response>) => import("../../../core/models").Album[];
+    };
+    playlists: {
+        call: string;
+        schema: {
+            readonly params: import("zod").ZodObject<{
+                entity_type: import("zod").ZodLiteral<"playlist">;
+                entity_language: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            readonly response: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                subtitle: import("zod").ZodString;
+                header_desc: import("zod").ZodString;
+                perma_url: import("zod").ZodString;
+                image: import("zod").ZodString;
+                language: import("zod").ZodString;
+                year: import("zod").ZodString;
+                play_count: import("zod").ZodString;
+                explicit_content: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"playlist">;
+                more_info: import("zod").ZodObject<{
+                    listid: import("zod").ZodString;
+                    isWeekly: import("zod").ZodString;
+                    listname: import("zod").ZodString;
+                    firstname: import("zod").ZodString;
+                    song_count: import("zod").ZodString;
+                    follower_count: import("zod").ZodString;
+                    fan_count: import("zod").ZodString;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>>;
+        };
+        mapper: (data: import("zod").infer<typeof SaavnGetTrendingSchema.playlists.response>) => import("../../../core/models").Playlist[];
+    };
+    songs: {
+        call: string;
+        schema: {
+            readonly params: import("zod").ZodObject<{
+                entity_type: import("zod").ZodLiteral<"song">;
+                entity_language: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            readonly response: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                subtitle: import("zod").ZodString;
+                header_desc: import("zod").ZodString;
+                perma_url: import("zod").ZodString;
+                image: import("zod").ZodString;
+                language: import("zod").ZodString;
+                year: import("zod").ZodString;
+                play_count: import("zod").ZodString;
+                explicit_content: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"song">;
+                more_info: import("zod").ZodObject<{
+                    music: import("zod").ZodString;
+                    album_id: import("zod").ZodString;
+                    album: import("zod").ZodString;
+                    label: import("zod").ZodString;
+                    label_id: import("zod").ZodNullable<import("zod").ZodString>;
+                    origin: import("zod").ZodString;
+                    is_dolby_content: import("zod").ZodBoolean;
+                    encrypted_media_url: import("zod").ZodString;
+                    encrypted_drm_media_url: import("zod").ZodString;
+                    album_url: import("zod").ZodString;
+                    duration: import("zod").ZodString;
+                    has_lyrics: import("zod").ZodString;
+                    lyrics_snippet: import("zod").ZodString;
+                    lyrics_id: import("zod").ZodOptional<import("zod").ZodString>;
+                    copyright_text: import("zod").ZodString;
+                    release_date: import("zod").ZodNullable<import("zod").ZodString>;
+                    artistMap: import("zod").ZodLazy<import("zod").ZodObject<{
+                        primary_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        featured_artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                        artists: import("zod").ZodArray<import("zod").ZodObject<{
+                            id: import("zod").ZodString;
+                            name: import("zod").ZodString;
+                            role: import("zod").ZodString;
+                            image: import("zod").ZodString;
+                            type: import("zod").ZodLiteral<"artist">;
+                            perma_url: import("zod").ZodString;
+                        }, import("zod/v4/core").$loose>>;
+                    }, import("zod/v4/core").$loose>>;
+                    vcode: import("zod").ZodOptional<import("zod").ZodString>;
+                    vlink: import("zod").ZodOptional<import("zod").ZodString>;
+                    label_url: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$loose>;
+            }, import("zod/v4/core").$loose>>;
+        };
+        mapper: (data: import("zod").infer<typeof SaavnGetTrendingSchema.songs.response>) => import("../../../core/models").Song[];
+    };
+};

package/dist/saavn/operations/get-trending/index.js

@@ -0,0 +1,24 @@
+import { SaavnGetTrendingMapper } from './mapper.ops';
+import { SaavnGetTrendingSchema } from './schema.ops';
+export const SaavnGetTrending = {
+    all: {
+        call: 'content.getTrending',
+        schema: SaavnGetTrendingSchema.all,
+        mapper: SaavnGetTrendingMapper.all,
+    },
+    albums: {
+        call: 'content.getTrending',
+        schema: SaavnGetTrendingSchema.albums,
+        mapper: SaavnGetTrendingMapper.albums,
+    },
+    playlists: {
+        call: 'content.getTrending',
+        schema: SaavnGetTrendingSchema.playlists,
+        mapper: SaavnGetTrendingMapper.playlists,
+    },
+    songs: {
+        call: 'content.getTrending',
+        schema: SaavnGetTrendingSchema.songs,
+        mapper: SaavnGetTrendingMapper.songs,
+    },
+};

package/dist/saavn/operations/get-trending/mapper.ops.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { SaavnGetTrendingSchema } from './schema.ops';
+import type { Album, Playlist, Song } from '../../../core/models';
+import type { SaavnTrendingAlbum, SaavnTrendingPlaylist, SaavnTrendingSongEntity } from '../../../saavn/entities';
+export declare function mapTrendingAlbum(data: z.infer<typeof SaavnTrendingAlbum>): Album;
+export declare function mapTrendingPlaylist(data: z.infer<typeof SaavnTrendingPlaylist>): Playlist;
+export declare function mapTrendingSong(data: z.infer<typeof SaavnTrendingSongEntity>): Song;
+export declare const SaavnGetTrendingMapper: {
+    all: (data: z.infer<typeof SaavnGetTrendingSchema.all.response>) => (Album | Song | Playlist)[];
+    albums: (data: z.infer<typeof SaavnGetTrendingSchema.albums.response>) => Album[];
+    playlists: (data: z.infer<typeof SaavnGetTrendingSchema.playlists.response>) => Playlist[];
+    songs: (data: z.infer<typeof SaavnGetTrendingSchema.songs.response>) => Song[];
+};

package/dist/saavn/operations/get-trending/mapper.ops.js

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+import { SaavnGetTrendingSchema } from './schema.ops';
+import { mapArtistBase, parseImageUrls } from '../../common-mapper';
+export function mapTrendingAlbum(data) {
+    return {
+        id: data.id,
+        type: 'album',
+        title: data.title,
+        subtitle: data.subtitle,
+        description: data.header_desc,
+        url: data.perma_url,
+        images: parseImageUrls(data.image),
+        language: data.language,
+        year: parseInt(data.year, 10),
+        stats: {
+            playCount: parseInt(data.play_count, 10),
+            songCount: data.more_info?.song_count
+                ? parseInt(data.more_info.song_count, 10)
+                : undefined,
+        },
+        flags: {
+            isExplicit: data.explicit_content === '1',
+        },
+        artists: {
+            primary: data.more_info?.artistMap?.primary_artists?.map(mapArtistBase),
+            featured: data.more_info?.artistMap?.featured_artists?.map(mapArtistBase),
+            all: data.more_info?.artistMap?.artists?.map(mapArtistBase),
+        },
+        meta: {
+            releaseDate: data.more_info?.release_date,
+        },
+    };
+}
+export function mapTrendingPlaylist(data) {
+    return {
+        id: data.id,
+        type: 'playlist',
+        title: data.title,
+        subtitle: data.subtitle,
+        description: data.header_desc,
+        url: data.perma_url,
+        images: parseImageUrls(data.image),
+        stats: {
+            songCount: data.more_info?.song_count
+                ? parseInt(data.more_info.song_count, 10)
+                : undefined,
+            followerCount: data.more_info?.follower_count
+                ? parseInt(data.more_info.follower_count, 10)
+                : undefined,
+            fanCount: data.more_info?.fan_count
+                ? parseInt(data.more_info.fan_count, 10)
+                : undefined,
+        },
+        flags: {
+            isExplicit: data.explicit_content === '1',
+            isWeekly: data.more_info?.isWeekly === 'true',
+        },
+        meta: {
+            language: data.language,
+        },
+    };
+}
+export function mapTrendingSong(data) {
+    return {
+        id: data.id,
+        type: 'song',
+        title: data.title,
+        subtitle: data.subtitle,
+        url: data.perma_url,
+        images: parseImageUrls(data.image),
+        album: {
+            id: data.more_info?.album_id,
+            title: data.more_info?.album,
+            url: data.more_info?.album_url,
+        },
+        artists: {
+            primary: data.more_info?.artistMap?.primary_artists?.map(mapArtistBase),
+            featured: data.more_info?.artistMap?.featured_artists?.map(mapArtistBase),
+            all: data.more_info?.artistMap?.artists?.map(mapArtistBase),
+        },
+        duration: parseInt(data.more_info?.duration || '0', 10),
+        language: data.language,
+        year: parseInt(data.year, 10),
+        stats: {
+            playCount: parseInt(data.play_count, 10),
+        },
+        flags: {
+            isExplicit: data.explicit_content === '1',
+            hasLyrics: data.more_info?.has_lyrics === 'true',
+            isDolby: data.more_info?.is_dolby_content,
+        },
+        lyrics: {
+            id: data.more_info?.lyrics_id,
+            snippet: data.more_info?.lyrics_snippet,
+        },
+        media: {
+            encryptedUrl: data.more_info?.encrypted_media_url,
+            previewUrl: data.more_info?.vlink,
+        },
+        meta: {
+            copyright: data.more_info?.copyright_text,
+            label: {
+                id: data.more_info?.label_id || undefined,
+                name: data.more_info?.label,
+                url: data.more_info?.label_url,
+            },
+            releaseDate: data.more_info?.release_date || undefined,
+        },
+    };
+}
+export const SaavnGetTrendingMapper = {
+    all: (data) => {
+        return data.map((item) => {
+            if (item.type === 'album') {
+                return mapTrendingAlbum(item);
+            }
+            else if (item.type === 'playlist') {
+                return mapTrendingPlaylist(item);
+            }
+            else {
+                return mapTrendingSong(item);
+            }
+        });
+    },
+    albums: (data) => {
+        return data.map(mapTrendingAlbum);
+    },
+    playlists: (data) => {
+        return data.map(mapTrendingPlaylist);
+    },
+    songs: (data) => {
+        return data.map(mapTrendingSong);
+    },
+};