@finatic/client 0.0.131

package/dist/types/types/shared.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Shared types for Finatic Connect SDK
+ */
+export interface Holding {
+    symbol: string;
+    quantity: number;
+    averagePrice: number;
+    currentPrice: number;
+    marketValue: number;
+    unrealizedPnL: number;
+    realizedPnL: number;
+    costBasis: number;
+    currency: string;
+}
+export interface Order {
+    symbol: string;
+    quantity: number;
+    side: 'buy' | 'sell';
+    type_: 'market' | 'limit' | 'stop' | 'stop_limit';
+    timeInForce: 'day' | 'gtc' | 'opg' | 'cls' | 'ioc' | 'fok';
+    price?: number;
+    stopPrice?: number;
+}
+export interface Portfolio {
+    id: string;
+    name: string;
+    type: string;
+    status: string;
+    cash: number;
+    buyingPower: number;
+    equity: number;
+    longMarketValue: number;
+    shortMarketValue: number;
+    initialMargin: number;
+    maintenanceMargin: number;
+    lastEquity: number;
+    positions: Holding[];
+    performance: PerformanceMetrics;
+}
+export interface PerformanceMetrics {
+    totalReturn: number;
+    dailyReturn: number;
+    weeklyReturn: number;
+    monthlyReturn: number;
+    yearlyReturn: number;
+    maxDrawdown: number;
+    sharpeRatio: number;
+    beta: number;
+    alpha: number;
+}

package/dist/types/types/theme.d.ts

@@ -0,0 +1,101 @@
+export interface Theme {
+    mode: 'light' | 'dark';
+    primaryColor: string;
+    colors: {
+        primary: string;
+        secondary: string;
+        background: {
+            primary: string;
+            secondary: string;
+            tertiary: string;
+        };
+        text: {
+            primary: string;
+            secondary: string;
+            disabled: string;
+            error: string;
+            success: string;
+            warning: string;
+        };
+        border: {
+            light: string;
+            medium: string;
+            dark: string;
+        };
+        status: {
+            active: string;
+            inactive: string;
+            pending: string;
+            error: string;
+            success: string;
+        };
+    };
+    typography: {
+        fontFamily: string;
+        fontSize: {
+            xs: string;
+            sm: string;
+            base: string;
+            lg: string;
+            xl: string;
+            '2xl': string;
+        };
+        fontWeight: {
+            light: number;
+            normal: number;
+            medium: number;
+            semibold: number;
+            bold: number;
+        };
+        lineHeight: {
+            none: number;
+            tight: number;
+            normal: number;
+            relaxed: number;
+        };
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
+    };
+    animation: {
+        duration: {
+            fast: string;
+            normal: string;
+            slow: string;
+        };
+        easing: {
+            linear: string;
+            easeIn: string;
+            easeOut: string;
+            easeInOut: string;
+        };
+    };
+    components: {
+        button: {
+            borderRadius: string;
+            padding: string;
+            fontSize: string;
+            fontWeight: number;
+        };
+        input: {
+            borderRadius: string;
+            padding: string;
+            fontSize: string;
+        };
+        card: {
+            borderRadius: string;
+            padding: string;
+            shadow: string;
+        };
+        modal: {
+            borderRadius: string;
+            padding: string;
+            backdrop: string;
+        };
+    };
+}

package/dist/types/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Core types for Finatic Connect SDK
+ */
+export interface Balance {
+    cash: number;
+    buyingPower: number;
+    equity: number;
+    longMarketValue: number;
+    shortMarketValue: number;
+    initialMargin: number;
+    maintenanceMargin: number;
+    lastEquity: number;
+}
+export interface Account {
+    id: string;
+    name: string;
+    type_: string;
+    status: string;
+    balance: Balance | null;
+}
+export interface Holding {
+    symbol: string;
+    quantity: number;
+    averagePrice: number;
+    currentPrice: number;
+    marketValue: number;
+    unrealizedPnl: number;
+}
+export interface Order {
+    symbol: string;
+    quantity: number;
+    side: 'buy' | 'sell';
+    type_: 'market' | 'limit' | 'stop' | 'stop_limit';
+    timeInForce: 'day' | 'gtc' | 'opg' | 'cls' | 'ioc' | 'fok';
+    price?: number;
+    stopPrice?: number;
+}
+export interface Portfolio {
+    totalValue: number;
+    cash: number;
+    equity: number;
+    positions: Holding[];
+}
+export interface Performance {
+    totalReturn: number;
+    dailyReturn: number;
+    weeklyReturn: number;
+    monthlyReturn: number;
+    yearlyReturn: number;
+    maxDrawdown: number;
+    sharpeRatio: number;
+    beta: number;
+    alpha: number;
+}
+export interface Event {
+    id: string;
+    type_: string;
+    timestamp: string;
+    data: string;
+}
+export interface AnalyticsRequest {
+    startDate: string;
+    endDate: string;
+    metrics: string[];
+    groupBy?: string;
+}
+export interface AnalyticsResponse {
+    data: Record<string, any>;
+    metadata: {
+        startDate: string;
+        endDate: string;
+        metrics: string[];
+        groupBy?: string;
+    };
+}
+export interface ErrorResponse {
+    code: string;
+    message: string;
+    details?: Record<string, any>;
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    metadata: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+export interface ApiPaginationInfo {
+    has_more: boolean;
+    next_offset: number;
+    current_offset: number;
+    limit: number;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    response_data: T;
+    message: string;
+    status_code: number;
+    pagination?: ApiPaginationInfo;
+}
+export interface PaginationMetadata {
+    hasMore: boolean;
+    nextOffset: number;
+    currentOffset: number;
+    limit: number;
+    currentPage: number;
+    hasNext: boolean;
+    hasPrevious: boolean;
+}
+export declare class PaginatedResult<T> {
+    readonly data: T;
+    readonly metadata: PaginationMetadata;
+    private navigationCallback?;
+    constructor(data: T, paginationInfo: ApiPaginationInfo, navigationCallback?: (offset: number, limit: number) => Promise<PaginatedResult<T>>);
+    get hasNext(): boolean;
+    get hasPrevious(): boolean;
+    get currentPage(): number;
+    /**
+     * Navigate to the next page
+     * @returns Promise<PaginatedResult<T> | null> - Next page result or null if no next page
+     */
+    nextPage(): Promise<PaginatedResult<T> | null>;
+    /**
+     * Navigate to the previous page
+     * @returns Promise<PaginatedResult<T> | null> - Previous page result or null if no previous page
+     */
+    previousPage(): Promise<PaginatedResult<T> | null>;
+    /**
+     * Navigate to a specific page
+     * @param pageNumber - The page number to navigate to (1-based)
+     * @returns Promise<PaginatedResult<T> | null> - Page result or null if page doesn't exist
+     */
+    goToPage(pageNumber: number): Promise<PaginatedResult<T> | null>;
+    /**
+     * Get the first page
+     * @returns Promise<PaginatedResult<T> | null> - First page result or null if error
+     */
+    firstPage(): Promise<PaginatedResult<T> | null>;
+    /**
+     * Get the last page (this is a best effort - we don't know the total count)
+     * @returns Promise<PaginatedResult<T> | null> - Last page result or null if error
+     */
+    lastPage(): Promise<PaginatedResult<T> | null>;
+    /**
+     * Get pagination info as a string
+     * @returns string - Human readable pagination info
+     */
+    getPaginationInfo(): string;
+}

package/dist/types/utils/errors.d.ts

@@ -0,0 +1,42 @@
+export declare class BaseError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export declare class ApiError extends BaseError {
+    readonly status: number;
+    readonly details?: Record<string, any> | undefined;
+    constructor(status: number, message: string, details?: Record<string, any> | undefined);
+}
+export declare class SessionError extends ApiError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class AuthenticationError extends ApiError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class AuthorizationError extends ApiError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class RateLimitError extends ApiError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class TokenError extends BaseError {
+    constructor(message: string);
+}
+export declare class ValidationError extends BaseError {
+    constructor(message: string);
+}
+export declare class NetworkError extends BaseError {
+    constructor(message: string);
+}
+export declare class SecurityError extends BaseError {
+    constructor(message: string);
+}
+export declare class CompanyAccessError extends ApiError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class OrderError extends ApiError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class OrderValidationError extends ApiError {
+    constructor(message: string, details?: Record<string, any>);
+}

package/dist/types/utils/events.d.ts

@@ -0,0 +1,12 @@
+type EventCallback = (...args: any[]) => void;
+export declare class EventEmitter {
+    private events;
+    on(event: string, callback: EventCallback): void;
+    off(event: string, callback: EventCallback): void;
+    once(event: string, callback: EventCallback): void;
+    emit(event: string, ...args: any[]): void;
+    removeAllListeners(event?: string): void;
+    listenerCount(event: string): number;
+    listeners(event: string): EventCallback[];
+}
+export {};

package/dist/types/utils/themeUtils.d.ts

@@ -0,0 +1,34 @@
+import { PortalTheme, PortalThemeConfig } from '../types/portal';
+/**
+ * Generate a portal URL with theme parameters
+ * @param baseUrl The base portal URL
+ * @param theme The theme configuration
+ * @returns The portal URL with theme parameters
+ */
+export declare function generatePortalThemeURL(baseUrl: string, theme?: PortalTheme): string;
+/**
+ * Generate a portal URL with theme parameters, appending to existing query params
+ * @param baseUrl The base portal URL (may already have query parameters)
+ * @param theme The theme configuration
+ * @returns The portal URL with theme parameters appended
+ */
+export declare function appendThemeToURL(baseUrl: string, theme?: PortalTheme): string;
+/**
+ * Get a theme configuration by preset name
+ * @param preset The preset theme name
+ * @returns The theme configuration or undefined if not found
+ */
+export declare function getThemePreset(preset: string): PortalThemeConfig | undefined;
+/**
+ * Validate a custom theme configuration
+ * @param theme The theme configuration to validate
+ * @returns True if valid, false otherwise
+ */
+export declare function validateCustomTheme(theme: PortalThemeConfig): boolean;
+/**
+ * Create a custom theme from a preset with modifications
+ * @param preset The base preset theme
+ * @param modifications Partial theme modifications
+ * @returns The modified theme configuration
+ */
+export declare function createCustomThemeFromPreset(preset: string, modifications: Partial<PortalThemeConfig>): PortalThemeConfig | null;

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@finatic/client",
+  "version": "0.0.131",
+  "description": "Finatic Client SDK for browser integration",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "clean": "rimraf dist",
+    "lint": "eslint src --ext .ts,.tsx",
+    "format": "prettier --write src/**/*.{ts,tsx}"
+  },
+  "dependencies": {
+    "crypto-js": "^4.2.0",
+    "uuid": "^9.0.1"
+  },
+  "devDependencies": {
+    "@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/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",
+    "eslint-plugin-react": "^7.33.0",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "prettier": "^3.0.0",
+    "rimraf": "^5.0.5",
+    "rollup": "^4.9.1",
+    "rollup-plugin-dts": "^6.1.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  }
+}