@b3dotfun/sdk 0.1.69-alpha.2 → 0.1.69-alpha.20

package/dist/types/global-account/bsmnt.d.ts

@@ -1,6 +1,5 @@
 declare const app: import("@b3dotfun/basement-api").ClientApplication;
 export declare const authenticate: (accessToken: string, identityToken: string, params?: Record<string, any>) => Promise<import("@feathersjs/authentication").AuthenticationResult | null>;
 export declare const resetSocket: () => void;
-export declare function extractAvatarIdFromUrl(url: string): string | null;
 export declare const authenticateWithB3JWT: (fullToken: string, params?: Record<string, any>) => Promise<import("@feathersjs/authentication").AuthenticationResult | null>;
 export default app;

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

@@ -3,6 +3,7 @@ import { CreateOrderParams } from "@b3dotfun/sdk/anyspend/react/hooks/useAnyspen
 import { PermissionsConfig } from "@b3dotfun/sdk/global-account/types/permissions";
 import { Account } from "thirdweb/wallets";
 import { ClientType } from "../../../client-manager";
+export type AuthStrategy = "thirdweb" | "better-auth";
 export interface B3ConfigContextType {
     accountOverride?: Account;
     automaticallySetFirstEoa: boolean;
@@ -13,8 +14,9 @@ export interface B3ConfigContextType {
     partnerId: string;
     stripePublishableKey?: string;
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
+    authStrategy: AuthStrategy;
 }
-export declare function B3ConfigProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, stripePublishableKey, createClientReferenceId, }: {
+export declare function B3ConfigProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, stripePublishableKey, createClientReferenceId, authStrategy, }: {
     children: React.ReactNode;
     accountOverride?: Account;
     environment?: "development" | "production";
@@ -25,5 +27,6 @@ export declare function B3ConfigProvider({ children, accountOverride, environmen
     partnerId: string;
     stripePublishableKey?: string;
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
+    authStrategy?: AuthStrategy;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function useB3Config(): B3ConfigContextType;

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

@@ -1,14 +1,16 @@
 import { CreateOnrampOrderParams } from "@b3dotfun/sdk/anyspend/react/hooks/useAnyspendCreateOnrampOrder";
 import { CreateOrderParams } from "@b3dotfun/sdk/anyspend/react/hooks/useAnyspendCreateOrder";
 import { PermissionsConfig } from "@b3dotfun/sdk/global-account/types/permissions";
+import type { AuthStrategy } from "./B3ConfigProvider";
 import "@relayprotocol/relay-kit-ui/styles.css";
+import { QueryClient } from "@tanstack/react-query";
 import { Account, EIP1193, Wallet } from "thirdweb/wallets";
 import { CreateConnectorFn } from "wagmi";
 import { ClientType } from "../../../client-manager";
 /**
  * Main B3Provider component
  */
-export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, }: {
+export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication, queryClient, authStrategy, }: {
     theme: "light" | "dark";
     children: React.ReactNode;
     accountOverride?: Account;
@@ -32,4 +34,9 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     overrideDefaultConnectors?: boolean;
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
     defaultPermissions?: PermissionsConfig;
+    disableBSMNTAuthentication?: boolean;
+    /** Provide your own QueryClient for React Query. If omitted, WalletProvider creates one internally. */
+    queryClient?: QueryClient;
+    /** Auth strategy: "thirdweb" (default, ecosystem wallet) or "better-auth" (email/password via Better Auth) */
+    authStrategy?: AuthStrategy;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,16 @@
+/**
+ * Parallel to AuthenticationProvider for Better Auth strategy.
+ *
+ * Manages the isAuthenticating lifecycle for Better Auth:
+ * 1. On mount, try to restore an existing Feathers JWT (from a previous login)
+ * 2. If no Feathers JWT, check for a Better Auth session (e.g. after OAuth redirect)
+ *    and exchange it for a Feathers JWT
+ * 3. If neither exists, set isAuthenticating: false so the login UI renders
+ *
+ * Also patches app.logout() so any code path that calls it (useAuthentication,
+ * useAuth, SignIn component, etc.) automatically clears the Better Auth session.
+ */
+declare const BetterAuthProvider: ({ partnerId }: {
+    partnerId: string;
+}) => null;
+export default BetterAuthProvider;

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

@@ -6,13 +6,15 @@ import { Wallet } from "thirdweb/wallets";
 export interface LocalSDKContextType {
     onConnectCallback?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
     onLogoutCallback?: () => void | Promise<void>;
+    disableBSMNTAuthentication?: boolean;
 }
 export declare const LocalSDKContext: import("react").Context<LocalSDKContextType>;
 /**
  * Local SDK Provider that wraps the app and provides internal SDK state
  */
-export declare function LocalSDKProvider({ children, onConnectCallback, onLogoutCallback, }: {
+export declare function LocalSDKProvider({ children, onConnectCallback, onLogoutCallback, disableBSMNTAuthentication, }: {
     children: React.ReactNode;
     onConnectCallback?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
     onLogoutCallback?: () => void | Promise<void>;
+    disableBSMNTAuthentication?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -16,6 +16,8 @@ interface IPFSMediaRendererProps {
     controls?: boolean;
     /** Style object */
     style?: React.CSSProperties;
+    /** Callback when media fails to load */
+    onError?: () => void;
 }
 /**
  * IPFSMediaRenderer - A wrapper around Thirdweb's MediaRenderer that configures
@@ -35,5 +37,5 @@ interface IPFSMediaRendererProps {
  * />
  * ```
  */
-export declare function IPFSMediaRenderer({ src, alt, className, client, width, height, controls, style, }: IPFSMediaRendererProps): import("react/jsx-runtime").JSX.Element;
+export declare function IPFSMediaRenderer({ src, alt, className, client, width, height, controls, style, onError, }: IPFSMediaRendererProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,5 @@
+interface SessionDurationContentProps {
+    partnerId: string;
+}
+declare const SessionDurationContent: ({ partnerId }: SessionDurationContentProps) => import("react/jsx-runtime").JSX.Element;
+export default SessionDurationContent;

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

@@ -0,0 +1,21 @@
+export interface BetterAuthResetPasswordProps {
+    /** The reset token from the URL query param */
+    token: string;
+    /** Called after password is successfully reset */
+    onSuccess?: () => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+    /** Optional class name */
+    className?: string;
+}
+/**
+ * Standalone reset password form. Render this on your reset password page.
+ * Reads the token from props (extract it from the URL query string).
+ *
+ * Usage:
+ * ```tsx
+ * const token = new URLSearchParams(window.location.search).get("token");
+ * <BetterAuthResetPassword token={token} onSuccess={() => navigate("/login")} />
+ * ```
+ */
+export declare function BetterAuthResetPassword({ token, onSuccess, onError, className }: BetterAuthResetPasswordProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,34 @@
+import { type BetterAuthSocialProvider } from "../../hooks/useBetterAuth";
+export interface BetterAuthSignInProps {
+    /** Title displayed above the form. Default: "Welcome back" for sign-in, "Create an account" for sign-up */
+    title?: string;
+    /** Subtitle displayed below the title */
+    subtitle?: string;
+    /** Which social providers to show. Defaults to all. Pass empty array to hide. */
+    socialProviders?: BetterAuthSocialProvider[];
+    /** Show email/password form. Default: true */
+    showEmail?: boolean;
+    /** URL to redirect to after password reset link is clicked. Token is appended as ?token=... */
+    passwordResetRedirectTo?: string;
+    /** Called after successful authentication */
+    onSuccess?: () => void;
+    /** Called on authentication error */
+    onError?: (error: Error) => void;
+    /** Optional class name for the root container */
+    className?: string;
+}
+/**
+ * Standalone inline sign-in component for Better Auth.
+ *
+ * Renders directly — no modal, no button wrapper. Designed for full-page
+ * sign-in layouts (e.g., B3OS web with branding on the left, form on the right).
+ *
+ * Usage:
+ * ```tsx
+ * <BetterAuthSignIn
+ *   socialProviders={["google", "github"]}
+ *   onSuccess={() => router.push("/dashboard")}
+ * />
+ * ```
+ */
+export declare function BetterAuthSignIn({ title, subtitle, socialProviders, showEmail, passwordResetRedirectTo, onSuccess, onError, className, }: BetterAuthSignInProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,6 @@
+interface LoginStepBetterAuthProps {
+    onSuccess?: () => void;
+    onError?: (error: Error) => Promise<void>;
+}
+export declare function LoginStepBetterAuth({ onSuccess, onError }: LoginStepBetterAuthProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -3,15 +3,17 @@ import { SingleStepAuthArgsType, Wallet } from "thirdweb/wallets";
 type WalletType = Wallet["id"];
 type StrategyType = SingleStepAuthArgsType["strategy"];
 type CustomStrategyType = "basement" | "privy";
-type AllowedStrategies = StrategyType | WalletType | CustomStrategyType;
-export declare const allowedStrategies: readonly ["apple", "google", "x", "discord", "guest", "walletConnect", "io.metamask", "com.coinbase.wallet", "basement", "privy"];
+type AllowedStrategies = StrategyType | WalletType | CustomStrategyType | "email";
+type NonWalletStrategyType = Exclude<AllowedStrategies, WalletType>;
+export declare const allowedStrategies: readonly ["apple", "google", "github", "x", "discord", "email", "guest", "walletConnect", "io.metamask", "com.coinbase.wallet", "basement", "privy"];
 export type AllowedStrategy = (typeof allowedStrategies)[number];
 export declare function isWalletType(strategy: AllowedStrategies): strategy is WalletType;
-export declare function isStrategyType(strategy: AllowedStrategies): strategy is StrategyType;
+export declare function isStrategyType(strategy: AllowedStrategies): strategy is NonWalletStrategyType;
 export declare function getConnectOptionsFromStrategy(strategy: AllowedStrategy): {
     strategy: StrategyType;
     wallet?: Wallet;
     chain?: Chain;
 };
 export declare const strategyIcons: Record<string, string>;
+export declare const strategyLabels: Record<string, string>;
 export {};

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

@@ -11,6 +11,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;
 }
 export declare function ToastProvider({ children }: {
     children: React.ReactNode;

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

@@ -1,6 +1,6 @@
 import * as React from "react";
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "b3" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    variant?: "default" | "link" | "b3" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "icon" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {

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

@@ -1,10 +1,13 @@
 export { B3DynamicModal } from "./B3DynamicModal";
 export { B3Provider } from "./B3Provider/B3Provider";
+export type { AuthStrategy } from "./B3Provider/B3ConfigProvider";
 export { RelayKitProviderWrapper } from "./B3Provider/RelayKitProviderWrapper";
 export { useB3 } from "./B3Provider/useB3";
 export { useB3Account } from "./B3Provider/useB3Account";
 export { useB3Config } from "./B3Provider/useB3Config";
 export { StyleRoot } from "./StyleRoot";
+export { BetterAuthResetPassword, type BetterAuthResetPasswordProps } from "./SignInWithB3/BetterAuthResetPassword";
+export { BetterAuthSignIn, type BetterAuthSignInProps } from "./SignInWithB3/BetterAuthSignIn";
 export { AuthButton } from "./SignInWithB3/components/AuthButton";
 export { PermissionItem } from "./SignInWithB3/components/PermissionItem";
 export { WalletRow } from "./SignInWithB3/components/WalletRow";

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

@@ -1,7 +1,7 @@
 import { type VariantProps } from "class-variance-authority";
 import * as React from "react";
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "icon" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {

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

@@ -5,6 +5,7 @@ export { useAddTWSessionKey } from "./useAddTWSessionKey";
 export { useAnalytics } from "./useAnalytics";
 export { useAuth } from "./useAuth";
 export { useAuthentication } from "./useAuthentication";
+export { useBetterAuth, EmailVerificationRequiredError } from "./useBetterAuth";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses";
 export { useB3EnsName } from "./useB3EnsName";
 export { useChainSwitchWithAction } from "./useChainSwitchWithAction";