@finatic/client 0.0.142 → 0.9.1

package/package.json

@@ -1,64 +1,108 @@
 {
   "name": "@finatic/client",
-  "version": "0.0.142",
+  "version": "0.9.1",
   "description": "Finatic Client SDK for browser integration",
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "workspaces": [
-    "demo-app"
-  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
-    "src",
-    "dist"
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "rollup -c",
-    "watch": "rollup -c -w",
-    "clean": "rimraf dist",
+    "build:watch": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
     "lint": "eslint src --ext .ts,.tsx",
-    "format": "prettier --write src/**/*.{ts,tsx}"
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.{ts,tsx}",
+    "format:check": "prettier --check src/**/*.ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "watch": "rollup -c -w"
+  },
+  "keywords": [
+    "finatic",
+    "trading",
+    "finance",
+    "api",
+    "sdk",
+    "typescript",
+    "typescript"
+  ],
+  "author": {
+    "name": "Finatic",
+    "email": "support@finatic.dev"
+  },
+  "license": "PROPRIETARY",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FinaticORG/FinaticClientSDK.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
   },
   "dependencies": {
+    "axios": "^1.0.0",
     "crypto-js": "^4.2.0",
-    "uuid": "^9.0.1"
+    "node-cache": "^1.0.0",
+    "p-retry": "^1.0.0",
+    "pino": "^1.0.0",
+    "uuid": "^9.0.1",
+    "zod": "^1.0.0"
   },
   "devDependencies": {
+    "@eslint/js": "^9.35.0",
     "@rollup/plugin-commonjs": "^25.0.7",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-typescript": "^11.1.6",
     "@types/crypto-js": "^4.2.1",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^24.5.0",
+    "@types/node-cache": "^4.2.5",
+    "@types/pino": "^7.0.5",
     "@types/uuid": "^9.0.7",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "eslint": "^8.0.0",
-    "eslint-config-prettier": "^9.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.0.0",
     "eslint-plugin-react": "^7.33.0",
     "eslint-plugin-react-hooks": "^4.6.0",
+    "jest": "^30.1.3",
     "prettier": "^3.0.0",
-    "rimraf": "^5.0.5",
+    "rimraf": "^6.0.1",
     "rollup": "^4.9.1",
     "rollup-plugin-dts": "^6.1.0",
+    "ts-jest": "^29.0.0",
     "tslib": "^2.8.1",
-    "typescript": "^5.3.3"
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.44.0"
   },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "workspaces": [
+    "demo-app"
+  ],
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0"
   },
+  "bugs": {
+    "url": "https://github.com/FinaticORG/FinaticClientSDK/issues"
+  },
+  "homepage": "https://github.com/FinaticORG/FinaticClientSDK#readme",
   "packageManager": "yarn@4.9.4+sha512.7b1cb0b62abba6a537b3a2ce00811a843bea02bcf53138581a6ae5b1bf563f734872bd47de49ce32a9ca9dcaff995aa789577ffb16811da7c603dcf69e73750b"
 }

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

@@ -1,270 +0,0 @@
-import { Order } from '../../types/api/orders';
-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, 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';
-import { ApiError } from '../../utils/errors';
-export declare class ApiClient {
-    private readonly baseUrl;
-    protected readonly deviceInfo?: DeviceInfo;
-    protected currentSessionState: SessionState | null;
-    protected currentSessionId: string | null;
-    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)
-     */
-    setSessionContext(sessionId: string, companyId: string, csrfToken?: string): void;
-    /**
-     * Get the current session ID
-     */
-    getCurrentSessionId(): string | null;
-    /**
-     * Get the current company ID
-     */
-    getCurrentCompanyId(): string | null;
-    /**
-     * Get the current CSRF token
-     */
-    getCurrentCsrfToken(): string | null;
-    /**
-     * Get a valid access token (session-based auth - no tokens needed)
-     */
-    getValidAccessToken(): Promise<string>;
-    /**
-     * Perform the actual Supabase session refresh
-     */
-    /**
-     * Clear session tokens (useful for logout)
-     */
-    clearTokens(): void;
-    /**
-     * Get current session info (for debugging/testing) - session-based auth
-     */
-    getTokenInfo(): {
-        accessToken: string;
-        refreshToken: string;
-        expiresAt: number;
-    } | null;
-    /**
-     * Make a request to the API.
-     */
-    protected request<T>(path: string, options: {
-        method: string;
-        headers?: Record<string, string>;
-        body?: any;
-        params?: Record<string, string>;
-    }): Promise<T>;
-    /**
-     * Handle API errors. This method can be overridden by language-specific implementations.
-     */
-    protected handleError(status: number, error: any): ApiError;
-    startSession(token: string, userId?: string): Promise<SessionResponse>;
-    requestOtp(sessionId: string, email: string): Promise<OtpRequestResponse>;
-    verifyOtp(sessionId: string, otp: string): Promise<OtpVerifyResponse>;
-    authenticateDirectly(sessionId: string, userId: string): Promise<SessionAuthenticateResponse>;
-    /**
-     * Get the portal URL for an active session
-     * @param sessionId The session identifier
-     * @returns Portal URL response
-     * @throws SessionError if session is not in ACTIVE state
-     */
-    getPortalUrl(sessionId: string): Promise<PortalUrlResponse>;
-    completePortalSession(sessionId: string): Promise<PortalUrlResponse>;
-    getOrders(): Promise<{
-        data: Order[];
-    }>;
-    placeBrokerOrder(params: Partial<BrokerOrderParams> & {
-        symbol: string;
-        orderQty: number;
-        action: 'Buy' | 'Sell';
-        orderType: 'Market' | 'Limit' | 'Stop' | 'StopLimit';
-        assetType: 'equity' | 'equity_option' | 'crypto' | 'forex' | 'future' | 'future_option';
-    }, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    cancelBrokerOrder(orderId: string, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', extras?: any, connection_id?: string): Promise<OrderResponse>;
-    modifyBrokerOrder(orderId: string, params: Partial<BrokerOrderParams>, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', extras?: any, connection_id?: string): Promise<OrderResponse>;
-    setBroker(broker: 'robinhood' | 'tasty_trade' | 'ninja_trader'): void;
-    setAccount(accountNumber: string, accountId?: string): void;
-    placeStockMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    placeStockLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    placeStockStopOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', stopPrice: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    placeCryptoMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeCryptoLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeOptionsMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options: OptionsOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    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>;
-    private buildOrderRequestBody;
-    private buildModifyRequestBody;
-    private applyBrokerDefaults;
-    getUserToken(sessionId: string): Promise<UserToken>;
-    /**
-     * Get the current session state
-     */
-    getCurrentSessionState(): SessionState | null;
-    /**
-     * Refresh the current session to extend its lifetime
-     * Note: This now uses Supabase session refresh instead of custom endpoint
-     */
-    refreshSession(): Promise<{
-        success: boolean;
-        response_data: {
-            session_id: string;
-            company_id: string;
-            status: string;
-            expires_at: string;
-            user_id: string;
-            auto_login: boolean;
-        };
-        message: string;
-        status_code: number;
-    }>;
-    getBrokerList(): Promise<{
-        _id: string;
-        response_data: BrokerInfo[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    getBrokerAccounts(options?: BrokerDataOptions): Promise<{
-        _id: string;
-        response_data: BrokerAccount[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    getBrokerOrders(options?: BrokerDataOptions): Promise<{
-        _id: string;
-        response_data: BrokerOrder[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    getBrokerPositions(options?: BrokerDataOptions): Promise<{
-        _id: string;
-        response_data: BrokerPosition[];
-        message: string;
-        status_code: number;
-        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[];
-        message: string;
-        status_code: number;
-        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
-     * @returns false for real API client
-     */
-    isMockClient(): boolean;
-    /**
-     * Disconnect a company from a broker connection
-     * @param connectionId - The connection ID to disconnect
-     * @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;
-    }>;
-}