@b3dotfun/sdk 0.1.69-alpha.1 → 0.1.69-alpha.10

package/src/global-account/react/components/SignInWithB3/utils/signInUtils.ts

@@ -5,7 +5,8 @@ type WalletType = Wallet["id"];
 type StrategyType = SingleStepAuthArgsType["strategy"];
 type CustomStrategyType = "basement" | "privy";
 
-type AllowedStrategies = StrategyType | WalletType | CustomStrategyType;
+type AllowedStrategies = StrategyType | WalletType | CustomStrategyType | "email";
+type NonWalletStrategyType = Exclude<AllowedStrategies, WalletType>;
 const customStrategies = ["basement", "privy"] as const;
 // type CustomStrategy = (typeof customStrategies)[number];
 
@@ -13,9 +14,10 @@ export const allowedStrategies = [
   // Auth strategies
   "apple",
   "google",
+  "github",
   "x",
   "discord",
-  // "github",
+  "email",
   "guest",
 
   // Wallet IDs
@@ -36,7 +38,7 @@ export function isWalletType(strategy: AllowedStrategies): strategy is WalletTyp
   return strategy === "walletConnect" || walletIdPattern.test(strategy);
 }
 
-export function isStrategyType(strategy: AllowedStrategies): strategy is StrategyType {
+export function isStrategyType(strategy: AllowedStrategies): strategy is NonWalletStrategyType {
   return !isWalletType(strategy);
 }
 
@@ -49,6 +51,10 @@ export function getConnectOptionsFromStrategy(strategy: AllowedStrategy): {
     throw new Error(`Invalid strategy: ${strategy}`);
   }
 
+  if (strategy === "email") {
+    throw new Error("Email strategy requires OTP flow and cannot be connected in a single step");
+  }
+
   if (isWalletType(strategy)) {
     return { strategy: "wallet" as const, wallet: createWallet(strategy) };
   } else {
@@ -65,6 +71,16 @@ export const strategyIcons: Record<string, string> = {
   guest: "https://cdn.b3.fun/incognito.svg",
   // Add more strategies as needed
 };
+
+export const strategyLabels: Record<string, string> = {
+  google: "Google",
+  x: "X",
+  discord: "Discord",
+  apple: "Apple",
+  guest: "Guest",
+  github: "GitHub",
+  email: "Email",
+};
 // Test it
 // console.log(getConnectOptionsFromStrategy("io.metamask"));
 // console.log(getConnectOptionsFromStrategy("google"));

package/src/global-account/react/components/Toast/ToastContext.tsx

@@ -15,6 +15,9 @@ interface ToastContextType {
   addToast: (type: ToastType, message: string, duration?: number) => string;
   removeToast: (id: string) => void;
   clearAll: () => void;
+  headerMode: boolean;
+  setHeaderMode: (enabled: boolean) => void;
+  latestToast: ToastItem | null;
 }
 
 const ToastContext = createContext<ToastContextType | undefined>(undefined);
@@ -23,6 +26,9 @@ let globalToastCounter = 0;
 
 export function ToastProvider({ children }: { children: React.ReactNode }) {
   const [toasts, setToasts] = useState<ToastItem[]>([]);
+  const [headerMode, setHeaderMode] = useState(false);
+  const headerModeRef = useRef(false);
+  const [latestToast, setLatestToast] = useState<ToastItem | null>(null);
   const timeoutsRef = useRef<Map<string, NodeJS.Timeout>>(new Map());
 
   const removeToast = useCallback((id: string) => {
@@ -45,13 +51,23 @@ export function ToastProvider({ children }: { children: React.ReactNode }) {
         createdAt: Date.now(),
       };
 
-      setToasts(prev => [...prev, newToast]);
+      if (headerModeRef.current) {
+        setLatestToast(newToast);
+        if (duration > 0) {
+          const timeout = setTimeout(() => {
+            setLatestToast(null);
+          }, duration);
+          timeoutsRef.current.set(id, timeout);
+        }
+      } else {
+        setToasts(prev => [...prev, newToast]);
 
-      if (duration > 0) {
-        const timeout = setTimeout(() => {
-          removeToast(id);
-        }, duration);
-        timeoutsRef.current.set(id, timeout);
+        if (duration > 0) {
+          const timeout = setTimeout(() => {
+            removeToast(id);
+          }, duration);
+          timeoutsRef.current.set(id, timeout);
+        }
       }
 
       return id;
@@ -65,6 +81,16 @@ export function ToastProvider({ children }: { children: React.ReactNode }) {
     setToasts([]);
   }, []);
 
+  const setHeaderModeCallback = useCallback((enabled: boolean) => {
+    setHeaderMode(enabled);
+    headerModeRef.current = enabled;
+    if (!enabled) {
+      setLatestToast(null);
+      timeoutsRef.current.forEach(timeout => clearTimeout(timeout));
+      timeoutsRef.current.clear();
+    }
+  }, []);
+
   // Cleanup on unmount
   useEffect(() => {
     const timeouts = timeoutsRef.current;
@@ -74,7 +100,13 @@ export function ToastProvider({ children }: { children: React.ReactNode }) {
     };
   }, []);
 
-  return <ToastContext.Provider value={{ toasts, addToast, removeToast, clearAll }}>{children}</ToastContext.Provider>;
+  return (
+    <ToastContext.Provider
+      value={{ toasts, addToast, removeToast, clearAll, headerMode, setHeaderMode: setHeaderModeCallback, latestToast }}
+    >
+      {children}
+    </ToastContext.Provider>
+  );
 }
 
 export function useToastContext() {

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

@@ -6,7 +6,7 @@ import { debugB3React } from "@b3dotfun/sdk/shared/utils/debug";
 import { client } from "@b3dotfun/sdk/shared/utils/thirdweb";
 import { ConnectionOptions } from "@thirdweb-dev/wagmi-adapter";
 import { getConnectors } from "@wagmi/core";
-import { useCallback, useContext, useEffect, useRef } from "react";
+import { useCallback, useContext, useEffect, useMemo, useRef } from "react";
 import {
   useActiveWallet,
   useAutoConnect,
@@ -18,7 +18,7 @@ import { Wallet, ecosystemWallet } from "thirdweb/wallets";
 import { preAuthenticate } from "thirdweb/wallets/in-app";
 import { useAccount, useConnect, useSwitchAccount } from "wagmi";
 import { LocalSDKContext } from "../components/B3Provider/LocalSDKProvider";
-import { getCachedWagmiConfig } from "../utils/createWagmiConfig";
+import { createWagmiConfig } from "../utils/createWagmiConfig";
 import { useSearchParam } from "./useSearchParamsSSR";
 import { useUserQuery } from "./useUserQuery";
 
@@ -30,7 +30,7 @@ const debug = debugB3React("useAuth");
  * This hook provides 1:1 feature parity with useAuthentication.ts
  */
 export function useAuth() {
-  const { onConnectCallback } = useContext(LocalSDKContext);
+  const { onConnectCallback, disableBSMNTAuthentication } = useContext(LocalSDKContext);
   const { disconnect } = useDisconnect();
   const wallets = useConnectedWallets();
   const activeWallet = useActiveWallet();
@@ -47,7 +47,7 @@ export function useAuth() {
   const useAutoConnectLoadingPrevious = useRef(false);
   const referralCode = useSearchParam("referralCode");
   const { partnerId } = useB3Config();
-  const wagmiConfig = getCachedWagmiConfig({ partnerId });
+  const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId }), [partnerId]);
   const { connect } = useConnect();
   const activeWagmiAccount = useAccount();
   const { switchAccount } = useSwitchAccount();
@@ -76,8 +76,10 @@ export function useAuth() {
 
       // Authenticate with BSMNT
       try {
-        const b3Jwt = await authenticateWithB3JWT(response.accessToken);
-        debug("BSMNT re-authentication successful", b3Jwt);
+        if (!disableBSMNTAuthentication) {
+          const b3Jwt = await authenticateWithB3JWT(response.accessToken);
+          debug("BSMNT re-authentication successful", b3Jwt);
+        }
       } catch (bsmntError) {
         // BSMNT authentication failure shouldn't block the main auth flow
         debug("BSMNT re-authentication failed (non-critical)", bsmntError);
@@ -88,7 +90,7 @@ export function useAuth() {
       debug("Re-authentication failed", err);
       throw err;
     }
-  }, [setUser]);
+  }, [setUser, disableBSMNTAuthentication]);
 
   const syncWagmi = useCallback(async () => {
     function syncWagmiFunc() {
@@ -136,9 +138,7 @@ export function useAuth() {
       });
     }
     syncWagmiFunc();
-    // wagmi config shouldn't change
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [partnerId, wallets]);
+  }, [wagmiConfig, wallets, connect, switchAccount]);
 
   useEffect(() => {
     syncWagmi();
@@ -159,9 +159,11 @@ export function useAuth() {
       setIsAuthenticating(false);
       debug("Re-authenticated successfully", { userAuth });
 
-      // Authenticate on BSMNT with B3 JWT
-      const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
-      debug("@@b3Jwt", b3Jwt);
+      if (!disableBSMNTAuthentication) {
+        // Authenticate on BSMNT with B3 JWT
+        const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
+        debug("@@b3Jwt", b3Jwt);
+      }
 
       return userAuth;
     } catch (error) {
@@ -171,7 +173,14 @@ export function useAuth() {
       setIsAuthenticating(false);
       throw new Error("Authentication required. Please authenticate.");
     }
-  }, [reAuthenticate, setIsAuthenticated, setIsAuthenticating, setUser, setHasStartedConnecting]);
+  }, [
+    reAuthenticate,
+    setIsAuthenticated,
+    setIsAuthenticating,
+    setUser,
+    setHasStartedConnecting,
+    disableBSMNTAuthentication,
+  ]);
 
   /**
    * Authenticate with B3
@@ -208,8 +217,10 @@ export function useAuth() {
 
         // Step 3: Authenticate with BSMNT for basement integration
         try {
-          const b3Jwt = await authenticateWithB3JWT(response.accessToken);
-          debug("BSMNT authentication successful", b3Jwt);
+          if (!disableBSMNTAuthentication) {
+            const b3Jwt = await authenticateWithB3JWT(response.accessToken);
+            debug("BSMNT authentication successful", b3Jwt);
+          }
         } catch (bsmntError) {
           // BSMNT authentication failure shouldn't block the main auth flow
           debug("BSMNT authentication failed (non-critical)", bsmntError);
@@ -221,7 +232,7 @@ export function useAuth() {
         throw err;
       }
     },
-    [referralCode, setUser],
+    [referralCode, setUser, disableBSMNTAuthentication],
   );
 
   /**

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

@@ -6,7 +6,7 @@ import { debugB3React } from "@b3dotfun/sdk/shared/utils/debug";
 import { client } from "@b3dotfun/sdk/shared/utils/thirdweb";
 import { ConnectionOptions } from "@thirdweb-dev/wagmi-adapter";
 import { getConnectors } from "@wagmi/core";
-import { useCallback, useContext, useEffect, useRef } from "react";
+import { useCallback, useContext, useEffect, useMemo, useRef } from "react";
 import {
   useActiveWallet,
   useAutoConnect,
@@ -25,7 +25,7 @@ import { useUserQuery } from "./useUserQuery";
 const debug = debugB3React("useAuthentication");
 
 export function useAuthentication(partnerId: string, { skipAutoConnect = false }: { skipAutoConnect?: boolean } = {}) {
-  const { onConnectCallback, onLogoutCallback } = useContext(LocalSDKContext);
+  const { onConnectCallback, onLogoutCallback, disableBSMNTAuthentication } = useContext(LocalSDKContext);
   const { disconnect } = useDisconnect();
   const wallets = useConnectedWallets();
   // Keep refs so logout() always disconnects current wallets, not stale closure values.
@@ -57,7 +57,7 @@ export function useAuthentication(partnerId: string, { skipAutoConnect = false }
   const { authenticate } = useTWAuth();
   const { user, setUser } = useUserQuery();
   const useAutoConnectLoadingPrevious = useRef(false);
-  const wagmiConfig = createWagmiConfig({ partnerId });
+  const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId }), [partnerId]);
   const { connect } = useConnect();
   const activeWagmiAccount = useAccount();
   const { switchAccount } = useSwitchAccount();
@@ -113,9 +113,7 @@ export function useAuthentication(partnerId: string, { skipAutoConnect = false }
       });
     }
     syncWagmiFunc();
-    // wagmi config shouldn't change
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [partnerId, wallets]);
+  }, [wagmiConfig, wallets, connect, switchAccount]);
 
   useEffect(() => {
     syncWagmi();
@@ -142,9 +140,11 @@ export function useAuthentication(partnerId: string, { skipAutoConnect = false }
         setIsAuthenticating(false);
         debug("Re-authenticated successfully", { userAuth });
 
-        // Authenticate on BSMNT with B3 JWT
-        const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
-        debug("@@b3Jwt", b3Jwt);
+        if (!disableBSMNTAuthentication) {
+          // Authenticate on BSMNT with B3 JWT
+          const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
+          debug("@@b3Jwt", b3Jwt);
+        }
 
         return userAuth;
       } catch (error) {
@@ -156,14 +156,25 @@ export function useAuthentication(partnerId: string, { skipAutoConnect = false }
         setIsAuthenticating(false);
         debug("Fresh authentication successful", { userAuth });
 
-        // Authenticate on BSMNT with B3 JWT
-        const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
-        debug("@@b3Jwt", b3Jwt);
+        if (!disableBSMNTAuthentication) {
+          // Authenticate on BSMNT with B3 JWT
+          const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
+          debug("@@b3Jwt", b3Jwt);
+        }
 
         return userAuth;
       }
     },
-    [activeWallet, partnerId, authenticate, setIsAuthenticated, setIsAuthenticating, setUser, setHasStartedConnecting],
+    [
+      activeWallet,
+      partnerId,
+      authenticate,
+      setIsAuthenticated,
+      setIsAuthenticating,
+      setUser,
+      setHasStartedConnecting,
+      disableBSMNTAuthentication,
+    ],
   );
 
   const logout = useCallback(

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

@@ -4,7 +4,7 @@ import { client } from "@b3dotfun/sdk/shared/utils/thirdweb";
 import { useCallback, useState } from "react";
 import { Chain } from "thirdweb";
 import { useConnect as useConnectTW } from "thirdweb/react";
-import { ecosystemWallet, SingleStepAuthArgsType } from "thirdweb/wallets";
+import { ecosystemWallet, MultiStepAuthArgsType, SingleStepAuthArgsType } from "thirdweb/wallets";
 const debug = debugB3React("useConnect");
 
 /**
@@ -23,7 +23,7 @@ export function useConnect(partnerId: string, chain?: Chain) {
    * It is used to connect to a wallet using the thirdweb client.
    */
   const connectTw = useCallback(
-    async (strategyOptions?: SingleStepAuthArgsType) => {
+    async (strategyOptions?: MultiStepAuthArgsType | SingleStepAuthArgsType) => {
       setIsLoading(true);
       return await connect(async () => {
         if (!strategyOptions) throw new Error("Strategy options are required");

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

@@ -12,7 +12,6 @@ import { useSearchParam } from "./useSearchParamsSSR";
  * @deprecated Use useAuth() instead
  */
 export function useTWAuth() {
-  console.warn("useTWAuth is deprecated. Please migrate to useAuth() for authentication.");
   const referralCode = useSearchParam("referralCode");
 
   const authenticate = useCallback(

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

@@ -451,6 +451,16 @@ export interface SendModalProps extends BaseModalProps {
   onSuccess?: (txHash?: string) => void;
 }
 
+/**
+ * Props for the Session Duration modal
+ * Allows users to configure how long they stay signed in
+ */
+export interface SessionDurationModalProps extends BaseModalProps {
+  type: "sessionDuration";
+  partnerId: string;
+  chain: Chain;
+}
+
 /**
  * Props for the Notifications modal
  * Allows users to manage notification settings and channels
@@ -677,6 +687,7 @@ export type ModalContentType =
   | DepositModalProps
   | SendModalProps
   | NotificationsModalProps
+  | SessionDurationModalProps
   | AnySpendCollectorClubPurchaseProps
   | AnySpendDepositModalProps
   | AnySpendWorkflowTriggerModalProps

package/src/global-account/react/utils/createWagmiConfig.tsx

@@ -38,21 +38,3 @@ export function createWagmiConfig(options: CreateWagmiConfigOptions) {
     connectors: finalConnectors,
   });
 }
-
-/** Module-level cache — wagmi configs must not be recreated on every render. */
-const wagmiConfigCache = new Map<string, ReturnType<typeof createWagmiConfig>>();
-
-/**
- * Returns a cached wagmi config for the given partnerId.
- * Use this instead of calling createWagmiConfig() directly inside React components or hooks
- * to avoid registering duplicate EventEmitter listeners on every render.
- */
-export function getCachedWagmiConfig(options: CreateWagmiConfigOptions) {
-  const key = options.partnerId;
-  let config = wagmiConfigCache.get(key);
-  if (!config) {
-    config = createWagmiConfig(options);
-    wagmiConfigCache.set(key, config);
-  }
-  return config;
-}

package/src/shared/utils/session-duration.ts

@@ -0,0 +1,64 @@
+const STORAGE_KEY_PREFIX = "b3-session-duration";
+const DEFAULT_DAYS = 7;
+
+// 0 = session cookie (expires when browser closes)
+export const SESSION_DURATION_OPTIONS = [0, 1, 7, 14, 30] as const;
+export type SessionDurationDays = (typeof SESSION_DURATION_OPTIONS)[number];
+
+function storageKey(partnerId?: string) {
+  return partnerId ? `${STORAGE_KEY_PREFIX}_${partnerId}` : STORAGE_KEY_PREFIX;
+}
+
+/**
+ * Read session duration for a specific partner.
+ *
+ * preferences shape: { [partnerId]: { sessionDuration: number }, sessionDuration?: number }
+ *
+ * Priority: user.preferences[partnerId].sessionDuration
+ *           → user.preferences.sessionDuration (global fallback)
+ *           → localStorage (per-partner) → localStorage (global) → default 7d
+ */
+export function getSessionDurationDays(userPreferences?: Record<string, any>, partnerId?: string): SessionDurationDays {
+  if (userPreferences) {
+    if (partnerId) {
+      const v = userPreferences[partnerId]?.sessionDuration;
+      if (SESSION_DURATION_OPTIONS.includes(v as SessionDurationDays)) return v as SessionDurationDays;
+    }
+    const v = userPreferences["sessionDuration"];
+    if (SESSION_DURATION_OPTIONS.includes(v as SessionDurationDays)) return v as SessionDurationDays;
+  }
+  try {
+    if (partnerId) {
+      const stored = localStorage.getItem(storageKey(partnerId));
+      if (stored !== null) {
+        const parsed = Number(stored);
+        if (SESSION_DURATION_OPTIONS.includes(parsed as SessionDurationDays)) return parsed as SessionDurationDays;
+      }
+    }
+    const stored = localStorage.getItem(STORAGE_KEY_PREFIX);
+    if (stored !== null) {
+      const parsed = Number(stored);
+      if (SESSION_DURATION_OPTIONS.includes(parsed as SessionDurationDays)) return parsed as SessionDurationDays;
+    }
+  } catch {
+    // localStorage unavailable (e.g. SSR)
+  }
+  return DEFAULT_DAYS;
+}
+
+export const SESSION_DURATION_LABELS: Record<SessionDurationDays, string> = {
+  0: "Session only",
+  1: "1 day",
+  7: "7 days",
+  14: "14 days",
+  30: "30 days",
+};
+
+/** Cache the preference locally so it's available immediately on next login */
+export function setSessionDurationDays(days: SessionDurationDays, partnerId?: string): void {
+  try {
+    localStorage.setItem(storageKey(partnerId), String(days));
+  } catch {
+    // ignore
+  }
+}

package/src/types/torph.d.ts

@@ -0,0 +1,4 @@
+declare module "torph/react" {
+  import type { JSX } from "react";
+  export function TextMorph(props: { children: string; className?: string }): JSX.Element;
+}