@b3dotfun/sdk 0.0.47 → 0.0.48-alpha.0

package/dist/esm/notifications/services/api.js

@@ -0,0 +1,179 @@
+import { getAuthToken } from "../../shared/utils/auth-token.js";
+const DEFAULT_API_URL = "https://notifications.b3.fun";
+let apiUrl = DEFAULT_API_URL;
+export function setApiUrl(url) {
+    apiUrl = url;
+}
+export function getApiUrl() {
+    return apiUrl;
+}
+function getHeaders(includeAuth = false) {
+    const headers = {
+        "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() {
+        const res = await fetch(`${apiUrl}/users/me`, {
+            headers: getHeaders(true),
+        });
+        return res.json();
+    },
+    /**
+     * Get current user's notification history
+     */
+    async getHistory(appId, limit = 100) {
+        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, channelIdentifier, metadata) {
+        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) {
+        return this.addChannel("email", email);
+    },
+    /**
+     * Update a notification channel
+     */
+    async updateChannel(channelId, updates) {
+        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) {
+        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() {
+        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() {
+        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, settings) {
+        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) {
+        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) {
+        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) {
+        const res = await fetch(`${apiUrl}/send`, {
+            method: "POST",
+            headers: getHeaders(true),
+            body: JSON.stringify(data),
+        });
+        return res.json();
+    },
+};

package/dist/esm/notifications/services/index.d.ts

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

package/dist/esm/notifications/services/index.js

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

package/dist/esm/notifications/types/index.d.ts

@@ -0,0 +1,51 @@
+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/dist/esm/shared/utils/auth-token.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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 declare function getAuthToken(): string | null;

package/dist/esm/shared/utils/auth-token.js

@@ -0,0 +1,11 @@
+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() {
+    return Cookies.get(B3_AUTH_COOKIE_NAME) || null;
+}

package/dist/esm/shared/utils/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./auth-token";
 export * from "./cn";
 export * from "./formatNumber";
 export * from "./formatUsername";

package/dist/esm/shared/utils/index.js

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

package/dist/types/global-account/react/components/B3Provider/B3Provider.d.ts

@@ -19,12 +19,12 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     };
     clientType?: ClientType;
     rpcUrls?: Record<number, string>;
-    partnerId?: string;
+    partnerId: string;
 }): import("react/jsx-runtime").JSX.Element;
 /**
  * Inner provider component that provides the actual B3Context
  */
-export declare function InnerProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, }: {
+export declare function InnerProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, }: {
     children: React.ReactNode;
     accountOverride?: Account;
     environment: B3ContextType["environment"];
@@ -32,4 +32,5 @@ export declare function InnerProvider({ children, accountOverride, environment,
     automaticallySetFirstEoa: boolean;
     theme: "light" | "dark";
     clientType?: ClientType;
+    partnerId: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/global-account/react/components/B3Provider/B3Provider.native.d.ts

@@ -5,21 +5,25 @@ import { B3ContextType } from "./types";
 /**
  * Main B3Provider component
  */
-export declare function B3Provider({ theme, children, accountOverride, environment, clientType, }: {
+export declare function B3Provider({ theme, children, accountOverride, environment, clientType, partnerId, rpcUrls, }: {
     theme: "light" | "dark";
     children: React.ReactNode;
     accountOverride?: Account;
     environment: B3ContextType["environment"];
     clientType?: ClientType;
+    partnerId: string;
+    rpcUrls?: Record<number, string>;
 }): import("react/jsx-runtime").JSX.Element;
 /**
  * Inner provider component that provides the actual B3Context
  */
-export declare function InnerProvider({ children, accountOverride, environment, defaultPermissions, theme, clientType, }: {
+export declare function InnerProvider({ children, accountOverride, environment, defaultPermissions, theme, clientType, partnerId, rpcUrls, }: {
     children: React.ReactNode;
     accountOverride?: Account;
     environment: B3ContextType["environment"];
     defaultPermissions?: PermissionsConfig;
     theme: "light" | "dark";
     clientType?: ClientType;
+    partnerId: string;
+    rpcUrls?: Record<number, string>;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/global-account/react/components/B3Provider/types.d.ts

@@ -12,12 +12,14 @@ export interface B3ContextType {
     setWallet: (wallet: Wallet) => void;
     wallet?: Wallet;
     setUser: (user?: Users) => void;
+    refetchUser: () => Promise<any>;
     initialized: boolean;
     ready: boolean;
     environment?: "development" | "production";
     defaultPermissions?: PermissionsConfig;
     theme: "light" | "dark";
     clientType: ClientType;
+    partnerId: string;
 }
 /**
  * Context for B3 provider

package/dist/types/global-account/react/components/ManageAccount/BalanceContent.d.ts

@@ -1,8 +1,7 @@
 interface BalanceContentProps {
     onLogout?: () => void;
-    partnerId: string;
     showDeposit?: boolean;
     showSwap?: boolean;
 }
-export declare function BalanceContent({ onLogout, partnerId, showDeposit, showSwap }: BalanceContentProps): import("react/jsx-runtime").JSX.Element;
+export declare function BalanceContent({ onLogout, showDeposit, showSwap }: BalanceContentProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/global-account/react/components/SignInWithB3/SignInWithB3Flow.d.ts

@@ -3,4 +3,4 @@ import { SignInWithB3ModalProps } from "@b3dotfun/sdk/global-account/react";
  * Component that manages the authentication flow for Sign In With B3
  * Handles different login providers, authentication steps, and session key management
  */
-export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, loginWithSiwe, source, signersEnabled, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, source, signersEnabled, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/global-account/react/components/SignInWithB3/SignInWithB3Privy.d.ts

@@ -4,8 +4,7 @@ interface SignInWithB3PrivyProps {
     onError?: (error: Error) => Promise<void>;
     onSuccess: (account: Account) => Promise<void>;
     accessToken?: string;
-    partnerId: string;
     chain: Chain;
 }
-export declare function SignInWithB3Privy({ onSuccess, onError, partnerId, chain }: SignInWithB3PrivyProps): import("react/jsx-runtime").JSX.Element;
+export declare function SignInWithB3Privy({ onSuccess, onError, chain }: SignInWithB3PrivyProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/global-account/react/components/SignInWithB3/steps/LoginStep.d.ts

@@ -9,7 +9,6 @@ interface LoginStepProps {
     /** Optional callback function called when an error occurs */
     onError?: (error: Error) => Promise<void>;
     /** Partner ID used for authentication */
-    partnerId: string;
     /** Blockchain chain information */
     chain: Chain;
     /** Optional authentication strategy options */
@@ -20,5 +19,5 @@ interface LoginStepContainerProps {
     partnerId?: string;
 }
 export declare function LoginStepContainer({ children, partnerId }: LoginStepContainerProps): import("react/jsx-runtime").JSX.Element;
-export declare function LoginStep({ onSuccess, onError, partnerId, chain }: LoginStepProps): import("react/jsx-runtime").JSX.Element;
+export declare function LoginStep({ onSuccess, chain }: LoginStepProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/global-account/react/components/SignInWithB3/steps/LoginStepCustom.d.ts

@@ -5,10 +5,9 @@ interface LoginStepCustomProps {
     automaticallySetFirstEoa: boolean;
     onSuccess: (account: Account) => Promise<void>;
     onError?: (error: Error) => Promise<void>;
-    partnerId: string;
     chain: Chain;
     strategies: AllowedStrategy[];
     maxInitialWallets?: number;
 }
-export declare function LoginStepCustom({ onSuccess, onError, partnerId, chain, strategies, maxInitialWallets, automaticallySetFirstEoa, }: LoginStepCustomProps): import("react/jsx-runtime").JSX.Element;
+export declare function LoginStepCustom({ onSuccess, onError, chain, strategies, maxInitialWallets, automaticallySetFirstEoa, }: LoginStepCustomProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/global-account/react/hooks/useAuthentication.d.ts

@@ -1,5 +1,6 @@
+import { Wallet } from "thirdweb/wallets";
 import { preAuthenticate } from "thirdweb/wallets/in-app";
-export declare function useAuthentication(partnerId: string, loginWithSiwe?: boolean): {
+export declare function useAuthentication(partnerId: string): {
     logout: (callback?: () => void) => Promise<void>;
     isAuthenticated: boolean;
     isReady: boolean;
@@ -7,6 +8,54 @@ export declare function useAuthentication(partnerId: string, loginWithSiwe?: boo
     isConnected: boolean;
     wallet: import("thirdweb/dist/types/wallets/in-app/core/wallet/types").EcosystemWallet;
     preAuthenticate: typeof preAuthenticate;
-    connect: (strategyOptions?: import("thirdweb/wallets").SingleStepAuthArgsType) => Promise<import("thirdweb/wallets").Wallet | null>;
+    connect: (wallet: Wallet) => Promise<void>;
     isAuthenticating: boolean;
+    onConnect: (wallet: Wallet) => Promise<void>;
+    user: {
+        email?: string | undefined;
+        username?: string | undefined;
+        telNumber?: string | undefined;
+        ens?: string | undefined;
+        avatar?: string | undefined;
+        preferences?: {} | undefined;
+        referredBy?: string | {} | undefined;
+        sourceApp?: string | undefined;
+        referralCode?: string | undefined;
+        userGroups?: number[] | undefined;
+        isMigratedFromBSMNT?: boolean | undefined;
+        privyLinkedAccounts?: {
+            name?: string | undefined;
+            address?: string | undefined;
+            email?: string | undefined;
+            chain_type?: string | undefined;
+            lv?: number | undefined;
+            wallet_client_type?: string | undefined;
+            smart_wallet_type?: string | undefined;
+            subject?: string | undefined;
+            type: string;
+        }[] | undefined;
+        twProfiles?: {
+            type: string;
+            details: {
+                id?: string | undefined;
+                name?: string | undefined;
+                address?: string | undefined;
+                email?: string | undefined;
+                phone?: string | undefined;
+                username?: string | undefined;
+                fid?: string | undefined;
+            };
+        }[] | undefined;
+        _id: string | {};
+        userId: string;
+        smartAccountAddress: string;
+        createdAt: number;
+        updatedAt: number;
+        partnerIds: {
+            privyId?: string | undefined;
+            thirdwebId?: string | undefined;
+        };
+    } | undefined;
+    refetchUser: (wallet?: Wallet) => Promise<void>;
+    setUser: (newUser?: import("@b3dotfun/b3-api").Users) => void;
 };

package/dist/types/global-account/react/hooks/useHandleConnectWithPrivy.d.ts

@@ -4,7 +4,7 @@ import { Account } from "thirdweb/wallets";
  * This essentially wraps our useConnect hook to handle the Privy auth flow.
  * Currently, this is for the basement-privy strategy
  */
-export declare function useHandleConnectWithPrivy(partnerId: string, chain?: Chain, onSuccess?: (account: Account) => void): {
+export declare function useHandleConnectWithPrivy(chain?: Chain, onSuccess?: (account: Account) => void): {
     connectTw: () => Promise<import("thirdweb/wallets").Wallet | null | undefined>;
     isLoading: boolean;
     fullToken: string | null;

package/dist/types/global-account/react/hooks/useUserQuery.d.ts

@@ -0,0 +1,58 @@
+import { Users } from "@b3dotfun/b3-api";
+/**
+ * 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 declare function useUserQuery(): {
+    user: {
+        email?: string | undefined;
+        username?: string | undefined;
+        telNumber?: string | undefined;
+        ens?: string | undefined;
+        avatar?: string | undefined;
+        preferences?: {} | undefined;
+        referredBy?: string | {} | undefined;
+        sourceApp?: string | undefined;
+        referralCode?: string | undefined;
+        userGroups?: number[] | undefined;
+        isMigratedFromBSMNT?: boolean | undefined;
+        privyLinkedAccounts?: {
+            name?: string | undefined;
+            address?: string | undefined;
+            email?: string | undefined;
+            chain_type?: string | undefined;
+            lv?: number | undefined;
+            wallet_client_type?: string | undefined;
+            smart_wallet_type?: string | undefined;
+            subject?: string | undefined;
+            type: string;
+        }[] | undefined;
+        twProfiles?: {
+            type: string;
+            details: {
+                id?: string | undefined;
+                name?: string | undefined;
+                address?: string | undefined;
+                email?: string | undefined;
+                phone?: string | undefined;
+                username?: string | undefined;
+                fid?: string | undefined;
+            };
+        }[] | undefined;
+        _id: string | {};
+        userId: string;
+        smartAccountAddress: string;
+        createdAt: number;
+        updatedAt: number;
+        partnerIds: {
+            privyId?: string | undefined;
+            thirdwebId?: string | undefined;
+        };
+    } | undefined;
+    setUser: (newUser?: Users) => void;
+    refetchUser: () => Promise<void>;
+    clearUser: () => void;
+    queryKey: string[];
+};

package/dist/types/global-account/react/hooks/useWagmiConfig.d.ts

@@ -0,0 +1,13 @@
+export declare function useWagmiConfig(partnerId: string, rpcUrls?: Record<number, string>): import("wagmi").Config<readonly [import("viem").Chain, ...import("viem").Chain[]], {
+    [k: string]: import("viem").HttpTransport<undefined, false>;
+}, readonly [import("wagmi").CreateConnectorFn<import("thirdweb/dist/types/adapters/eip1193").EIP1193Provider | undefined, {
+    connect<withCapabilities extends boolean = false>(parameters?: import("@thirdweb-dev/wagmi-adapter").ConnectionOptions<withCapabilities> | undefined): Promise<{
+        accounts: withCapabilities extends true ? readonly {
+            address: `0x${string}`;
+            capabilities: Record<string, unknown>;
+        }[] : readonly `0x${string}`[];
+        chainId: number;
+    }>;
+}, {
+    "thirdweb:lastChainId": number;
+}>]>;

package/dist/types/global-account/react/stores/useModalStore.d.ts

@@ -32,8 +32,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/dist/types/notifications/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./services";
+export { getAuthToken } from "../shared/utils/auth-token";

package/dist/types/notifications/react/hooks/index.d.ts

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

package/dist/types/notifications/react/hooks/useNotifications.d.ts

@@ -0,0 +1,42 @@
+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 declare function useNotifications(): {
+    user: UserData | null;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    connectEmail: (email: string) => Promise<void>;
+    connectTelegram: () => Promise<void>;
+    updateChannel: (channelId: string, updates: {
+        enabled?: boolean;
+    }) => Promise<void>;
+    deleteChannel: (channelId: string) => Promise<void>;
+    isEmailConnected: boolean;
+    isTelegramConnected: boolean;
+    isDiscordConnected: boolean;
+};

package/dist/types/notifications/react/index.d.ts

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