@finatic/client 0.0.141 → 0.0.142

package/dist/index.d.ts

@@ -1127,6 +1127,8 @@ declare class ApiClient {
     private tradingContext;
     private companyId;
     private csrfToken;
+    private readonly logger;
+    private buildLoggerExtra;
     constructor(baseUrl: string, deviceInfo?: DeviceInfo$1);
     /**
      * Set session context (session ID, company ID, CSRF token)
@@ -1414,6 +1416,8 @@ declare class FinaticConnect extends EventEmitter {
     private readonly SESSION_VALIDATION_TIMEOUT;
     private readonly SESSION_REFRESH_BUFFER_HOURS;
     private sessionStartTime;
+    private readonly logger;
+    private buildLoggerExtra;
     constructor(options: FinaticConnectOptions, deviceInfo?: DeviceInfo);
     private linkUserToSession;
     /**
@@ -1749,7 +1753,40 @@ declare function validateCustomTheme(theme: PortalThemeConfig): boolean;
  */
 declare function createCustomThemeFromPreset(preset: string, modifications: Partial<PortalThemeConfig>): PortalThemeConfig | null;
 
+type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+interface LoggerMetadata {
+    [key: string]: unknown;
+}
+interface LoggerExtra {
+    metadata?: LoggerMetadata;
+    module?: string;
+    function?: string;
+    event?: string;
+    duration_ms?: number;
+    error?: unknown;
+    [key: string]: unknown;
+}
+interface LoggerOptions {
+    name: string;
+    level?: LogLevel;
+    defaultMetadata?: LoggerMetadata;
+}
+interface Logger {
+    getLevel: () => LogLevel;
+    setLevel: (level: LogLevel) => void;
+    debug: (message: string, extra?: LoggerExtra) => void;
+    info: (message: string, extra?: LoggerExtra) => void;
+    warn: (message: string, extra?: LoggerExtra) => void;
+    error: (message: string, extra?: LoggerExtra) => void;
+    exception: (message: string, error: unknown, extra?: LoggerExtra) => void;
+}
+type LogVerbosity = 0 | 1 | 2 | 3;
+
+declare const setupLogger: (nameOrOptions: string | LoggerOptions, level?: LogLevel, defaultMetadata?: LoggerMetadata) => Logger;
+declare const buildLoggerExtra: (metadata: LoggerMetadata) => LoggerExtra;
+declare const logStartEnd: (logger: Logger) => <Args extends unknown[], ReturnType>(fn: (...args: Args) => ReturnType | Promise<ReturnType>) => (...args: Args) => Promise<ReturnType>;
+
 declare const portalThemePresets: Record<string, PortalThemeConfig>;
 
-export { ApiClient, ApiError, AuthenticationError, AuthorizationError, BaseError, CompanyAccessError, EventEmitter, FinaticConnect, NetworkError, OrderError, OrderValidationError, PaginatedResult, RateLimitError, SecurityError, SessionError, TokenError, TradingNotEnabledError, appendThemeToURL, createCustomThemeFromPreset, generatePortalThemeURL, getThemePreset, portalThemePresets, validateCustomTheme };
-export type { AccountsFilter, ApiConfig, ApiResponse, BalancesFilter, BrokerAccount, BrokerBalance, BrokerConnection, BrokerDataAccount, BrokerDataOptions, BrokerDataOrder, BrokerDataPosition, BrokerExtras$1 as BrokerExtras, BrokerInfo, BrokerOrder, BrokerOrderParams, BrokerPosition, CryptoOrderOptions, DeviceInfo$1 as DeviceInfo, FilteredAccountsResponse, FilteredBalancesResponse, FilteredOrdersResponse, FilteredPositionsResponse, FinaticConnectOptions, FinaticUserToken, Holding, OptionsOrder, OptionsOrderOptions, Order, OrderEvent, OrderEventsFilter, OrderFill, OrderFillsFilter, OrderGroup, OrderGroupOrder, OrderGroupsFilter, OrderLeg, OrderNotFoundError, OrderResponse, OrdersFilter, OtpRequestResponse, OtpVerifyResponse, PerformanceMetrics, PortalMessage, PortalProps, PortalResponse, PortalTheme, PortalThemeConfig, PortalThemePreset, PortalUrlResponse, Portfolio, PortfolioSnapshot, PositionLot, PositionLotFill, PositionLotFillsFilter, PositionLotsFilter, PositionsFilter, RefreshTokenRequest, RefreshTokenResponse, RequestHeaders, SessionAuthenticateResponse, SessionInitResponse, SessionResponse, SessionStatus, SessionValidationResponse, TokenInfo, TradeAccessDeniedError, TradingContext, UserToken, ValidationError };
+export { ApiClient, ApiError, AuthenticationError, AuthorizationError, BaseError, CompanyAccessError, EventEmitter, FinaticConnect, NetworkError, OrderError, OrderValidationError, PaginatedResult, RateLimitError, SecurityError, SessionError, TokenError, TradingNotEnabledError, appendThemeToURL, buildLoggerExtra, createCustomThemeFromPreset, generatePortalThemeURL, getThemePreset, logStartEnd, portalThemePresets, setupLogger, validateCustomTheme };
+export type { AccountsFilter, ApiConfig, ApiResponse, BalancesFilter, BrokerAccount, BrokerBalance, BrokerConnection, BrokerDataAccount, BrokerDataOptions, BrokerDataOrder, BrokerDataPosition, BrokerExtras$1 as BrokerExtras, BrokerInfo, BrokerOrder, BrokerOrderParams, BrokerPosition, CryptoOrderOptions, DeviceInfo$1 as DeviceInfo, FilteredAccountsResponse, FilteredBalancesResponse, FilteredOrdersResponse, FilteredPositionsResponse, FinaticConnectOptions, FinaticUserToken, Holding, LogLevel, LogVerbosity, Logger, LoggerExtra, LoggerMetadata, LoggerOptions, OptionsOrder, OptionsOrderOptions, Order, OrderEvent, OrderEventsFilter, OrderFill, OrderFillsFilter, OrderGroup, OrderGroupOrder, OrderGroupsFilter, OrderLeg, OrderNotFoundError, OrderResponse, OrdersFilter, OtpRequestResponse, OtpVerifyResponse, PerformanceMetrics, PortalMessage, PortalProps, PortalResponse, PortalTheme, PortalThemeConfig, PortalThemePreset, PortalUrlResponse, Portfolio, PortfolioSnapshot, PositionLot, PositionLotFill, PositionLotFillsFilter, PositionLotsFilter, PositionsFilter, RefreshTokenRequest, RefreshTokenResponse, RequestHeaders, SessionAuthenticateResponse, SessionInitResponse, SessionResponse, SessionStatus, SessionValidationResponse, TokenInfo, TradeAccessDeniedError, TradingContext, UserToken, ValidationError };