@finatic/client 0.0.140 → 0.0.142

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

@@ -3,7 +3,7 @@ import { BrokerInfo, BrokerAccount, BrokerOrder, BrokerPosition, BrokerBalance,
 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, BalancesFilter } from '../../types/api/broker';
+import { OrdersFilter, PositionsFilter, AccountsFilter, BalancesFilter, OrderFill, OrderEvent, OrderGroup, PositionLot, PositionLotFill, OrderFillsFilter, OrderEventsFilter, OrderGroupsFilter, PositionLotsFilter, PositionLotFillsFilter } from '../../types/api/broker';
 import { PaginatedResult } from '../../types/common/pagination';
 import { PortalUrlResponse } from '../../types/api/core';
 import { DeviceInfo, SessionState, SessionResponse, OtpRequestResponse, OtpVerifyResponse, SessionAuthenticateResponse, UserToken } from '../../types/api/auth';
@@ -16,6 +16,8 @@ export declare class ApiClient {
     private tradingContext;
     private companyId;
     private csrfToken;
+    private readonly logger;
+    private buildLoggerExtra;
     constructor(baseUrl: string, deviceInfo?: DeviceInfo);
     /**
      * Set session context (session ID, company ID, CSRF token)
@@ -197,4 +199,72 @@ export declare class ApiClient {
      * @returns Promise with disconnect response
      */
     disconnectCompany(connectionId: string): Promise<DisconnectCompanyResponse>;
+    /**
+     * Get order fills for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order fills response
+     */
+    getOrderFills(orderId: string, filter?: OrderFillsFilter): Promise<{
+        _id: string;
+        response_data: OrderFill[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get order events for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order events response
+     */
+    getOrderEvents(orderId: string, filter?: OrderEventsFilter): Promise<{
+        _id: string;
+        response_data: OrderEvent[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get order groups
+     * @param filter - Optional filter parameters
+     * @returns Promise with order groups response
+     */
+    getOrderGroups(filter?: OrderGroupsFilter): Promise<{
+        _id: string;
+        response_data: OrderGroup[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get position lots (tax lots for positions)
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lots response
+     */
+    getPositionLots(filter?: PositionLotsFilter): Promise<{
+        _id: string;
+        response_data: PositionLot[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get position lot fills for a specific lot
+     * @param lotId - The position lot ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lot fills response
+     */
+    getPositionLotFills(lotId: string, filter?: PositionLotFillsFilter): Promise<{
+        _id: string;
+        response_data: PositionLotFill[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
 }

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

@@ -27,6 +27,8 @@ export 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;
     /**
@@ -293,5 +295,38 @@ export declare class FinaticConnect extends EventEmitter {
      * @throws AuthenticationError if user is not authenticated
      */
     disconnectCompany(connectionId: string): Promise<DisconnectCompanyResponse>;
+    /**
+     * Get order fills for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order fills response
+     */
+    getOrderFills(orderId: string, filter?: import('../../types/api/broker').OrderFillsFilter): Promise<import('../../types/api/broker').OrderFill[]>;
+    /**
+     * Get order events for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order events response
+     */
+    getOrderEvents(orderId: string, filter?: import('../../types/api/broker').OrderEventsFilter): Promise<import('../../types/api/broker').OrderEvent[]>;
+    /**
+     * Get order groups
+     * @param filter - Optional filter parameters
+     * @returns Promise with order groups response
+     */
+    getOrderGroups(filter?: import('../../types/api/broker').OrderGroupsFilter): Promise<import('../../types/api/broker').OrderGroup[]>;
+    /**
+     * Get position lots (tax lots for positions)
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lots response
+     */
+    getPositionLots(filter?: import('../../types/api/broker').PositionLotsFilter): Promise<import('../../types/api/broker').PositionLot[]>;
+    /**
+     * Get position lot fills for a specific lot
+     * @param lotId - The position lot ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lot fills response
+     */
+    getPositionLotFills(lotId: string, filter?: import('../../types/api/broker').PositionLotFillsFilter): Promise<import('../../types/api/broker').PositionLotFill[]>;
 }
 export {};

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

@@ -6,7 +6,9 @@ export declare class PortalUI {
     private portalOrigin;
     private options?;
     private originalBodyStyle;
+    private readonly logger;
     constructor(portalUrl: string);
+    private buildLoggerExtra;
     private createContainer;
     /**
      * Lock background scrolling by setting overflow: hidden on body

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export type { ApiConfig, ApiResponse, Order, OptionsOrder, BrokerAccount, PortfolioSnapshot, PerformanceMetrics, UserToken, Holding, Portfolio, PortalResponse, SessionInitResponse, 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 { ApiConfig, ApiResponse, Order, OptionsOrder, BrokerAccount, PortfolioSnapshot, PerformanceMetrics, UserToken, Holding, Portfolio, PortalResponse, SessionInitResponse, 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, OrderFill, OrderEvent, OrderLeg, OrderGroup, OrderGroupOrder, PositionLot, PositionLotFill, OrderFillsFilter, OrderEventsFilter, OrderGroupsFilter, PositionLotsFilter, PositionLotFillsFilter, } 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';
@@ -8,4 +8,5 @@ export { PaginatedResult } from './types/common/pagination';
 export * from './utils/errors';
 export * from './utils/events';
 export * from './utils/themeUtils';
+export * from './lib/logger';
 export { portalThemePresets } from './themes/portalPresets';

package/dist/types/lib/logger/index.d.ts

@@ -0,0 +1,2 @@
+export * from './logger';
+export * from './logger.types';

package/dist/types/lib/logger/logger.d.ts

@@ -0,0 +1,4 @@
+import { Logger, LoggerExtra, LoggerMetadata, LoggerOptions, LogLevel } from './logger.types';
+export declare const setupLogger: (nameOrOptions: string | LoggerOptions, level?: LogLevel, defaultMetadata?: LoggerMetadata) => Logger;
+export declare const buildLoggerExtra: (metadata: LoggerMetadata) => LoggerExtra;
+export declare const logStartEnd: (logger: Logger) => <Args extends unknown[], ReturnType>(fn: (...args: Args) => ReturnType | Promise<ReturnType>) => (...args: Args) => Promise<ReturnType>;

package/dist/types/lib/logger/logger.types.d.ts

@@ -0,0 +1,28 @@
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+export interface LoggerMetadata {
+    [key: string]: unknown;
+}
+export interface LoggerExtra {
+    metadata?: LoggerMetadata;
+    module?: string;
+    function?: string;
+    event?: string;
+    duration_ms?: number;
+    error?: unknown;
+    [key: string]: unknown;
+}
+export interface LoggerOptions {
+    name: string;
+    level?: LogLevel;
+    defaultMetadata?: LoggerMetadata;
+}
+export 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;
+}
+export type LogVerbosity = 0 | 1 | 2 | 3;

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

@@ -19,6 +19,8 @@ export declare class MockApiClient {
     private csrfToken;
     private mockDataProvider;
     private readonly mockApiOnly;
+    private readonly logger;
+    private buildLoggerExtra;
     constructor(baseUrl: string, deviceInfo?: DeviceInfo, mockConfig?: MockConfig);
     /**
      * Store tokens after successful authentication

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

@@ -303,3 +303,119 @@ export interface DisconnectCompanyResponse {
     message: string;
     status_code: number;
 }
+export interface OrderFill {
+    id: string;
+    order_id: string;
+    leg_id: string | null;
+    price: number;
+    quantity: number;
+    executed_at: string;
+    execution_id: string | null;
+    trade_id: string | null;
+    venue: string | null;
+    commission_fee: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface OrderEvent {
+    id: string;
+    order_id: string;
+    order_group_id: string | null;
+    event_type: string | null;
+    event_time: string;
+    event_id: string | null;
+    order_status: string | null;
+    inferred: boolean;
+    confidence: number | null;
+    reason_code: string | null;
+    recorded_at: string | null;
+}
+export interface OrderLeg {
+    id: string;
+    order_id: string;
+    leg_index: number;
+    asset_type: string;
+    broker_provided_symbol: string | null;
+    quantity: number;
+    filled_quantity: number | null;
+    avg_fill_price: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+export interface OrderGroupOrder extends BrokerDataOrder {
+    legs: OrderLeg[];
+}
+export interface OrderGroup {
+    id: string;
+    user_broker_connection_id: string | null;
+    created_at: string;
+    updated_at: string;
+    orders: OrderGroupOrder[];
+}
+export interface PositionLot {
+    id: string;
+    position_id: string | null;
+    user_broker_connection_id: string;
+    broker_provided_account_id: string;
+    instrument_key: string;
+    asset_type: string | null;
+    side: 'long' | 'short' | null;
+    open_quantity: number;
+    closed_quantity: number;
+    remaining_quantity: number;
+    open_price: number;
+    close_price_avg: number | null;
+    cost_basis: number;
+    cost_basis_w_commission: number;
+    realized_pl: number;
+    realized_pl_w_commission: number;
+    lot_opened_at: string;
+    lot_closed_at: string | null;
+    position_group_id: string | null;
+    created_at: string;
+    updated_at: string;
+    position_lot_fills?: PositionLotFill[];
+}
+export interface PositionLotFill {
+    id: string;
+    lot_id: string;
+    order_fill_id: string;
+    fill_price: number;
+    fill_quantity: number;
+    executed_at: string;
+    commission_share: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface OrderFillsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface OrderEventsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface OrderGroupsFilter {
+    broker_id?: string;
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+    created_after?: string;
+    created_before?: string;
+}
+export interface PositionLotsFilter {
+    broker_id?: string;
+    connection_id?: string;
+    account_id?: string;
+    symbol?: string;
+    position_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface PositionLotFillsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}

package/package.json

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