@finatic/client 0.9.0 → 0.9.2

package/src/utils/brokerUtils.ts

@@ -1,104 +0,0 @@
-/**
- * Broker filtering utility functions
- */
-
-import { setupLogger, buildLoggerExtra, LoggerExtra } from '../lib/logger';
-
-const brokerLogger = setupLogger('FinaticClientSDK.BrokerUtils', undefined, {
-  codebase: 'FinaticClientSDK',
-});
-
-const buildBrokerExtra = (functionName: string, metadata?: Record<string, unknown>): LoggerExtra => ({
-  module: 'BrokerUtils',
-  function: functionName,
-  ...(metadata ? buildLoggerExtra(metadata) : {}),
-});
-
-// Supported broker names and their corresponding IDs (including aliases)
-const SUPPORTED_BROKERS: Record<string, string> = {
-  'alpaca': 'alpaca',
-  'robinhood': 'robinhood',
-  'tasty_trade': 'tasty_trade',
-  'ninja_trader': 'ninja_trader',
-  'tradovate': 'tradovate', // Alias for ninja_trader
-  'interactive_brokers': 'interactive_brokers',
-};
-
-/**
- * Convert broker names to broker IDs, filtering out unsupported ones
- * @param brokerNames Array of broker names to convert
- * @returns Object containing valid broker IDs and any warnings about unsupported names
- */
-export function convertBrokerNamesToIds(brokerNames: string[]): {
-  brokerIds: string[];
-  warnings: string[];
-} {
-  const brokerIds: string[] = [];
-  const warnings: string[] = [];
-
-  for (const brokerName of brokerNames) {
-    const brokerId = SUPPORTED_BROKERS[brokerName.toLowerCase()];
-    if (brokerId) {
-      brokerIds.push(brokerId);
-    } else {
-      warnings.push(`Broker name '${brokerName}' is not supported. Supported brokers: ${Object.keys(SUPPORTED_BROKERS).join(', ')}`);
-    }
-  }
-
-  return { brokerIds, warnings };
-}
-
-/**
- * Append broker filter parameters to a portal URL
- * @param baseUrl The base portal URL (may already have query parameters)
- * @param brokerNames Array of broker names to filter by
- * @returns The portal URL with broker filter parameters appended
- */
-export function appendBrokerFilterToURL(baseUrl: string, brokerNames?: string[]): string {
-  if (!brokerNames || brokerNames.length === 0) {
-    return baseUrl;
-  }
-
-  try {
-    const url = new URL(baseUrl);
-    const { brokerIds, warnings } = convertBrokerNamesToIds(brokerNames);
-
-    // Log warnings for unsupported broker names
-    warnings.forEach(warning =>
-      brokerLogger.warn('Unsupported broker name provided', buildBrokerExtra('appendBrokerFilterToURL', {
-        warning,
-      })),
-    );
-
-    // Only add broker filter if we have valid broker IDs
-    if (brokerIds.length > 0) {
-      const encodedBrokers = btoa(JSON.stringify(brokerIds));
-      url.searchParams.set('brokers', encodedBrokers);
-    }
-
-    return url.toString();
-  } catch (error) {
-    brokerLogger.exception('Failed to append broker filter to URL', error, buildBrokerExtra('appendBrokerFilterToURL', {
-      base_url: baseUrl,
-      brokers_count: brokerNames?.length ?? 0,
-    }));
-    return baseUrl;
-  }
-}
-
-/**
- * Get list of supported broker names
- * @returns Array of supported broker names
- */
-export function getSupportedBrokerNames(): string[] {
-  return Object.keys(SUPPORTED_BROKERS);
-}
-
-/**
- * Check if a broker name is supported
- * @param brokerName The broker name to check
- * @returns True if the broker is supported, false otherwise
- */
-export function isBrokerSupported(brokerName: string): boolean {
-  return brokerName.toLowerCase() in SUPPORTED_BROKERS;
-}

package/src/utils/errors.ts

@@ -1,104 +0,0 @@
-export class BaseError extends Error {
-  constructor(
-    message: string,
-    public readonly code: string = 'UNKNOWN_ERROR'
-  ) {
-    super(message);
-    this.name = this.constructor.name;
-  }
-}
-
-export class ApiError extends BaseError {
-  constructor(
-    public readonly status: number,
-    message: string,
-    public readonly details?: Record<string, any>
-  ) {
-    super(message, `API_ERROR_${status}`);
-    this.name = 'ApiError';
-  }
-}
-
-export class SessionError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(400, message, details);
-    this.name = 'SessionError';
-  }
-}
-
-export class AuthenticationError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(401, message, details);
-    this.name = 'AuthenticationError';
-  }
-}
-
-export class AuthorizationError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(403, message, details);
-    this.name = 'AuthorizationError';
-  }
-}
-
-export class RateLimitError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(429, message, details);
-    this.name = 'RateLimitError';
-  }
-}
-
-export class TokenError extends BaseError {
-  constructor(message: string) {
-    super(message, 'TOKEN_ERROR');
-    this.name = 'TokenError';
-  }
-}
-
-export class ValidationError extends BaseError {
-  constructor(message: string) {
-    super(message, 'VALIDATION_ERROR');
-    this.name = 'ValidationError';
-  }
-}
-
-export class NetworkError extends BaseError {
-  constructor(message: string) {
-    super(message, 'NETWORK_ERROR');
-    this.name = 'NetworkError';
-  }
-}
-
-export class SecurityError extends BaseError {
-  constructor(message: string) {
-    super(message, 'SECURITY_ERROR');
-    this.name = 'SecurityError';
-  }
-}
-
-export class CompanyAccessError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(403, message, details);
-    this.name = 'CompanyAccessError';
-  }
-}
-
-export class OrderError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(500, message, details);
-    this.name = 'OrderError';
-  }
-}
-
-export class OrderValidationError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(400, message, details);
-    this.name = 'OrderValidationError';
-  }
-}
-
-export class TradingNotEnabledError extends ApiError {
-  constructor(message: string, details?: Record<string, any>) {
-    super(403, message, details);
-    this.name = 'TradingNotEnabledError';
-  }
-}

package/src/utils/events.ts

@@ -1,66 +0,0 @@
-import { setupLogger, buildLoggerExtra } from '../lib/logger';
-
-type EventCallback = (...args: any[]) => void;
-
-const eventsLogger = setupLogger('FinaticClientSDK.Events', undefined, {
-  codebase: 'FinaticClientSDK',
-});
-
-export class EventEmitter {
-  private events: Map<string, Set<EventCallback>> = new Map();
-
-  public on(event: string, callback: EventCallback): void {
-    if (!this.events.has(event)) {
-      this.events.set(event, new Set());
-    }
-    this.events.get(event)!.add(callback);
-  }
-
-  public off(event: string, callback: EventCallback): void {
-    if (this.events.has(event)) {
-      this.events.get(event)!.delete(callback);
-    }
-  }
-
-  public once(event: string, callback: EventCallback): void {
-    const onceCallback = (...args: any[]) => {
-      callback(...args);
-      this.off(event, onceCallback);
-    };
-    this.on(event, onceCallback);
-  }
-
-  public emit(event: string, ...args: any[]): void {
-    if (this.events.has(event)) {
-      this.events.get(event)!.forEach(callback => {
-        try {
-          callback(...args);
-        } catch (error) {
-          eventsLogger.exception('Error in event handler', error, {
-            module: 'EventEmitter',
-            function: 'emit',
-            ...buildLoggerExtra({
-              event_name: event,
-            }),
-          });
-        }
-      });
-    }
-  }
-
-  public removeAllListeners(event?: string): void {
-    if (event) {
-      this.events.delete(event);
-    } else {
-      this.events.clear();
-    }
-  }
-
-  public listenerCount(event: string): number {
-    return this.events.get(event)?.size || 0;
-  }
-
-  public listeners(event: string): EventCallback[] {
-    return Array.from(this.events.get(event) || []);
-  }
-}

package/src/utils/themeUtils.ts

@@ -1,165 +0,0 @@
-import { PortalTheme, PortalThemeConfig } from '../types/portal';
-import { portalThemePresets } from '../themes/portalPresets';
-import { setupLogger, buildLoggerExtra, LoggerExtra } from '../lib/logger';
-
-const themeLogger = setupLogger('FinaticClientSDK.ThemeUtils', undefined, {
-  codebase: 'FinaticClientSDK',
-});
-
-const buildThemeExtra = (functionName: string, metadata?: Record<string, unknown>): LoggerExtra => ({
-  module: 'ThemeUtils',
-  function: functionName,
-  ...(metadata ? buildLoggerExtra(metadata) : {}),
-});
-
-/**
- * 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 function generatePortalThemeURL(baseUrl: string, theme?: PortalTheme): string {
-  if (!theme) {
-    return baseUrl;
-  }
-
-  try {
-    const url = new URL(baseUrl);
-
-    if (theme.preset) {
-      // Use preset theme
-      url.searchParams.set('theme', theme.preset);
-    } else if (theme.custom) {
-      // Use custom theme
-      const encodedTheme = btoa(JSON.stringify(theme.custom));
-      url.searchParams.set('theme', 'custom');
-      url.searchParams.set('themeObject', encodedTheme);
-    }
-
-    return url.toString();
-  } catch (error) {
-    themeLogger.exception('Failed to generate theme URL', error, buildThemeExtra('generatePortalThemeURL', {
-      base_url: baseUrl,
-      has_theme: Boolean(theme),
-    }));
-    return baseUrl;
-  }
-}
-
-/**
- * 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 function appendThemeToURL(baseUrl: string, theme?: PortalTheme): string {
-  if (!theme) {
-    return baseUrl;
-  }
-
-  try {
-    const url = new URL(baseUrl);
-
-    if (theme.preset) {
-      // Use preset theme
-      url.searchParams.set('theme', theme.preset);
-    } else if (theme.custom) {
-      // Use custom theme
-      const encodedTheme = btoa(JSON.stringify(theme.custom));
-      url.searchParams.set('theme', 'custom');
-      url.searchParams.set('themeObject', encodedTheme);
-    }
-
-    return url.toString();
-  } catch (error) {
-    themeLogger.exception('Failed to append theme to URL', error, buildThemeExtra('appendThemeToURL', {
-      base_url: baseUrl,
-      has_theme: Boolean(theme),
-    }));
-    return baseUrl;
-  }
-}
-
-/**
- * Get a theme configuration by preset name
- * @param preset The preset theme name
- * @returns The theme configuration or undefined if not found
- */
-export function getThemePreset(preset: string): PortalThemeConfig | undefined {
-  return portalThemePresets[preset];
-}
-
-/**
- * Validate a custom theme configuration
- * @param theme The theme configuration to validate
- * @returns True if valid, false otherwise
- */
-export function validateCustomTheme(theme: PortalThemeConfig): boolean {
-  try {
-    // Only validate what's provided - everything else gets defaults
-    if (theme.mode && !['dark', 'light', 'auto'].includes(theme.mode)) {
-      return false;
-    }
-
-    // If colors are provided, validate the structure
-    if (theme.colors) {
-      // Check that any provided color sections have valid structure
-      const colorSections = ['background', 'status', 'text', 'border', 'input', 'button'];
-      for (const section of colorSections) {
-        const colorSection = theme.colors[section as keyof typeof theme.colors];
-        if (colorSection && typeof colorSection !== 'object') {
-          return false;
-        }
-      }
-    }
-
-    // If typography is provided, validate structure
-    if (theme.typography) {
-      if (theme.typography.fontSize && typeof theme.typography.fontSize !== 'object') {
-        return false;
-      }
-      if (theme.typography.fontWeight && typeof theme.typography.fontWeight !== 'object') {
-        return false;
-      }
-    }
-
-    // If effects are provided, validate structure
-    if (theme.effects) {
-      if (theme.effects.animations && typeof theme.effects.animations !== 'object') {
-        return false;
-      }
-      if (theme.effects.shadows && typeof theme.effects.shadows !== 'object') {
-        return false;
-      }
-    }
-
-    return true;
-  } catch (error) {
-    themeLogger.exception('Theme validation error', error, buildThemeExtra('validateCustomTheme'));
-    return false;
-  }
-}
-
-/**
- * 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 function createCustomThemeFromPreset(
-  preset: string,
-  modifications: Partial<PortalThemeConfig>
-): PortalThemeConfig | null {
-  const baseTheme = getThemePreset(preset);
-  if (!baseTheme) {
-    themeLogger.warn('Preset theme not found', buildThemeExtra('createCustomThemeFromPreset', {
-      preset,
-    }));
-    return null;
-  }
-
-  return {
-    ...baseTheme,
-    ...modifications,
-  };
-}