feat: added more utility methods, improved translations functionality

Author: sb-vijay-jangid

.DS_Store

@@ -38,74 +38,163 @@ The Apple store will reject your app if it includes simulator binaries. Therefor
       mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"
 
 # Compatibility
-We support latest Xcode 13+ and swift 5 (5.5) Version. This SDK requires base language as english. Other base language will not supported by this SDK
+This SDK requires base language as english. Other base language will not supported by this SDK
 
-# Configuration
+- **iOS 13.0+** (Primary SDK functionality)
+- **Swift 5.0 or later**
+- Compatible with **Xcode 13.0+**
 
-        import DevnagriSdk
+## Import Requirements
 
-Initialize the SDK by calling the following code in your didFinishLaunchingWithOptions Method and you can get API_KEY from devnagri
+To use DevNagri SDK in your Swift files, you must import the framework:
 
-*updateStringTime* is an optional parameter 
-For auto update strings translations you can set time in minutes.
+```swift
+import DevnagriSdk
+```
 
-     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
-            DevnagriSDK.shared.initSdk(apiKey: String, updateStringTime:Int?) { isInitialized, message in
-                            //Reload or update UI here...
-            }
-     }
-     
-# Default Localisation Override
-   The SDK override the functionality of NSLocalisedString by default. You just need to import the DevnagriSdk to the file where you want NSLocalisedString to be override by the SDK.
+**Note**: This import is **required** when using `NSLocalizedString` method replacement functionality, as the SDK extends the localization system to work with SDK's dynamic translation features.
+
+The SDK override the functionality of NSLocalisedString by default. You just need to import the DevnagriSdk to the file where you want NSLocalisedString to be override by the SDK.
+
+---
+
+## Public Methods & APIs
+Initialize the SDK by calling the following code in your `didFinishLaunchingWithOptions` Method and you can get `API_KEY` from devnagri.
+
+```swift
+import DevnagriSdk
+
+func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
 
-# Change Language
-In case you don't want to use the system language, you can set a different language in the updateAppLocale method. The language code (locale) needs to be present in a release from Devnagri.
-        //You can start loader here...
-            DevnagriSDK.shared.updateAppLocale(code: "hi") { isUpdated, message in
-                //You can stop loader here...
-                //Reload or update UI here...
-            }
-      
+    DevnagriSDK.shared.initSdk( 
+         apiKey: "YOUR_API_KEY",
+        updateStringsTime: 30, // Minutes (minimum 10)
+        completionHandler: { isInitialized, message in
+          if isInitialized {
+                print("SDK initialized successfully")
+          } else {
+                print("Initialization failed: \(message ?? "")")
+        }
+    }
+
+)}
+```
+- `apiKey`: Your DevNagri API key (required)
+- `updateStringsTime`: Automatic translation update interval in minutes (optional, minimum 10)
+- `completionHandler`: Callback with initialization status and message
+
+
+# Language Management
+### **Change Language**   
+In case you don't want to use the system language, you can set a different language in the `updateAppLocale` method. The language code (locale) needs to be present in a release from Devnagri.
+
+```swift
+import DevnagriSdk
+
+DevnagriSDK.shared.updateAppLocale(code: "es") { isUpdated, message in
+    //You can stop loader here...
+    //Reload or update UI here...
+    
+}
+```   
   Please note that you will see the english text back if your device language is english and you have not set any specific language for the SDK. To get the translation in Hindi, Please update app locale to Hindi as per above method.
-  
-# Get Current language code
+   
+### **Get Current language code** ###
 In case you want to know which language code currently used by application.
 
-     let currentLanguageCode = DevnagriSDK.shared.getCurrentApplicationLanguageCode()
+```swift
+import DevnagriSdk
 
-    
-# Get Supported Languages
+let currentLang = DevnagriSDK.shared.getCurrentApplicationLanguageCode()
+print("Current language: \(currentLang)") // e.g., "en", "es", "fr"
+```  
+   
+### **Get Supported Languages** ###
 You can get supported languages for the SDK using this method. This will return hashmap of language name and language code
 
-      DevnagriSDK.shared.getAllSupportableLanguage{ arrOfLanguage in
-            //do your stuff here ...
-      } 
- 
-# Translate String, List and Dictionary on runtime
+```swift
+import DevnagriSdk
+
+DevnagriSDK.shared.getAllSupportableLanguages { languages in
+    for language in languages {
+        print("\(language.language) - \(language.languageCode)")
+        // Example output: "Spanish - es", "French - fr"
+    }
+}
+```
+    
+---
+   
+# Translation Methods 
+### **Get Translation of a Specific String** ###
 You can use these methods anywhere in your project and these will provide translation for current active locale in callback method.
 
-Get Translation of a Specific String
 
-      DevnagriSDK.shared.getTranslationOfString(sentence : "Hello"){ translatedString in
-        //Do your stuff at here....
-      }
+```swift
+import DevnagriSdk
 
-Get Translations of an Array of Strings.
+DevnagriSDK.shared.getTranslationOfString(sentence: "Hello World") { translatedText in
+    print("Translated: \(translatedText)")
+}
+```
 
-      let arrayOfStrings:[String] = ["SampleText1","SampleText2","SampleText3"];
-      DevnagriSDK.shared.getTranslationsOfStrings(sentences : arrayOfStrings){translatedStrings
-        //Do your stuff at here....
-      }
+### **Get Translations of an Array of Strings.** ###
 
-Get Translations Of Dictionary
+```swift
+import DevnagriSdk
 
-       let dicOfStrings:[String:String] = ["A":"SampleText1", "B":"SampleText2", "C":"SampleText3"];
-       DevnagriSDK.shared.getTranslationOfDictionary(dictionary:[“Key1”:”Value1”, “Key2”:”Value 2”]){translatedDictionary in
-        //Do your stuff at here....
-        }
+let sentences = ["Hello", "Goodbye", "Welcome"]
+DevnagriSDK.shared.getTranslationOfStrings(sentences: sentences) { translatedArray in
+    // Returns array of translated strings in same order
+    print("Translated: \(translatedArray)")
+}
+```
 
-Get Translations of Api response Json
+### **Get Translations Of Dictionary** ###
+
+```swift
+import DevnagriSdk
+
+let dict = ["title": "Hello", "subtitle": "Welcome"]
+DevnagriSDK.shared.getTranslationsOfDictionary(dictionary: dict) { translatedDict in
+    // Returns dictionary with translated values, same keys
+    print("Translated dictionary: \(translatedDict)")
+}
+```
+
+### **Get Translations of Api response Json** ###
+```swift
+import DevnagriSdk
+
+let jsonDict = ["user": ["name": "John", "id": "123"], "message": "Hello"]
+DevnagriSDK.shared.getTranslationOfDictionary(
+    dict: jsonDict,
+    ignoreKeys: ["id", "userId"], // Don't translate these keys
+    callback: { translatedResponse in
+        print("Translated JSON: \(translatedResponse)")
+    }
+)
+```
+
+ 
+### **Refreshes subscription status and configuration from server.** ###
+
+```swift
+import DevnagriSdk
+
+DevnagriSDK.shared.refreshSubscriptionDetail()
+```
+
+### **Performance tuning methods** ###
+
+```swift
+import DevnagriSdk
+
+DevnagriSDK.shared.setMaxRecursionCount(count: 50)
+DevnagriSDK.shared.setRecursionDurationInSeconds(seconds: 30)
+```
+
+**How It Works:**
+- **setMaxRecursionCount**: Controls maximum retry attempts for API calls
+- **setRecursionDurationInSeconds**: Sets delay between retry attempts
 
-        DevnagriSDK.shared.getTranslationOfDictionary(dict: , igonreKeys: [""]) { translatedNSDictionary in
-         //Do your stuff at here   
-        }