@forge-connect/react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,310 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+type OAuthProvider = 'google' | 'discord' | 'twitter' | 'apple';
+type Chain = 'solana' | 'ethereum';
+interface ForgeConnectConfig {
+    /** Base URL of the ForgeConnect API */
+    apiUrl: string;
+    /** OAuth providers to enable */
+    oauthProviders?: OAuthProvider[];
+    /** Enable wallet login */
+    walletLogin?: boolean;
+    /** Enable passwordless (OTP) login */
+    passwordlessLogin?: boolean;
+    /** Appearance customization */
+    appearance?: AppearanceConfig;
+}
+interface AppearanceConfig {
+    theme?: 'light' | 'dark';
+    accentColor?: string;
+    logo?: string;
+    title?: string;
+}
+interface User {
+    id: string;
+    displayName: string | null;
+    avatarUrl: string | null;
+    primaryEmail: string | null;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}
+type AuthProvider = 'email' | 'google' | 'twitter' | 'discord' | 'apple' | 'solana_wallet' | 'ethereum_wallet';
+interface AuthMethod {
+    id: string;
+    provider: AuthProvider;
+    providerId: string;
+    isVerified: boolean;
+    verifiedAt: string | null;
+    createdAt: string;
+}
+interface Wallet {
+    id: string;
+    userId: string;
+    chain: Chain;
+    address: string;
+    label: string | null;
+    isPrimary: boolean;
+    verifiedAt: string | null;
+    lastUsedAt: string | null;
+}
+interface Session {
+    id: string;
+    createdAt: string;
+    expiresAt: string;
+    lastActiveAt: string;
+    deviceInfo: Record<string, unknown> | null;
+    ipAddress: string;
+}
+type AuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
+interface AuthState {
+    status: AuthStatus;
+    user: User | null;
+    accessToken: string | null;
+}
+type ModalStep = 'method-select' | 'email-login' | 'email-register' | 'email-otp' | 'wallet-connect' | 'oauth';
+interface ModalState {
+    isOpen: boolean;
+    step: ModalStep;
+}
+
+interface ForgeConnectProviderProps {
+    config: ForgeConnectConfig;
+    children: ReactNode;
+    /** Called when user successfully authenticates */
+    onLogin?: (user: User) => void;
+    /** Called when user logs out */
+    onLogout?: () => void;
+}
+declare function ForgeConnectProvider({ config, children, onLogin, onLogout }: ForgeConnectProviderProps): react_jsx_runtime.JSX.Element;
+
+interface LoginButtonProps {
+    className?: string;
+    label?: string;
+}
+declare function LoginButton({ className, label }: LoginButtonProps): react_jsx_runtime.JSX.Element;
+
+declare function LoginModal(): react_jsx_runtime.JSX.Element;
+
+interface ModalOverlayProps {
+    isOpen: boolean;
+    onClose: () => void;
+    children: ReactNode;
+}
+declare function ModalOverlay({ isOpen, onClose, children }: ModalOverlayProps): react.ReactPortal | null;
+
+declare class ForgeConnectApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+declare function createApiClient(apiUrl: string): {
+    register(email: string, password: string, displayName?: string): Promise<{
+        success: true;
+    }>;
+    login(email: string, password: string): Promise<{
+        accessToken: string;
+        user: {
+            id: string;
+            displayName: string | null;
+            email: string;
+        };
+    }>;
+    sendOtp(email: string): Promise<{
+        success: true;
+    }>;
+    verifyOtp(email: string, code: string): Promise<{
+        accessToken: string;
+        user: {
+            id: string;
+            email: string;
+        };
+    }>;
+    walletChallenge(walletAddress: string, chain?: string): Promise<{
+        challengeId: string;
+        nonce: string;
+    }>;
+    walletVerify(challengeId: string, signature: string, walletAddress: string): Promise<{
+        accessToken: string;
+    }>;
+    refresh(): Promise<{
+        accessToken: string;
+    }>;
+    logout(token: string): Promise<{
+        success: true;
+    }>;
+    logoutAll(token: string): Promise<{
+        success: true;
+    }>;
+    getMe(token: string): Promise<{
+        id: string;
+        displayName: string | null;
+        avatarUrl: string | null;
+        primaryEmail: string | null;
+        status: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    updateMe(token: string, data: {
+        displayName?: string;
+        avatarUrl?: string;
+    }): Promise<{
+        id: string;
+        displayName: string | null;
+        avatarUrl: string | null;
+        primaryEmail: string | null;
+        status: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    getAuthMethods(token: string): Promise<{
+        id: string;
+        provider: string;
+        providerId: string;
+        isVerified: boolean;
+        verifiedAt: string | null;
+        createdAt: string;
+    }[]>;
+    linkAuthMethod(token: string, data: {
+        provider: string;
+        email?: string;
+        password?: string;
+        challengeId?: string;
+        signature?: string;
+        walletAddress?: string;
+    }): Promise<{
+        success: true;
+    }>;
+    unlinkAuthMethod(token: string, id: string): Promise<{
+        success: true;
+    }>;
+    getWallets(token: string): Promise<{
+        id: string;
+        userId: string;
+        chain: string;
+        address: string;
+        label: string | null;
+        isPrimary: boolean;
+        verifiedAt: string | null;
+        lastUsedAt: string | null;
+    }[]>;
+    updateWallet(token: string, id: string, data: {
+        label?: string;
+        isPrimary?: boolean;
+    }): Promise<{
+        id: string;
+        userId: string;
+        chain: string;
+        address: string;
+        label: string | null;
+        isPrimary: boolean;
+        verifiedAt: string | null;
+        lastUsedAt: string | null;
+    }>;
+    getSessions(token: string): Promise<{
+        id: string;
+        createdAt: string;
+        expiresAt: string;
+        lastActiveAt: string;
+        deviceInfo: Record<string, unknown> | null;
+        ipAddress: string;
+    }[]>;
+    revokeSession(token: string, id: string): Promise<{
+        success: true;
+    }>;
+};
+type ApiClient = ReturnType<typeof createApiClient>;
+
+interface ForgeConnectContextValue {
+    auth: AuthState;
+    modal: ModalState;
+    config: ForgeConnectConfig;
+    api: ApiClient;
+    loginWithEmail: (email: string, password: string) => Promise<void>;
+    register: (email: string, password: string, displayName?: string) => Promise<void>;
+    sendOtp: (email: string) => Promise<void>;
+    verifyOtp: (email: string, code: string) => Promise<void>;
+    loginWithWallet: (walletAddress: string, signMessage: (message: Uint8Array) => Promise<Uint8Array>, chain?: string) => Promise<void>;
+    loginWithOAuth: (provider: string) => void;
+    logout: () => Promise<void>;
+    logoutAll: () => Promise<void>;
+    openModal: () => void;
+    closeModal: () => void;
+    setModalStep: (step: ModalState['step']) => void;
+    getAccessToken: () => string | null;
+}
+declare const ForgeConnectContext: react.Context<ForgeConnectContextValue | null>;
+
+declare function useForgeConnect(): ForgeConnectContextValue;
+
+declare function useUser(): {
+    user: User | null;
+    authMethods: AuthMethod[] | null;
+    loading: boolean;
+    updateProfile: (data: {
+        displayName?: string;
+        avatarUrl?: string;
+    }) => Promise<{
+        id: string;
+        displayName: string | null;
+        avatarUrl: string | null;
+        primaryEmail: string | null;
+        status: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    fetchAuthMethods: () => Promise<{
+        id: string;
+        provider: string;
+        providerId: string;
+        isVerified: boolean;
+        verifiedAt: string | null;
+        createdAt: string;
+    }[]>;
+    linkAuthMethod: (data: {
+        provider: string;
+        email?: string;
+        password?: string;
+        challengeId?: string;
+        signature?: string;
+        walletAddress?: string;
+    }) => Promise<void>;
+    unlinkAuthMethod: (id: string) => Promise<void>;
+};
+
+declare function useWallets(): {
+    wallets: Wallet[] | null;
+    loading: boolean;
+    fetchWallets: () => Promise<{
+        id: string;
+        userId: string;
+        chain: string;
+        address: string;
+        label: string | null;
+        isPrimary: boolean;
+        verifiedAt: string | null;
+        lastUsedAt: string | null;
+    }[]>;
+    updateWallet: (id: string, data: {
+        label?: string;
+        isPrimary?: boolean;
+    }) => Promise<void>;
+};
+
+declare function useSessions(): {
+    sessions: Session[] | null;
+    loading: boolean;
+    fetchSessions: () => Promise<{
+        id: string;
+        createdAt: string;
+        expiresAt: string;
+        lastActiveAt: string;
+        deviceInfo: Record<string, unknown> | null;
+        ipAddress: string;
+    }[]>;
+    revokeSession: (id: string) => Promise<void>;
+};
+
+export { type ApiClient, type AppearanceConfig, type AuthMethod, type AuthProvider, type AuthState, type AuthStatus, type Chain, ForgeConnectApiError, type ForgeConnectConfig, ForgeConnectContext, type ForgeConnectContextValue, ForgeConnectProvider, LoginButton, LoginModal, ModalOverlay, type ModalState, type ModalStep, type OAuthProvider, type Session, type User, type Wallet, createApiClient, useForgeConnect, useSessions, useUser, useWallets };