@pollar/react 0.8.1 → 0.9.0-rc.1

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PollarApplicationConfigContent, PollarLoginOptions, PollarClientConfig, WalletId, AuthState, pollarPaths, PollarClient, PollarAdapters, OnStorageDegrade, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, TxHistoryState, PollarAdapter, KycStatus as KycStatus$1, RampQuote, KycProvider, KycStartResponse, RampDirection, PaymentInstructions, WalletBalanceRecord, SessionInfo, DistributionRulesState, DistributionRule } from '@pollar/core';
+import { WalletId, AuthState, pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, EnabledAssetsState, TxHistoryState, PollarAdapter, KycStatus as KycStatus$1, RampQuote, KycProvider, KycStartResponse, RampDirection, PaymentInstructions, WalletBalanceRecord, DistributionRulesState, DistributionRule } from '@pollar/core';
+export { SessionsState } from '@pollar/core';
 import { ReactNode } from 'react';
 
 type ConfigResponse = pollarPaths['/applications/config']['get']['responses'][200]['content']['application/json'];
@@ -22,17 +23,6 @@ interface RenderWalletsProps {
  * with whatever the slot returns (typically a kit-powered wallet grid).
  */
 type RenderWalletsSlot = (props: RenderWalletsProps) => ReactNode;
-interface AuthProviderProps {
-    config: PollarClientConfig;
-    children: React.ReactNode;
-}
-interface AuthContextValue {
-    session: PollarApplicationConfigContent | null;
-    isLoading: boolean;
-    isAuthenticated: boolean;
-    login: (options: PollarLoginOptions) => void;
-    logout: () => Promise<void>;
-}
 interface LoginButtonProps {
     onSuccess?: () => void;
     onError?: (error: Error) => void;
@@ -50,8 +40,15 @@ interface PollarContextValue {
     getClient: () => PollarClient;
     openLoginModal: () => void;
     isAuthenticated: boolean;
+    /**
+     * `true` once the server has confirmed the session (login / refresh /
+     * `/auth/session/resume`). `false` while a cold-start session is still
+     * optimistic — gate sensitive actions (e.g. signing) on this.
+     */
+    verified: boolean;
     login: (options: PollarLoginOptions) => void;
     logout: () => void;
+    sessions: SessionsState;
     /** Open the active-sessions modal. */
     openSessionsModal: () => void;
     appConfig: PollarConfig;
@@ -61,7 +58,7 @@ interface PollarContextValue {
     openTxModal: () => void;
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
-    signAndSubmitTx: (unsignedXdr: string) => Promise<SubmitOutcome>;
+    signAndSubmitTx: (unsignedXdr?: string) => Promise<SubmitOutcome>;
     /** External-wallet only. Custodial flows should use `signAndSubmitTx`. */
     signTx: (unsignedXdr: string) => Promise<SignOutcome>;
     submitTx: (signedXdr: string) => Promise<SubmitOutcome>;
@@ -74,6 +71,15 @@ interface PollarContextValue {
     setNetwork: (network: StellarNetwork) => void;
     walletBalance: WalletBalanceState;
     refreshWalletBalance: () => Promise<void>;
+    /**
+     * The application's dashboard-enabled assets paired with the authenticated
+     * wallet's on-chain trustline state (`trustlineEstablished` per asset). Driven
+     * by {@link refreshAssets}; mirrors {@link walletBalance}.
+     */
+    enabledAssets: EnabledAssetsState;
+    refreshAssets: () => Promise<void>;
+    /** Open the enabled-assets / trustline-state modal. */
+    openEnabledAssetsModal: () => void;
     openKycModal: (options?: {
         country?: string;
         level?: 'basic' | 'intermediate' | 'enhanced';
@@ -133,6 +139,32 @@ declare function createPollarAdapterHook<T extends PollarAdapter>(key: string):
 
 declare function WalletButton(): react_jsx_runtime.JSX.Element;
 
+interface WalletButtonTemplateProps {
+    walletAddress: string | null;
+    accentColor: string;
+    open: boolean;
+    copied: boolean;
+    dropdownBg: string;
+    dropdownBorder: string;
+    itemColor: string;
+    wrapperRef: React.RefObject<HTMLDivElement>;
+    isInProgress: boolean;
+    walletType: WalletId | null;
+    onToggleOpen: () => void;
+    onCopy: () => void;
+    onWalletBalance: () => void;
+    onTxHistory: () => void;
+    onSend: () => void;
+    onReceive: () => void;
+    onSessions: () => void;
+    onKyc: () => void;
+    onRamp: () => void;
+    onDistributionRules: () => void;
+    onLogout: () => void;
+    onLogin: () => void;
+}
+declare function WalletButtonTemplate({ walletAddress, accentColor, open, copied, dropdownBg, dropdownBorder, itemColor, wrapperRef, isInProgress, onToggleOpen, onCopy, onWalletBalance, onTxHistory, onSend, onReceive, onSessions, onKyc, onRamp, onDistributionRules, onLogout, onLogin, }: WalletButtonTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface KycModalProps {
     onClose: () => void;
     /** ISO 3166-1 alpha-2 country code to filter providers. Defaults to 'MX'. */
@@ -166,6 +198,11 @@ interface WalletBalanceModalProps {
 }
 declare function WalletBalanceModal({ onClose }: WalletBalanceModalProps): react_jsx_runtime.JSX.Element;
 
+interface EnabledAssetsModalProps {
+    onClose: () => void;
+}
+declare function EnabledAssetsModal({ onClose }: EnabledAssetsModalProps): react_jsx_runtime.JSX.Element;
+
 interface SendModalProps {
     onClose: () => void;
 }
@@ -192,6 +229,9 @@ interface LoginModalTemplateProps {
     logoUrl: string | null;
     emailEnabled: boolean;
     embeddedWallets: boolean;
+    /** Show the "Smart Wallet" (passkey) option. Optional & defaults to off so
+     *  adding it isn't a breaking change for existing template consumers. */
+    smartWallet?: boolean;
     providers: {
         google: boolean;
         discord: boolean;
@@ -205,6 +245,7 @@ interface LoginModalTemplateProps {
     onEmailSubmit?: () => void;
     onSocialLogin?: (provider: 'google' | 'github') => void;
     onWalletConnect?: (id: WalletId) => void;
+    onSmartWallet?: () => void;
     /** Optional override for the wallet picker view. Defaults to a Freighter+Albedo list. */
     renderWallets?: RenderWalletsSlot;
     authState: AuthState;
@@ -214,7 +255,7 @@ interface LoginModalTemplateProps {
     onCancel: () => void;
     onRetry: () => void;
 }
-declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, providers, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onWalletConnect, renderWallets, authState, codeInputKey, onCodeSubmit, onBack, onCancel, onRetry, }: LoginModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onWalletConnect, onSmartWallet, renderWallets, authState, codeInputKey, onCodeSubmit, onBack, onCancel, onRetry, }: LoginModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 type KycStep = 'select_provider' | 'verifying' | 'polling' | 'done';
 interface KycModalTemplateProps {
@@ -307,6 +348,16 @@ interface WalletBalanceModalTemplateProps {
 }
 declare function WalletBalanceModalTemplate({ theme, accentColor, walletBalance, walletAddress, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
 
+interface EnabledAssetsModalTemplateProps {
+    theme: string;
+    accentColor: string;
+    enabledAssets: EnabledAssetsState;
+    walletAddress: string;
+    onRefresh: () => void;
+    onClose: () => void;
+}
+declare function EnabledAssetsModalTemplate({ theme, accentColor, enabledAssets, walletAddress, onRefresh, onClose, }: EnabledAssetsModalTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface SendModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -349,17 +400,6 @@ interface ReceiveModalTemplateProps {
 }
 declare function ReceiveModalTemplate({ theme, accentColor, walletAddress, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-type SessionsState = {
-    step: 'idle';
-} | {
-    step: 'loading';
-} | {
-    step: 'loaded';
-    sessions: SessionInfo[];
-} | {
-    step: 'error';
-    message: string;
-};
 interface SessionsModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -386,4 +426,4 @@ interface DistributionRulesModalTemplateProps {
 }
 declare function DistributionRulesModalTemplate({ theme, accentColor, state, claimingId, claimErrors, claimedIds, onRefresh, onClaim, onClose, }: DistributionRulesModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthContextValue, type AuthModalProps, type AuthProviderProps, DistributionRulesModal, DistributionRulesModalTemplate, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, type RenderWalletsProps, type RenderWalletsSlot, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SessionsState, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, createPollarAdapterHook, usePollar };
+export { type AuthModalProps, DistributionRulesModal, DistributionRulesModalTemplate, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, type RenderWalletsProps, type RenderWalletsSlot, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, createPollarAdapterHook, usePollar };