@finatic/client 0.0.136 → 0.0.137

package/dist/types/core/client/ApiClient.d.ts

@@ -1,14 +1,13 @@
-import { Holding, Portfolio } from '../../types/api/portfolio';
 import { Order } from '../../types/api/orders';
-import { BrokerInfo, BrokerAccount, BrokerOrder, BrokerPosition, BrokerDataOptions, DisconnectCompanyResponse } from '../../types/api/broker';
+import { BrokerInfo, BrokerAccount, BrokerOrder, BrokerPosition, BrokerBalance, BrokerDataOptions, DisconnectCompanyResponse } from '../../types/api/broker';
 import { BrokerOrderParams, BrokerExtras } from '../../types/api/broker';
 import { CryptoOrderOptions, OptionsOrderOptions, OrderResponse } from '../../types/api/orders';
 import { BrokerConnection } from '../../types/api/broker';
-import { OrdersFilter, PositionsFilter, AccountsFilter } from '../../types/api/broker';
+import { OrdersFilter, PositionsFilter, AccountsFilter, BalancesFilter } from '../../types/api/broker';
 import { TradingContext } from '../../types/api/orders';
 import { PaginatedResult } from '../../types/common/pagination';
 import { PortalUrlResponse } from '../../types/api/core';
-import { DeviceInfo, SessionState, TokenInfo, SessionResponse, OtpRequestResponse, OtpVerifyResponse, SessionValidationResponse, SessionAuthenticateResponse, UserToken } from '../../types/api/auth';
+import { DeviceInfo, SessionState, TokenInfo, SessionResponse, OtpRequestResponse, OtpVerifyResponse, SessionAuthenticateResponse, UserToken } from '../../types/api/auth';
 import { ApiError } from '../../utils/errors';
 export declare class ApiClient {
     private readonly baseUrl;
@@ -90,17 +89,10 @@ export declare class ApiClient {
      * @throws SessionError if session is not in ACTIVE state
      */
     getPortalUrl(sessionId: string): Promise<PortalUrlResponse>;
-    validatePortalSession(sessionId: string, signature: string): Promise<SessionValidationResponse>;
     completePortalSession(sessionId: string): Promise<PortalUrlResponse>;
-    getHoldings(): Promise<{
-        data: Holding[];
-    }>;
     getOrders(): Promise<{
         data: Order[];
     }>;
-    getPortfolio(): Promise<{
-        data: Portfolio;
-    }>;
     placeBrokerOrder(params: Partial<BrokerOrderParams> & {
         symbol: string;
         orderQty: number;
@@ -126,8 +118,7 @@ export declare class ApiClient {
     private buildOrderRequestBody;
     private buildModifyRequestBody;
     private applyBrokerDefaults;
-    revokeToken(): Promise<void>;
-    getUserToken(userId: string): Promise<UserToken>;
+    getUserToken(sessionId: string): Promise<UserToken>;
     /**
      * Get the current session state
      */
@@ -180,6 +171,14 @@ export declare class ApiClient {
         warnings: null;
         errors: null;
     }>;
+    getBrokerBalances(options?: BrokerDataOptions): Promise<{
+        _id: string;
+        response_data: BrokerBalance[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
     getBrokerConnections(): Promise<{
         _id: string;
         response_data: BrokerConnection[];
@@ -188,9 +187,18 @@ export declare class ApiClient {
         warnings: null;
         errors: null;
     }>;
+    getBalances(filters?: any): Promise<{
+        _id: string;
+        response_data: any[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
     getBrokerOrdersPage(page?: number, perPage?: number, filters?: OrdersFilter): Promise<PaginatedResult<BrokerOrder[]>>;
     getBrokerAccountsPage(page?: number, perPage?: number, filters?: AccountsFilter): Promise<PaginatedResult<BrokerAccount[]>>;
     getBrokerPositionsPage(page?: number, perPage?: number, filters?: PositionsFilter): Promise<PaginatedResult<BrokerPosition[]>>;
+    getBrokerBalancesPage(page?: number, perPage?: number, filters?: BalancesFilter): Promise<PaginatedResult<BrokerBalance[]>>;
     getNextPage<T>(previousResult: PaginatedResult<T>, fetchFunction: (offset: number, limit: number) => Promise<PaginatedResult<T>>): Promise<PaginatedResult<T> | null>;
     /**
      * Check if this is a mock client

package/dist/types/core/client/FinaticConnect.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from '../../utils/events';
 import { PaginatedResult } from '../../types/common/pagination';
-import { OrderResponse, TradingContext } from '../../types/api/orders';
-import { BrokerInfo, BrokerConnection, OrdersFilter, PositionsFilter, AccountsFilter, BrokerDataOrder, BrokerDataPosition, BrokerDataAccount, DisconnectCompanyResponse } from '../../types/api/broker';
+import { OrderResponse } from '../../types/api/orders';
+import { BrokerBalance, BrokerInfo, BrokerConnection, OrdersFilter, PositionsFilter, AccountsFilter, BalancesFilter, BrokerDataOrder, BrokerDataPosition, BrokerDataAccount, DisconnectCompanyResponse } from '../../types/api/broker';
 import { FinaticConnectOptions, PortalOptions } from '../../types/connect';
 interface DeviceInfo {
     ip_address: string;
@@ -34,6 +34,11 @@ export declare class FinaticConnect extends EventEmitter {
      * @returns True if the user is fully authenticated and ready for API calls
      */
     isAuthed(): boolean;
+    /**
+     * Check if the client is authenticated (alias for isAuthed for consistency)
+     * @returns True if authenticated, false otherwise
+     */
+    is_authenticated(): boolean;
     /**
      * Get user's orders with pagination and optional filtering
      * @param params - Query parameters including page, perPage, and filters
@@ -64,10 +69,6 @@ export declare class FinaticConnect extends EventEmitter {
         perPage?: number;
         filter?: AccountsFilter;
     }): Promise<PaginatedResult<BrokerDataAccount[]>>;
-    /**
-     * Revoke the current user's access
-     */
-    revokeToken(): Promise<void>;
     /**
      * Initialize the Finatic Connect SDK
      * @param token - The portal token from your backend
@@ -83,6 +84,11 @@ export declare class FinaticConnect extends EventEmitter {
      * @param userId - The user ID from a previous session
      */
     setUserId(userId: string): Promise<void>;
+    /**
+     * Get the user and tokens for a completed session
+     * @returns Promise with user information and tokens
+     */
+    getSessionUser(): Promise<Record<string, any>>;
     private initializeWithUser;
     /**
      * Handle company access error by opening the portal
@@ -147,32 +153,41 @@ export declare class FinaticConnect extends EventEmitter {
         order_id?: string;
     }>, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', connection_id?: string): Promise<OrderResponse>;
     /**
-     * Set the broker context for trading
-     * @param broker - The broker to use for trading
+     * Place a stock market order (convenience method)
+     */
+    placeStockMarketOrder(symbol: string, quantity: number, side: 'buy' | 'sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string): Promise<OrderResponse>;
+    /**
+     * Place a stock limit order (convenience method)
      */
-    setBroker(broker: 'robinhood' | 'tasty_trade' | 'ninja_trader'): void;
+    placeStockLimitOrder(symbol: string, quantity: number, side: 'buy' | 'sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string): Promise<OrderResponse>;
     /**
-     * Set the account context for trading
-     * @param accountNumber - The account number to use for trading
-     * @param accountId - Optional account ID
+     * Place a stock stop order (convenience method)
      */
-    setAccount(accountNumber: string, accountId?: string): void;
+    placeStockStopOrder(symbol: string, quantity: number, side: 'buy' | 'sell', stopPrice: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string): Promise<OrderResponse>;
     /**
-     * Get the current trading context
+     * Place a crypto market order (convenience method)
      */
-    getTradingContext(): TradingContext;
+    placeCryptoMarketOrder(symbol: string, quantity: number, side: 'buy' | 'sell', broker?: 'coinbase' | 'binance' | 'kraken', accountNumber?: string): Promise<OrderResponse>;
     /**
-     * Clear the trading context
+     * Place a crypto limit order (convenience method)
      */
-    clearTradingContext(): void;
+    placeCryptoLimitOrder(symbol: string, quantity: number, side: 'buy' | 'sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'coinbase' | 'binance' | 'kraken', accountNumber?: string): Promise<OrderResponse>;
     /**
-     * Place a stock market order (convenience method)
+     * Place an options market order (convenience method)
      */
-    placeStockMarketOrder(symbol: string, quantity: number, side: 'buy' | 'sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string): Promise<OrderResponse>;
+    placeOptionsMarketOrder(symbol: string, quantity: number, side: 'buy' | 'sell', broker?: 'tasty_trade' | 'robinhood' | 'ninja_trader', accountNumber?: string): Promise<OrderResponse>;
     /**
-     * Place a stock limit order (convenience method)
+     * Place an options limit order (convenience method)
      */
-    placeStockLimitOrder(symbol: string, quantity: number, side: 'buy' | 'sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string): Promise<OrderResponse>;
+    placeOptionsLimitOrder(symbol: string, quantity: number, side: 'buy' | 'sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'tasty_trade' | 'robinhood' | 'ninja_trader', accountNumber?: string): Promise<OrderResponse>;
+    /**
+     * Place a futures market order (convenience method)
+     */
+    placeFuturesMarketOrder(symbol: string, quantity: number, side: 'buy' | 'sell', broker?: 'ninja_trader' | 'tasty_trade', accountNumber?: string): Promise<OrderResponse>;
+    /**
+     * Place a futures limit order (convenience method)
+     */
+    placeFuturesLimitOrder(symbol: string, quantity: number, side: 'buy' | 'sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'ninja_trader' | 'tasty_trade', accountNumber?: string): Promise<OrderResponse>;
     /**
      * Get the current user ID
      * @returns The current user ID or undefined if not authenticated
@@ -258,6 +273,7 @@ export declare class FinaticConnect extends EventEmitter {
      * @returns Promise with paginated accounts result
      */
     getAccountsPage(page?: number, perPage?: number, filter?: AccountsFilter): Promise<PaginatedResult<BrokerDataAccount[]>>;
+    getBalancesPage(page?: number, perPage?: number, filter?: BalancesFilter): Promise<PaginatedResult<BrokerBalance[]>>;
     /**
      * Get the next page of orders
      * @param previousResult - The previous paginated result
@@ -276,6 +292,7 @@ export declare class FinaticConnect extends EventEmitter {
      * @returns Promise with next page of accounts or null if no more pages
      */
     getNextAccountsPage(previousResult: PaginatedResult<BrokerDataAccount[]>): Promise<PaginatedResult<BrokerDataAccount[]> | null>;
+    getNextBalancesPage(previousResult: PaginatedResult<BrokerBalance[]>): Promise<PaginatedResult<BrokerBalance[]> | null>;
     /**
      * Get all orders across all pages (convenience method)
      * @param filter - Optional filter parameters
@@ -294,6 +311,7 @@ export declare class FinaticConnect extends EventEmitter {
      * @returns Promise with all accounts
      */
     getAllAccounts(filter?: AccountsFilter): Promise<BrokerDataAccount[]>;
+    getAllBalances(filter?: BalancesFilter): Promise<BrokerBalance[]>;
     /**
      * Register session management (but don't auto-cleanup for 24-hour sessions)
      */

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export type { ApiConfig, ApiResponse, Order, OptionsOrder, BrokerAccount, PortfolioSnapshot, PerformanceMetrics, UserToken, Holding, Portfolio, PortalResponse, SessionInitResponse, SessionStartResponse, SessionResponse, OtpRequestResponse, OtpVerifyResponse, PortalUrlResponse, SessionValidationResponse, SessionAuthenticateResponse, RequestHeaders, SessionStatus, BrokerOrderParams, BrokerExtras, CryptoOrderOptions, OptionsOrderOptions, OrderResponse, TradingContext, DeviceInfo, BrokerOrder, BrokerPosition, BrokerDataOptions, BrokerInfo, TokenInfo, RefreshTokenRequest, RefreshTokenResponse, AccountsFilter, OrdersFilter, PositionsFilter, BrokerDataOrder, BrokerDataPosition, BrokerDataAccount, FilteredOrdersResponse, FilteredPositionsResponse, FilteredAccountsResponse, BrokerConnection, } from './types';
+export type { ApiConfig, ApiResponse, Order, OptionsOrder, BrokerAccount, PortfolioSnapshot, PerformanceMetrics, UserToken, Holding, Portfolio, PortalResponse, SessionInitResponse, SessionStartResponse, SessionResponse, OtpRequestResponse, OtpVerifyResponse, PortalUrlResponse, SessionValidationResponse, SessionAuthenticateResponse, RequestHeaders, SessionStatus, BrokerOrderParams, BrokerExtras, CryptoOrderOptions, OptionsOrderOptions, OrderResponse, TradingContext, DeviceInfo, BrokerOrder, BrokerPosition, BrokerBalance, BrokerDataOptions, BrokerInfo, TokenInfo, RefreshTokenRequest, RefreshTokenResponse, AccountsFilter, OrdersFilter, PositionsFilter, BalancesFilter, BrokerDataOrder, BrokerDataPosition, BrokerDataAccount, FilteredOrdersResponse, FilteredPositionsResponse, FilteredAccountsResponse, FilteredBalancesResponse, BrokerConnection, } from './types';
 export type { FinaticConnectOptions, FinaticUserToken, PortalMessage } from './types/connect';
 export type { PortalProps, PortalTheme, PortalThemeConfig, PortalThemePreset, } from './types/portal';
 export type { TradeAccessDeniedError, OrderNotFoundError, ValidationError, } from './types/api/errors';

package/dist/types/mocks/MockApiClient.d.ts

@@ -1,4 +1,4 @@
-import { SessionResponse, OtpRequestResponse, OtpVerifyResponse, PortalUrlResponse, SessionValidationResponse, SessionAuthenticateResponse, UserToken, Holding, Order, Portfolio, BrokerInfo, BrokerAccount, BrokerOrder, BrokerPosition, BrokerConnection, BrokerDataOptions, BrokerOrderParams, BrokerExtras, CryptoOrderOptions, OptionsOrderOptions, OrderResponse, TradingContext, OrdersFilter, PositionsFilter, AccountsFilter, BrokerDataOrder, BrokerDataPosition, DisconnectCompanyResponse } from '../types';
+import { SessionResponse, OtpRequestResponse, OtpVerifyResponse, PortalUrlResponse, SessionValidationResponse, SessionAuthenticateResponse, UserToken, Order, BrokerInfo, BrokerAccount, BrokerOrder, BrokerPosition, BrokerBalance, BrokerConnection, BrokerDataOptions, BrokerOrderParams, BrokerExtras, CryptoOrderOptions, OptionsOrderOptions, OrderResponse, TradingContext, OrdersFilter, PositionsFilter, AccountsFilter, BalancesFilter, BrokerDataOrder, BrokerDataPosition, DisconnectCompanyResponse } from '../types';
 import { PaginatedResult } from '../types';
 import { DeviceInfo, SessionState, TokenInfo } from '../types/api/auth';
 import { MockDataProvider, MockConfig } from './MockDataProvider';
@@ -71,15 +71,9 @@ export declare class MockApiClient {
     getPortalUrl(sessionId: string): Promise<PortalUrlResponse>;
     validatePortalSession(sessionId: string, signature: string): Promise<SessionValidationResponse>;
     completePortalSession(sessionId: string): Promise<PortalUrlResponse>;
-    getHoldings(filter?: OrdersFilter): Promise<{
-        data: Holding[];
-    }>;
     getOrders(filter?: OrdersFilter): Promise<{
         data: Order[];
     }>;
-    getPortfolio(): Promise<{
-        data: Portfolio;
-    }>;
     placeOrder(order: BrokerOrderParams): Promise<void>;
     placeBrokerOrder(params: Partial<BrokerOrderParams> & {
         symbol: string;
@@ -103,8 +97,7 @@ export declare class MockApiClient {
     placeOptionsLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, options: OptionsOrderOptions, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
     placeFuturesMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
     placeFuturesLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    revokeToken(accessToken: string): Promise<void>;
-    getUserToken(userId: string): Promise<UserToken>;
+    getUserToken(sessionId: string): Promise<UserToken>;
     getCurrentSessionState(): SessionState | null;
     getBrokerList(): Promise<{
         _id: string;
@@ -144,12 +137,16 @@ export declare class MockApiClient {
     getBrokerPositionsWithFilter(filter?: PositionsFilter): Promise<{
         data: BrokerDataPosition[];
     }>;
+    getBrokerBalancesWithFilter(filter?: BalancesFilter): Promise<{
+        data: BrokerBalance[];
+    }>;
     getBrokerDataAccountsWithFilter(filter?: AccountsFilter): Promise<{
         data: BrokerAccount[];
     }>;
     getBrokerOrdersPage(page?: number, perPage?: number, filters?: OrdersFilter): Promise<PaginatedResult<BrokerDataOrder[]>>;
     getBrokerAccountsPage(page?: number, perPage?: number, filters?: AccountsFilter): Promise<PaginatedResult<BrokerAccount[]>>;
     getBrokerPositionsPage(page?: number, perPage?: number, filters?: PositionsFilter): Promise<PaginatedResult<BrokerDataPosition[]>>;
+    getBrokerBalancesPage(page?: number, perPage?: number, filters?: BalancesFilter): Promise<PaginatedResult<BrokerBalance[]>>;
     getBrokerConnections(): Promise<{
         _id: string;
         response_data: BrokerConnection[];

package/dist/types/mocks/MockDataProvider.d.ts

@@ -1,6 +1,5 @@
-import { Holding, Portfolio } from '../types/api/portfolio';
 import { Order, OrderResponse } from '../types/api/orders';
-import { BrokerInfo, BrokerAccount, BrokerConnection, OrdersFilter, PositionsFilter, AccountsFilter, BrokerDataOrder, BrokerDataPosition, BrokerOrderParams, DisconnectCompanyResponse } from '../types/api/broker';
+import { BrokerInfo, BrokerAccount, BrokerBalance, BrokerConnection, OrdersFilter, PositionsFilter, AccountsFilter, BalancesFilter, BrokerDataOrder, BrokerDataPosition, BrokerOrderParams, DisconnectCompanyResponse } from '../types/api/broker';
 import { SessionResponse, OtpRequestResponse, OtpVerifyResponse, SessionValidationResponse, SessionAuthenticateResponse, UserToken, RefreshTokenResponse } from '../types/api/auth';
 import { PortalUrlResponse } from '../types/api/core';
 /**
@@ -80,12 +79,6 @@ export declare class MockDataProvider {
         warnings: null;
         errors: null;
     }>;
-    mockGetHoldings(): Promise<{
-        data: Holding[];
-    }>;
-    mockGetPortfolio(): Promise<{
-        data: Portfolio;
-    }>;
     mockGetOrders(filter?: OrdersFilter): Promise<{
         data: Order[];
     }>;
@@ -95,6 +88,9 @@ export declare class MockDataProvider {
     mockGetBrokerPositions(filter?: PositionsFilter): Promise<{
         data: BrokerDataPosition[];
     }>;
+    mockGetBrokerBalances(filter?: BalancesFilter): Promise<{
+        data: BrokerBalance[];
+    }>;
     mockGetBrokerDataAccounts(filter?: AccountsFilter): Promise<{
         data: BrokerAccount[];
     }>;
@@ -106,7 +102,7 @@ export declare class MockDataProvider {
     /**
      * Get stored user token
      */
-    getUserToken(userId: string): UserToken | undefined;
+    getUserToken(sessionId: string): UserToken | undefined;
     /**
      * Clear all stored data
      */
@@ -121,6 +117,7 @@ export declare class MockDataProvider {
     private applyBrokerOrderFilters;
     private applyBrokerPositionFilters;
     private applyBrokerAccountFilters;
+    private applyBrokerBalanceFilters;
     /**
      * Generate mock orders with diverse data
      */

package/dist/types/types/api/broker.d.ts

@@ -17,6 +17,18 @@ export interface BrokerAccount {
     updated_at: string;
     /** ISO 8601 timestamp with timezone information */
     last_synced_at: string;
+    /** ISO 8601 timestamp with timezone information - when positions were last synced */
+    positions_synced_at: string | null;
+    /** ISO 8601 timestamp with timezone information - when orders were last synced */
+    orders_synced_at: string | null;
+    /** ISO 8601 timestamp with timezone information - when balances were last synced */
+    balances_synced_at: string | null;
+    /** ISO 8601 timestamp with timezone information - when the account was created */
+    account_created_at: string | null;
+    /** ISO 8601 timestamp with timezone information - when the account was last updated */
+    account_updated_at: string | null;
+    /** ISO 8601 timestamp with timezone information - when the first trade occurred */
+    account_first_trade_at: string | null;
 }
 export interface BrokerOrder {
     id: string;
@@ -59,6 +71,24 @@ export interface BrokerPosition {
     /** ISO 8601 timestamp with timezone information */
     updated_at: string;
 }
+export interface BrokerBalance {
+    id: string;
+    account_id: string;
+    total_cash_value: number | null;
+    net_liquidation_value: number | null;
+    initial_margin: number | null;
+    maintenance_margin: number | null;
+    available_to_withdraw: number | null;
+    total_realized_pnl: number | null;
+    balance_created_at: string | null;
+    balance_updated_at: string | null;
+    is_end_of_day_snapshot: boolean | null;
+    raw_payload: any | null;
+    /** ISO 8601 timestamp with timezone information */
+    created_at: string;
+    /** ISO 8601 timestamp with timezone information */
+    updated_at: string;
+}
 export interface BrokerDataOptions {
     broker_name?: string;
     account_id?: string;
@@ -227,6 +257,17 @@ export interface AccountsFilter {
     offset?: number;
     with_metadata?: boolean;
 }
+export interface BalancesFilter {
+    broker_id?: string;
+    connection_id?: string;
+    account_id?: string;
+    is_end_of_day_snapshot?: boolean;
+    limit?: number;
+    offset?: number;
+    balance_created_after?: string;
+    balance_created_before?: string;
+    with_metadata?: boolean;
+}
 export interface FilteredOrdersResponse {
     orders: BrokerDataOrder[];
     total: number;
@@ -245,6 +286,12 @@ export interface FilteredAccountsResponse {
     limit: number;
     offset: number;
 }
+export interface FilteredBalancesResponse {
+    balances: BrokerBalance[];
+    total: number;
+    limit: number;
+    offset: number;
+}
 export interface DisconnectCompanyResponse {
     success: boolean;
     response_data: {

package/dist/types/types/connect.d.ts

@@ -50,4 +50,6 @@ export interface PortalOptions {
     theme?: PortalTheme;
     /** Optional list of broker names to filter by (only these brokers will be shown) */
     brokers?: string[];
+    /** Optional email address to prefill in the portal */
+    email?: string;
 }

package/dist/types/types/portal.d.ts

@@ -5,62 +5,191 @@ export interface PortalConfig {
     zIndex?: number;
 }
 export interface PortalThemeConfig {
-    mode: 'dark' | 'light' | 'auto';
-    colors: {
-        background: {
-            primary: string;
-            secondary: string;
-            tertiary: string;
-            accent: string;
-            glass: string;
-        };
-        status: {
-            connected: string;
-            disconnected: string;
-            warning: string;
-            pending: string;
-            error: string;
-            success: string;
-        };
-        text: {
-            primary: string;
-            secondary: string;
-            muted: string;
-            inverse: string;
-        };
-        border: {
-            primary: string;
-            secondary: string;
-            hover: string;
-            focus: string;
-            accent: string;
-        };
-        input: {
-            background: string;
-            border: string;
-            borderFocus: string;
-            text: string;
-            placeholder: string;
-        };
-        button: {
-            primary: {
-                background: string;
-                text: string;
-                hover: string;
-                active: string;
+    mode?: 'dark' | 'light' | 'auto';
+    colors?: {
+        background?: {
+            primary?: string;
+            secondary?: string;
+            tertiary?: string;
+            accent?: string;
+            glass?: string;
+        };
+        status?: {
+            connected?: string;
+            disconnected?: string;
+            warning?: string;
+            pending?: string;
+            error?: string;
+            success?: string;
+        };
+        text?: {
+            primary?: string;
+            secondary?: string;
+            muted?: string;
+            inverse?: string;
+        };
+        border?: {
+            primary?: string;
+            secondary?: string;
+            hover?: string;
+            focus?: string;
+            accent?: string;
+        };
+        input?: {
+            background?: string;
+            border?: string;
+            borderFocus?: string;
+            text?: string;
+            placeholder?: string;
+        };
+        button?: {
+            primary?: {
+                background?: string;
+                text?: string;
+                hover?: string;
+                active?: string;
+            };
+            secondary?: {
+                background?: string;
+                text?: string;
+                border?: string;
+                hover?: string;
+                active?: string;
+            };
+        };
+    };
+    typography?: {
+        fontFamily?: {
+            primary?: string;
+            secondary?: string;
+        };
+        fontSize?: {
+            xs?: string;
+            sm?: string;
+            base?: string;
+            lg?: string;
+            xl?: string;
+            '2xl'?: string;
+            '3xl'?: string;
+            '4xl'?: string;
+        };
+        fontWeight?: {
+            normal?: number;
+            medium?: number;
+            semibold?: number;
+            bold?: number;
+            extrabold?: number;
+        };
+        lineHeight?: {
+            tight?: string;
+            normal?: string;
+            relaxed?: string;
+        };
+    };
+    spacing?: {
+        xs?: string;
+        sm?: string;
+        md?: string;
+        lg?: string;
+        xl?: string;
+        '2xl'?: string;
+        '3xl'?: string;
+    };
+    layout?: {
+        containerMaxWidth?: string;
+        gridGap?: string;
+        cardPadding?: string;
+        borderRadius?: {
+            sm?: string;
+            md?: string;
+            lg?: string;
+            xl?: string;
+            '2xl'?: string;
+            full?: string;
+        };
+    };
+    components?: {
+        brokerCard?: {
+            width?: string;
+            height?: string;
+            logoSize?: string;
+            padding?: string;
+        };
+        statusIndicator?: {
+            size?: string;
+            glowIntensity?: number;
+        };
+        modal?: {
+            background?: string;
+            backdrop?: string;
+        };
+        brokerCardModern?: {
+            width?: string;
+            height?: string;
+            padding?: string;
+            logoSize?: string;
+            statusSize?: string;
+        };
+        connectButton?: {
+            width?: string;
+            height?: string;
+        };
+        themeSwitcher?: {
+            indicatorSize?: string;
+        };
+    };
+    effects?: {
+        glassmorphism?: {
+            enabled?: boolean;
+            blur?: string;
+            opacity?: number;
+            border?: string;
+        };
+        animations?: {
+            enabled?: boolean;
+            duration?: {
+                fast?: string;
+                normal?: string;
+                slow?: string;
             };
-            secondary: {
-                background: string;
-                text: string;
-                border: string;
-                hover: string;
-                active: string;
+            easing?: {
+                default?: string;
+                smooth?: string;
+                bounce?: string;
             };
         };
+        shadows?: {
+            sm?: string;
+            md?: string;
+            lg?: string;
+            xl?: string;
+            card?: string;
+            cardHover?: string;
+            glow?: string;
+            focus?: string;
+        };
     };
     branding?: {
+        logo?: string;
+        companyName?: string;
+        favicon?: string;
         primaryColor?: string;
     };
+    glow?: {
+        primary?: string;
+        secondary?: string;
+        card?: string;
+        cardHover?: string;
+        button?: string;
+        focus?: string;
+        scrollbar?: string;
+    };
+    gradients?: {
+        start?: string;
+        end?: string;
+        hoverStart?: string;
+        hoverEnd?: string;
+    };
 }
 export type PortalThemePreset = 'dark' | 'light' | 'corporateBlue' | 'purple' | 'green' | 'orange';
 export interface PortalTheme {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finatic/client",
-  "version": "0.0.136",
+  "version": "0.0.137",
   "description": "Finatic Client SDK for browser integration",
   "type": "module",
   "publishConfig": {