@b3dotfun/sdk 0.0.47 → 0.0.48-alpha.0

package/src/global-account/react/hooks/useUserQuery.ts

@@ -0,0 +1,95 @@
+import { Users } from "@b3dotfun/b3-api";
+import { debugB3React } from "@b3dotfun/sdk/shared/utils/debug";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+
+const debug = debugB3React("useUserQuery");
+
+const USER_QUERY_KEY = ["b3-user"];
+
+/**
+ * Retrieves the user from localStorage
+ */
+function getUserFromStorage(): Users | null {
+  if (typeof window === "undefined") {
+    return null;
+  }
+
+  try {
+    const storedUser = localStorage.getItem("b3-user");
+    return storedUser ? JSON.parse(storedUser) : null;
+  } catch (error) {
+    console.warn("Failed to restore user from localStorage:", error);
+    return null;
+  }
+}
+
+/**
+ * Saves user to localStorage
+ */
+function saveUserToStorage(user: Users | null) {
+  if (typeof window === "undefined") {
+    return;
+  }
+
+  if (user) {
+    localStorage.setItem("b3-user", JSON.stringify(user));
+  } else {
+    localStorage.removeItem("b3-user");
+  }
+}
+
+/**
+ * NOTE: THIS IS ONLY MEANT FOR INTERNAL USE, from useOnConnect
+ *
+ * Custom hook to manage user state with react-query
+ * This allows for invalidation and refetching of user data
+ */
+export function useUserQuery() {
+  const queryClient = useQueryClient();
+
+  // Query to get user data (primarily from cache/localStorage)
+  const { data: user } = useQuery<Users | null>({
+    queryKey: USER_QUERY_KEY,
+    queryFn: getUserFromStorage,
+    staleTime: Infinity, // User data doesn't go stale automatically
+    gcTime: Infinity, // Keep in cache indefinitely
+    initialData: getUserFromStorage,
+  });
+
+  // Mutation to update user
+  const setUserMutation = useMutation({
+    mutationFn: async (newUser: Users | undefined) => {
+      const userToSave = newUser ?? null;
+      saveUserToStorage(userToSave);
+      return userToSave;
+    },
+    onSuccess: data => {
+      queryClient.setQueryData(USER_QUERY_KEY, data);
+      debug("User updated", data);
+    },
+  });
+
+  // Helper function to set user (maintains backward compatibility)
+  const setUser = (newUser?: Users) => {
+    setUserMutation.mutate(newUser);
+  };
+
+  // Helper function to invalidate and refetch user
+  const refetchUser = async () => {
+    await queryClient.invalidateQueries({ queryKey: USER_QUERY_KEY });
+    return queryClient.refetchQueries({ queryKey: USER_QUERY_KEY });
+  };
+
+  // Helper function to clear user
+  const clearUser = () => {
+    setUser(undefined);
+  };
+
+  return {
+    user: user ?? undefined,
+    setUser,
+    refetchUser,
+    clearUser,
+    queryKey: USER_QUERY_KEY,
+  };
+}

package/src/global-account/react/hooks/useWagmiConfig.tsx

@@ -0,0 +1,44 @@
+import { ecosystemWalletId } from "@b3dotfun/sdk/shared/constants";
+import { supportedChains } from "@b3dotfun/sdk/shared/constants/chains/supported";
+import { client } from "@b3dotfun/sdk/shared/utils/thirdweb";
+import { inAppWalletConnector } from "@thirdweb-dev/wagmi-adapter";
+import { useMemo } from "react";
+import { http } from "viem";
+import { createConfig } from "wagmi";
+
+export function useWagmiConfig(partnerId: string, rpcUrls?: Record<number, string>) {
+  // Stringify rpcUrls for stable comparison to prevent wagmiConfig recreation
+  // when parent component passes new object references with same content
+  const rpcUrlsString = useMemo(() => (rpcUrls ? JSON.stringify(rpcUrls) : undefined), [rpcUrls]);
+
+  const ecocystemConfig = useMemo(() => {
+    return {
+      ecosystemId: ecosystemWalletId,
+      partnerId: partnerId,
+      client,
+    };
+  }, [partnerId]);
+
+  /**
+   * Creates wagmi config with optional custom RPC URLs
+   * @param rpcUrls - Optional mapping of chain IDs to RPC URLs
+   */
+  const wagmiConfig = useMemo(() => {
+    const parsedRpcUrls = rpcUrlsString ? JSON.parse(rpcUrlsString) : undefined;
+
+    return createConfig({
+      chains: [supportedChains[0], ...supportedChains.slice(1)],
+      transports: Object.fromEntries(supportedChains.map(chain => [chain.id, http(parsedRpcUrls?.[chain.id])])),
+      connectors: [
+        inAppWalletConnector({
+          ...ecocystemConfig,
+          client,
+        }),
+        // injected(),
+        // coinbaseWallet({ appName: "HypeDuel" }),
+      ],
+    });
+  }, [rpcUrlsString, ecocystemConfig]);
+
+  return wagmiConfig;
+}

package/src/global-account/react/stores/useModalStore.ts

@@ -35,8 +35,6 @@ export interface SignInWithB3ModalProps extends BaseModalProps {
   sessionKeyAddress?: Address;
   /** Unique identifier for the partner application */
   partnerId: string;
-  /** Whether to authenticate with Sign In With Ethereum */
-  loginWithSiwe?: boolean;
   /** Whether to close the modal after successful login */
   closeAfterLogin?: boolean;
   /** Source of the sign-in request */

package/src/notifications/index.ts

@@ -0,0 +1,9 @@
+// Export types
+export * from "./types";
+
+// Export services
+export * from "./services";
+
+// Re-export auth token getter from shared for convenience
+// Note: Auth token is managed by B3 Global Account authentication
+export { getAuthToken } from "../shared/utils/auth-token";

package/src/notifications/react/hooks/index.ts

@@ -0,0 +1 @@
+export * from "./useNotifications";

package/src/notifications/react/hooks/useNotifications.ts

@@ -0,0 +1,153 @@
+import { useEffect, useRef, useState } from "react";
+import { notificationsAPI } from "../../services/api";
+import type { UserData } from "../../types";
+
+/**
+ * React hook for managing B3 notifications
+ * Automatically uses the authenticated user's ID from JWT
+ *
+ * @example
+ * ```tsx
+ * import { useNotifications } from '@b3dotfun/sdk/notifications/react';
+ *
+ * function NotificationSettings() {
+ *   const { user, loading, connectEmail, connectTelegram, isEmailConnected } = useNotifications();
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {!isEmailConnected && (
+ *         <button onClick={() => connectEmail('user@example.com')}>
+ *           Connect Email
+ *         </button>
+ *       )}
+ *       <button onClick={connectTelegram}>Connect Telegram</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useNotifications() {
+  const [user, setUser] = useState<UserData | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  // Refs to track polling timers for cleanup
+  const telegramPollIntervalRef = useRef<NodeJS.Timeout | null>(null);
+  const telegramPollTimeoutRef = useRef<NodeJS.Timeout | null>(null);
+
+  // Cleanup function for Telegram polling
+  const cleanupTelegramPolling = () => {
+    if (telegramPollIntervalRef.current) {
+      clearInterval(telegramPollIntervalRef.current);
+      telegramPollIntervalRef.current = null;
+    }
+    if (telegramPollTimeoutRef.current) {
+      clearTimeout(telegramPollTimeoutRef.current);
+      telegramPollTimeoutRef.current = null;
+    }
+  };
+
+  // Load user data on mount
+  useEffect(() => {
+    loadUser();
+  }, []);
+
+  // Cleanup polling on unmount
+  useEffect(() => {
+    return () => {
+      cleanupTelegramPolling();
+    };
+  }, []);
+
+  const loadUser = async () => {
+    try {
+      setLoading(true);
+      setError(null);
+      const userData = await notificationsAPI.getUser();
+      setUser(userData);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Failed to load user"));
+      console.error("Failed to load user:", err);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const connectEmail = async (email: string) => {
+    try {
+      await notificationsAPI.connectEmail(email);
+      await loadUser(); // Refresh user data
+    } catch (err) {
+      console.error("Failed to connect email:", err);
+      throw err;
+    }
+  };
+
+  const connectTelegram = async () => {
+    try {
+      // Clear any existing polling before starting new one
+      cleanupTelegramPolling();
+
+      const { deepLink } = await notificationsAPI.getTelegramLink();
+      window.open(deepLink, "_blank");
+
+      // Poll for connection status
+      telegramPollIntervalRef.current = setInterval(async () => {
+        try {
+          const { connected } = await notificationsAPI.checkTelegramStatus();
+          if (connected) {
+            cleanupTelegramPolling();
+            await loadUser(); // Refresh user data
+          }
+        } catch (err) {
+          console.error("Failed to check Telegram status:", err);
+        }
+      }, 2000);
+
+      // Stop polling after 2 minutes
+      telegramPollTimeoutRef.current = setTimeout(() => {
+        cleanupTelegramPolling();
+      }, 120000);
+    } catch (err) {
+      console.error("Failed to connect Telegram:", err);
+      throw err;
+    }
+  };
+
+  const updateChannel = async (channelId: string, updates: { enabled?: boolean }) => {
+    try {
+      await notificationsAPI.updateChannel(channelId, updates);
+      await loadUser(); // Refresh user data
+    } catch (err) {
+      console.error("Failed to update channel:", err);
+      throw err;
+    }
+  };
+
+  const deleteChannel = async (channelId: string) => {
+    try {
+      await notificationsAPI.deleteChannel(channelId);
+      await loadUser(); // Refresh user data
+    } catch (err) {
+      console.error("Failed to delete channel:", err);
+      throw err;
+    }
+  };
+
+  return {
+    user,
+    loading,
+    error,
+    refresh: loadUser,
+    connectEmail,
+    connectTelegram,
+    updateChannel,
+    deleteChannel,
+    // Convenience helpers
+    isEmailConnected: user?.channels?.find(c => c.channel_type === "email")?.enabled === 1,
+    isTelegramConnected: user?.channels?.find(c => c.channel_type === "telegram")?.enabled === 1,
+    isDiscordConnected: user?.channels?.find(c => c.channel_type === "discord")?.enabled === 1,
+  };
+}

package/src/notifications/react/index.ts

@@ -0,0 +1 @@
+export * from "./hooks";

package/src/notifications/services/api.ts

@@ -0,0 +1,217 @@
+import { getAuthToken } from "@b3dotfun/sdk/shared/utils/auth-token";
+import type {
+  NotificationHistory,
+  NotificationPreferences,
+  SendNotificationRequest,
+  TelegramLinkResponse,
+  TelegramStatusResponse,
+  UserData,
+} from "../types";
+
+const DEFAULT_API_URL = "https://notifications.b3.fun";
+
+let apiUrl: string = DEFAULT_API_URL;
+
+export function setApiUrl(url: string) {
+  apiUrl = url;
+}
+
+export function getApiUrl(): string {
+  return apiUrl;
+}
+
+function getHeaders(includeAuth = false): HeadersInit {
+  const headers: HeadersInit = {
+    "Content-Type": "application/json",
+  };
+
+  if (includeAuth) {
+    const token = getAuthToken();
+    if (token) {
+      headers["Authorization"] = `Bearer ${token}`;
+    }
+  }
+
+  return headers;
+}
+
+export const notificationsAPI = {
+  // ===== USER MANAGEMENT =====
+
+  /**
+   * Register the current user (userId extracted from JWT)
+   */
+  async registerUser() {
+    const res = await fetch(`${apiUrl}/users`, {
+      method: "POST",
+      headers: getHeaders(true),
+    });
+    if (!res.ok) {
+      const errorBody = await res.text().catch(() => "Could not read error body");
+      throw new Error(`API Error: ${res.status} ${res.statusText} - ${errorBody}`);
+    }
+    return res.json();
+  },
+
+  /**
+   * Get current user's profile and preferences
+   */
+  async getUser(): Promise<UserData> {
+    const res = await fetch(`${apiUrl}/users/me`, {
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  /**
+   * Get current user's notification history
+   */
+  async getHistory(appId?: string, limit = 100): Promise<NotificationHistory[]> {
+    const params = new URLSearchParams();
+    if (appId) params.append("appId", appId);
+    params.append("limit", limit.toString());
+
+    const res = await fetch(`${apiUrl}/users/me/history?${params}`, {
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  // ===== CHANNELS =====
+
+  /**
+   * Add a notification channel for current user
+   */
+  async addChannel(channelType: string, channelIdentifier: string, metadata?: Record<string, any>) {
+    const res = await fetch(`${apiUrl}/users/me/channels`, {
+      method: "POST",
+      headers: getHeaders(true),
+      body: JSON.stringify({
+        channelType,
+        channelIdentifier,
+        enabled: true,
+        metadata,
+      }),
+    });
+    return res.json();
+  },
+
+  /**
+   * Connect email for current user
+   */
+  async connectEmail(email: string) {
+    return this.addChannel("email", email);
+  },
+
+  /**
+   * Update a notification channel
+   */
+  async updateChannel(
+    channelId: string,
+    updates: { enabled?: boolean; channelIdentifier?: string; metadata?: Record<string, any> },
+  ) {
+    const res = await fetch(`${apiUrl}/users/me/channels/${channelId}`, {
+      method: "PUT",
+      headers: getHeaders(true),
+      body: JSON.stringify(updates),
+    });
+    return res.json();
+  },
+
+  /**
+   * Delete a notification channel
+   */
+  async deleteChannel(channelId: string) {
+    const res = await fetch(`${apiUrl}/users/me/channels/${channelId}`, {
+      method: "DELETE",
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  // ===== TELEGRAM =====
+
+  /**
+   * Get Telegram deep link for current user
+   */
+  async getTelegramLink(): Promise<TelegramLinkResponse> {
+    const res = await fetch(`${apiUrl}/telegram/request-link`, {
+      method: "POST",
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  /**
+   * Check current user's Telegram connection status
+   */
+  async checkTelegramStatus(): Promise<TelegramStatusResponse> {
+    const res = await fetch(`${apiUrl}/telegram/status/me`, {
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  // ===== APP PREFERENCES =====
+
+  /**
+   * Save notification preferences for an app
+   * @param appId - The application ID
+   * @param settings - Notification preferences including channels, type, and enabled status (defaults to true)
+   */
+  async savePreferences(appId: string, settings: NotificationPreferences) {
+    const res = await fetch(`${apiUrl}/users/me/apps/${appId}/settings`, {
+      method: "POST",
+      headers: getHeaders(true),
+      body: JSON.stringify({ enabled: true, ...settings }),
+    });
+    return res.json();
+  },
+
+  /**
+   * Get notification settings for an app
+   */
+  async getAppSettings(appId: string) {
+    const res = await fetch(`${apiUrl}/users/me/apps/${appId}/settings`, {
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  // ===== IN-APP NOTIFICATIONS =====
+
+  /**
+   * Get current user's in-app notifications
+   */
+  async getInAppNotifications() {
+    const res = await fetch(`${apiUrl}/users/me/notifications`, {
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  /**
+   * Mark a notification as read
+   */
+  async markNotificationAsRead(notificationId: string) {
+    const res = await fetch(`${apiUrl}/users/me/notifications/${notificationId}/read`, {
+      method: "PUT",
+      headers: getHeaders(true),
+    });
+    return res.json();
+  },
+
+  // ===== SENDING NOTIFICATIONS =====
+
+  /**
+   * Send a notification (requires auth)
+   */
+  async sendNotification(data: SendNotificationRequest) {
+    const res = await fetch(`${apiUrl}/send`, {
+      method: "POST",
+      headers: getHeaders(true),
+      body: JSON.stringify(data),
+    });
+    return res.json();
+  },
+};

package/src/notifications/services/index.ts

@@ -0,0 +1 @@
+export * from "./api";

package/src/notifications/types/index.ts

@@ -0,0 +1,58 @@
+export type ChannelType = "email" | "telegram" | "discord" | "sms" | "whatsapp" | "in_app";
+
+export interface NotificationChannel {
+  id: number;
+  channel_type: ChannelType;
+  enabled: number;
+  channel_identifier: string;
+}
+
+export interface UserData {
+  user: {
+    id: number;
+    user_id: string;
+  };
+  channels: NotificationChannel[];
+  appSettings: Array<{
+    app_id: string;
+    notification_type: string;
+    enabled: number;
+    channels: string;
+  }>;
+}
+
+export interface NotificationHistory {
+  id: string;
+  app_id: string;
+  notification_type: string;
+  title: string;
+  message: string;
+  created_at: string;
+  read: boolean;
+}
+
+export interface TelegramLinkResponse {
+  deepLink: string;
+  verificationCode: string;
+  botUsername: string;
+}
+
+export interface TelegramStatusResponse {
+  connected: boolean;
+  chatId?: string;
+}
+
+export interface NotificationPreferences {
+  notificationType: string;
+  channels: string[];
+  enabled?: boolean;
+}
+
+export interface SendNotificationRequest {
+  userId: string;
+  appId: string;
+  notificationType: string;
+  message: string;
+  title?: string;
+  data?: Record<string, any>;
+}

package/src/shared/utils/auth-token.ts

@@ -0,0 +1,13 @@
+import Cookies from "js-cookie";
+
+const B3_AUTH_COOKIE_NAME = "b3-auth";
+
+/**
+ * Get the authentication token from the B3 auth cookie
+ * This token is managed by the B3 Global Account authentication system
+ *
+ * @returns The JWT token string or null if not found
+ */
+export function getAuthToken(): string | null {
+  return Cookies.get(B3_AUTH_COOKIE_NAME) || null;
+}

package/src/shared/utils/index.ts

@@ -1,4 +1,5 @@
 // Export utility functions
+export * from "./auth-token";
 export * from "./cn";
 export * from "./formatNumber";
 export * from "./formatUsername";