@pollar/core 0.4.3 → 0.4.5

package/dist/index.d.mts

@@ -1325,48 +1325,10 @@ declare const StateStatus: {
 type StateStatus = (typeof StateStatus)[keyof typeof StateStatus];
 declare const PollarStateVar: {
     readonly NETWORK: "network";
-    readonly AUTHENTICATION: "authentication";
     readonly TRANSACTION: "transaction";
 };
 type PollarStateVar = (typeof PollarStateVar)[keyof typeof PollarStateVar];
 declare const STATE_VAR_CODES: {
-    readonly authentication: {
-        readonly NONE: "NONE";
-        readonly LOGOUT: "LOGOUT";
-        readonly CREATE_SESSION_START: "CREATE_SESSION_START";
-        readonly CREATE_SESSION_ERROR: "CREATE_SESSION_ERROR";
-        readonly CREATE_SESSION_SUCCESS: "CREATE_SESSION_SUCCESS";
-        readonly EMAIL_AUTH_START: "EMAIL_AUTH_START";
-        readonly EMAIL_AUTH_START_ERROR: "EMAIL_AUTH_START_ERROR";
-        readonly EMAIL_AUTH_START_SUCCESS: "EMAIL_AUTH_START_SUCCESS";
-        readonly EMAIL_AUTH_CODE_ERROR: "EMAIL_AUTH_CODE_ERROR";
-        readonly EMAIL_AUTH_CODE_SUCCESS: "EMAIL_AUTH_CODE_SUCCESS";
-        readonly WALLET_AUTH_START: "WALLET_AUTH_START";
-        readonly WALLET_AUTH_FREIGHTER_NOT_INSTALLED: "WALLET_AUTH_FREIGHTER_NOT_INSTALLED";
-        readonly WALLET_AUTH_ALBEDO_NOT_INSTALLED: "WALLET_AUTH_ALBEDO_NOT_INSTALLED";
-        readonly WALLET_AUTH_CONNECTED: "WALLET_AUTH_CONNECTED";
-        readonly WALLET_AUTH_LOGIN_START: "WALLET_AUTH_LOGIN_START";
-        readonly WALLET_AUTH_LOGIN_START_SUCCESS: "WALLET_AUTH_LOGIN_START_SUCCESS";
-        readonly WALLET_AUTH_LOGIN_START_ERROR: "WALLET_AUTH_LOGIN_START_ERROR";
-        readonly WALLET_AUTH_ERROR: "WALLET_AUTH_ERROR";
-        readonly STREAM_POLL_START: "STREAM_POLL_START";
-        readonly STREAM_POLL_EVENT: "STREAM_POLL_EVENT";
-        readonly STREAM_POLL_READY: "STREAM_POLL_READY";
-        readonly FETCH_SESSION_START: "FETCH_SESSION_START";
-        readonly FETCH_SESSION_SUCCESS: "FETCH_SESSION_SUCCESS";
-        readonly FETCH_SESSION_ERROR: "FETCH_SESSION_ERROR";
-        readonly NO_RESTORED_SESSION: "NO_RESTORED_SESSION";
-        readonly RESTORED_SESSION_SUCCESS: "RESTORED_SESSION_SUCCESS";
-        readonly RESTORED_SESSION_ERROR: "RESTORED_SESSION_ERROR";
-        readonly SESSION_STORED: "SESSION_STORED";
-        readonly ERROR_ABORTED: "ABORTED";
-        readonly ERROR_UNKNOWN: "ERROR_UNKNOWN";
-    };
-    readonly walletAddress: {
-        readonly NONE: "NONE";
-        readonly REMOVED_ADDRESS: "REMOVED_ADDRESS";
-        readonly UPDATED_ADDRESS: "UPDATED_ADDRESS";
-    };
     readonly transaction: {
         readonly NONE: "NONE";
         readonly BUILD_TRANSACTION_ERROR_NO_WALLET: "BUILD_TRANSACTION_ERROR_NO_WALLET";
@@ -1461,11 +1423,9 @@ type PollarLoginOptions = {
 };
 type NetworkCodes = (typeof STATE_VAR_CODES)[typeof PollarStateVar.NETWORK];
 type StateNetworkCodes = NetworkCodes[keyof (typeof STATE_VAR_CODES)[typeof PollarStateVar.NETWORK]];
-type AuthenticationCodes = (typeof STATE_VAR_CODES)[typeof PollarStateVar.AUTHENTICATION];
-type StateAuthenticationCodes = AuthenticationCodes[keyof (typeof STATE_VAR_CODES)[typeof PollarStateVar.AUTHENTICATION]];
 type TransactionCodes = (typeof STATE_VAR_CODES)[typeof PollarStateVar.TRANSACTION];
 type StateTransactionCodes = TransactionCodes[keyof (typeof STATE_VAR_CODES)[typeof PollarStateVar.TRANSACTION]];
-type StateVarCodes = StateNetworkCodes | StateAuthenticationCodes | StateTransactionCodes;
+type StateVarCodes = StateNetworkCodes | StateTransactionCodes;
 interface PollarStateEntry {
     var: PollarStateVar;
     code: StateVarCodes;
@@ -1477,6 +1437,64 @@ interface PollarStateEntry {
 type PollarState = {
     [key in PollarStateVar]: PollarStateEntry[];
 };
+declare const AUTH_ERROR_CODES: {
+    readonly SESSION_CREATE_FAILED: "SESSION_CREATE_FAILED";
+    readonly EMAIL_SEND_FAILED: "EMAIL_SEND_FAILED";
+    readonly EMAIL_VERIFY_FAILED: "EMAIL_VERIFY_FAILED";
+    readonly EMAIL_CODE_EXPIRED: "EMAIL_CODE_EXPIRED";
+    readonly EMAIL_CODE_INVALID: "EMAIL_CODE_INVALID";
+    readonly AUTH_FAILED: "AUTH_FAILED";
+    readonly WALLET_CONNECT_FAILED: "WALLET_CONNECT_FAILED";
+    readonly WALLET_AUTH_FAILED: "WALLET_AUTH_FAILED";
+    readonly UNEXPECTED_ERROR: "UNEXPECTED_ERROR";
+};
+type AuthErrorCode = (typeof AUTH_ERROR_CODES)[keyof typeof AUTH_ERROR_CODES];
+type AuthState = {
+    step: 'idle';
+} | {
+    step: 'creating_session';
+} | {
+    step: 'entering_email';
+    clientSessionId: string;
+} | {
+    step: 'sending_email';
+    email: string;
+} | {
+    step: 'entering_code';
+    clientSessionId: string;
+    email: string;
+} | {
+    step: 'verifying_email_code';
+    clientSessionId: string;
+    email: string;
+} | {
+    step: 'opening_oauth';
+    provider: 'google' | 'github';
+} | {
+    step: 'connecting_wallet';
+    walletType: WalletType;
+} | {
+    step: 'wallet_not_installed';
+    walletType: WalletType;
+} | {
+    step: 'authenticating_wallet';
+} | {
+    step: 'authenticating';
+} | {
+    step: 'authenticated';
+    session: PollarApplicationConfigContent;
+} | {
+    step: 'error';
+    previousStep: string;
+    message: string;
+    errorCode: AuthErrorCode;
+    clientSessionId?: string;
+    email?: string;
+};
+declare class PollarFlowError extends Error {
+    readonly code: "INVALID_FLOW";
+    constructor(message: string);
+}
 
 declare class PollarClient {
     readonly apiKey: string;
@@ -1486,62 +1504,35 @@ declare class PollarClient {
     private _session;
     private _stateListeners;
     private _state;
+    private _authState;
+    private _authStateListeners;
+    private _loginController;
     constructor(config: PollarClientConfig);
     isAuthenticated(): boolean;
-    getState(): {
-        session: {
-            clientSessionId: string;
-            userId: string | null;
-            status: string;
-            token: {
-                accessToken: string;
-                refreshToken: string;
-                expiresAt: number;
-            };
-            user: {
-                id?: string;
-                ready: boolean;
-            };
-            wallet: {
-                publicKey: string | null;
-                existsOnStellar?: boolean;
-                createdAt?: number;
-            };
-            data: {
-                mail: string;
-                first_name: string;
-                last_name: string;
-                avatar: string;
-                providers: {
-                    email: {
-                        address: string;
-                    } | null;
-                    google: {
-                        id: string;
-                    } | null;
-                    github: {
-                        id: string;
-                    } | null;
-                    wallet: {
-                        address: string;
-                    } | null;
-                };
-            };
-        } | null;
-    };
+    getAuthState(): AuthState;
+    onAuthStateChange(cb: (state: AuthState) => void): () => void;
+    login(options: PollarLoginOptions): void;
+    beginEmailLogin(): void;
+    sendEmailCode(email: string): void;
+    verifyEmailCode(code: string): void;
+    loginOAuth(provider: 'google' | 'github'): void;
+    loginWallet(type: WalletType): void;
+    cancelLogin(): void;
+    logout(): void;
     getApi(): PollarApiClient;
-    login(options: PollarLoginOptions): {
-        cancelLogin: () => void;
-    };
-    onStateChange(cb: (state: PollarStateEntry) => void): () => void;
-    verifyEmailCode(clientSessionId: string, code: string): Promise<void>;
     getNetwork(): "testnet" | "public";
+    onStateChange(cb: (state: PollarStateEntry) => void): () => void;
     buildTx(operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']): Promise<void>;
     submitTx(signedXdr: string): Promise<void>;
-    logout(): void;
+    /** Creates a new AbortController, cancelling any existing flow first. */
+    private _newController;
+    /** Builds the deps object passed to flow functions via bind pattern. */
+    private _flowDeps;
+    private _handleFlowError;
     private _readStore;
     private _storeSession;
     private _clearSession;
+    private _setAuthState;
     private _emitState;
 }
 
@@ -1570,4 +1561,4 @@ declare class StellarClient {
     getBalances(publicKey: string): Promise<GetBalancesResult>;
 }
 
-export { AlbedoAdapter, type ConnectWalletResponse, FreighterAdapter, type GetBalancesResult, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, type PollarLoginOptions, type PollarState, type PollarStateEntry, PollarStateVar, STATE_VAR_CODES, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignTransactionOptions, type SignTransactionResponse, type StateAuthenticationCodes, type StateNetworkCodes, StateStatus, type StateTransactionCodes, type StateVarCodes, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, type TxBuildBody, type TxBuildResponse, type TxSignAndSendBody, type TxSignSendResponse, type WalletAdapter, WalletType, isValidSession, type paths as pollarPaths };
+export { AUTH_ERROR_CODES, AlbedoAdapter, type AuthErrorCode, type AuthState, type ConnectWalletResponse, FreighterAdapter, type GetBalancesResult, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLoginOptions, type PollarState, type PollarStateEntry, PollarStateVar, STATE_VAR_CODES, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignTransactionOptions, type SignTransactionResponse, type StateNetworkCodes, StateStatus, type StateTransactionCodes, type StateVarCodes, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, type TxBuildBody, type TxBuildResponse, type TxSignAndSendBody, type TxSignSendResponse, type WalletAdapter, WalletType, isValidSession, type paths as pollarPaths };

package/dist/index.d.ts

@@ -1325,48 +1325,10 @@ declare const StateStatus: {
 type StateStatus = (typeof StateStatus)[keyof typeof StateStatus];
 declare const PollarStateVar: {
     readonly NETWORK: "network";
-    readonly AUTHENTICATION: "authentication";
     readonly TRANSACTION: "transaction";
 };
 type PollarStateVar = (typeof PollarStateVar)[keyof typeof PollarStateVar];
 declare const STATE_VAR_CODES: {
-    readonly authentication: {
-        readonly NONE: "NONE";
-        readonly LOGOUT: "LOGOUT";
-        readonly CREATE_SESSION_START: "CREATE_SESSION_START";
-        readonly CREATE_SESSION_ERROR: "CREATE_SESSION_ERROR";
-        readonly CREATE_SESSION_SUCCESS: "CREATE_SESSION_SUCCESS";
-        readonly EMAIL_AUTH_START: "EMAIL_AUTH_START";
-        readonly EMAIL_AUTH_START_ERROR: "EMAIL_AUTH_START_ERROR";
-        readonly EMAIL_AUTH_START_SUCCESS: "EMAIL_AUTH_START_SUCCESS";
-        readonly EMAIL_AUTH_CODE_ERROR: "EMAIL_AUTH_CODE_ERROR";
-        readonly EMAIL_AUTH_CODE_SUCCESS: "EMAIL_AUTH_CODE_SUCCESS";
-        readonly WALLET_AUTH_START: "WALLET_AUTH_START";
-        readonly WALLET_AUTH_FREIGHTER_NOT_INSTALLED: "WALLET_AUTH_FREIGHTER_NOT_INSTALLED";
-        readonly WALLET_AUTH_ALBEDO_NOT_INSTALLED: "WALLET_AUTH_ALBEDO_NOT_INSTALLED";
-        readonly WALLET_AUTH_CONNECTED: "WALLET_AUTH_CONNECTED";
-        readonly WALLET_AUTH_LOGIN_START: "WALLET_AUTH_LOGIN_START";
-        readonly WALLET_AUTH_LOGIN_START_SUCCESS: "WALLET_AUTH_LOGIN_START_SUCCESS";
-        readonly WALLET_AUTH_LOGIN_START_ERROR: "WALLET_AUTH_LOGIN_START_ERROR";
-        readonly WALLET_AUTH_ERROR: "WALLET_AUTH_ERROR";
-        readonly STREAM_POLL_START: "STREAM_POLL_START";
-        readonly STREAM_POLL_EVENT: "STREAM_POLL_EVENT";
-        readonly STREAM_POLL_READY: "STREAM_POLL_READY";
-        readonly FETCH_SESSION_START: "FETCH_SESSION_START";
-        readonly FETCH_SESSION_SUCCESS: "FETCH_SESSION_SUCCESS";
-        readonly FETCH_SESSION_ERROR: "FETCH_SESSION_ERROR";
-        readonly NO_RESTORED_SESSION: "NO_RESTORED_SESSION";
-        readonly RESTORED_SESSION_SUCCESS: "RESTORED_SESSION_SUCCESS";
-        readonly RESTORED_SESSION_ERROR: "RESTORED_SESSION_ERROR";
-        readonly SESSION_STORED: "SESSION_STORED";
-        readonly ERROR_ABORTED: "ABORTED";
-        readonly ERROR_UNKNOWN: "ERROR_UNKNOWN";
-    };
-    readonly walletAddress: {
-        readonly NONE: "NONE";
-        readonly REMOVED_ADDRESS: "REMOVED_ADDRESS";
-        readonly UPDATED_ADDRESS: "UPDATED_ADDRESS";
-    };
     readonly transaction: {
         readonly NONE: "NONE";
         readonly BUILD_TRANSACTION_ERROR_NO_WALLET: "BUILD_TRANSACTION_ERROR_NO_WALLET";
@@ -1461,11 +1423,9 @@ type PollarLoginOptions = {
 };
 type NetworkCodes = (typeof STATE_VAR_CODES)[typeof PollarStateVar.NETWORK];
 type StateNetworkCodes = NetworkCodes[keyof (typeof STATE_VAR_CODES)[typeof PollarStateVar.NETWORK]];
-type AuthenticationCodes = (typeof STATE_VAR_CODES)[typeof PollarStateVar.AUTHENTICATION];
-type StateAuthenticationCodes = AuthenticationCodes[keyof (typeof STATE_VAR_CODES)[typeof PollarStateVar.AUTHENTICATION]];
 type TransactionCodes = (typeof STATE_VAR_CODES)[typeof PollarStateVar.TRANSACTION];
 type StateTransactionCodes = TransactionCodes[keyof (typeof STATE_VAR_CODES)[typeof PollarStateVar.TRANSACTION]];
-type StateVarCodes = StateNetworkCodes | StateAuthenticationCodes | StateTransactionCodes;
+type StateVarCodes = StateNetworkCodes | StateTransactionCodes;
 interface PollarStateEntry {
     var: PollarStateVar;
     code: StateVarCodes;
@@ -1477,6 +1437,64 @@ interface PollarStateEntry {
 type PollarState = {
     [key in PollarStateVar]: PollarStateEntry[];
 };
+declare const AUTH_ERROR_CODES: {
+    readonly SESSION_CREATE_FAILED: "SESSION_CREATE_FAILED";
+    readonly EMAIL_SEND_FAILED: "EMAIL_SEND_FAILED";
+    readonly EMAIL_VERIFY_FAILED: "EMAIL_VERIFY_FAILED";
+    readonly EMAIL_CODE_EXPIRED: "EMAIL_CODE_EXPIRED";
+    readonly EMAIL_CODE_INVALID: "EMAIL_CODE_INVALID";
+    readonly AUTH_FAILED: "AUTH_FAILED";
+    readonly WALLET_CONNECT_FAILED: "WALLET_CONNECT_FAILED";
+    readonly WALLET_AUTH_FAILED: "WALLET_AUTH_FAILED";
+    readonly UNEXPECTED_ERROR: "UNEXPECTED_ERROR";
+};
+type AuthErrorCode = (typeof AUTH_ERROR_CODES)[keyof typeof AUTH_ERROR_CODES];
+type AuthState = {
+    step: 'idle';
+} | {
+    step: 'creating_session';
+} | {
+    step: 'entering_email';
+    clientSessionId: string;
+} | {
+    step: 'sending_email';
+    email: string;
+} | {
+    step: 'entering_code';
+    clientSessionId: string;
+    email: string;
+} | {
+    step: 'verifying_email_code';
+    clientSessionId: string;
+    email: string;
+} | {
+    step: 'opening_oauth';
+    provider: 'google' | 'github';
+} | {
+    step: 'connecting_wallet';
+    walletType: WalletType;
+} | {
+    step: 'wallet_not_installed';
+    walletType: WalletType;
+} | {
+    step: 'authenticating_wallet';
+} | {
+    step: 'authenticating';
+} | {
+    step: 'authenticated';
+    session: PollarApplicationConfigContent;
+} | {
+    step: 'error';
+    previousStep: string;
+    message: string;
+    errorCode: AuthErrorCode;
+    clientSessionId?: string;
+    email?: string;
+};
+declare class PollarFlowError extends Error {
+    readonly code: "INVALID_FLOW";
+    constructor(message: string);
+}
 
 declare class PollarClient {
     readonly apiKey: string;
@@ -1486,62 +1504,35 @@ declare class PollarClient {
     private _session;
     private _stateListeners;
     private _state;
+    private _authState;
+    private _authStateListeners;
+    private _loginController;
     constructor(config: PollarClientConfig);
     isAuthenticated(): boolean;
-    getState(): {
-        session: {
-            clientSessionId: string;
-            userId: string | null;
-            status: string;
-            token: {
-                accessToken: string;
-                refreshToken: string;
-                expiresAt: number;
-            };
-            user: {
-                id?: string;
-                ready: boolean;
-            };
-            wallet: {
-                publicKey: string | null;
-                existsOnStellar?: boolean;
-                createdAt?: number;
-            };
-            data: {
-                mail: string;
-                first_name: string;
-                last_name: string;
-                avatar: string;
-                providers: {
-                    email: {
-                        address: string;
-                    } | null;
-                    google: {
-                        id: string;
-                    } | null;
-                    github: {
-                        id: string;
-                    } | null;
-                    wallet: {
-                        address: string;
-                    } | null;
-                };
-            };
-        } | null;
-    };
+    getAuthState(): AuthState;
+    onAuthStateChange(cb: (state: AuthState) => void): () => void;
+    login(options: PollarLoginOptions): void;
+    beginEmailLogin(): void;
+    sendEmailCode(email: string): void;
+    verifyEmailCode(code: string): void;
+    loginOAuth(provider: 'google' | 'github'): void;
+    loginWallet(type: WalletType): void;
+    cancelLogin(): void;
+    logout(): void;
     getApi(): PollarApiClient;
-    login(options: PollarLoginOptions): {
-        cancelLogin: () => void;
-    };
-    onStateChange(cb: (state: PollarStateEntry) => void): () => void;
-    verifyEmailCode(clientSessionId: string, code: string): Promise<void>;
     getNetwork(): "testnet" | "public";
+    onStateChange(cb: (state: PollarStateEntry) => void): () => void;
     buildTx(operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']): Promise<void>;
     submitTx(signedXdr: string): Promise<void>;
-    logout(): void;
+    /** Creates a new AbortController, cancelling any existing flow first. */
+    private _newController;
+    /** Builds the deps object passed to flow functions via bind pattern. */
+    private _flowDeps;
+    private _handleFlowError;
     private _readStore;
     private _storeSession;
     private _clearSession;
+    private _setAuthState;
     private _emitState;
 }
 
@@ -1570,4 +1561,4 @@ declare class StellarClient {
     getBalances(publicKey: string): Promise<GetBalancesResult>;
 }
 
-export { AlbedoAdapter, type ConnectWalletResponse, FreighterAdapter, type GetBalancesResult, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, type PollarLoginOptions, type PollarState, type PollarStateEntry, PollarStateVar, STATE_VAR_CODES, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignTransactionOptions, type SignTransactionResponse, type StateAuthenticationCodes, type StateNetworkCodes, StateStatus, type StateTransactionCodes, type StateVarCodes, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, type TxBuildBody, type TxBuildResponse, type TxSignAndSendBody, type TxSignSendResponse, type WalletAdapter, WalletType, isValidSession, type paths as pollarPaths };
+export { AUTH_ERROR_CODES, AlbedoAdapter, type AuthErrorCode, type AuthState, type ConnectWalletResponse, FreighterAdapter, type GetBalancesResult, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLoginOptions, type PollarState, type PollarStateEntry, PollarStateVar, STATE_VAR_CODES, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignTransactionOptions, type SignTransactionResponse, type StateNetworkCodes, StateStatus, type StateTransactionCodes, type StateVarCodes, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, type TxBuildBody, type TxBuildResponse, type TxSignAndSendBody, type TxSignSendResponse, type WalletAdapter, WalletType, isValidSession, type paths as pollarPaths };