@umituz/react-native-settings 5.2.19 → 5.2.21

package/src/presentation/utils/config-creators/feature-configs.ts

@@ -9,6 +9,7 @@ import type {
   AchievementDefinition,
   LevelDefinition,
 } from "../../../domains/gamification/types";
+import type { SettingsStackParamList } from "../../navigation/types";
 
 /**
  * Create subscription configuration
@@ -17,11 +18,11 @@ import type {
  */
 export const createSubscriptionConfig = (
   isPremium: boolean,
-  routeOrOnPress: string | (() => void),
+  routeOrOnPress: keyof SettingsStackParamList | (() => void),
 ): SubscriptionConfig => ({
   enabled: true,
   icon: "diamond",
-  route: typeof routeOrOnPress === "string" ? routeOrOnPress : undefined,
+  route: typeof routeOrOnPress === "function" ? undefined : routeOrOnPress,
   onPress: typeof routeOrOnPress === "function" ? routeOrOnPress : undefined,
   isPremium,
 });

package/src/presentation/utils/settingsConfigFactory.ts

@@ -6,6 +6,7 @@
 import { useMemo } from "react";
 import type { FeedbackFormData } from "./config-creators/types";
 import type { SettingsConfig } from "../screens/types";
+import type { SettingsStackParamList } from "../navigation/types";
 import {
   createAppearanceConfig,
   createLanguageConfig,
@@ -61,7 +62,7 @@ export const createSettingsConfig = (
     legal: features.legal ? createLegalConfig() : false,
     faqs: features.faqs ? createFAQConfig() : false,
     rating: features.rating ? createRatingConfig(handleRatePress, appStoreUrl) : false,
-    subscription: features.subscription ? createSubscriptionConfig(isPremium, "SubscriptionDetail") : false,
+    subscription: features.subscription ? createSubscriptionConfig(isPremium, "SubscriptionDetail" as keyof SettingsStackParamList) : false,
     gamification: features.gamification ? true : false,
     videoTutorial: features.videoTutorial ? true : false,
     disclaimer: false,

package/src/utils/appUtils.ts

@@ -35,9 +35,3 @@ export function validatePlatform(): "ios" | "android" {
   return platform;
 }
 
-/**
- * Checks if the app is currently in development mode
- */
-export function isDev(): boolean {
-  return __DEV__;
-}

package/src/utils/errorUtils.ts

@@ -0,0 +1,54 @@
+/**
+ * Error Utilities
+ * Centralized error message formatting and handling
+ */
+
+/**
+ * Format error message from unknown error type
+ * Handles Error instances, string errors, and unknown error types
+ *
+ * @param error - The error to format
+ * @returns Formatted error message string
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await riskyOperation();
+ * } catch (err) {
+ *   const message = formatErrorMessage(err);
+ *   console.error(message);
+ * }
+ * ```
+ */
+export const formatErrorMessage = (error: unknown): string => {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (typeof error === 'string') {
+    return error;
+  }
+  return 'Unknown error';
+};
+
+/**
+ * Format error for logging with optional context
+ * Useful for debugging and error tracking
+ *
+ * @param error - The error to format
+ * @param context - Optional context string (e.g., function name, operation)
+ * @returns Formatted error string with context
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetchUserData();
+ * } catch (err) {
+ *   console.error(formatErrorForLogging(err, 'fetchUserData'));
+ *   // Output: "[fetchUserData] Network timeout"
+ * }
+ * ```
+ */
+export const formatErrorForLogging = (error: unknown, context?: string): string => {
+  const message = formatErrorMessage(error);
+  return context ? `[${context}] ${message}` : message;
+};

package/src/utils/hooks/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared React Hooks
+ */
+export { useMountSafety } from './useMountSafety';
+export { useAsyncStateUpdate } from './useAsyncStateUpdate';
+export type { AsyncStateOptions, AsyncStateResult } from './useAsyncStateUpdate';

package/src/utils/hooks/useAsyncStateUpdate.ts

@@ -0,0 +1,114 @@
+/**
+ * Async State Update Hook
+ * Safely handles async operations with loading, error, and mounted state management
+ *
+ * Eliminates common patterns:
+ * - Manual isMountedRef checks
+ * - Duplicate try-catch-finally blocks
+ * - Repetitive loading/error state management
+ *
+ * @example
+ * ```typescript
+ * const { data, loading, error, execute } = useAsyncStateUpdate<User>({
+ *   onSuccess: (user) => console.log('User loaded:', user),
+ *   onError: (error) => console.error('Failed:', error),
+ * });
+ *
+ * const loadUser = async () => {
+ *   await execute(async () => {
+ *     return await api.fetchUser(userId);
+ *   });
+ * };
+ * ```
+ */
+import { useState, useCallback } from 'react';
+import { useMountSafety } from './useMountSafety';
+import { formatErrorMessage } from '../errorUtils';
+
+export interface AsyncStateOptions<T> {
+  /** Initial data value */
+  initialData?: T | null;
+  /** Callback invoked on successful operation */
+  onSuccess?: (data: T) => void;
+  /** Callback invoked on error */
+  onError?: (error: string) => void;
+}
+
+export interface AsyncStateResult<T> {
+  /** Current data value */
+  data: T | null;
+  /** Loading state */
+  loading: boolean;
+  /** Error message if operation failed */
+  error: string | null;
+  /** Execute an async operation with automatic state management */
+  execute: (operation: () => Promise<T>) => Promise<T | null>;
+  /** Manually set data */
+  setData: (data: T | null) => void;
+  /** Manually set error */
+  setError: (error: string | null) => void;
+}
+
+/**
+ * Hook for managing async operations with automatic state updates
+ *
+ * Features:
+ * - Automatic loading state management
+ * - Safe mounted state checks
+ * - Standardized error handling
+ * - Optional success/error callbacks
+ *
+ * @param options - Configuration options
+ * @returns Async state result with execute function
+ */
+export const useAsyncStateUpdate = <T = unknown>(
+  options?: AsyncStateOptions<T>
+): AsyncStateResult<T> => {
+  const [data, setData] = useState<T | null>(options?.initialData ?? null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const isMountedRef = useMountSafety();
+
+  const execute = useCallback(
+    async (operation: () => Promise<T>): Promise<T | null> => {
+      if (!isMountedRef.current) return null;
+
+      setLoading(true);
+      setError(null);
+
+      try {
+        const result = await operation();
+
+        if (isMountedRef.current) {
+          setData(result);
+          options?.onSuccess?.(result);
+        }
+
+        return result;
+      } catch (err) {
+        const errorMessage = formatErrorMessage(err);
+
+        if (isMountedRef.current) {
+          setError(errorMessage);
+          options?.onError?.(errorMessage);
+        }
+
+        return null;
+      } finally {
+        if (isMountedRef.current) {
+          setLoading(false);
+        }
+      }
+    },
+    [isMountedRef, options]
+  );
+
+  return {
+    data,
+    loading,
+    error,
+    execute,
+    setData,
+    setError,
+  };
+};

package/src/utils/hooks/useMountSafety.ts

@@ -0,0 +1,30 @@
+/**
+ * Mount Safety Hook
+ * Provides safe mounted state tracking to prevent state updates after unmount
+ *
+ * @example
+ * ```typescript
+ * const isMountedRef = useMountSafety();
+ *
+ * const fetchData = async () => {
+ *   const data = await api.fetch();
+ *   if (isMountedRef.current) {
+ *     setData(data);
+ *   }
+ * };
+ * ```
+ */
+import { useRef, useEffect } from 'react';
+
+export const useMountSafety = () => {
+  const isMountedRef = useRef(true);
+
+  useEffect(() => {
+    isMountedRef.current = true;
+    return () => {
+      isMountedRef.current = false;
+    };
+  }, []);
+
+  return isMountedRef;
+};

package/src/utils/index.ts

@@ -1 +1,3 @@
 export * from "./appUtils";
+export * from "./errorUtils";
+export * from "./hooks";

package/src/domains/about/presentation/hooks/useAboutInfo.utils.ts

@@ -1,167 +0,0 @@
-/**
- * useAboutInfo Hook Utilities
- * Shared utility functions for about info hook
- */
-
-import type { MutableRefObject } from 'react';
-import type { AppInfo, AboutConfig } from '../../domain/entities/AppInfo';
-import type { AboutRepository } from '../../infrastructure/repositories/AboutRepository';
-import { createDefaultAppInfo } from '../../utils/AppInfoFactory';
-
-/**
- * Safely set error if component is mounted
- */
-export const setErrorIfMounted = (
-  isMountedRef: MutableRefObject<boolean>,
-  setError: (error: string | null) => void,
-  err: string | null
-) => {
-  if (isMountedRef.current) {
-    setError(err);
-  }
-};
-
-/**
- * Safely set loading state if component is mounted
- */
-export const setLoadingIfMounted = (
-  isMountedRef: MutableRefObject<boolean>,
-  setLoading: (loading: boolean) => void,
-  value: boolean
-) => {
-  if (isMountedRef.current) {
-    setLoading(value);
-  }
-};
-
-/**
- * Initialize app info with config
- */
-export const initializeAppInfo = async (
-  config: AboutConfig,
-  repository: AboutRepository,
-  isMountedRef: MutableRefObject<boolean>,
-  isInitializedRef: MutableRefObject<boolean>,
-  setAppInfo: (info: AppInfo | null) => void,
-  setError: (error: string | null) => void,
-  setLoading: (loading: boolean) => void,
-  force = false
-): Promise<void> => {
-  if (isInitializedRef.current && !force) {
-    return;
-  }
-
-  if (!isMountedRef.current) {
-    return;
-  }
-
-  setLoading(true);
-  setError(null);
-
-  try {
-    const defaultAppInfo = createDefaultAppInfo(config);
-    await repository.saveAppInfo(defaultAppInfo);
-
-    if (isMountedRef.current) {
-      setAppInfo(defaultAppInfo);
-      isInitializedRef.current = true;
-    }
-  } catch (err) {
-    setError(err instanceof Error ? err.message : 'Unknown error');
-  } finally {
-    setLoading(false);
-  }
-};
-
-/**
- * Update app info with new config
- */
-export const updateAppInfoConfig = async (
-  config: AboutConfig,
-  repository: AboutRepository,
-  isMountedRef: MutableRefObject<boolean>,
-  setAppInfo: (info: AppInfo | null) => void,
-  setError: (error: string | null) => void,
-  setLoading: (loading: boolean) => void
-): Promise<void> => {
-  if (!isMountedRef.current) {
-    return;
-  }
-
-  setLoading(true);
-  setError(null);
-
-  try {
-    const updatedAppInfo = createDefaultAppInfo(config);
-    await repository.saveAppInfo(updatedAppInfo);
-
-    if (isMountedRef.current) {
-      setAppInfo(updatedAppInfo);
-    }
-  } catch (err) {
-    setError(err instanceof Error ? err.message : 'Unknown error');
-  } finally {
-    setLoading(false);
-  }
-};
-
-/**
- * Update app info with partial updates
- */
-export const updateAppInfoPartial = async (
-  updates: Partial<AppInfo>,
-  repository: AboutRepository,
-  isMountedRef: MutableRefObject<boolean>,
-  setAppInfo: (info: AppInfo | null) => void,
-  setError: (error: string | null) => void,
-  setLoading: (loading: boolean) => void
-): Promise<void> => {
-  if (!isMountedRef.current) {
-    return;
-  }
-
-  setLoading(true);
-  setError(null);
-
-  try {
-    const updatedInfo = await repository.updateAppInfo(updates);
-
-    if (isMountedRef.current) {
-      setAppInfo(updatedInfo);
-    }
-  } catch (err) {
-    setError(err instanceof Error ? err.message : 'Unknown error');
-  } finally {
-    setLoading(false);
-  }
-};
-
-/**
- * Refresh app info from repository
- */
-export const refreshAppInfo = async (
-  repository: AboutRepository,
-  isMountedRef: MutableRefObject<boolean>,
-  setAppInfo: (info: AppInfo | null) => void,
-  setError: (error: string | null) => void,
-  setLoading: (loading: boolean) => void
-): Promise<void> => {
-  if (!isMountedRef.current) {
-    return;
-  }
-
-  setLoading(true);
-  setError(null);
-
-  try {
-    const refreshedInfo = await repository.getAppInfo();
-
-    if (isMountedRef.current) {
-      setAppInfo(refreshedInfo);
-    }
-  } catch (err) {
-    setError(err instanceof Error ? err.message : 'Unknown error');
-  } finally {
-    setLoading(false);
-  }
-};

package/src/domains/notifications/infrastructure/storage/NotificationsStore.ts

@@ -1,45 +0,0 @@
-/**
- * Notifications Store - Zustand State Management
- * Simple offline-first notification state
- * NO backend, NO user IDs, NO notification history
- */
-
-import { createStore } from '@umituz/react-native-design-system';
-
-interface NotificationsState {
-  hasPermissions: boolean;
-  isInitialized: boolean;
-}
-
-interface NotificationsActions {
-  setPermissions: (granted: boolean) => void;
-  setInitialized: (initialized: boolean) => void;
-}
-
-export const useNotificationsStore = createStore<NotificationsState, NotificationsActions>({
-  name: 'notifications-store',
-  initialState: {
-    hasPermissions: false,
-    isInitialized: false,
-  },
-  persist: false,
-  actions: (set) => ({
-    setPermissions: (granted) => set({ hasPermissions: granted }),
-    setInitialized: (initialized) => set({ isInitialized: initialized }),
-  }),
-});
-
-/**
- * Hook for accessing notifications state
- */
-export const useNotifications = () => {
-  const store = useNotificationsStore();
-  const { hasPermissions, isInitialized, setPermissions, setInitialized } = store;
-
-  return {
-    hasPermissions,
-    isInitialized,
-    setPermissions,
-    setInitialized,
-  };
-};

package/src/domains/notifications/infrastructure/utils/dev.ts

@@ -1,22 +0,0 @@
-export const isDev = () => {
-  try {
-    return typeof __DEV__ !== 'undefined' && __DEV__;
-  } catch {
-    return false;
-  }
-};
-
-export const devLog = (_message: string, ..._args: unknown[]) => {
-  if (isDev()) {
-  }
-};
-
-export const devError = (_message: string, ..._args: unknown[]) => {
-  if (isDev()) {
-  }
-};
-
-export const devWarn = (_message: string, ..._args: unknown[]) => {
-  if (isDev()) {
-  }
-};

package/src/domains/notifications/reminders/infrastructure/storage/RemindersStore.ts

@@ -1,152 +0,0 @@
-/**
- * Reminders Store - Zustand State Management
- * Manages reminder state with AsyncStorage persistence
- */
-
-import { useMemo } from 'react';
-import { createStore } from '@umituz/react-native-design-system';
-import type { Reminder, QuietHoursConfig, NotificationPreferences } from '../../../infrastructure/services/types';
-
-// ============================================================================
-// REMINDERS STORE
-// ============================================================================
-
-interface RemindersState {
-  reminders: Reminder[];
-}
-
-interface RemindersActions {
-  addReminder: (reminder: Reminder) => void;
-  updateReminder: (id: string, updates: Partial<Reminder>) => void;
-  deleteReminder: (id: string) => void;
-  toggleReminder: (id: string) => void;
-  resetReminders: () => void;
-}
-
-const DEFAULT_REMINDERS_STATE: RemindersState = {
-  reminders: [],
-};
-
-export const useRemindersStore = createStore<RemindersState, RemindersActions>({
-  name: 'reminders-store',
-  initialState: DEFAULT_REMINDERS_STATE,
-  persist: true,
-  actions: (set, get) => ({
-    addReminder: (reminder: Reminder) => {
-      const { reminders } = get();
-      set({ reminders: [...reminders, reminder] });
-    },
-
-    updateReminder: (id: string, updates: Partial<Reminder>) => {
-      const { reminders } = get();
-      set({
-        reminders: reminders.map(r =>
-          r.id === id ? { ...r, ...updates, updatedAt: new Date().toISOString() } : r
-        ),
-      });
-    },
-
-    deleteReminder: (id: string) => {
-      const { reminders } = get();
-      set({ reminders: reminders.filter(r => r.id !== id) });
-    },
-
-    toggleReminder: (id: string) => {
-      const { reminders } = get();
-      set({
-        reminders: reminders.map(r =>
-          r.id === id ? { ...r, enabled: !r.enabled, updatedAt: new Date().toISOString() } : r
-        ),
-      });
-    },
-
-    resetReminders: () => {
-      set({ reminders: [] });
-    },
-  }),
-});
-
-// ============================================================================
-// PREFERENCES STORE
-// ============================================================================
-
-interface PreferencesState {
-  preferences: NotificationPreferences;
-  isLoading: boolean;
-  isInitialized: boolean;
-}
-
-interface PreferencesActions {
-  initialize: () => void;
-  updatePreferences: (updates: Partial<NotificationPreferences>) => void;
-  updateQuietHours: (quietHours: QuietHoursConfig) => void;
-  reset: () => void;
-}
-
-// ============================================================================
-// DEFAULT VALUES
-// ============================================================================
-
-const DEFAULT_PREFERENCES: NotificationPreferences = {
-  enabled: true,
-  sound: true,
-  vibration: true,
-  quietHours: {
-    enabled: false,
-    startHour: 22,
-    startMinute: 0,
-    endHour: 7,
-    endMinute: 0,
-  },
-};
-
-const initialPreferencesState: PreferencesState = {
-  preferences: DEFAULT_PREFERENCES,
-  isLoading: true,
-  isInitialized: false,
-};
-
-export const usePreferencesStore = createStore<PreferencesState, PreferencesActions>({
-  name: 'preferences-store',
-  initialState: initialPreferencesState,
-  persist: true,
-  actions: (set, get) => ({
-    initialize: () => {
-      set({ isLoading: false, isInitialized: true });
-    },
-
-    updatePreferences: (updates: Partial<NotificationPreferences>) => {
-      const { preferences } = get();
-      set({ preferences: { ...preferences, ...updates } });
-    },
-
-    updateQuietHours: (quietHours: QuietHoursConfig) => {
-      const { preferences } = get();
-      set({ preferences: { ...preferences, quietHours } });
-    },
-
-    reset: () => {
-      set({ preferences: DEFAULT_PREFERENCES });
-    },
-  }),
-});
-
-// ============================================================================
-// SELECTOR HOOKS - REMINDERS
-// ============================================================================
-
-export const useReminders = () => useRemindersStore(state => state.reminders);
-export const useEnabledReminders = () => {
-  const reminders = useRemindersStore(state => state.reminders);
-  return useMemo(() => reminders.filter(r => r.enabled), [reminders]);
-};
-export const useReminderById = (id: string) => useRemindersStore(state => state.reminders.find(r => r.id === id));
-
-// ============================================================================
-// SELECTOR HOOKS - PREFERENCES
-// ============================================================================
-
-export const useNotificationPreferences = () => usePreferencesStore(state => state.preferences);
-export const useQuietHours = () => usePreferencesStore(state => state.preferences.quietHours);
-export const useRemindersLoading = () => usePreferencesStore(state => state.isLoading);
-export const useRemindersInitialized = () => usePreferencesStore(state => state.isInitialized);

package/src/infrastructure/utils/styleUtils.ts

@@ -1,7 +0,0 @@
-/**
- * Style Utilities
- * Re-exports from organized style modules
- * @deprecated Import from specific modules instead: styles/layoutStyles, styles/componentStyles, etc.
- */
-
-export * from './styles';