@umituz/react-native-settings 5.2.34 → 5.2.36

package/src/infrastructure/utils/errorHandlers.ts

@@ -1,250 +0,0 @@
-/**
- * Error Handling Utilities
- * Centralized error handling and error message generation
- * FIXED: Added safety checks for showToast and proper error handling
- */
-
-import { isDev } from '../../utils/devUtils';
-
-/**
- * Error types for better error classification
- */
-export enum ErrorType {
-  NETWORK = "NETWORK",
-  VALIDATION = "VALIDATION",
-  AUTHENTICATION = "AUTHENTICATION",
-  AUTHORIZATION = "AUTHORIZATION",
-  NOT_FOUND = "NOT_FOUND",
-  SERVER = "SERVER",
-  UNKNOWN = "UNKNOWN",
-}
-
-/**
- * Custom error class with error type
- */
-export class AppError extends Error {
-  constructor(
-    message: string,
-    public type: ErrorType = ErrorType.UNKNOWN,
-    public code?: string,
-    public statusCode?: number
-  ) {
-    super(message);
-    this.name = "AppError";
-  }
-}
-
-/**
- * Error handler result
- */
-export interface ErrorHandlerResult {
-  message: string;
-  type: ErrorType;
-  shouldShowToUser: boolean;
-}
-
-/**
- * Classify error based on error properties
- */
-export const classifyError = (error: unknown): ErrorType => {
-  if (error instanceof AppError) {
-    return error.type;
-  }
-
-  if (!(error instanceof Error)) {
-    return ErrorType.UNKNOWN;
-  }
-
-  const errorMessage = error.message.toLowerCase();
-
-  // Network errors
-  if (
-    errorMessage.includes("network") ||
-    errorMessage.includes("fetch") ||
-    errorMessage.includes("connection")
-  ) {
-    return ErrorType.NETWORK;
-  }
-
-  // Authentication errors
-  if (
-    errorMessage.includes("unauthorized") ||
-    errorMessage.includes("unauthenticated") ||
-    errorMessage.includes("token") ||
-    errorMessage.includes("401")
-  ) {
-    return ErrorType.AUTHENTICATION;
-  }
-
-  // Authorization errors
-  if (
-    errorMessage.includes("forbidden") ||
-    errorMessage.includes("permission") ||
-    errorMessage.includes("403")
-  ) {
-    return ErrorType.AUTHORIZATION;
-  }
-
-  // Not found errors
-  if (
-    errorMessage.includes("not found") ||
-    errorMessage.includes("404")
-  ) {
-    return ErrorType.NOT_FOUND;
-  }
-
-  // Server errors
-  if (
-    errorMessage.includes("500") ||
-    errorMessage.includes("502") ||
-    errorMessage.includes("503")
-  ) {
-    return ErrorType.SERVER;
-  }
-
-  return ErrorType.UNKNOWN;
-};
-
-/**
- * Get user-friendly error message
- */
-export const getUserFriendlyErrorMessage = (
-  error: unknown,
-  context?: {
-    operation?: string;
-    entity?: string;
-  }
-): ErrorHandlerResult => {
-  const errorType = classifyError(error);
-
-  let message = "An unexpected error occurred";
-  let shouldShowToUser = true;
-
-  switch (errorType) {
-    case ErrorType.NETWORK:
-      message = "Unable to connect. Please check your internet connection and try again.";
-      break;
-
-    case ErrorType.AUTHENTICATION:
-      message = "Your session has expired. Please sign in again.";
-      break;
-
-    case ErrorType.AUTHORIZATION:
-      message = "You don't have permission to perform this action.";
-      break;
-
-    case ErrorType.NOT_FOUND:
-      if (context?.entity) {
-        // FIXED: Sanitize entity name to prevent injection
-        const sanitizedEntity = String(context.entity).replace(/[<>]/g, "");
-        message = `${sanitizedEntity} not found`;
-      } else {
-        message = "The requested resource was not found.";
-      }
-      break;
-
-    case ErrorType.SERVER:
-      message = "Server error. Please try again later.";
-      shouldShowToUser = false;
-      break;
-
-    case ErrorType.VALIDATION:
-      message = error instanceof Error ? error.message : "Invalid input";
-      break;
-
-    default:
-      if (error instanceof Error) {
-        message = error.message;
-      }
-  }
-
-  return { message, type: errorType, shouldShowToUser };
-};
-
-/**
- * Log error appropriately based on type
- */
-export const logError = (
-  error: unknown,
-  context?: {
-    operation?: string;
-    userId?: string;
-    additionalInfo?: Record<string, unknown>;
-  }
-): void => {
-  const errorType = classifyError(error);
-  const errorMessage = error instanceof Error ? error.message : String(error);
-
-  const logData = {
-    type: errorType,
-    message: errorMessage,
-    operation: context?.operation,
-    userId: context?.userId,
-    ...context?.additionalInfo,
-  };
-
-  // Log errors in development mode
-  if (isDev()) {
-    console.error("[Error]", logData);
-  }
-
-  // Note: Apps can integrate error tracking services (e.g., Sentry) by wrapping this function
-};
-
-/**
- * Handle error with logging and user message
- */
-export const handleError = (
-  error: unknown,
-  context?: {
-    operation?: string;
-    entity?: string;
-    userId?: string;
-    showToast?: (message: string) => void;
-  }
-): ErrorHandlerResult => {
-  // Log the error
-  logError(error, context);
-
-  // Get user-friendly message
-  const result = getUserFriendlyErrorMessage(error, context);
-
-  // Show toast if provided and safe to do so
-  // FIXED: Added safety check and try-catch for showToast
-  if (context?.showToast && result.shouldShowToUser) {
-    try {
-      if (typeof context.showToast === "function") {
-        context.showToast(result.message);
-      }
-    } catch (toastError) {
-      // Log toast error but don't crash error handling
-      if (isDev()) {
-        console.error("[ErrorHandlers] showToast failed:", toastError);
-      }
-    }
-  }
-
-  return result;
-};
-
-/**
- * Wrap an async function with error handling
- */
-export const withErrorHandling = async <T>(
-  operation: () => Promise<T>,
-  options: {
-    operation?: string;
-    entity?: string;
-    showToast?: (message: string) => void;
-    onError?: (result: ErrorHandlerResult) => void;
-  }
-): Promise<{ success: true; data: T } | { success: false; error: ErrorHandlerResult }> => {
-  try {
-    const data = await operation();
-    return { success: true, data };
-  } catch (error) {
-    const errorResult = handleError(error, options);
-    options?.onError?.(errorResult);
-    return { success: false, error: errorResult };
-  }
-};

package/src/infrastructure/utils/index.ts

@@ -1,12 +0,0 @@
-/**
- * Infrastructure Utilities
- * Centralized utility functions for common operations
- */
-
-export * from './styles';
-export * from './memoUtils';
-export * from './styleTokens';
-export * from './configFactory';
-export * from './validation';
-export * from './async';
-export * from './errorHandlers';

package/src/infrastructure/utils/memoComparisonUtils.ts

@@ -1,66 +0,0 @@
-/**
- * Memo Comparison Utilities
- *
- * Provides reusable comparison functions for React.memo to reduce code duplication.
- * These functions follow best practices for shallow comparison in React components.
- */
-
-/**
- * Standard comparison for components with config and translation props
- * @param prevProps Previous props
- * @param nextProps Next props
- * @returns true if props are equal (should not re-render)
- */
-export function compareConfigAndTranslate(
-  prevProps: Record<string, unknown>,
-  nextProps: Record<string, unknown>
-): boolean {
-  return (
-    prevProps.config === nextProps.config &&
-    prevProps.t === nextProps.t
-  );
-}
-
-/**
- * Standard comparison for components with normalized config and features
- * @param prevProps Previous props
- * @param nextProps Next props
- * @returns true if props are equal (should not re-render)
- */
-export function compareConfigAndFeatures(
-  prevProps: Record<string, unknown>,
-  nextProps: Record<string, unknown>
-): boolean {
-  return (
-    prevProps.normalizedConfig === nextProps.normalizedConfig &&
-    prevProps.features === nextProps.features
-  );
-}
-
-/**
- * Standard comparison for components with single prop
- * @param propKey Property key to compare
- * @returns Comparison function
- */
-export function createSinglePropComparator<K extends string>(
-  propKey: K
-): (prevProps: Record<string, unknown>, nextProps: Record<string, unknown>) => boolean {
-  return (prevProps, nextProps) => prevProps[propKey] === nextProps[propKey];
-}
-
-/**
- * Standard comparison for components with gamification config
- * @param prevProps Previous props
- * @param nextProps Next props
- * @returns true if props are equal (should not re-render)
- */
-export function compareGamificationProps(
-  prevProps: Record<string, unknown>,
-  nextProps: Record<string, unknown>
-): boolean {
-  return (
-    prevProps.config === nextProps.config &&
-    prevProps.gamificationConfig === nextProps.gamificationConfig &&
-    prevProps.t === nextProps.t
-  );
-}

package/src/infrastructure/utils/memoUtils.ts

@@ -1,167 +0,0 @@
-/**
- * Memo Utilities
- * Centralized memoization helpers to reduce code duplication
- */
-import { useMemo, useCallback, useRef, useEffect, DependencyList } from 'react';
-import type { DesignTokens } from '@umituz/react-native-design-system';
-
-/**
- * Custom hook to create memoized styles from a style factory function
- * @param styleFactory Function that creates styles
- * @param tokens Design tokens
- * @param deps Dependencies for memoization
- * @returns Memoized styles object
- */
-export function useMemoizedStyles<T>(
-  styleFactory: (tokens: DesignTokens) => T,
-  tokens: DesignTokens,
-  deps: DependencyList = []
-): T {
-  return useMemo(() => styleFactory(tokens), [tokens, ...deps]);
-}
-
-/**
- * Custom hook to create a memoized callback with proper type inference
- * @param callback Function to memoize
- * @param deps Dependencies for memoization
- * @returns Memoized callback
- */
-export function useMemoizedCallback<T extends (...args: never[]) => unknown>(
-  callback: T,
-  deps: DependencyList
-): T {
-  return useCallback(callback, deps) as T;
-}
-
-/**
- * Custom hook to create a memoized value with proper type inference
- * @param factory Function that creates the value
- * @param deps Dependencies for memoization
- * @returns Memoized value
- */
-export function useMemoizedValue<T>(
-  factory: () => T,
-  deps: DependencyList
-): T {
-  return useMemo(factory, deps);
-}
-
-/**
- * Creates a memoized style object with proper caching
- * @param styleCreator Function that creates styles
- * @param deps Dependencies for memoization
- * @returns Memoized styles
- */
-export function useStyledMemo<T extends Record<string, unknown>>(
-  styleCreator: () => T,
-  deps: DependencyList = []
-): T {
-  return useMemo(styleCreator, deps);
-}
-
-/**
- * Memoizes a value with a custom equality check (non-hook version)
- * @param value Value to memoize
- * @param _isEqual Custom equality function
- * @returns Memoized value
- */
-export function memoWithEquality<T>(
-  value: T,
-  _isEqual: (prev: T, next: T) => boolean
-): T {
-  // This is a utility function, not a hook
-  // It cannot use hooks internally
-  return value;
-}
-
-/**
- * Creates a cache key for style memoization
- * @param tokens Design tokens
- * @param prefix Optional prefix for the key
- * @returns Cache key string
- */
-export function createStyleCacheKey(
-  tokens: DesignTokens,
-  prefix: string = ''
-): string {
-  const { colors, spacing, typography } = tokens;
-
-  return `${prefix}-${JSON.stringify({
-    colors: { primary: colors.primary, background: colors.backgroundPrimary },
-    spacing: { md: spacing.md, lg: spacing.lg },
-    typography: { body: typography.bodyMedium.responsiveFontSize },
-  })}`;
-}
-
-/**
- * Memoizes a value with a custom equality check
- * @param value Value to memoize
- * @param _isEqual Custom equality function
- * @returns Memoized value
- */
-export function useMemoWithEquality<T>(
-  value: T,
-  _isEqual: (prev: T, next: T) => boolean
-): T {
-  const ref = useRef<T>(value);
-
-  return useMemo(() => {
-    if (!_isEqual(ref.current, value)) {
-      ref.current = value;
-    }
-    return ref.current;
-  }, [value, _isEqual]);
-}
-
-/**
- * Custom hook that creates a debounced callback with proper cleanup
- * @param callback Function to debounce
- * @param delay Delay in milliseconds
- * @returns Debounced callback
- */
-export function useDebouncedCallback<T extends (...args: never[]) => unknown>(
-  callback: T,
-  delay: number
-): T {
-  const timeoutRef = useRef<NodeJS.Timeout | null>(null);
-
-  useEffect(() => {
-    return () => {
-      if (timeoutRef.current) {
-        clearTimeout(timeoutRef.current);
-      }
-    };
-  }, []);
-
-  return useCallback((...args: Parameters<T>) => {
-    if (timeoutRef.current) {
-      clearTimeout(timeoutRef.current);
-    }
-
-    timeoutRef.current = setTimeout(() => {
-      callback(...args);
-    }, delay);
-  }, [callback, delay]) as T;
-}
-
-/**
- * Custom hook that creates a throttled callback
- * @param callback Function to throttle
- * @param delay Delay in milliseconds
- * @returns Throttled callback
- */
-export function useThrottledCallback<T extends (...args: never[]) => unknown>(
-  callback: T,
-  delay: number
-): T {
-  const lastRunRef = useRef<number>(0);
-
-  return useCallback((...args: Parameters<T>) => {
-    const now = Date.now();
-
-    if (now - lastRunRef.current >= delay) {
-      callback(...args);
-      lastRunRef.current = now;
-    }
-  }, [callback, delay]) as T;
-}

package/src/infrastructure/utils/styleTokens.ts

@@ -1,145 +0,0 @@
-/**
- * Style Tokens
- * Centralized design tokens to replace magic numbers across the codebase
- */
-
-/**
- * Spacing tokens - replaces magic numbers for padding, margins, gaps
- */
-export const SPACING = {
-  xs: 4,
-  sm: 8,
-  md: 12,
-  lg: 16,
-  xl: 20,
-  xxl: 24,
-  xxxl: 32,
-} as const;
-
-/**
- * Font size tokens - replaces magic numbers for font sizes
- */
-export const FONT_SIZE = {
-  xs: 10,
-  sm: 12,
-  md: 14,
-  base: 16,
-  lg: 18,
-  xl: 20,
-  xxl: 24,
-  xxxl: 28,
-  display: 32,
-} as const;
-
-/**
- * Border radius tokens - replaces magic numbers for border radius
- */
-export const BORDER_RADIUS = {
-  none: 0,
-  sm: 4,
-  md: 8,
-  lg: 12,
-  xl: 16,
-  full: 9999,
-} as const;
-
-/**
- * Opacity tokens - replaces magic numbers for opacity values
- */
-export const OPACITY = {
-  disabled: 0.3,
-  hover: 0.7,
-  focus: 0.8,
-  pressed: 0.9,
-  overlay: 0.5,
-  icon: 0.6,
-} as const;
-
-/**
- * Alpha/Transparency values for withAlpha() usage
- * Used with design system's withAlpha(color, alpha) function
- */
-export const ALPHA_VALUES = {
-  subtle: 0.1,      // Very subtle tint
-  light: 0.15,      // Light background tint
-  medium: 0.2,      // Medium background
-  strong: 0.3,      // Strong background
-  visible: 0.5,     // Clearly visible
-  prominent: 0.8,   // Almost opaque
-} as const;
-
-/**
- * Icon size tokens
- */
-export const ICON_SIZE = {
-  xs: 16,
-  sm: 20,
-  md: 24,
-  lg: 32,
-  xl: 40,
-  xxl: 48,
-} as const;
-
-/**
- * Layout dimension tokens
- */
-export const DIMENSION = {
-  touchTarget: {
-    minHeight: 44,
-    minWidth: 44,
-  },
-  card: {
-    minHeight: 72,
-  },
-  input: {
-    minHeight: 48,
-  },
-  button: {
-    minHeight: 44,
-    height: 48,
-  },
-  avatar: {
-    xs: 24,
-    sm: 32,
-    md: 40,
-    lg: 48,
-    xl: 64,
-    xxl: 96,
-  },
-} as const;
-
-/**
- * Z-index tokens for layering
- */
-export const Z_INDEX = {
-  base: 0,
-  overlay: 10,
-  dropdown: 100,
-  sticky: 200,
-  fixed: 300,
-  modalBackdrop: 400,
-  modal: 500,
-  popover: 600,
-  toast: 700,
-} as const;
-
-/**
- * Animation duration tokens (in ms)
- */
-export const DURATION = {
-  fast: 150,
-  normal: 250,
-  slow: 350,
-  extraSlow: 500,
-} as const;
-
-/**
- * Type exports for token values
- */
-export type SpacingToken = typeof SPACING[keyof typeof SPACING];
-export type FontSizeToken = typeof FONT_SIZE[keyof typeof FONT_SIZE];
-export type BorderRadiusToken = typeof BORDER_RADIUS[keyof typeof BORDER_RADIUS];
-export type OpacityToken = typeof OPACITY[keyof typeof OPACITY];
-export type IconSizeToken = typeof ICON_SIZE[keyof typeof ICON_SIZE];
-export type ZIndexToken = typeof Z_INDEX[keyof typeof Z_INDEX];
-export type DurationToken = typeof DURATION[keyof typeof DURATION];