@pollar/react 0.8.0 → 0.9.0-rc.0

package/README.md

@@ -247,6 +247,9 @@ want to swap the chrome but keep the data wiring from `usePollar()`.
 `<TxStatusView>` is the shared status component (build → sign → success/error) reused by `TransactionModal` and
 `SendModal`; it's exported on its own for consumers that want to embed the lifecycle elsewhere.
 
+> **0.8.1** — `onWalletConnect` is now **optional** on `<LoginModalTemplate>` (defaults to a no-op). If you drive the
+> wallet picker entirely through `ui.renderWallets`, you no longer have to pass a handler you don't use.
+
 ---
 
 ### Custom adapters

package/dist/index.d.mts

@@ -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, 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>;
@@ -133,6 +130,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'. */
@@ -192,6 +215,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;
@@ -204,7 +230,8 @@ interface LoginModalTemplateProps {
     onEmailChange?: (email: string) => void;
     onEmailSubmit?: () => void;
     onSocialLogin?: (provider: 'google' | 'github') => void;
-    onWalletConnect: (id: WalletId) => 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 +241,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 {
@@ -349,17 +376,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 +402,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, 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 };

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, 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>;
@@ -133,6 +130,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'. */
@@ -192,6 +215,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;
@@ -204,7 +230,8 @@ interface LoginModalTemplateProps {
     onEmailChange?: (email: string) => void;
     onEmailSubmit?: () => void;
     onSocialLogin?: (provider: 'google' | 'github') => void;
-    onWalletConnect: (id: WalletId) => 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 +241,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 {
@@ -349,17 +376,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 +402,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, 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 };