@umituz/react-native-localization 1.0.0 → 1.2.0

package/src/infrastructure/storage/LocalizationStore.ts

@@ -1,13 +1,23 @@
 /**
  * Localization Store
  * Zustand state management for language preferences with AsyncStorage persistence
+ *
+ * REFACTORED: Now uses centralized AsyncStorageWrapper for DRY compliance
+ * - Eliminates duplicate AsyncStorage calls
+ * - Consistent error handling and logging
+ * - Type-safe storage operations
  */
 
-import { create } from 'zustand';
-import { StorageWrapper, STORAGE_KEYS } from './AsyncStorageWrapper';
-import i18n from '../config/i18n';
-import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE, getLanguageByCode, getDeviceLocale } from '../config/languages';
-import type { Language } from '../../domain/repositories/ILocalizationRepository';
+import { create } from "zustand";
+import { StorageWrapper, STORAGE_KEYS } from "./AsyncStorageWrapper";
+import i18n from "../config/i18n";
+import {
+  SUPPORTED_LANGUAGES,
+  DEFAULT_LANGUAGE,
+  getLanguageByCode,
+  getDeviceLocale,
+} from "../config/languages";
+import type { Language } from "../../domain/repositories/ILocalizationRepository";
 
 interface LocalizationState {
   currentLanguage: string;
@@ -32,37 +42,115 @@ export const useLocalizationStore = create<LocalizationState>((set, get) => ({
    * - Fallback: English (en-US) if device locale not supported
    */
   initialize: async () => {
-    // ✅ CRITICAL FIX: Don't reset isInitialized if already initialized
-    // This prevents UI flash on re-initialization
-    const { isInitialized: alreadyInitialized } = get();
-    if (alreadyInitialized) return;
-
-    // Get saved language preference
-    const savedLanguage = await StorageWrapper.getString(STORAGE_KEYS.LANGUAGE, DEFAULT_LANGUAGE);
-
-    // ✅ DEVICE LOCALE DETECTION: Use device locale on first launch
-    let languageCode: string;
-    if (savedLanguage && savedLanguage !== DEFAULT_LANGUAGE) {
-      // User has previously selected a language → Use their choice
-      languageCode = savedLanguage;
-    } else {
-      // First launch → Detect device locale automatically
-      languageCode = getDeviceLocale();
-      // Save detected locale for future launches
-      await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
+    try {
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.log("[LocalizationStore] Starting initialization...");
+
+      // ✅ CRITICAL FIX: Don't reset isInitialized if already initialized
+      // This prevents UI flash on re-initialization
+      const { isInitialized: alreadyInitialized } = get();
+      if (alreadyInitialized) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__)
+          console.log("[LocalizationStore] Already initialized, skipping");
+        return;
+      }
+
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.log("[LocalizationStore] Getting saved language preference...");
+      // ✅ Get saved language preference (returns null if not exists)
+      const savedLanguage = await StorageWrapper.getString(
+        STORAGE_KEYS.LANGUAGE,
+        DEFAULT_LANGUAGE,
+      );
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.log("[LocalizationStore] Saved language:", savedLanguage);
+
+      // ✅ DEVICE LOCALE DETECTION: Use device locale on first launch
+      let languageCode: string;
+      if (savedLanguage && savedLanguage !== DEFAULT_LANGUAGE) {
+        // User has previously selected a language → Use their choice
+        languageCode = savedLanguage;
+        /* eslint-disable-next-line no-console */
+        if (__DEV__)
+          console.log(
+            "[LocalizationStore] Using saved language:",
+            languageCode,
+          );
+      } else {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__)
+          console.log(
+            "[LocalizationStore] First launch, detecting device locale...",
+          );
+        // First launch → Detect device locale automatically
+        languageCode = getDeviceLocale();
+        /* eslint-disable-next-line no-console */
+        if (__DEV__)
+          console.log(
+            "[LocalizationStore] Detected device locale:",
+            languageCode,
+          );
+        // Save detected locale for future launches
+        await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
+      }
+
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.log("[LocalizationStore] Validating language code...");
+      // ✅ DEFENSIVE: Validate language exists, fallback to default
+      const language = getLanguageByCode(languageCode);
+      const finalLanguage = language ? languageCode : DEFAULT_LANGUAGE;
+      const finalLanguageObj = getLanguageByCode(finalLanguage);
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.log("[LocalizationStore] Final language:", finalLanguage);
+
+      /* eslint-disable-next-line no-console */
+      if (__DEV__) console.log("[LocalizationStore] Changing i18n language...");
+      // Only change language if i18n is available
+      if (i18n && typeof i18n.changeLanguage === "function") {
+        await i18n.changeLanguage(finalLanguage);
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) console.log("[LocalizationStore] i18n language changed");
+      } else {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__)
+          console.warn(
+            "[LocalizationStore] i18n not available, skipping language change",
+          );
+      }
+
+      set({
+        currentLanguage: finalLanguage,
+        isRTL: finalLanguageObj?.rtl || false,
+        isInitialized: true, // ✅ Always set true to unblock UI
+      });
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.log(
+          "[LocalizationStore] Initialization completed successfully",
+        );
+    } catch (error) {
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.error("[LocalizationStore] Initialization error:", error);
+      /* eslint-disable-next-line no-console */
+      if (__DEV__)
+        console.error("[LocalizationStore] Error details:", {
+          message: error instanceof Error ? error.message : String(error),
+          stack: error instanceof Error ? error.stack : "No stack",
+          name: error instanceof Error ? error.name : "Unknown",
+        });
+      // Set initialized even on error to prevent blocking UI
+      set({
+        isInitialized: true,
+      });
+      throw error;
     }
-
-    // ✅ DEFENSIVE: Validate language exists, fallback to default
-    const language = getLanguageByCode(languageCode);
-    const finalLanguage = language ? languageCode : DEFAULT_LANGUAGE;
-    const finalLanguageObj = getLanguageByCode(finalLanguage);
-
-    await i18n.changeLanguage(finalLanguage);
-    set({
-      currentLanguage: finalLanguage,
-      isRTL: finalLanguageObj?.rtl || false,
-      isInitialized: true, // ✅ Always set true to unblock UI
-    });
   },
 
   /**
@@ -75,8 +163,10 @@ export const useLocalizationStore = create<LocalizationState>((set, get) => ({
     // ✅ DEFENSIVE: Early return if unsupported language
     if (!language) return;
 
-    // Update i18n
-    await i18n.changeLanguage(languageCode);
+    // Update i18n (only if available)
+    if (i18n && typeof i18n.changeLanguage === "function") {
+      await i18n.changeLanguage(languageCode);
+    }
 
     // Update state
     set({
@@ -84,7 +174,7 @@ export const useLocalizationStore = create<LocalizationState>((set, get) => ({
       isRTL: language.rtl || false,
     });
 
-    // Persist language preference
+    // ✅ DRY: Single line replaces try/catch/logging
     await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
   },
 }));
@@ -105,8 +195,19 @@ export const useLocalization = () => {
 
   const currentLanguageObject = getLanguageByCode(currentLanguage);
 
+  // Safe translation function - returns key if i18n not available
+  const t = (key: string, options?: any): string => {
+    if (i18n && typeof i18n.t === "function") {
+      const result = i18n.t(key, options);
+      // i18n.t can return string or object, ensure we return string
+      return typeof result === "string" ? result : key;
+    }
+    // Fallback: return key if i18n not available
+    return key;
+  };
+
   return {
-    t: i18n.t.bind(i18n), // Translation function
+    t,
     currentLanguage,
     currentLanguageObject,
     isRTL,

package/lib/infrastructure/locales/en-US/animation.json

@@ -1,30 +0,0 @@
-{
-    "presets": {
-        "fadeIn": "Fade In",
-        "fadeOut": "Fade Out",
-        "slideInUp": "Slide In Up",
-        "slideInDown": "Slide In Down",
-        "slideInLeft": "Slide In Left",
-        "slideInRight": "Slide In Right",
-        "scaleIn": "Scale In",
-        "scaleOut": "Scale Out",
-        "bounce": "Bounce",
-        "shake": "Shake"
-    },
-    "gestures": {
-        "tap": "Tap",
-        "pan": "Pan",
-        "pinch": "Pinch",
-        "rotation": "Rotation",
-        "longPress": "Long Press"
-    },
-    "actions": {
-        "animate": "Animate",
-        "reset": "Reset Animation"
-    },
-    "labels": {
-        "duration": "Duration",
-        "damping": "Damping",
-        "stiffness": "Stiffness"
-    }
-}

package/lib/infrastructure/locales/en-US/audio.json

@@ -1,56 +0,0 @@
-{
-    "recording": {
-        "start": "Start Recording",
-        "stop": "Stop Recording",
-        "pause": "Pause Recording",
-        "resume": "Resume Recording",
-        "save": "Save Recording",
-        "delete": "Delete Recording",
-        "recording": "Recording...",
-        "paused": "Paused",
-        "duration": "Duration"
-    },
-    "playback": {
-        "play": "Play",
-        "pause": "Pause",
-        "stop": "Stop",
-        "replay": "Replay",
-        "forward": "Forward",
-        "backward": "Backward",
-        "speed": "Speed",
-        "volume": "Volume",
-        "mute": "Mute",
-        "unmute": "Unmute",
-        "loop": "Loop",
-        "playing": "Playing",
-        "buffering": "Buffering",
-        "finished": "Finished"
-    },
-    "permissions": {
-        "microphoneTitle": "Microphone Permission",
-        "microphoneMessage": "This app needs microphone access to record audio",
-        "deniedTitle": "Permission Denied",
-        "deniedMessage": "Please enable microphone permissions in Settings",
-        "openSettings": "Open Settings"
-    },
-    "quality": {
-        "low": "Low Quality",
-        "high": "High Quality"
-    },
-    "errors": {
-        "recordFailed": "Failed to start recording",
-        "stopFailed": "Failed to stop recording",
-        "playFailed": "Failed to play audio",
-        "loadFailed": "Failed to load audio",
-        "saveFailed": "Failed to save recording",
-        "permissionDenied": "Microphone permission denied",
-        "noRecording": "No recording available",
-        "invalidFile": "Invalid audio file"
-    },
-    "formats": {
-        "aac": "AAC",
-        "mp3": "MP3",
-        "m4a": "M4A",
-        "wav": "WAV"
-    }
-}

package/lib/infrastructure/locales/en-US/emoji.json

@@ -1,29 +0,0 @@
-{
-    "picker": {
-        "title": "Select Emoji",
-        "search": "Search emojis...",
-        "searchPlaceholder": "Search",
-        "noResults": "No emojis found",
-        "recentlyUsed": "Recently Used"
-    },
-    "categories": {
-        "smileys_emotion": "Smileys & Emotion",
-        "people_body": "People & Body",
-        "animals_nature": "Animals & Nature",
-        "food_drink": "Food & Drink",
-        "travel_places": "Travel & Places",
-        "activities": "Activities",
-        "objects": "Objects",
-        "symbols": "Symbols",
-        "flags": "Flags"
-    },
-    "actions": {
-        "select": "Select",
-        "cancel": "Cancel",
-        "clear": "Clear Emoji"
-    },
-    "validation": {
-        "required": "Please select an emoji",
-        "invalid": "Invalid emoji"
-    }
-}

package/lib/infrastructure/locales/en-US/forms.json

@@ -1,38 +0,0 @@
-{
-    "validation": {
-        "required": "This field is required",
-        "invalidEmail": "Invalid email address",
-        "invalidPhone": "Invalid phone number",
-        "passwordTooShort": "Password must be at least 8 characters",
-        "passwordTooLong": "Password must be at most 128 characters",
-        "passwordsDontMatch": "Passwords do not match",
-        "nameTooShort": "Name must be at least 2 characters",
-        "nameTooLong": "Name must be at most 50 characters"
-    },
-    "fields": {
-        "email": "Email",
-        "password": "Password",
-        "passwordConfirmation": "Confirm Password",
-        "name": "Name",
-        "phone": "Phone Number",
-        "currentPassword": "Current Password",
-        "newPassword": "New Password",
-        "newPasswordConfirmation": "Confirm New Password",
-        "subject": "Subject",
-        "message": "Message"
-    },
-    "actions": {
-        "submit": "Submit",
-        "cancel": "Cancel",
-        "reset": "Reset",
-        "save": "Save",
-        "update": "Update"
-    },
-    "schemas": {
-        "login": "Login Form",
-        "register": "Registration Form",
-        "profile": "Profile Form",
-        "changePassword": "Change Password",
-        "contact": "Contact Form"
-    }
-}

package/lib/infrastructure/locales/en-US/icons.json

@@ -1,34 +0,0 @@
-{
-    "libraries": {
-        "lucide": "Lucide Icons",
-        "material": "Material Design",
-        "fontawesome": "FontAwesome",
-        "ionicons": "Ionicons"
-    },
-    "categories": {
-        "all": "All Icons",
-        "navigation": "Navigation",
-        "action": "Action",
-        "social": "Social",
-        "communication": "Communication",
-        "media": "Media",
-        "business": "Business",
-        "weather": "Weather",
-        "symbols": "Symbols",
-        "emoji": "Emoji"
-    },
-    "picker": {
-        "title": "Select Icon",
-        "search": "Search icons...",
-        "searchPlaceholder": "Search",
-        "noResults": "No icons found",
-        "selected": "Selected",
-        "selectLibrary": "Select Library",
-        "selectCategory": "Select Category"
-    },
-    "actions": {
-        "select": "Select",
-        "cancel": "Cancel",
-        "clear": "Clear Selection"
-    }
-}

package/lib/infrastructure/locales/en-US/location.json

@@ -1,49 +0,0 @@
-{
-    "permission": {
-        "title": "Location Permission",
-        "message": "This app needs access to your location to provide location-based features.",
-        "request": "Grant Location Permission",
-        "denied": "Location permission denied",
-        "granted": "Location permission granted",
-        "unknown": "Location permission status unknown"
-    },
-    "status": {
-        "loading": "Getting your location...",
-        "success": "Location retrieved successfully",
-        "failed": "Unable to get location",
-        "unavailable": "Location services not available",
-        "cached": "Using cached location",
-        "timeout": "Location request timed out"
-    },
-    "accuracy": {
-        "high": "High accuracy",
-        "balanced": "Balanced accuracy",
-        "low": "Low accuracy",
-        "lowest": "Lowest accuracy"
-    },
-    "errors": {
-        "notAvailable": "Location services not available on this platform",
-        "permissionDenied": "Location permission denied. Please enable location access in settings.",
-        "timeout": "Location request timed out. Please try again.",
-        "unknown": "An unknown error occurred while getting location",
-        "noLocation": "Unable to determine your location"
-    },
-    "actions": {
-        "getCurrentLocation": "Get Current Location",
-        "refreshLocation": "Refresh Location",
-        "clearLocation": "Clear Location",
-        "openSettings": "Open Settings"
-    },
-    "labels": {
-        "latitude": "Latitude",
-        "longitude": "Longitude",
-        "accuracy": "Accuracy",
-        "address": "Address",
-        "timestamp": "Time",
-        "coordinates": "Coordinates"
-    },
-    "units": {
-        "meters": "meters",
-        "kilometers": "kilometers"
-    }
-}

package/lib/infrastructure/locales/en-US/media.json

@@ -1,49 +0,0 @@
-{
-    "picker": {
-        "selectImage": "Select Image",
-        "selectImages": "Select Images",
-        "selectVideo": "Select Video",
-        "takePhoto": "Take Photo",
-        "chooseFromLibrary": "Choose from Library",
-        "cancel": "Cancel"
-    },
-    "permissions": {
-        "cameraTitle": "Camera Permission",
-        "cameraMessage": "This app needs camera access to take photos",
-        "libraryTitle": "Photo Library Permission",
-        "libraryMessage": "This app needs access to your photo library",
-        "deniedTitle": "Permission Denied",
-        "deniedMessage": "Please enable permissions in Settings",
-        "openSettings": "Open Settings"
-    },
-    "actions": {
-        "resize": "Resize",
-        "crop": "Crop",
-        "rotate": "Rotate",
-        "flip": "Flip",
-        "compress": "Compress",
-        "save": "Save",
-        "delete": "Delete",
-        "edit": "Edit"
-    },
-    "errors": {
-        "pickFailed": "Failed to pick image",
-        "cameraFailed": "Failed to launch camera",
-        "saveFailed": "Failed to save image",
-        "manipulateFailed": "Failed to edit image",
-        "permissionDenied": "Permission denied",
-        "noImage": "No image selected",
-        "invalidImage": "Invalid image file",
-        "tooLarge": "File size too large"
-    },
-    "quality": {
-        "low": "Low",
-        "medium": "Medium",
-        "high": "High"
-    },
-    "format": {
-        "jpeg": "JPEG",
-        "png": "PNG",
-        "webp": "WebP"
-    }
-}

package/lib/infrastructure/locales/en-US/toast.json

@@ -1,38 +0,0 @@
-{
-    "types": {
-        "success": "Success",
-        "error": "Error",
-        "info": "Info",
-        "warning": "Warning"
-    },
-    "position": {
-        "top": "Top",
-        "bottom": "Bottom"
-    },
-    "presets": {
-        "saved": "Saved",
-        "savedDescription": "Your changes have been saved",
-        "deleted": "Deleted",
-        "deletedDescription": "Item has been removed",
-        "copied": "Copied",
-        "copiedDescription": "Copied to clipboard",
-        "errorGeneric": "Error",
-        "errorGenericDescription": "Something went wrong. Please try again.",
-        "errorNetwork": "Network Error",
-        "errorNetworkDescription": "Please check your connection",
-        "errorValidation": "Validation Error",
-        "errorValidationDescription": "Please check your input",
-        "infoLoading": "Loading",
-        "infoLoadingDescription": "Please wait...",
-        "infoSyncing": "Syncing",
-        "infoSyncingDescription": "Syncing your data...",
-        "warningUnsaved": "Unsaved Changes",
-        "warningUnsavedDescription": "You have unsaved changes",
-        "warningLimit": "Limit Reached",
-        "warningLimitDescription": "You have reached the limit"
-    },
-    "labels": {
-        "visibilityTime": "Display Duration",
-        "autoHide": "Auto Hide"
-    }
-}

package/src/infrastructure/locales/en-US/animation.json

@@ -1,30 +0,0 @@
-{
-  "presets": {
-    "fadeIn": "Fade In",
-    "fadeOut": "Fade Out",
-    "slideInUp": "Slide In Up",
-    "slideInDown": "Slide In Down",
-    "slideInLeft": "Slide In Left",
-    "slideInRight": "Slide In Right",
-    "scaleIn": "Scale In",
-    "scaleOut": "Scale Out",
-    "bounce": "Bounce",
-    "shake": "Shake"
-  },
-  "gestures": {
-    "tap": "Tap",
-    "pan": "Pan",
-    "pinch": "Pinch",
-    "rotation": "Rotation",
-    "longPress": "Long Press"
-  },
-  "actions": {
-    "animate": "Animate",
-    "reset": "Reset Animation"
-  },
-  "labels": {
-    "duration": "Duration",
-    "damping": "Damping",
-    "stiffness": "Stiffness"
-  }
-}

package/src/infrastructure/locales/en-US/audio.json

@@ -1,56 +0,0 @@
-{
-  "recording": {
-    "start": "Start Recording",
-    "stop": "Stop Recording",
-    "pause": "Pause Recording",
-    "resume": "Resume Recording",
-    "save": "Save Recording",
-    "delete": "Delete Recording",
-    "recording": "Recording...",
-    "paused": "Paused",
-    "duration": "Duration"
-  },
-  "playback": {
-    "play": "Play",
-    "pause": "Pause",
-    "stop": "Stop",
-    "replay": "Replay",
-    "forward": "Forward",
-    "backward": "Backward",
-    "speed": "Speed",
-    "volume": "Volume",
-    "mute": "Mute",
-    "unmute": "Unmute",
-    "loop": "Loop",
-    "playing": "Playing",
-    "buffering": "Buffering",
-    "finished": "Finished"
-  },
-  "permissions": {
-    "microphoneTitle": "Microphone Permission",
-    "microphoneMessage": "This app needs microphone access to record audio",
-    "deniedTitle": "Permission Denied",
-    "deniedMessage": "Please enable microphone permissions in Settings",
-    "openSettings": "Open Settings"
-  },
-  "quality": {
-    "low": "Low Quality",
-    "high": "High Quality"
-  },
-  "errors": {
-    "recordFailed": "Failed to start recording",
-    "stopFailed": "Failed to stop recording",
-    "playFailed": "Failed to play audio",
-    "loadFailed": "Failed to load audio",
-    "saveFailed": "Failed to save recording",
-    "permissionDenied": "Microphone permission denied",
-    "noRecording": "No recording available",
-    "invalidFile": "Invalid audio file"
-  },
-  "formats": {
-    "aac": "AAC",
-    "mp3": "MP3",
-    "m4a": "M4A",
-    "wav": "WAV"
-  }
-}

package/src/infrastructure/locales/en-US/emoji.json

@@ -1,29 +0,0 @@
-{
-  "picker": {
-    "title": "Select Emoji",
-    "search": "Search emojis...",
-    "searchPlaceholder": "Search",
-    "noResults": "No emojis found",
-    "recentlyUsed": "Recently Used"
-  },
-  "categories": {
-    "smileys_emotion": "Smileys & Emotion",
-    "people_body": "People & Body",
-    "animals_nature": "Animals & Nature",
-    "food_drink": "Food & Drink",
-    "travel_places": "Travel & Places",
-    "activities": "Activities",
-    "objects": "Objects",
-    "symbols": "Symbols",
-    "flags": "Flags"
-  },
-  "actions": {
-    "select": "Select",
-    "cancel": "Cancel",
-    "clear": "Clear Emoji"
-  },
-  "validation": {
-    "required": "Please select an emoji",
-    "invalid": "Invalid emoji"
-  }
-}