cordova-plugin-hot-updates 2.1.2 → 2.2.0

package/README.md

@@ -1,4 +1,4 @@
-# Cordova Hot Updates Plugin v2.1.2
+# Cordova Hot Updates Plugin v2.2.0
 
 Frontend-controlled manual hot updates for Cordova iOS applications using WebView Reload approach.
 
@@ -85,6 +85,66 @@ function downloadAndInstall(url, version) {
 }
 ```
 
+## Error Handling
+
+All errors are returned in a unified format for programmatic handling:
+
+```javascript
+// Error format
+callback({
+  error: {
+    code: "ERROR_CODE",        // Code for programmatic handling
+    message: "Detailed message" // Detailed message for logs
+  }
+})
+
+// Success result
+callback(null)
+```
+
+### Error Codes
+
+#### getUpdate() errors:
+- `UPDATE_DATA_REQUIRED` - Missing updateData parameter
+- `URL_REQUIRED` - Missing url parameter
+- `DOWNLOAD_IN_PROGRESS` - Download already in progress
+- `DOWNLOAD_FAILED` - Network download error (message contains details)
+- `HTTP_ERROR` - HTTP status != 200 (message contains status code)
+- `TEMP_DIR_ERROR` - Error creating temporary directory
+- `EXTRACTION_FAILED` - Error extracting ZIP archive
+- `WWW_NOT_FOUND` - www folder not found in archive
+
+#### forceUpdate() errors:
+- `NO_UPDATE_READY` - getUpdate() not called first
+- `UPDATE_FILES_NOT_FOUND` - Downloaded update files not found
+- `INSTALL_FAILED` - Error copying files (message contains details)
+
+#### canary() errors:
+- `VERSION_REQUIRED` - Missing version parameter
+
+### Error Handling Example
+
+```javascript
+window.hotUpdate.getUpdate({url: 'http://...'}, function(error) {
+  if (error) {
+    console.error('[HotUpdates]', error.code, ':', error.message);
+
+    switch(error.code) {
+      case 'HTTP_ERROR':
+        // Handle HTTP errors
+        break;
+      case 'DOWNLOAD_FAILED':
+        // Handle network errors
+        break;
+      default:
+        console.error('Unknown error:', error);
+    }
+  } else {
+    console.log('Update downloaded successfully');
+  }
+});
+```
+
 ## API Reference
 
 All API methods are available via `window.hotUpdate` after the `deviceready` event.
@@ -402,47 +462,6 @@ document.addEventListener('deviceready', function() {
 }, false);
 ```
 
-## Migration from v1.0.0
-
-**Removed methods:**
-- `getCurrentVersion()` - Manage in JS
-- `getPendingUpdateInfo()` - Not needed
-- `checkForUpdates()` - Frontend controls
-- `downloadUpdate()` - Use `getUpdate()`
-- `installUpdate()` - Use `forceUpdate()`
-
-**New API:**
-- `window.hotUpdate.getUpdate({url, version?}, callback)`
-- `window.hotUpdate.forceUpdate(callback)`
-- `window.hotUpdate.canary(version, callback)`
-- `window.hotUpdate.getIgnoreList(callback)`
-
-**Changes:**
-- API via `window.hotUpdate` (not `window.HotUpdates`)
-- Callback signature: `callback(error)` pattern
-- No automatic background checking
-
-## Changelog
-
-### v2.1.2 (2025-11-13)
-
-**Breaking Changes:**
-- Changed API from `window.HotUpdates` to `window.hotUpdate`
-- Removed automatic update checking
-- Simplified to 4 methods: `getUpdate`, `forceUpdate`, `canary`, `getIgnoreList`
-
-**New Features:**
-- Frontend-controlled manual updates
-- Two-step update flow
-- 20-second canary timer
-- IgnoreList system
-- Auto-install on next launch
-- WebView cache clearing
-
-### v1.0.0
-
-- Initial release
-
 ## License
 
 Custom Non-Commercial License - See [LICENSE](LICENSE) file

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "cordova-plugin-hot-updates",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Frontend-controlled manual hot updates for Cordova iOS apps using WebView Reload approach. Manual updates only, JavaScript controls all decisions.",
   "main": "www/HotUpdates.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "prepublishOnly": "npm run verify",
-    "verify": "node -e \"console.log('Verifying package structure...'); const fs = require('fs'); ['www/HotUpdates.js', 'src/ios/HotUpdates.h', 'src/ios/HotUpdates.m', 'plugin.xml', 'LICENSE', 'README.md'].forEach(f => { if (!fs.existsSync(f)) throw new Error('Missing required file: ' + f); }); console.log('✓ All required files present');\"",
+    "verify": "node -e \"console.log('Verifying package structure...'); const fs = require('fs'); ['www/HotUpdates.js', 'src/ios/HotUpdates.h', 'src/ios/HotUpdates.m', 'src/ios/HotUpdatesConstants.h', 'src/ios/HotUpdatesConstants.m', 'src/ios/HotUpdates+Helpers.h', 'src/ios/HotUpdates+Helpers.m', 'plugin.xml', 'LICENSE', 'README.md'].forEach(f => { if (!fs.existsSync(f)) throw new Error('Missing required file: ' + f); }); console.log('✓ All required files present');\"",
     "pack-test": "npm pack && echo '\n✓ Package created. Test installation with: cordova plugin add ./cordova-plugin-hot-updates-*.tgz'",
     "preversion": "npm run verify",
     "postversion": "git push && git push --tags"

package/plugin.xml

@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='utf-8'?>
 <plugin id="cordova-plugin-hot-updates"
-        version="2.1.2"
+        version="2.2.0"
         xmlns="http://apache.org/cordova/ns/plugins/1.0"
         xmlns:android="http://schemas.android.com/apk/res/android">
 
@@ -40,6 +40,10 @@
         <!-- Native iOS files -->
         <source-file src="src/ios/HotUpdates.h" />
         <source-file src="src/ios/HotUpdates.m" />
+        <source-file src="src/ios/HotUpdatesConstants.h" />
+        <source-file src="src/ios/HotUpdatesConstants.m" />
+        <source-file src="src/ios/HotUpdates+Helpers.h" />
+        <source-file src="src/ios/HotUpdates+Helpers.m" />
 
         <!-- Required frameworks -->
         <framework src="Foundation.framework" />

package/src/ios/HotUpdates+Helpers.h

@@ -0,0 +1,23 @@
+/*!
+ * @file HotUpdates+Helpers.h
+ * @brief Helper methods for Hot Updates Plugin
+ * @details Category extension providing utility methods for error handling
+ * @version 2.2.0
+ * @date 2025-11-13
+ * @author Mustafin Vladimir
+ * @copyright Copyright (c) 2025. All rights reserved.
+ */
+
+#import "HotUpdates.h"
+
+@interface HotUpdates (Helpers)
+
+/*!
+ * @brief Create error dictionary for JavaScript callback
+ * @param code Error code (e.g., "URL_REQUIRED")
+ * @param message Detailed message for logs
+ * @return Dictionary with error structure {error: {code: "...", message: "..."}}
+ */
+- (NSDictionary*)createError:(NSString*)code message:(NSString*)message;
+
+@end

package/src/ios/HotUpdates+Helpers.m

@@ -0,0 +1,24 @@
+/*!
+ * @file HotUpdates+Helpers.m
+ * @brief Implementation of helper methods for Hot Updates Plugin
+ * @details Provides utility methods for error handling and response formatting
+ * @version 2.2.0
+ * @date 2025-11-13
+ * @author Mustafin Vladimir
+ * @copyright Copyright (c) 2025. All rights reserved.
+ */
+
+#import "HotUpdates+Helpers.h"
+
+@implementation HotUpdates (Helpers)
+
+- (NSDictionary*)createError:(NSString*)code message:(NSString*)message {
+    return @{
+        @"error": @{
+            @"code": code,
+            @"message": message
+        }
+    };
+}
+
+@end

package/src/ios/HotUpdates.h

@@ -19,6 +19,8 @@
 
 #import <UIKit/UIKit.h>
 #import <Cordova/CDVPlugin.h>
+#import "HotUpdatesConstants.h"
+
 @interface HotUpdates : CDVPlugin
 {
     NSString *documentsPath;
@@ -61,9 +63,8 @@
 - (void)getUpdate:(CDVInvokedUrlCommand*)command;      // Download update
 - (void)forceUpdate:(CDVInvokedUrlCommand*)command;    // Install downloaded update
 - (void)canary:(CDVInvokedUrlCommand*)command;         // Confirm successful load
-- (void)rollback:(CDVInvokedUrlCommand*)command;       // Rollback to previous version
 
-// Information methods
-- (void)getVersionInfo:(CDVInvokedUrlCommand*)command;
+// Debug methods
+- (void)getVersionInfo:(CDVInvokedUrlCommand*)command; // Get all version info for debugging
 
 @end

package/src/ios/HotUpdates.m

@@ -12,8 +12,8 @@
  *          - IgnoreList for tracking problematic versions
  *          - Auto-install pending updates on next app launch
  *
- * @version 2.1.2
- * @date 2025-11-13
+ * @version 2.2.0
+ * @date 2025-11-03
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.
  */
@@ -21,27 +21,10 @@
 #import <Cordova/CDV.h>
 #import <Cordova/CDVViewController.h>
 #import "HotUpdates.h"
+#import "HotUpdates+Helpers.h"
+#import "HotUpdatesConstants.h"
 #import <SSZipArchive/SSZipArchive.h>
 
-// Storage keys
-static NSString * const kInstalledVersion = @"hot_updates_installed_version";
-static NSString * const kPendingVersion = @"hot_updates_pending_version";
-static NSString * const kHasPending = @"hot_updates_has_pending";
-static NSString * const kPreviousVersion = @"hot_updates_previous_version";
-static NSString * const kIgnoreList = @"hot_updates_ignore_list";
-static NSString * const kCanaryVersion = @"hot_updates_canary_version";
-static NSString * const kDownloadInProgress = @"hot_updates_download_in_progress";
-
-// Constants for v2.1.0
-static NSString * const kPendingUpdateURL = @"hot_updates_pending_update_url";
-static NSString * const kPendingUpdateReady = @"hot_updates_pending_ready";
-
-// Directory names
-static NSString * const kWWWDirName = @"www";
-static NSString * const kPreviousWWWDirName = @"www_previous";
-static NSString * const kBackupWWWDirName = @"www_backup";
-static NSString * const kPendingUpdateDirName = @"pending_update";
-
 // Флаг для предотвращения повторных перезагрузок при навигации внутри WebView
 static BOOL hasPerformedInitialReload = NO;
 
@@ -65,24 +48,18 @@ static BOOL hasPerformedInitialReload = NO;
 - (void)pluginInitialize {
     [super pluginInitialize];
 
-    // Получаем пути к директориям
     NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
     documentsPath = [paths objectAtIndex:0];
     wwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
     previousVersionPath = [documentsPath stringByAppendingPathComponent:kPreviousWWWDirName];
 
-    // Загружаем конфигурацию
     [self loadConfiguration];
-
-    // Загрузка ignoreList
     [self loadIgnoreList];
 
-    // Инициализация переменных
     isUpdateReadyToInstall = NO;
     pendingUpdateURL = nil;
     pendingUpdateVersion = nil;
 
-    // Загружаем информацию о pending update если есть
     pendingUpdateURL = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingUpdateURL];
     isUpdateReadyToInstall = [[NSUserDefaults standardUserDefaults] boolForKey:kPendingUpdateReady];
     if (isUpdateReadyToInstall) {
@@ -95,21 +72,14 @@ static BOOL hasPerformedInitialReload = NO;
     NSLog(@"[HotUpdates] Documents www path: %@", wwwPath);
     NSLog(@"[HotUpdates] Ignore list: %@", ignoreList);
 
-    // 1. Проверяем и устанавливаем pending updates
     [self checkAndInstallPendingUpdate];
-
-    // 2. Создаем папку www если её нет (копируем из bundle)
     [self initializeWWWFolder];
-
-    // 3. Переключаем WebView на обновленный контент и перезагружаем
     [self switchToUpdatedContentWithReload];
 
-    // 4. Запускаем canary timer на 20 секунд
     NSString *currentVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
     if (currentVersion) {
         NSString *canaryVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kCanaryVersion];
 
-        // Если canary еще не был вызван для текущей версии
         if (!canaryVersion || ![canaryVersion isEqualToString:currentVersion]) {
             NSLog(@"[HotUpdates] Starting canary timer (20 seconds) for version %@", currentVersion);
 
@@ -127,7 +97,6 @@ static BOOL hasPerformedInitialReload = NO;
 }
 
 - (void)loadConfiguration {
-    // Получаем версию bundle приложения
     appBundleVersion = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"];
     if (!appBundleVersion) {
         appBundleVersion = @"1.0.0";
@@ -146,14 +115,9 @@ static BOOL hasPerformedInitialReload = NO;
     NSString *pendingVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
     NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
 
-    // ТЗ п.7: Если пользователь проигнорировал попап, обновление устанавливается автоматически при следующем запуске
     if (hasPendingUpdate && pendingVersion) {
-        // ВАЖНО (ТЗ): НЕ проверяем ignoreList - JS сам решил загрузить эту версию
-        // Если версия скачана (через getUpdate), значит JS одобрил её установку
-
         NSLog(@"[HotUpdates] Installing pending update %@ to Documents/www (auto-install on launch)", pendingVersion);
 
-        // НОВОЕ: Создаем резервную копию текущей версии перед установкой
         [self backupCurrentVersion];
 
         NSString *pendingUpdatePath = [documentsPath stringByAppendingPathComponent:kPendingUpdateDirName];
@@ -161,24 +125,20 @@ static BOOL hasPerformedInitialReload = NO;
         NSString *documentsWwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
 
         if ([[NSFileManager defaultManager] fileExistsAtPath:pendingWwwPath]) {
-            // Удаляем старую Documents/www
             if ([[NSFileManager defaultManager] fileExistsAtPath:documentsWwwPath]) {
                 [[NSFileManager defaultManager] removeItemAtPath:documentsWwwPath error:nil];
             }
 
-            // Копируем pending_update/www в Documents/www
             NSError *copyError = nil;
             BOOL copySuccess = [[NSFileManager defaultManager] copyItemAtPath:pendingWwwPath toPath:documentsWwwPath error:&copyError];
 
             if (copySuccess) {
-                // Помечаем как установленный
                 [[NSUserDefaults standardUserDefaults] setObject:pendingVersion forKey:kInstalledVersion];
                 [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kHasPending];
                 [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPendingVersion];
-                [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion]; // Сбрасываем canary для новой версии
+                [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion];
                 [[NSUserDefaults standardUserDefaults] synchronize];
 
-                // Очищаем pending_update папку
                 [[NSFileManager defaultManager] removeItemAtPath:pendingUpdatePath error:nil];
 
                 NSLog(@"[HotUpdates] Update %@ installed successfully (canary timer will start)", pendingVersion);
@@ -195,7 +155,7 @@ static BOOL hasPerformedInitialReload = NO;
  *          Uses static flag to prevent reload on every page navigation (only once per app launch)
  */
 - (void)switchToUpdatedContentWithReload {
-    // Предотвращаем повторные перезагрузки при навигации между страницами (например, admin → index.html)
+    // Предотвращаем повторные перезагрузки при навигации между страницами
     if (hasPerformedInitialReload) {
         NSLog(@"[HotUpdates] Initial reload already performed, skipping");
         return;
@@ -207,19 +167,15 @@ static BOOL hasPerformedInitialReload = NO;
         NSString *documentsWwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
         NSString *indexPath = [documentsWwwPath stringByAppendingPathComponent:@"index.html"];
 
-        // Проверяем, что файлы действительно существуют
         if ([[NSFileManager defaultManager] fileExistsAtPath:indexPath]) {
             NSLog(@"[HotUpdates] Using WebView reload approach");
             NSLog(@"[HotUpdates] Found installed update version: %@", installedVersion);
 
-            // Устанавливаем новый путь
             ((CDVViewController *)self.viewController).wwwFolderName = documentsWwwPath;
             NSLog(@"[HotUpdates] Changed wwwFolderName to: %@", documentsWwwPath);
 
-            // Принудительно перезагружаем WebView для применения нового пути
             [self reloadWebView];
 
-            // Устанавливаем флаг, чтобы больше не перезагружать при навигации
             hasPerformedInitialReload = YES;
 
             NSLog(@"[HotUpdates] WebView reloaded with updated content (version: %@)", installedVersion);
@@ -228,7 +184,6 @@ static BOOL hasPerformedInitialReload = NO;
         }
     } else {
         NSLog(@"[HotUpdates] No installed updates, using bundle www");
-        // Устанавливаем флаг даже если нет обновлений, чтобы не проверять постоянно
         hasPerformedInitialReload = YES;
     }
 }
@@ -256,11 +211,9 @@ static BOOL hasPerformedInitialReload = NO;
 }
 
 - (void)reloadWebView {
-    // Приводим к типу CDVViewController для доступа к webViewEngine
     if ([self.viewController isKindOfClass:[CDVViewController class]]) {
         CDVViewController *cdvViewController = (CDVViewController *)self.viewController;
 
-        // Строим новый URL для обновленного контента
         NSString *documentsWwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
         NSString *indexPath = [documentsWwwPath stringByAppendingPathComponent:@"index.html"];
         NSURL *fileURL = [NSURL fileURLWithPath:indexPath];
@@ -270,13 +223,11 @@ static BOOL hasPerformedInitialReload = NO;
 
         id webViewEngine = cdvViewController.webViewEngine;
         if (webViewEngine && [webViewEngine respondsToSelector:@selector(engineWebView)]) {
-            // Получаем WKWebView
             WKWebView *webView = [webViewEngine performSelector:@selector(engineWebView)];
 
             if (webView && [webView isKindOfClass:[WKWebView class]]) {
-                // Используем loadFileURL:allowingReadAccessToURL: для правильных sandbox permissions
+                // loadFileURL:allowingReadAccessToURL: правильно настраивает sandbox permissions для локальных файлов
                 dispatch_async(dispatch_get_main_queue(), ^{
-                    // Этот метод правильно настраивает sandbox для локальных файлов
                     [webView loadFileURL:fileURL allowingReadAccessToURL:allowReadAccessToURL];
                     NSLog(@"[HotUpdates] WebView loadFileURL executed with sandbox permissions");
                 });
@@ -294,12 +245,10 @@ static BOOL hasPerformedInitialReload = NO;
 
 - (void)initializeWWWFolder {
     NSFileManager *fileManager = [NSFileManager defaultManager];
-    
-    // Проверяем, существует ли папка www в Documents
+
     if (![fileManager fileExistsAtPath:wwwPath]) {
         NSLog(@"[HotUpdates] WWW folder not found in Documents. Creating and copying from bundle...");
-        
-        // Копируем содержимое www из bundle в Documents
+
         NSString *bundleWWWPath = [[NSBundle mainBundle] pathForResource:@"www" ofType:nil];
         if (bundleWWWPath) {
             NSError *error;
@@ -323,7 +272,6 @@ static BOOL hasPerformedInitialReload = NO;
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error = nil;
 
-    // Создаем папку назначения если её нет
     if (![fileManager fileExistsAtPath:destination]) {
         [fileManager createDirectoryAtPath:destination withIntermediateDirectories:YES attributes:nil error:&error];
         if (error) {
@@ -332,24 +280,19 @@ static BOOL hasPerformedInitialReload = NO;
         }
     }
 
-    // Распаковка ZIP архива с SSZipArchive
     NSLog(@"[HotUpdates] Extracting ZIP archive using SSZipArchive library");
 
-    // Простая проверка файла
     if (![[NSFileManager defaultManager] fileExistsAtPath:zipPath]) {
         NSLog(@"[HotUpdates] ZIP file does not exist: %@", zipPath);
         return NO;
     }
-    
-    // Создаем временную папку для распаковки
+
     NSString *tempExtractPath = [destination stringByAppendingPathComponent:@"temp_extract"];
-    
-    // Удаляем существующую временную папку
+
     if ([[NSFileManager defaultManager] fileExistsAtPath:tempExtractPath]) {
         [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
     }
-    
-    // Создаем временную папку
+
     if (![[NSFileManager defaultManager] createDirectoryAtPath:tempExtractPath withIntermediateDirectories:YES attributes:nil error:&error]) {
         NSLog(@"[HotUpdates] Failed to create temp extraction folder: %@", error.localizedDescription);
         return NO;
@@ -357,17 +300,15 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSLog(@"[HotUpdates] Extracting to temp location: %@", tempExtractPath);
 
-    // Распаковываем ZIP архив
     BOOL extractSuccess = [SSZipArchive unzipFileAtPath:zipPath toDestination:tempExtractPath];
 
     if (extractSuccess) {
         NSLog(@"[HotUpdates] ZIP extraction successful");
 
-        // Проверяем содержимое распакованного архива
         NSArray *extractedContents = [[NSFileManager defaultManager] contentsOfDirectoryAtPath:tempExtractPath error:nil];
         NSLog(@"[HotUpdates] Extracted contents: %@", extractedContents);
-        
-        // Ищем папку www в распакованном содержимом
+
+        // Ищем папку www (может быть вложенной)
         NSString *wwwSourcePath = nil;
         for (NSString *item in extractedContents) {
             NSString *itemPath = [tempExtractPath stringByAppendingPathComponent:item];
@@ -377,7 +318,6 @@ static BOOL hasPerformedInitialReload = NO;
                     wwwSourcePath = itemPath;
                     break;
                 }
-                // Проверяем, есть ли www внутри папки
                 NSString *nestedWwwPath = [itemPath stringByAppendingPathComponent:@"www"];
                 if ([[NSFileManager defaultManager] fileExistsAtPath:nestedWwwPath]) {
                     wwwSourcePath = nestedWwwPath;
@@ -385,26 +325,22 @@ static BOOL hasPerformedInitialReload = NO;
                 }
             }
         }
-        
+
         if (wwwSourcePath) {
             NSLog(@"[HotUpdates] Found www folder at: %@", wwwSourcePath);
 
-            // Копируем www папку в финальное место
             NSString *finalWwwPath = [destination stringByAppendingPathComponent:@"www"];
 
-            // Удаляем существующую папку www если есть
             if ([[NSFileManager defaultManager] fileExistsAtPath:finalWwwPath]) {
                 [[NSFileManager defaultManager] removeItemAtPath:finalWwwPath error:nil];
             }
 
-            // Копируем новую www папку
             NSError *copyError = nil;
             BOOL copySuccess = [[NSFileManager defaultManager] copyItemAtPath:wwwSourcePath toPath:finalWwwPath error:&copyError];
 
             if (copySuccess) {
                 NSLog(@"[HotUpdates] www folder copied successfully to: %@", finalWwwPath);
 
-                // Очищаем временную папку
                 [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
 
                 NSLog(@"[HotUpdates] ZIP extraction completed successfully");
@@ -417,11 +353,9 @@ static BOOL hasPerformedInitialReload = NO;
             NSLog(@"[HotUpdates] Available contents: %@", extractedContents);
         }
 
-        // Очищаем временную папку при ошибке
         [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
     } else {
         NSLog(@"[HotUpdates] Failed to extract ZIP archive");
-        // Очищаем временную папку при ошибке
         [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
     }
 
@@ -471,7 +405,6 @@ static BOOL hasPerformedInitialReload = NO;
     NSString *currentVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
     NSString *previousVersion = [self getPreviousVersion];
 
-    // Если некуда откатываться (свежая установка из Store) - ничего не делаем
     if (!previousVersion || previousVersion.length == 0) {
         NSLog(@"[HotUpdates] Fresh install from Store, rollback not possible");
         return;
@@ -479,21 +412,17 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSLog(@"[HotUpdates] Version %@ considered faulty, performing rollback", currentVersion);
 
-    // Добавляем в ignoreList
     if (currentVersion) {
         [self addVersionToIgnoreList:currentVersion];
     }
 
-    // Выполняем rollback
     BOOL rollbackSuccess = [self rollbackToPreviousVersion];
 
     if (rollbackSuccess) {
         NSLog(@"[HotUpdates] Automatic rollback completed successfully");
 
-        // Сбрасываем флаг для разрешения перезагрузки после rollback
         hasPerformedInitialReload = NO;
 
-        // Очищаем кэш и перезагружаем WebView
         [self clearWebViewCache];
         [self reloadWebView];
     } else {
@@ -549,26 +478,23 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSLog(@"[HotUpdates] Rollback: %@ -> %@", currentVersion ?: @"bundle", previousVersion ?: @"nil");
 
-    // Проверка: нет previousVersion
     if (!previousVersion || previousVersion.length == 0) {
         NSLog(@"[HotUpdates] Rollback failed: no previous version");
         return NO;
     }
 
-    // Проверка: папка не существует
     if (![fileManager fileExistsAtPath:previousVersionPath]) {
         NSLog(@"[HotUpdates] Rollback failed: previous version folder not found");
         return NO;
     }
 
-    // Проверка: previous = current (защита от цикла)
+    // Защита от цикла rollback
     NSString *effectiveCurrentVersion = currentVersion ?: appBundleVersion;
     if ([previousVersion isEqualToString:effectiveCurrentVersion]) {
         NSLog(@"[HotUpdates] Rollback failed: cannot rollback to same version");
         return NO;
     }
 
-    // Создаем временную резервную копию текущей
     NSString *tempBackupPath = [documentsPath stringByAppendingPathComponent:kBackupWWWDirName];
     if ([fileManager fileExistsAtPath:tempBackupPath]) {
         [fileManager removeItemAtPath:tempBackupPath error:nil];
@@ -576,7 +502,6 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSError *error = nil;
 
-    // Бэкапим текущую версию
     if ([fileManager fileExistsAtPath:wwwPath]) {
         [fileManager moveItemAtPath:wwwPath toPath:tempBackupPath error:&error];
         if (error) {
@@ -585,23 +510,19 @@ static BOOL hasPerformedInitialReload = NO;
         }
     }
 
-    // Копируем предыдущую версию
     BOOL success = [fileManager copyItemAtPath:previousVersionPath
                                         toPath:wwwPath
                                          error:&error];
 
     if (success) {
-        // Обновляем метаданные (previousVersion очищается для предотвращения циклов)
         [[NSUserDefaults standardUserDefaults] setObject:previousVersion forKey:kInstalledVersion];
         [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPreviousVersion];
         [[NSUserDefaults standardUserDefaults] synchronize];
 
-        // Очищаем временный бэкап
         [fileManager removeItemAtPath:tempBackupPath error:nil];
 
         NSLog(@"[HotUpdates] Rollback successful: %@ -> %@", currentVersion, previousVersion);
 
-        // Добавляем проблемную версию в ignoreList
         if (currentVersion) {
             [self addVersionToIgnoreList:currentVersion];
         }
@@ -610,7 +531,6 @@ static BOOL hasPerformedInitialReload = NO;
     } else {
         NSLog(@"[HotUpdates] Rollback failed: %@", error.localizedDescription);
 
-        // Восстанавливаем текущую версию
         if ([fileManager fileExistsAtPath:tempBackupPath]) {
             [fileManager moveItemAtPath:tempBackupPath toPath:wwwPath error:nil];
         }
@@ -626,11 +546,8 @@ static BOOL hasPerformedInitialReload = NO;
 
     if (!updateData) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Update data required"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorUpdateDataRequired
+                                                                                message:@"Update data required"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
@@ -639,16 +556,12 @@ static BOOL hasPerformedInitialReload = NO;
 
     if (!downloadURL) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"URL required"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorURLRequired
+                                                                                message:@"URL is required"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // Опциональная версия (для автоустановки при следующем запуске)
     NSString *updateVersion = [updateData objectForKey:@"version"];
     if (!updateVersion) {
         updateVersion = @"pending";
@@ -657,50 +570,38 @@ static BOOL hasPerformedInitialReload = NO;
     NSLog(@"[HotUpdates] getUpdate() called - downloading update from: %@", downloadURL);
     NSLog(@"[HotUpdates] Version: %@", updateVersion);
 
-    // ВАЖНО (ТЗ): НЕ проверяем ignoreList - JS сам контролирует что загружать
-
-    // 1. Проверяем, не установлена ли уже эта версия
     NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
     if (installedVersion && [installedVersion isEqualToString:updateVersion]) {
         NSLog(@"[HotUpdates] Version %@ already installed, skipping download", updateVersion);
-        // Возвращаем SUCCESS - версия уже установлена
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // 2. Проверяем, не скачана ли уже эта версия (hasPending + та же версия)
     BOOL hasPending = [[NSUserDefaults standardUserDefaults] boolForKey:kHasPending];
     NSString *existingPendingVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
 
     if (hasPending && existingPendingVersion && [existingPendingVersion isEqualToString:updateVersion]) {
         NSLog(@"[HotUpdates] Version %@ already downloaded, skipping re-download", updateVersion);
-        // Возвращаем SUCCESS - версия уже скачана, повторная загрузка не нужна
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // 3. Проверяем, не скачивается ли уже обновление
     if (isDownloadingUpdate) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Download already in progress"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorDownloadInProgress
+                                                                                message:@"Download already in progress"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // Сохраняем URL и версию для последующей установки и автоустановки
     pendingUpdateURL = downloadURL;
     pendingUpdateVersion = updateVersion;
     [[NSUserDefaults standardUserDefaults] setObject:downloadURL forKey:kPendingUpdateURL];
     [[NSUserDefaults standardUserDefaults] setObject:updateVersion forKey:kPendingVersion];
     [[NSUserDefaults standardUserDefaults] synchronize];
 
-    // Запускаем загрузку
     [self downloadUpdateOnly:downloadURL callbackId:command.callbackId];
 }
 
@@ -729,11 +630,8 @@ static BOOL hasPerformedInitialReload = NO;
             NSLog(@"[HotUpdates] Download failed: %@", error.localizedDescription);
 
             CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                     messageAsDictionary:@{
-                @"error": @{
-                    @"message": error.localizedDescription
-                }
-            }];
+                                                     messageAsDictionary:[self createError:kErrorDownloadFailed
+                                                                                    message:[NSString stringWithFormat:@"Download failed: %@", error.localizedDescription]]];
             [self.commandDelegate sendPluginResult:result callbackId:callbackId];
             return;
         }
@@ -743,11 +641,8 @@ static BOOL hasPerformedInitialReload = NO;
             NSLog(@"[HotUpdates] Download failed: HTTP %ld", (long)httpResponse.statusCode);
 
             CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                     messageAsDictionary:@{
-                @"error": @{
-                    @"message": [NSString stringWithFormat:@"HTTP %ld", (long)httpResponse.statusCode]
-                }
-            }];
+                                                     messageAsDictionary:[self createError:kErrorHTTPError
+                                                                                    message:[NSString stringWithFormat:@"HTTP error: %ld", (long)httpResponse.statusCode]]];
             [self.commandDelegate sendPluginResult:result callbackId:callbackId];
             return;
         }
@@ -767,15 +662,12 @@ static BOOL hasPerformedInitialReload = NO;
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error;
 
-    // Создаем временную папку для распаковки
     NSString *tempUpdatePath = [documentsPath stringByAppendingPathComponent:@"temp_downloaded_update"];
 
-    // Удаляем старую временную папку
     if ([fileManager fileExistsAtPath:tempUpdatePath]) {
         [fileManager removeItemAtPath:tempUpdatePath error:nil];
     }
 
-    // Создаем новую временную папку
     [fileManager createDirectoryAtPath:tempUpdatePath
            withIntermediateDirectories:YES
                             attributes:nil
@@ -784,16 +676,12 @@ static BOOL hasPerformedInitialReload = NO;
     if (error) {
         NSLog(@"[HotUpdates] Error creating temp directory: %@", error);
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Cannot create temp directory"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorTempDirError
+                                                                                message:@"Cannot create temp directory"]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Распаковываем обновление
     BOOL unzipSuccess = [self unzipFile:updateLocation.path toDestination:tempUpdatePath];
 
     if (!unzipSuccess) {
@@ -801,63 +689,49 @@ static BOOL hasPerformedInitialReload = NO;
         [fileManager removeItemAtPath:tempUpdatePath error:nil];
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Failed to extract update package"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorExtractionFailed
+                                                                                message:@"Failed to extract update package"]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Проверяем наличие www папки
     NSString *tempWwwPath = [tempUpdatePath stringByAppendingPathComponent:kWWWDirName];
     if (![fileManager fileExistsAtPath:tempWwwPath]) {
         NSLog(@"[HotUpdates] www folder not found in update package");
         [fileManager removeItemAtPath:tempUpdatePath error:nil];
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"www folder not found in package"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorWWWNotFound
+                                                                                message:@"www folder not found in package"]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Копируем также в pending_update для автоустановки при следующем запуске (ТЗ п.7)
+    // Копируем в pending_update для автоустановки при следующем запуске
     NSString *pendingPath = [documentsPath stringByAppendingPathComponent:kPendingUpdateDirName];
 
-    // Удаляем старую pending_update папку
     if ([fileManager fileExistsAtPath:pendingPath]) {
         [fileManager removeItemAtPath:pendingPath error:nil];
     }
 
-    // Копируем temp_downloaded_update → pending_update
     BOOL copySuccess = [fileManager copyItemAtPath:tempUpdatePath
                                             toPath:pendingPath
                                              error:&error];
 
     if (!copySuccess) {
         NSLog(@"[HotUpdates] Failed to copy to pending_update: %@", error);
-        // Не критично - forceUpdate всё равно сработает из temp_downloaded_update
     } else {
         NSLog(@"[HotUpdates] Copied to pending_update for auto-install on next launch");
     }
 
-    // Помечаем обновление как готовое к установке (для forceUpdate)
     isUpdateReadyToInstall = YES;
     [[NSUserDefaults standardUserDefaults] setBool:YES forKey:kPendingUpdateReady];
-
-    // Устанавливаем флаг для автоустановки при следующем запуске (ТЗ п.7)
     [[NSUserDefaults standardUserDefaults] setBool:YES forKey:kHasPending];
     [[NSUserDefaults standardUserDefaults] synchronize];
 
     NSLog(@"[HotUpdates] Update downloaded and ready to install");
     NSLog(@"[HotUpdates] If user ignores popup, update will install automatically on next launch");
 
-    // Возвращаем успех (callback без ошибки) - ТЗ: возвращаем null при успехе
     CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
     [self.commandDelegate sendPluginResult:result callbackId:callbackId];
 }
@@ -867,16 +741,10 @@ static BOOL hasPerformedInitialReload = NO;
 - (void)forceUpdate:(CDVInvokedUrlCommand*)command {
     NSLog(@"[HotUpdates] forceUpdate() called - installing downloaded update");
 
-    // ВАЖНО: Не проверяем ignoreList - это контролирует JS
-
-    // Проверяем, что обновление было скачано
     if (!isUpdateReadyToInstall) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"No update ready to install. Call getUpdate() first."
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorNoUpdateReady
+                                                                                message:@"No update ready to install"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
@@ -884,47 +752,36 @@ static BOOL hasPerformedInitialReload = NO;
     NSString *tempUpdatePath = [documentsPath stringByAppendingPathComponent:@"temp_downloaded_update"];
     NSString *tempWwwPath = [tempUpdatePath stringByAppendingPathComponent:kWWWDirName];
 
-    // Проверяем наличие скачанных файлов
     if (![[NSFileManager defaultManager] fileExistsAtPath:tempWwwPath]) {
         NSLog(@"[HotUpdates] Downloaded update files not found");
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Downloaded update files not found"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorUpdateFilesNotFound
+                                                                                message:@"Downloaded update files not found"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // Устанавливаем обновление
     [self installDownloadedUpdate:tempWwwPath callbackId:command.callbackId];
 }
 
 - (void)installDownloadedUpdate:(NSString*)tempWwwPath callbackId:(NSString*)callbackId {
     NSLog(@"[HotUpdates] Installing update");
 
-    // Определяем версию ДО установки
     NSString *versionToInstall = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
     if (!versionToInstall) {
         versionToInstall = @"unknown";
     }
 
-    // ВАЖНО (ТЗ): НЕ проверяем ignoreList - JS сам контролирует что устанавливать
-
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error;
 
-    // ВАЖНО: Создаем резервную копию текущей версии
     [self backupCurrentVersion];
 
-    // Удаляем текущую www
     if ([fileManager fileExistsAtPath:wwwPath]) {
         [fileManager removeItemAtPath:wwwPath error:nil];
     }
 
-    // Копируем новую версию
     BOOL copySuccess = [fileManager copyItemAtPath:tempWwwPath
                                             toPath:wwwPath
                                              error:&error];
@@ -933,67 +790,53 @@ static BOOL hasPerformedInitialReload = NO;
         NSLog(@"[HotUpdates] Failed to install update: %@", error);
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": error.localizedDescription
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorInstallFailed
+                                                                                message:[NSString stringWithFormat:@"Install failed: %@", error.localizedDescription]]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Используем версию определенную ранее
     NSString *newVersion = versionToInstall;
 
-    // Обновляем метаданные
     [[NSUserDefaults standardUserDefaults] setObject:newVersion forKey:kInstalledVersion];
     [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kPendingUpdateReady];
-    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kHasPending]; // Очищаем флаг автоустановки
+    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kHasPending];
     [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPendingUpdateURL];
     [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPendingVersion];
-    [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion]; // Сбрасываем canary
+    [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion];
     [[NSUserDefaults standardUserDefaults] synchronize];
 
-    // Очищаем временные папки
     NSString *tempUpdatePath = [documentsPath stringByAppendingPathComponent:@"temp_downloaded_update"];
     NSString *pendingPath = [documentsPath stringByAppendingPathComponent:kPendingUpdateDirName];
     [fileManager removeItemAtPath:tempUpdatePath error:nil];
     [fileManager removeItemAtPath:pendingPath error:nil];
 
-    // Сбрасываем флаги
     isUpdateReadyToInstall = NO;
     pendingUpdateURL = nil;
 
     NSLog(@"[HotUpdates] Update installed successfully");
 
-    // Возвращаем успех ПЕРЕД перезагрузкой - ТЗ: возвращаем null при успехе
     CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
     [self.commandDelegate sendPluginResult:result callbackId:callbackId];
 
-    // КРИТИЧЕСКИ ВАЖНО: Запускаем canary timer ПЕРЕД перезагрузкой
-    // После reloadWebView pluginInitialize НЕ вызывается, поэтому таймер нужно запустить вручную
+    // После reloadWebView pluginInitialize НЕ вызывается, поэтому canary timer запускаем вручную
     NSLog(@"[HotUpdates] Starting canary timer (20 seconds) for version %@", newVersion);
 
-    // Останавливаем предыдущий таймер если был
     if (canaryTimer && [canaryTimer isValid]) {
         [canaryTimer invalidate];
     }
 
-    // Запускаем новый таймер на 20 секунд
     canaryTimer = [NSTimer scheduledTimerWithTimeInterval:20.0
                                                    target:self
                                                  selector:@selector(canaryTimeout)
                                                  userInfo:nil
                                                   repeats:NO];
 
-    // Сбрасываем флаг для разрешения перезагрузки после установки обновления
     hasPerformedInitialReload = NO;
 
-    // КРИТИЧЕСКИ ВАЖНО: Очищаем кэш WebView перед перезагрузкой
-    // Без этого может загрузиться старая закэшированная версия
+    // Очищаем кэш WebView перед перезагрузкой, иначе может загрузиться старая версия
     [self clearWebViewCache];
 
-    // Перезагружаем WebView с новым контентом
     [self reloadWebView];
 }
 
@@ -1004,7 +847,8 @@ static BOOL hasPerformedInitialReload = NO;
 
     if (!canaryVersion || canaryVersion.length == 0) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                    messageAsString:@"Version required"];
+                                                 messageAsDictionary:[self createError:kErrorVersionRequired
+                                                                                message:@"Version is required"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
@@ -1031,7 +875,7 @@ static BOOL hasPerformedInitialReload = NO;
     [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
 }
 
-#pragma mark - Information Methods
+#pragma mark - Debug Methods
 
 - (void)getVersionInfo:(CDVInvokedUrlCommand*)command {
     NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
@@ -1055,14 +899,4 @@ static BOOL hasPerformedInitialReload = NO;
     [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
 }
 
-- (void)checkForUpdates:(CDVInvokedUrlCommand*)command {
-    CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                             messageAsDictionary:@{
-        @"error": @{
-            @"message": @"checkForUpdates() removed in v2.1.0. Use fetch() in JS to check your server for updates, then call getUpdate({url}) to download."
-        }
-    }];
-    [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
-}
-
 @end

package/src/ios/HotUpdatesConstants.h

@@ -0,0 +1,45 @@
+/*!
+ * @file HotUpdatesConstants.h
+ * @brief Constants for Hot Updates Plugin
+ * @details Defines error codes, storage keys, and directory names
+ * @version 2.2.0
+ * @date 2025-11-13
+ * @author Mustafin Vladimir
+ * @copyright Copyright (c) 2025. All rights reserved.
+ */
+
+#import <Foundation/Foundation.h>
+
+#pragma mark - Error Codes
+
+extern NSString * const kErrorUpdateDataRequired;
+extern NSString * const kErrorURLRequired;
+extern NSString * const kErrorDownloadInProgress;
+extern NSString * const kErrorDownloadFailed;
+extern NSString * const kErrorHTTPError;
+extern NSString * const kErrorTempDirError;
+extern NSString * const kErrorExtractionFailed;
+extern NSString * const kErrorWWWNotFound;
+extern NSString * const kErrorNoUpdateReady;
+extern NSString * const kErrorUpdateFilesNotFound;
+extern NSString * const kErrorInstallFailed;
+extern NSString * const kErrorVersionRequired;
+
+#pragma mark - Storage Keys
+
+extern NSString * const kInstalledVersion;
+extern NSString * const kPendingVersion;
+extern NSString * const kHasPending;
+extern NSString * const kPreviousVersion;
+extern NSString * const kIgnoreList;
+extern NSString * const kCanaryVersion;
+extern NSString * const kDownloadInProgress;
+extern NSString * const kPendingUpdateURL;
+extern NSString * const kPendingUpdateReady;
+
+#pragma mark - Directory Names
+
+extern NSString * const kWWWDirName;
+extern NSString * const kPreviousWWWDirName;
+extern NSString * const kBackupWWWDirName;
+extern NSString * const kPendingUpdateDirName;

package/src/ios/HotUpdatesConstants.m

@@ -0,0 +1,46 @@
+/*!
+ * @file HotUpdatesConstants.m
+ * @brief Implementation of constants for Hot Updates Plugin
+ * @details Defines all constant values used throughout the plugin
+ * @version 2.2.0
+ * @date 2025-11-13
+ * @author Mustafin Vladimir
+ * @copyright Copyright (c) 2025. All rights reserved.
+ */
+
+#import <Foundation/Foundation.h>
+#import "HotUpdatesConstants.h"
+
+#pragma mark - Error Codes
+
+NSString * const kErrorUpdateDataRequired = @"UPDATE_DATA_REQUIRED";
+NSString * const kErrorURLRequired = @"URL_REQUIRED";
+NSString * const kErrorDownloadInProgress = @"DOWNLOAD_IN_PROGRESS";
+NSString * const kErrorDownloadFailed = @"DOWNLOAD_FAILED";
+NSString * const kErrorHTTPError = @"HTTP_ERROR";
+NSString * const kErrorTempDirError = @"TEMP_DIR_ERROR";
+NSString * const kErrorExtractionFailed = @"EXTRACTION_FAILED";
+NSString * const kErrorWWWNotFound = @"WWW_NOT_FOUND";
+NSString * const kErrorNoUpdateReady = @"NO_UPDATE_READY";
+NSString * const kErrorUpdateFilesNotFound = @"UPDATE_FILES_NOT_FOUND";
+NSString * const kErrorInstallFailed = @"INSTALL_FAILED";
+NSString * const kErrorVersionRequired = @"VERSION_REQUIRED";
+
+#pragma mark - Storage Keys
+
+NSString * const kInstalledVersion = @"hot_updates_installed_version";
+NSString * const kPendingVersion = @"hot_updates_pending_version";
+NSString * const kHasPending = @"hot_updates_has_pending";
+NSString * const kPreviousVersion = @"hot_updates_previous_version";
+NSString * const kIgnoreList = @"hot_updates_ignore_list";
+NSString * const kCanaryVersion = @"hot_updates_canary_version";
+NSString * const kDownloadInProgress = @"hot_updates_download_in_progress";
+NSString * const kPendingUpdateURL = @"hot_updates_pending_update_url";
+NSString * const kPendingUpdateReady = @"hot_updates_pending_ready";
+
+#pragma mark - Directory Names
+
+NSString * const kWWWDirName = @"www";
+NSString * const kPreviousWWWDirName = @"www_previous";
+NSString * const kBackupWWWDirName = @"www_backup";
+NSString * const kPendingUpdateDirName = @"pending_update";