@finatic/client 0.0.139 → 0.0.140

package/src/utils/errors.ts

@@ -0,0 +1,104 @@
+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

@@ -0,0 +1,54 @@
+type EventCallback = (...args: any[]) => void;
+
+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) {
+          console.error(`Error in event handler for ${event}:`, error);
+        }
+      });
+    }
+  }
+
+  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

@@ -0,0 +1,146 @@
+import { PortalTheme, PortalThemeConfig } from '../types/portal';
+import { portalThemePresets } from '../themes/portalPresets';
+
+/**
+ * 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) {
+    console.error('Failed to generate theme URL:', error);
+    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) {
+    console.error('Failed to append theme to URL:', error);
+    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) {
+    console.error('Theme validation error:', error);
+    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) {
+    console.error(`Preset theme '${preset}' not found`);
+    return null;
+  }
+
+  return {
+    ...baseTheme,
+    ...modifications,
+  };
+}