@dubsdotapp/expo 0.5.23 → 0.5.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dubsdotapp/expo",
-  "version": "0.5.23",
+  "version": "0.5.25",
   "description": "React Native SDK for the Dubs betting platform",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/chat/hooks.ts

@@ -12,6 +12,7 @@ import type {
   SentFriendRequest,
   SendMessageParams,
 } from './types';
+import type { WhatsNewPost } from '../types';
 
 // ── Connection ──
 
@@ -362,3 +363,64 @@ export function useRespondToFriendRequest(): {
 
   return { accept, reject, loading };
 }
+
+// ── What's New ────────────────────────────────────────────────────────────
+
+/**
+ * Read-only subscription to the calling app's What's New posts.
+ *
+ * Auto-refreshes via the chat socket when a new `whats_new` notification
+ * arrives, so the unread badge / list update without manual refetch.
+ */
+export function useWhatsNew(): {
+  posts: WhatsNewPost[];
+  unreadCount: number;
+  loading: boolean;
+  refetch: () => Promise<void>;
+  markRead: (postIds: number[]) => Promise<void>;
+  markAllRead: () => Promise<void>;
+} {
+  const { client } = useDubs();
+  const { whatsNewPosts, whatsNewUnreadCount, refreshWhatsNew } = useChatContext();
+  const [loading, setLoading] = useState(false);
+
+  const refetch = useCallback(async () => {
+    setLoading(true);
+    try {
+      await refreshWhatsNew();
+    } finally {
+      setLoading(false);
+    }
+  }, [refreshWhatsNew]);
+
+  const markRead = useCallback(
+    async (postIds: number[]) => {
+      if (postIds.length === 0) return;
+      try {
+        await client.markWhatsNewRead(postIds);
+        await refreshWhatsNew();
+      } catch (err) {
+        console.error('[Dubs:useWhatsNew] markRead error:', err);
+      }
+    },
+    [client, refreshWhatsNew],
+  );
+
+  const markAllRead = useCallback(async () => {
+    try {
+      await client.markAllWhatsNewRead();
+      await refreshWhatsNew();
+    } catch (err) {
+      console.error('[Dubs:useWhatsNew] markAllRead error:', err);
+    }
+  }, [client, refreshWhatsNew]);
+
+  return {
+    posts: whatsNewPosts,
+    unreadCount: whatsNewUnreadCount,
+    loading,
+    refetch,
+    markRead,
+    markAllRead,
+  };
+}

package/src/chat/index.ts

@@ -22,6 +22,7 @@ export {
   useSendFriendRequest,
   useRespondToFriendRequest,
   useCancelFriendRequest,
+  useWhatsNew,
 } from './hooks';
 
 // Types

package/src/chat/provider.tsx

@@ -13,6 +13,7 @@ import type {
   DirectMessage,
   ChatNotification,
 } from './types';
+import type { WhatsNewPost } from '../types';
 
 export interface ChatContextValue {
   /** The underlying socket manager */
@@ -45,6 +46,12 @@ export interface ChatContextValue {
   refreshPendingRequests: () => Promise<void>;
   /** Reload pending friend requests (sent) from REST */
   refreshSentFriendRequests: () => Promise<void>;
+  /** What's New posts for this app */
+  whatsNewPosts: WhatsNewPost[];
+  /** Number of unread What's New posts */
+  whatsNewUnreadCount: number;
+  /** Reload What's New posts + unread count from REST */
+  refreshWhatsNew: () => Promise<void>;
 }
 
 const ChatContext = createContext<ChatContextValue | null>(null);
@@ -72,6 +79,8 @@ export function ChatProvider({ children, autoConnect = true }: ChatProviderProps
   const [friends, setFriends] = useState<FriendUser[]>([]);
   const [pendingRequests, setPendingRequests] = useState<FriendRequest[]>([]);
   const [sentFriendRequests, setSentFriendRequests] = useState<SentFriendRequest[]>([]);
+  const [whatsNewPosts, setWhatsNewPosts] = useState<WhatsNewPost[]>([]);
+  const [whatsNewUnreadCount, setWhatsNewUnreadCount] = useState(0);
 
   // ── REST loaders ──
 
@@ -121,6 +130,18 @@ export function ChatProvider({ children, autoConnect = true }: ChatProviderProps
     }
   }, [client]);
 
+  const refreshWhatsNew = useCallback(async () => {
+    try {
+      const res = await client.getWhatsNewPosts();
+      setWhatsNewPosts(res.posts);
+      // Count unread from the same payload (avoids a second roundtrip)
+      const unread = res.posts.filter((p: WhatsNewPost) => !p.is_read).length;
+      setWhatsNewUnreadCount(unread);
+    } catch (_) {
+      // Server may not yet expose /whats-new endpoints — silent fail
+    }
+  }, [client]);
+
   // ── Socket setup ──
 
   useEffect(() => {
@@ -160,6 +181,8 @@ export function ChatProvider({ children, autoConnect = true }: ChatProviderProps
           refreshSentFriendRequests();
         }
         if (n.type === 'friend_request_declined') refreshSentFriendRequests();
+        // What's New posts: a developer published a new one for this app
+        if (n.type === 'whats_new') refreshWhatsNew();
       },
       onFriendRequestAccepted: () => {
         refreshFriends();
@@ -177,11 +200,12 @@ export function ChatProvider({ children, autoConnect = true }: ChatProviderProps
     refreshFriends().catch(() => {});
     refreshPendingRequests().catch(() => {});
     refreshSentFriendRequests().catch(() => {});
+    refreshWhatsNew().catch(() => {});
 
     return () => {
       chatSocket.disconnect();
     };
-  }, [client, autoConnect, refreshMessages, refreshConversations, refreshFriends, refreshPendingRequests, refreshSentFriendRequests]);
+  }, [client, autoConnect, refreshMessages, refreshConversations, refreshFriends, refreshPendingRequests, refreshSentFriendRequests, refreshWhatsNew]);
 
   // ── Reconnect on app foreground ──
 
@@ -197,14 +221,21 @@ export function ChatProvider({ children, autoConnect = true }: ChatProviderProps
             chatSocket.connect({ host, token });
           }
         }
-        // Refresh data to catch up on missed events
+        // Refresh all key data to catch up on socket events that fired
+        // while the app was backgrounded (declines, accepts, cancels,
+        // new requests, friend removals, etc.)
         refreshMessages();
+        refreshConversations().catch(() => {});
+        refreshFriends().catch(() => {});
+        refreshPendingRequests().catch(() => {});
+        refreshSentFriendRequests().catch(() => {});
+        refreshWhatsNew().catch(() => {});
       }
     };
 
     const sub = AppState.addEventListener('change', handleAppState);
     return () => sub.remove();
-  }, [client, refreshMessages, refreshConversations]);
+  }, [client, refreshMessages, refreshConversations, refreshFriends, refreshPendingRequests, refreshSentFriendRequests, refreshWhatsNew]);
 
   const value = useMemo<ChatContextValue>(
     () => ({
@@ -218,13 +249,16 @@ export function ChatProvider({ children, autoConnect = true }: ChatProviderProps
       friends,
       pendingRequests,
       sentFriendRequests,
+      whatsNewPosts,
+      whatsNewUnreadCount,
       refreshMessages,
       refreshConversations,
       refreshFriends,
       refreshPendingRequests,
       refreshSentFriendRequests,
+      refreshWhatsNew,
     }),
-    [status, messages, onlineUsers, onlineCount, unreadCount, conversations, friends, pendingRequests, sentFriendRequests, refreshMessages, refreshConversations, refreshFriends, refreshPendingRequests, refreshSentFriendRequests],
+    [status, messages, onlineUsers, onlineCount, unreadCount, conversations, friends, pendingRequests, sentFriendRequests, whatsNewPosts, whatsNewUnreadCount, refreshMessages, refreshConversations, refreshFriends, refreshPendingRequests, refreshSentFriendRequests, refreshWhatsNew],
   );
 
   return <ChatContext.Provider value={value}>{children}</ChatContext.Provider>;

package/src/client.ts

@@ -35,6 +35,7 @@ import type {
   CheckUsernameResult,
   LiveScore,
   UiConfig,
+  WhatsNewPost,
   UFCEvent,
   UFCFighterDetail,
   ArcadePool,
@@ -765,6 +766,33 @@ export class DubsClient {
     return this.request('GET', '/social/blocked');
   }
 
+  // ── What's New ──
+
+  /** List published What's New posts for this app, with is_read for the current user. */
+  async getWhatsNewPosts(): Promise<{ posts: WhatsNewPost[] }> {
+    return this.request('GET', '/whats-new/posts');
+  }
+
+  /** Fetch a single What's New post by id. */
+  async getWhatsNewPost(postId: number): Promise<{ post: WhatsNewPost }> {
+    return this.request('GET', `/whats-new/posts/${postId}`);
+  }
+
+  /** Number of unread What's New posts for the current user (this app). */
+  async getWhatsNewUnreadCount(): Promise<{ count: number }> {
+    return this.request('GET', '/whats-new/unread-count');
+  }
+
+  /** Mark specific posts as read. */
+  async markWhatsNewRead(postIds: number[]): Promise<void> {
+    await this.request('POST', '/whats-new/mark-read', { postIds });
+  }
+
+  /** Mark every unread post as read. */
+  async markAllWhatsNewRead(): Promise<{ updated: number }> {
+    return this.request('POST', '/whats-new/mark-all-read');
+  }
+
   // ── App Config ──
 
   /** Fetch the app's UI customization config (accent color, icon, tagline, environment) */

package/src/index.ts

@@ -62,6 +62,8 @@ export type {
   LiveScore,
   LiveScoreCompetitor,
   UiConfig,
+  WhatsNewPost,
+  WhatsNewCategory,
   UFCFighter,
   UFCFighterDetail,
   UFCData,
@@ -191,6 +193,7 @@ export {
   useSendFriendRequest,
   useRespondToFriendRequest,
   useCancelFriendRequest,
+  useWhatsNew,
 } from './chat';
 export type {
   ChatProviderProps,

package/src/types.ts

@@ -660,3 +660,23 @@ export interface UiConfig {
     ios: boolean;
   };
 }
+
+// ── What's New (per-app feature announcements) ──
+
+export type WhatsNewCategory = 'feature' | 'improvement' | 'bugfix' | 'announcement';
+
+export interface WhatsNewPost {
+  id: number;
+  title: string;
+  content: string;
+  gif_url: string | null;
+  category: WhatsNewCategory;
+  version: string | null;
+  is_pinned: boolean;
+  is_published: boolean;
+  /** Present when the post is fetched in an authenticated context. */
+  is_read?: boolean;
+  created_by: string;
+  created_at: string;
+  updated_at: string;
+}