@wavezfm/api 0.1.9 → 0.3.0

package/dist/types.d.ts

@@ -65,6 +65,8 @@ export interface AuthUser {
     displayName?: string | null;
     name?: string | null;
     bio?: string | null;
+    country?: string | null;
+    countryCode?: string | null;
     image?: string | null;
     avatar?: string | null;
     avatarId?: string | null;
@@ -84,12 +86,22 @@ export interface AuthUser {
     colorTheme?: string | null;
     timeFormat?: "12h" | "24h" | string | null;
     notifyChatMentions?: boolean;
+    notifyFanToasts?: boolean;
     playMentionSound?: boolean;
+    playWhisperSound?: boolean;
     lastFmScrobblingEnabled?: boolean;
     presenceStatus?: string | null;
     selectedBadgeIds?: string[];
     selectedBadges?: BadgeAssignment[];
     showChatBadge?: boolean;
+    showFanRelationsOnProfile?: boolean;
+    showSuperfansOnProfile?: boolean;
+    showOnlineRoomOnProfile?: boolean;
+    showLastSeenOnProfile?: boolean;
+    blockUnknownWhispers?: boolean;
+    autoOpenIncomingWhispers?: boolean;
+    sfwMode?: boolean;
+    sfwModeAudioEnabled?: boolean;
     subscriptionStatus?: string | null;
     subscriptionCycle?: string | null;
     subscriptionCurrentPeriodStartAt?: string | null;
@@ -130,6 +142,51 @@ export interface RoomSummary {
     } | null;
     [key: string]: unknown;
 }
+export type RoomExternalMediaProvider = "youtube" | "kick" | "google_drive" | "dailymotion" | "direct_mp3" | "direct_mp4" | "direct_m3u" | "direct_m3u8";
+export interface RoomExternalMediaSubtitleTrack {
+    label: string;
+    language: string;
+    url: string;
+    filename: string;
+    sourceFormat: "srt" | "vtt";
+    default?: boolean;
+}
+export interface RoomExternalMediaMetadataResponse {
+    success: true;
+    data: {
+        canonicalUrl: string;
+        title: string | null;
+        durationMs: number | null;
+        subtitles: RoomExternalMediaSubtitleTrack[];
+    };
+}
+export interface RoomExternalMediaValidationResponse {
+    success: true;
+    data: {
+        canonicalUrl: string;
+        provider: RoomExternalMediaProvider;
+        available: boolean;
+        code: string | null;
+        live: boolean;
+    };
+}
+export interface RoomPlaybackHistoryEntry {
+    id: string;
+    trackId: string;
+    title: string;
+    artist: string;
+    djId: string;
+    djUsername: string;
+    djDisplayUsername: string | null;
+    source: "youtube" | "soundcloud";
+    sourceId: string;
+    thumbnailUrl: string | null;
+    durationMs: number;
+    woots: number;
+    grabs: number;
+    mehs: number;
+    playedAt: string;
+}
 export interface RoomQueueUser {
     internalId: string;
     publicId?: number | null;
@@ -216,16 +273,109 @@ export interface PlaylistTrack {
     artist?: string;
     durationMs?: number;
     thumbnailUrl?: string | null;
+    position?: number;
+    isLive?: boolean;
+    clipStartMs?: number | null;
+    clipEndMs?: number | null;
     [key: string]: unknown;
 }
+export interface PlaylistTrackSearchResult {
+    playlist: PlaylistSummary;
+    track: PlaylistTrack;
+}
+export interface PlaylistTrackAvailabilityInput {
+    source: string;
+    sourceId: string;
+}
+export interface PlaylistTrackAvailabilityResult {
+    source: "youtube" | "soundcloud";
+    sourceId: string;
+    status: "available" | "unavailable" | "unknown";
+    reason: string | null;
+}
+export interface PlaylistJsonTrack {
+    source: "youtube" | "soundcloud";
+    sourceId: string;
+    title: string;
+    artist: string;
+    durationMs: number;
+    thumbnailUrl: string | null;
+    isLive: boolean;
+    clipStartMs?: number | null;
+    clipEndMs?: number | null;
+}
+export interface PlaylistJsonExport {
+    schema: "wavezfm.playlist.v1";
+    exportedAt: string;
+    playlist: {
+        name: string;
+        trackCount: number;
+    };
+    tracks: PlaylistJsonTrack[];
+}
+export interface PlaylistJsonImportResult {
+    source: "json";
+    playlistId: string;
+    playlistName: string;
+    sourcePlaylistName: string;
+    totalTracks: number;
+    importedTracks: number;
+    duplicateTracks: number;
+    failedTracks: number;
+    truncated: boolean;
+}
 export interface MediaSearchResult {
     source: string;
     sourceId: string;
     title: string;
     artist?: string;
+    durationMs?: number;
     thumbnailUrl?: string | null;
+    isLive?: boolean;
     [key: string]: unknown;
 }
+export interface MediaSearchResponse {
+    items: MediaSearchResult[];
+    nextPageToken: string | null;
+    previousPageToken: string | null;
+}
+export interface ChatMediaPreviewResponse {
+    previewUrl: string;
+}
+export interface ChatImageUploadResponse {
+    url: string;
+    expiresAt: string;
+    contentType: "image/gif" | "image/jpeg" | "image/png" | "image/webp";
+    size: number;
+}
+export interface GifFavorite {
+    id: string;
+    title: string;
+    previewUrl: string;
+    gifUrl: string;
+    width: number | null;
+    height: number | null;
+    addedAt: string;
+}
+export interface LastFmAccountProfile {
+    username: string;
+    displayName: string | null;
+    avatarUrl: string | null;
+}
+export type LastFmLinkStatus = {
+    status: "idle" | "pending";
+} | {
+    status: "linked";
+    username: string;
+} | {
+    status: "error";
+    error: string;
+};
+export interface LastFmWriteResponse {
+    success: boolean;
+    skipped?: boolean;
+    code?: string;
+}
 export interface ChatMessage {
     id: string;
     userId: string;
@@ -238,6 +388,9 @@ export interface ChatMessage {
     role?: string;
     roomRole?: string;
     platformRole?: string | null;
+    ephemeral?: boolean;
+    persisted?: boolean;
+    targetUserIds?: string[];
     [key: string]: unknown;
 }
 export interface WalletBalance {
@@ -264,10 +417,27 @@ export interface StoreCatalogResponse {
     backgroundSections?: StoreCatalogSection[];
     badgeSections?: StoreCatalogSection[];
     videoFrameSections?: StoreCatalogSection[];
+    miscItems?: MiscStoreItem[];
     premiumShopEnabled?: boolean;
     badgeShopEnabled?: boolean;
     videoFrameShopEnabled?: boolean;
     backgroundShopEnabled?: boolean;
+    miscShopEnabled?: boolean;
+    [key: string]: unknown;
+}
+export interface MiscStoreItem {
+    id: string;
+    kind: "xp_boost" | "display_name_change" | string;
+    name: string;
+    namePtBr?: string | null;
+    nameEnUs?: string | null;
+    description?: string;
+    descriptionPtBr?: string | null;
+    descriptionEnUs?: string | null;
+    currency: "coins" | "diamonds" | string;
+    price: number;
+    xpMultiplierPercent?: number | null;
+    durationMinutes?: number | null;
     [key: string]: unknown;
 }
 export interface StoreCatalogSection {
@@ -396,6 +566,16 @@ export interface RoomBotMessageReplyInput {
 export interface RoomBotSendMessageInput {
     content: string;
     replyTo?: RoomBotMessageReplyInput | null;
+    /** Deliver the message live without storing it in room chat history. */
+    ephemeral?: boolean;
+    /** Restrict an ephemeral message to one currently connected user ID. */
+    targetUserId?: string;
+    /** Restrict an ephemeral message to up to 50 currently connected user IDs. */
+    targetUserIds?: string[];
+}
+export interface RoomBotSendMessageResponse {
+    bot: RoomBotState["bot"];
+    message: ChatMessage;
 }
 export interface RoomBotEditMessageInput {
     content: string;
@@ -428,6 +608,7 @@ export interface SystemStatus {
     badgeShopEnabled: boolean;
     videoFrameShopEnabled: boolean;
     backgroundShopEnabled: boolean;
+    miscShopEnabled?: boolean;
     spotifyEnabled: boolean;
     soundcloudEnabled: boolean;
     globalDonationGoal: SystemDonationGoal | null;
@@ -438,19 +619,43 @@ export interface SystemStatus {
     [key: string]: unknown;
 }
 export interface CheckoutSessionResponse {
-    checkoutUrl: string;
+    uiMode?: "hosted" | "elements" | "mercadopago" | string;
+    checkoutUrl: string | null;
+    clientSecret?: string | null;
+    publishableKey?: string | null;
     [key: string]: unknown;
 }
+export interface NotificationCenterStatus {
+    clearedAt: string | null;
+}
+export interface NotificationCenterClearResponse {
+    ok: true;
+    clearedAt: string;
+}
 export interface UserSettings {
+    userId?: string;
     bio?: string | null;
-    colorTheme?: string | null;
+    country?: string | null;
+    countryCode?: string | null;
+    colorTheme?: "wavezfm" | "wavezfm-black" | string | null;
     timeFormat?: "12h" | "24h" | string | null;
     notifyChatMentions?: boolean;
+    notifyFanToasts?: boolean;
     playMentionSound?: boolean;
+    playWhisperSound?: boolean;
     lastFmScrobblingEnabled?: boolean;
-    presenceStatus?: "online" | "busy" | "away" | string | null;
+    presenceStatus?: "online" | "busy" | "away" | "invisible" | string | null;
     selectedBadgeIds?: string[];
     showChatBadge?: boolean;
+    showFanRelationsOnProfile?: boolean;
+    showSuperfansOnProfile?: boolean;
+    showOnlineRoomOnProfile?: boolean;
+    showLastSeenOnProfile?: boolean;
+    blockUnknownWhispers?: boolean;
+    autoOpenIncomingWhispers?: boolean;
+    sfwMode?: boolean;
+    sfwModeAudioEnabled?: boolean;
+    activeViolationCount?: number;
     [key: string]: unknown;
 }
 export interface TwoFactorStatus {
@@ -483,6 +688,8 @@ export interface RoomBotRealtimeOptions {
     autoReconnect?: boolean;
     reconnectDelayMs?: number;
     reconnectMaxDelayMs?: number;
+    heartbeatIntervalMs?: number;
+    heartbeatTimeoutMs?: number;
     logging?: boolean;
     protocols?: string | string[];
     locale?: WavezApiLocale;

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@wavezfm/api",
-  "version": "0.1.9",
+  "version": "0.3.0",
   "description": "Official JavaScript/TypeScript API client for WavezFM.",
+  "homepage": "https://docs.wavez.fm/docs",
   "type": "module",
   "license": "MIT",
   "sideEffects": false,
@@ -10,7 +11,8 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",