@hot-updater/react-native 0.23.1 → 0.24.1

package/ios/HotUpdater/Internal/HotUpdaterImpl.swift

@@ -8,7 +8,7 @@ import React
     private static let DEFAULT_CHANNEL = "production"
 
     // MARK: - Initialization
-    
+
     /**
      * Convenience initializer that creates and configures all dependencies.
      */
@@ -27,7 +27,7 @@ import React
 
         self.init(bundleStorage: bundleStorage, preferences: preferences)
     }
-    
+
     /**
      * Primary initializer with dependency injection.
      * @param bundleStorage Service for bundle storage operations
@@ -66,15 +66,14 @@ import React
     public static func getIsolationKey() -> String {
         // Get fingerprint hash from Info.plist
         let fingerprintHash = Bundle.main.object(forInfoDictionaryKey: "HOT_UPDATER_FINGERPRINT_HASH") as? String
-        
+
         // Get app version and channel
         let appVersion = self.appVersion ?? "unknown"
         let appChannel = self.appChannel
-        
+
         // Use fingerprint if available, otherwise use app version
         let baseKey = (fingerprintHash != nil && !fingerprintHash!.isEmpty) ? fingerprintHash! : appVersion
-        
-        // Build complete isolation key
+
         return "hotupdater_\(baseKey)_\(appChannel)_"
     }
 
@@ -122,22 +121,28 @@ import React
         do {
             // Validate parameters (this runs on calling thread - typically JS thread)
             guard let data = params else {
-                throw NSError(domain: "HotUpdaterError", code: 101, 
-                             userInfo: [NSLocalizedDescriptionKey: "Missing params dictionary"])
+                let error = NSError(domain: "HotUpdater", code: 0,
+                                   userInfo: [NSLocalizedDescriptionKey: "Missing or invalid parameters for updateBundle"])
+                reject("UNKNOWN_ERROR", error.localizedDescription, error)
+                return
             }
-            
+
             guard let bundleId = data["bundleId"] as? String, !bundleId.isEmpty else {
-                throw NSError(domain: "HotUpdaterError", code: 102, 
-                             userInfo: [NSLocalizedDescriptionKey: "Missing or empty 'bundleId'"])
+                let error = NSError(domain: "HotUpdater", code: 0,
+                                   userInfo: [NSLocalizedDescriptionKey: "Missing or empty 'bundleId'"])
+                reject("MISSING_BUNDLE_ID", error.localizedDescription, error)
+                return
             }
-            
+
             let fileUrlString = data["fileUrl"] as? String ?? ""
 
             var fileUrl: URL? = nil
             if !fileUrlString.isEmpty {
                 guard let url = URL(string: fileUrlString) else {
-                    throw NSError(domain: "HotUpdaterError", code: 103,
-                                 userInfo: [NSLocalizedDescriptionKey: "Invalid 'fileUrl' provided: \(fileUrlString)"])
+                    let error = NSError(domain: "HotUpdater", code: 0,
+                                       userInfo: [NSLocalizedDescriptionKey: "Invalid 'fileUrl' provided: \(fileUrlString)"])
+                    reject("INVALID_FILE_URL", error.localizedDescription, error)
+                    return
                 }
                 fileUrl = url
             }
@@ -160,10 +165,10 @@ import React
                 }
             }) { [weak self] result in
                 guard self != nil else {
-                    let error = NSError(domain: "HotUpdaterError", code: 998, 
-                                       userInfo: [NSLocalizedDescriptionKey: "Self deallocated during update"])
+                    let error = NSError(domain: "HotUpdater", code: 0,
+                                       userInfo: [NSLocalizedDescriptionKey: "Internal error: self deallocated during update"])
                     DispatchQueue.main.async {
-                        reject("UPDATE_ERROR", error.localizedDescription, error)
+                        reject("SELF_DEALLOCATED", error.localizedDescription, error)
                     }
                     return
                 }
@@ -174,12 +179,11 @@ import React
                         NSLog("[HotUpdaterImpl] Update successful for \(bundleId). Resolving promise.")
                         resolve(true)
                     case .failure(let error):
-                        let nsError = error as NSError
-                        NSLog("[HotUpdaterImpl] Update failed for \(bundleId) - Domain: \(nsError.domain), Code: \(nsError.code), Description: \(nsError.localizedDescription)")
+                        NSLog("[HotUpdaterImpl] Update failed for \(bundleId) - Error: \(error)")
 
-                        // Create a meaningful error code for React Native
-                        let errorCode = "BUNDLE_STORAGE_ERROR_\(nsError.code)"
-                        reject(errorCode, nsError.localizedDescription, nsError)
+                        let normalizedCode = HotUpdaterImpl.normalizeErrorCode(from: error)
+                        let nsError = error as NSError
+                        reject(normalizedCode, nsError.localizedDescription, nsError)
                     }
                 }
             }
@@ -188,8 +192,75 @@ import React
             let nsError = error as NSError
             NSLog("[HotUpdaterImpl] Error in updateBundleFromJS - Domain: \(nsError.domain), Code: \(nsError.code), Description: \(nsError.localizedDescription)")
 
-            let errorCode = "UPDATE_ERROR_\(nsError.code)"
-            reject(errorCode, nsError.localizedDescription, nsError)
+            reject("UNKNOWN_ERROR", nsError.localizedDescription, nsError)
         }
     }
-}
+
+    /**
+     * Normalizes native errors to a small, predictable set of JS-facing error codes.
+     * Rare or platform-specific codes are collapsed to UNKNOWN_ERROR to reduce surface area.
+     */
+    private static func normalizeErrorCode(from error: Error) -> String {
+        let baseCode: String
+
+        if let storageError = error as? BundleStorageError {
+            // Collapse signature sub-errors into a single public code
+            if case .signatureVerificationFailed = storageError {
+                baseCode = "SIGNATURE_VERIFICATION_FAILED"
+            } else {
+                baseCode = storageError.errorCodeString
+            }
+        } else if error is SignatureVerificationError {
+            baseCode = "SIGNATURE_VERIFICATION_FAILED"
+        } else {
+            baseCode = "UNKNOWN_ERROR"
+        }
+
+        return userFacingErrorCodes.contains(baseCode) ? baseCode : "UNKNOWN_ERROR"
+    }
+
+    // Error codes we intentionally expose to JS callers.
+    private static let userFacingErrorCodes: Set<String> = [
+        "MISSING_BUNDLE_ID",
+        "INVALID_FILE_URL",
+        "DIRECTORY_CREATION_FAILED",
+        "DOWNLOAD_FAILED",
+        "INCOMPLETE_DOWNLOAD",
+        "EXTRACTION_FORMAT_ERROR",
+        "INVALID_BUNDLE",
+        "INSUFFICIENT_DISK_SPACE",
+        "SIGNATURE_VERIFICATION_FAILED",
+        "MOVE_OPERATION_FAILED",
+        "BUNDLE_IN_CRASHED_HISTORY",
+        "SELF_DEALLOCATED",
+        "UNKNOWN_ERROR",
+    ]
+
+    // MARK: - Rollback Support
+
+    /**
+     * Notifies the system that the app has successfully started with the given bundle.
+     * If the bundle matches the staging bundle, it promotes to stable.
+     * @param bundleId The ID of the currently running bundle
+     * @return true if promotion was successful or no action was needed
+     */
+    public func notifyAppReady(bundleId: String) -> [String: Any] {
+        return bundleStorage.notifyAppReady(bundleId: bundleId)
+    }
+
+    /**
+     * Gets the crashed bundle history.
+     * @return Array of crashed bundle IDs
+     */
+    public func getCrashHistory() -> [String] {
+        return bundleStorage.getCrashHistory().bundles.map { $0.bundleId }
+    }
+
+    /**
+     * Clears the crashed bundle history.
+     * @return true if clearing was successful
+     */
+    public func clearCrashHistory() -> Bool {
+        return bundleStorage.clearCrashHistory()
+    }
+}

package/ios/HotUpdater/Internal/SignatureVerifier.swift

@@ -5,35 +5,37 @@ import Security
 private let SIGNED_HASH_PREFIX = "sig:"
 
 /// Error types for signature verification failures.
-///
-/// **IMPORTANT**: The error messages in `errorUserInfo` are used by the JavaScript layer
-/// (`packages/react-native/src/types.ts`) to detect signature verification failures.
-/// If you change these messages, update `isSignatureVerificationError()` in types.ts accordingly.
 public enum SignatureVerificationError: Error, CustomNSError {
     case publicKeyNotConfigured
     case invalidPublicKeyFormat
+    case missingFileHash
     case invalidSignatureFormat
-    case verificationFailed
-    case hashMismatch
-    case hashCalculationFailed
+    case signatureVerificationFailed
+    case fileHashMismatch
+    case fileReadFailed
     case unsignedNotAllowed
     case securityFrameworkError(OSStatus)
 
     // CustomNSError protocol implementation
     public static var errorDomain: String {
-        return "com.hotupdater.SignatureVerificationError"
+        return "HotUpdater"
     }
 
     public var errorCode: Int {
+        return 0
+    }
+
+    public var errorCodeString: String {
         switch self {
-        case .publicKeyNotConfigured: return 2001
-        case .invalidPublicKeyFormat: return 2002
-        case .invalidSignatureFormat: return 2003
-        case .verificationFailed: return 2004
-        case .hashMismatch: return 2005
-        case .hashCalculationFailed: return 2006
-        case .unsignedNotAllowed: return 2007
-        case .securityFrameworkError: return 2099
+        case .publicKeyNotConfigured: return "PUBLIC_KEY_NOT_CONFIGURED"
+        case .invalidPublicKeyFormat: return "INVALID_PUBLIC_KEY_FORMAT"
+        case .missingFileHash: return "MISSING_FILE_HASH"
+        case .invalidSignatureFormat: return "INVALID_SIGNATURE_FORMAT"
+        case .signatureVerificationFailed: return "SIGNATURE_VERIFICATION_FAILED"
+        case .fileHashMismatch: return "FILE_HASH_MISMATCH"
+        case .fileReadFailed: return "FILE_READ_FAILED"
+        case .unsignedNotAllowed: return "UNSIGNED_NOT_ALLOWED"
+        case .securityFrameworkError: return "SECURITY_FRAMEWORK_ERROR"
         }
     }
 
@@ -49,20 +51,24 @@ public enum SignatureVerificationError: Error, CustomNSError {
             userInfo[NSLocalizedDescriptionKey] = "Public key format is invalid"
             userInfo[NSLocalizedRecoverySuggestionErrorKey] = "Ensure the public key is in PEM format (BEGIN PUBLIC KEY)"
 
+        case .missingFileHash:
+            userInfo[NSLocalizedDescriptionKey] = "File hash is missing or empty"
+            userInfo[NSLocalizedRecoverySuggestionErrorKey] = "Ensure the bundle update includes a valid file hash"
+
         case .invalidSignatureFormat:
-            userInfo[NSLocalizedDescriptionKey] = "Signature format is invalid"
-            userInfo[NSLocalizedRecoverySuggestionErrorKey] = "The signature must be base64-encoded"
+            userInfo[NSLocalizedDescriptionKey] = "Signature format is invalid or corrupted"
+            userInfo[NSLocalizedRecoverySuggestionErrorKey] = "The signature data is malformed or cannot be decoded. Bundle may be corrupted"
 
-        case .verificationFailed:
+        case .signatureVerificationFailed:
             userInfo[NSLocalizedDescriptionKey] = "Bundle signature verification failed"
             userInfo[NSLocalizedRecoverySuggestionErrorKey] = "The bundle may be corrupted or tampered with. Rejecting update for security"
 
-        case .hashMismatch:
-            userInfo[NSLocalizedDescriptionKey] = "Bundle hash verification failed"
-            userInfo[NSLocalizedRecoverySuggestionErrorKey] = "The bundle file hash does not match. File may be corrupted"
+        case .fileHashMismatch:
+            userInfo[NSLocalizedDescriptionKey] = "File hash verification failed"
+            userInfo[NSLocalizedRecoverySuggestionErrorKey] = "The bundle file hash does not match the expected value. File may be corrupted"
 
-        case .hashCalculationFailed:
-            userInfo[NSLocalizedDescriptionKey] = "Failed to calculate file hash"
+        case .fileReadFailed:
+            userInfo[NSLocalizedDescriptionKey] = "Failed to read file for verification"
             userInfo[NSLocalizedRecoverySuggestionErrorKey] = "Could not read file for hash verification"
 
         case .unsignedNotAllowed:
@@ -149,7 +155,7 @@ public class SignatureVerifier {
         // Rule: null/empty fileHash → REJECT
         guard let hash = fileHash, !hash.isEmpty else {
             NSLog("[SignatureVerifier] fileHash is null or empty. Rejecting update.")
-            return .failure(.verificationFailed)
+            return .failure(.missingFileHash)
         }
 
         if isSignedFormat(hash) {
@@ -192,7 +198,7 @@ public class SignatureVerifier {
 
         guard HashUtils.verifyHash(fileURL: fileURL, expectedHash: expectedHash) else {
             NSLog("[SignatureVerifier] Hash mismatch!")
-            return .failure(.hashMismatch)
+            return .failure(.fileHashMismatch)
         }
 
         NSLog("[SignatureVerifier] ✅ Hash verified successfully")
@@ -228,7 +234,7 @@ public class SignatureVerifier {
         // Calculate file hash
         guard let fileHashHex = HashUtils.calculateSHA256(fileURL: fileURL) else {
             NSLog("[SignatureVerifier] Failed to calculate file hash")
-            return .failure(.hashCalculationFailed)
+            return .failure(.fileReadFailed)
         }
 
         NSLog("[SignatureVerifier] Calculated file hash: \(fileHashHex)")
@@ -264,7 +270,7 @@ public class SignatureVerifier {
 
         if let err = error?.takeRetainedValue() {
             NSLog("[SignatureVerifier] Verification failed: \(err)")
-            return .failure(.verificationFailed)
+            return .failure(.signatureVerificationFailed)
         }
 
         if verified {
@@ -272,7 +278,7 @@ public class SignatureVerifier {
             return .success(())
         } else {
             NSLog("[SignatureVerifier] ❌ Signature verification failed")
-            return .failure(.verificationFailed)
+            return .failure(.signatureVerificationFailed)
         }
     }
 

package/ios/HotUpdater/Internal/URLSessionDownloadService.swift

@@ -21,7 +21,7 @@ protocol DownloadService {
 
 
 enum DownloadError: Error {
-    case incompleteDownload
+    case incompleteDownload(expected: Int64, actual: Int64)
     case invalidContentLength
 }
 
@@ -109,7 +109,7 @@ extension URLSessionDownloadService: URLSessionDownloadDelegate {
             NSLog("[DownloadService] Download incomplete: \(actualSize) / \(expectedSize) bytes")
             // Delete incomplete file
             try? FileManager.default.removeItem(at: location)
-            completion?(.failure(DownloadError.incompleteDownload))
+            completion?(.failure(DownloadError.incompleteDownload(expected: expectedSize, actual: actualSize)))
             return
         }
 

package/ios/HotUpdater/Public/HotUpdater.h

@@ -10,12 +10,18 @@
 #endif // RCT_NEW_ARCH_ENABLED
 
 /**
- * Returns the currently active bundle URL.
-* Callable from Objective-C (e.g., AppDelegate).
+ * Returns the currently active bundle URL from the default (static) instance.
+ * Callable from Objective-C (e.g., AppDelegate).
  * This is implemented in HotUpdater.mm and calls the Swift static method.
  */
 + (NSURL *)bundleURL;
 
+/**
+ * Returns the bundle URL for this specific instance.
+ * @return The bundle URL for this instance
+ */
+- (NSURL *)bundleURL;
+
 /**
  * 다운로드 진행 상황 업데이트 시간을 추적하는 속성
  */

package/lib/commonjs/DefaultResolver.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createDefaultResolver = createDefaultResolver;
+var _fetchUpdateInfo = require("./fetchUpdateInfo.js");
+/**
+ * Creates a default resolver that uses baseURL for network operations.
+ * This encapsulates the existing baseURL logic into a resolver.
+ *
+ * @param baseURL - The base URL for the update server
+ * @returns A HotUpdaterResolver that uses the baseURL
+ */
+function createDefaultResolver(baseURL) {
+  return {
+    checkUpdate: async params => {
+      // Build URL based on strategy (existing buildUpdateUrl logic)
+      let url;
+      if (params.updateStrategy === "fingerprint") {
+        if (!params.fingerprintHash) {
+          throw new Error("Fingerprint hash is required");
+        }
+        url = `${baseURL}/fingerprint/${params.platform}/${params.fingerprintHash}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
+      } else {
+        url = `${baseURL}/app-version/${params.platform}/${params.appVersion}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
+      }
+
+      // Use existing fetchUpdateInfo
+      return (0, _fetchUpdateInfo.fetchUpdateInfo)({
+        url,
+        requestHeaders: params.requestHeaders,
+        requestTimeout: params.requestTimeout
+      });
+    }
+  };
+}
+//# sourceMappingURL=DefaultResolver.js.map

package/lib/commonjs/DefaultResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_fetchUpdateInfo","require","createDefaultResolver","baseURL","checkUpdate","params","url","updateStrategy","fingerprintHash","Error","platform","channel","minBundleId","bundleId","appVersion","fetchUpdateInfo","requestHeaders","requestTimeout"],"sourceRoot":"../../src","sources":["DefaultResolver.ts"],"mappings":";;;;;;AACA,IAAAA,gBAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,qBAAqBA,CAACC,OAAe,EAAsB;EACzE,OAAO;IACLC,WAAW,EAAE,MACXC,MAAiC,IACC;MAClC;MACA,IAAIC,GAAW;MACf,IAAID,MAAM,CAACE,cAAc,KAAK,aAAa,EAAE;QAC3C,IAAI,CAACF,MAAM,CAACG,eAAe,EAAE;UAC3B,MAAM,IAAIC,KAAK,CAAC,8BAA8B,CAAC;QACjD;QACAH,GAAG,GAAG,GAAGH,OAAO,gBAAgBE,MAAM,CAACK,QAAQ,IAAIL,MAAM,CAACG,eAAe,IAAIH,MAAM,CAACM,OAAO,IAAIN,MAAM,CAACO,WAAW,IAAIP,MAAM,CAACQ,QAAQ,EAAE;MACxI,CAAC,MAAM;QACLP,GAAG,GAAG,GAAGH,OAAO,gBAAgBE,MAAM,CAACK,QAAQ,IAAIL,MAAM,CAACS,UAAU,IAAIT,MAAM,CAACM,OAAO,IAAIN,MAAM,CAACO,WAAW,IAAIP,MAAM,CAACQ,QAAQ,EAAE;MACnI;;MAEA;MACA,OAAO,IAAAE,gCAAe,EAAC;QACrBT,GAAG;QACHU,cAAc,EAAEX,MAAM,CAACW,cAAc;QACrCC,cAAc,EAAEZ,MAAM,CAACY;MACzB,CAAC,CAAC;IACJ;EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/checkForUpdate.js

@@ -4,11 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.checkForUpdate = checkForUpdate;
-exports.getUpdateSource = void 0;
 var _reactNative = require("react-native");
 var _error = require("./error.js");
-var _fetchUpdateInfo = require("./fetchUpdateInfo.js");
 var _native = require("./native.js");
+// Internal type that includes resolver for use within index.ts
+
 async function checkForUpdate(options) {
   if (__DEV__) {
     return null;
@@ -27,52 +27,40 @@ async function checkForUpdate(options) {
     return null;
   }
   const fingerprintHash = (0, _native.getFingerprintHash)();
-  return (0, _fetchUpdateInfo.fetchUpdateInfo)({
-    source: options.source,
-    params: {
-      bundleId: currentBundleId,
-      appVersion: currentAppVersion,
+  if (!options.resolver?.checkUpdate) {
+    options.onError?.(new _error.HotUpdaterError("Resolver is required but not configured"));
+    return null;
+  }
+  let updateInfo = null;
+  try {
+    updateInfo = await options.resolver.checkUpdate({
       platform,
+      appVersion: currentAppVersion,
+      bundleId: currentBundleId,
       minBundleId,
       channel,
-      fingerprintHash
-    },
-    requestHeaders: options.requestHeaders,
-    onError: options.onError,
-    requestTimeout: options.requestTimeout
-  }).then(updateInfo => {
-    if (!updateInfo) {
-      return null;
+      updateStrategy: options.updateStrategy,
+      fingerprintHash,
+      requestHeaders: options.requestHeaders,
+      requestTimeout: options.requestTimeout
+    });
+  } catch (error) {
+    options.onError?.(error);
+    return null;
+  }
+  if (!updateInfo) {
+    return null;
+  }
+  return {
+    ...updateInfo,
+    updateBundle: async () => {
+      return (0, _native.updateBundle)({
+        bundleId: updateInfo.id,
+        fileUrl: updateInfo.fileUrl,
+        fileHash: updateInfo.fileHash,
+        status: updateInfo.status
+      });
     }
-    return {
-      ...updateInfo,
-      updateBundle: async () => {
-        return (0, _native.updateBundle)({
-          bundleId: updateInfo.id,
-          fileUrl: updateInfo.fileUrl,
-          fileHash: updateInfo.fileHash,
-          status: updateInfo.status
-        });
-      }
-    };
-  });
+  };
 }
-const getUpdateSource = (baseUrl, options) => params => {
-  switch (options.updateStrategy) {
-    case "fingerprint":
-      {
-        if (!params.fingerprintHash) {
-          throw new _error.HotUpdaterError("Fingerprint hash is required");
-        }
-        return `${baseUrl}/fingerprint/${params.platform}/${params.fingerprintHash}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
-      }
-    case "appVersion":
-      {
-        return `${baseUrl}/app-version/${params.platform}/${params.appVersion}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
-      }
-    default:
-      return baseUrl;
-  }
-};
-exports.getUpdateSource = getUpdateSource;
 //# sourceMappingURL=checkForUpdate.js.map

package/lib/commonjs/checkForUpdate.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_error","_fetchUpdateInfo","_native","checkForUpdate","options","__DEV__","includes","Platform","OS","onError","HotUpdaterError","currentAppVersion","getAppVersion","platform","currentBundleId","getBundleId","minBundleId","getMinBundleId","channel","getChannel","fingerprintHash","getFingerprintHash","fetchUpdateInfo","source","params","bundleId","appVersion","requestHeaders","requestTimeout","then","updateInfo","updateBundle","id","fileUrl","fileHash","status","getUpdateSource","baseUrl","updateStrategy","exports"],"sourceRoot":"../../src","sources":["checkForUpdate.ts"],"mappings":";;;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AACA,IAAAE,gBAAA,GAAAF,OAAA;AACA,IAAAG,OAAA,GAAAH,OAAA;AA4BO,eAAeI,cAAcA,CAClCC,OAA8B,EACQ;EACtC,IAAIC,OAAO,EAAE;IACX,OAAO,IAAI;EACb;EAEA,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAACC,QAAQ,CAACC,qBAAQ,CAACC,EAAE,CAAC,EAAE;IAC7CJ,OAAO,CAACK,OAAO,GACb,IAAIC,sBAAe,CAAC,iDAAiD,CACvE,CAAC;IACD,OAAO,IAAI;EACb;EAEA,MAAMC,iBAAiB,GAAG,IAAAC,qBAAa,EAAC,CAAC;EACzC,MAAMC,QAAQ,GAAGN,qBAAQ,CAACC,EAAuB;EACjD,MAAMM,eAAe,GAAG,IAAAC,mBAAW,EAAC,CAAC;EACrC,MAAMC,WAAW,GAAG,IAAAC,sBAAc,EAAC,CAAC;EACpC,MAAMC,OAAO,GAAG,IAAAC,kBAAU,EAAC,CAAC;EAE5B,IAAI,CAACR,iBAAiB,EAAE;IACtBP,OAAO,CAACK,OAAO,GAAG,IAAIC,sBAAe,CAAC,2BAA2B,CAAC,CAAC;IACnE,OAAO,IAAI;EACb;EAEA,MAAMU,eAAe,GAAG,IAAAC,0BAAkB,EAAC,CAAC;EAE5C,OAAO,IAAAC,gCAAe,EAAC;IACrBC,MAAM,EAAEnB,OAAO,CAACmB,MAAM;IACtBC,MAAM,EAAE;MACNC,QAAQ,EAAEX,eAAe;MACzBY,UAAU,EAAEf,iBAAiB;MAC7BE,QAAQ;MACRG,WAAW;MACXE,OAAO;MACPE;IACF,CAAC;IACDO,cAAc,EAAEvB,OAAO,CAACuB,cAAc;IACtClB,OAAO,EAAEL,OAAO,CAACK,OAAO;IACxBmB,cAAc,EAAExB,OAAO,CAACwB;EAC1B,CAAC,CAAC,CAACC,IAAI,CAAEC,UAAU,IAAK;IACtB,IAAI,CAACA,UAAU,EAAE;MACf,OAAO,IAAI;IACb;IAEA,OAAO;MACL,GAAGA,UAAU;MACbC,YAAY,EAAE,MAAAA,CAAA,KAAY;QACxB,OAAO,IAAAA,oBAAY,EAAC;UAClBN,QAAQ,EAAEK,UAAU,CAACE,EAAE;UACvBC,OAAO,EAAEH,UAAU,CAACG,OAAO;UAC3BC,QAAQ,EAAEJ,UAAU,CAACI,QAAQ;UAC7BC,MAAM,EAAEL,UAAU,CAACK;QACrB,CAAC,CAAC;MACJ;IACF,CAAC;EACH,CAAC,CAAC;AACJ;AAYO,MAAMC,eAAe,GAC1BA,CAACC,OAAe,EAAEjC,OAA+B,KAChDoB,MAA0B,IAAK;EAC9B,QAAQpB,OAAO,CAACkC,cAAc;IAC5B,KAAK,aAAa;MAAE;QAClB,IAAI,CAACd,MAAM,CAACJ,eAAe,EAAE;UAC3B,MAAM,IAAIV,sBAAe,CAAC,8BAA8B,CAAC;QAC3D;QACA,OAAO,GAAG2B,OAAO,gBAAgBb,MAAM,CAACX,QAAQ,IAAIW,MAAM,CAACJ,eAAe,IAAII,MAAM,CAACN,OAAO,IAAIM,MAAM,CAACR,WAAW,IAAIQ,MAAM,CAACC,QAAQ,EAAE;MACzI;IACA,KAAK,YAAY;MAAE;QACjB,OAAO,GAAGY,OAAO,gBAAgBb,MAAM,CAACX,QAAQ,IAAIW,MAAM,CAACE,UAAU,IAAIF,MAAM,CAACN,OAAO,IAAIM,MAAM,CAACR,WAAW,IAAIQ,MAAM,CAACC,QAAQ,EAAE;MACpI;IACA;MACE,OAAOY,OAAO;EAClB;AACF,CAAC;AAACE,OAAA,CAAAH,eAAA,GAAAA,eAAA","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_error","_native","checkForUpdate","options","__DEV__","includes","Platform","OS","onError","HotUpdaterError","currentAppVersion","getAppVersion","platform","currentBundleId","getBundleId","minBundleId","getMinBundleId","channel","getChannel","fingerprintHash","getFingerprintHash","resolver","checkUpdate","updateInfo","appVersion","bundleId","updateStrategy","requestHeaders","requestTimeout","error","updateBundle","id","fileUrl","fileHash","status"],"sourceRoot":"../../src","sources":["checkForUpdate.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AACA,IAAAE,OAAA,GAAAF,OAAA;AAoCA;;AAKO,eAAeG,cAAcA,CAClCC,OAAsC,EACA;EACtC,IAAIC,OAAO,EAAE;IACX,OAAO,IAAI;EACb;EAEA,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAACC,QAAQ,CAACC,qBAAQ,CAACC,EAAE,CAAC,EAAE;IAC7CJ,OAAO,CAACK,OAAO,GACb,IAAIC,sBAAe,CAAC,iDAAiD,CACvE,CAAC;IACD,OAAO,IAAI;EACb;EAEA,MAAMC,iBAAiB,GAAG,IAAAC,qBAAa,EAAC,CAAC;EACzC,MAAMC,QAAQ,GAAGN,qBAAQ,CAACC,EAAuB;EACjD,MAAMM,eAAe,GAAG,IAAAC,mBAAW,EAAC,CAAC;EACrC,MAAMC,WAAW,GAAG,IAAAC,sBAAc,EAAC,CAAC;EACpC,MAAMC,OAAO,GAAG,IAAAC,kBAAU,EAAC,CAAC;EAE5B,IAAI,CAACR,iBAAiB,EAAE;IACtBP,OAAO,CAACK,OAAO,GAAG,IAAIC,sBAAe,CAAC,2BAA2B,CAAC,CAAC;IACnE,OAAO,IAAI;EACb;EAEA,MAAMU,eAAe,GAAG,IAAAC,0BAAkB,EAAC,CAAC;EAE5C,IAAI,CAACjB,OAAO,CAACkB,QAAQ,EAAEC,WAAW,EAAE;IAClCnB,OAAO,CAACK,OAAO,GACb,IAAIC,sBAAe,CAAC,yCAAyC,CAC/D,CAAC;IACD,OAAO,IAAI;EACb;EAEA,IAAIc,UAAgC,GAAG,IAAI;EAE3C,IAAI;IACFA,UAAU,GAAG,MAAMpB,OAAO,CAACkB,QAAQ,CAACC,WAAW,CAAC;MAC9CV,QAAQ;MACRY,UAAU,EAAEd,iBAAiB;MAC7Be,QAAQ,EAAEZ,eAAe;MACzBE,WAAW;MACXE,OAAO;MACPS,cAAc,EAAEvB,OAAO,CAACuB,cAAc;MACtCP,eAAe;MACfQ,cAAc,EAAExB,OAAO,CAACwB,cAAc;MACtCC,cAAc,EAAEzB,OAAO,CAACyB;IAC1B,CAAC,CAAC;EACJ,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd1B,OAAO,CAACK,OAAO,GAAGqB,KAAc,CAAC;IACjC,OAAO,IAAI;EACb;EAEA,IAAI,CAACN,UAAU,EAAE;IACf,OAAO,IAAI;EACb;EAEA,OAAO;IACL,GAAGA,UAAU;IACbO,YAAY,EAAE,MAAAA,CAAA,KAAY;MACxB,OAAO,IAAAA,oBAAY,EAAC;QAClBL,QAAQ,EAAEF,UAAU,CAACQ,EAAE;QACvBC,OAAO,EAAET,UAAU,CAACS,OAAO;QAC3BC,QAAQ,EAAEV,UAAU,CAACU,QAAQ;QAC7BC,MAAM,EAAEX,UAAU,CAACW;MACrB,CAAC,CAAC;IACJ;EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/error.js

@@ -3,7 +3,51 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.HotUpdaterError = void 0;
+exports.HotUpdaterErrorCode = exports.HotUpdaterError = void 0;
+exports.isHotUpdaterError = isHotUpdaterError;
+/**
+ * Hot Updater Error Codes
+ *
+ * This file defines all possible error codes that can be thrown by the native
+ * updateBundle function. These error codes are shared across iOS and Android
+ * implementations to ensure consistent error handling.
+ *
+ * Error Classification:
+ * - Parameter Validation: Invalid or missing function parameters
+ * - Bundle Storage: Errors during download, extraction, and storage
+ * - Signature Verification: Cryptographic verification failures (collapsed to a single public code)
+ * - Internal: Platform-specific or unexpected errors
+ *
+ * Retryability:
+ * - Retryable: DOWNLOAD_FAILED, INCOMPLETE_DOWNLOAD
+ * - Non-retryable: Most validation and verification errors
+ */
+let HotUpdaterErrorCode = exports.HotUpdaterErrorCode = /*#__PURE__*/function (HotUpdaterErrorCode) {
+  HotUpdaterErrorCode["MISSING_BUNDLE_ID"] = "MISSING_BUNDLE_ID";
+  HotUpdaterErrorCode["INVALID_FILE_URL"] = "INVALID_FILE_URL";
+  HotUpdaterErrorCode["DIRECTORY_CREATION_FAILED"] = "DIRECTORY_CREATION_FAILED";
+  HotUpdaterErrorCode["DOWNLOAD_FAILED"] = "DOWNLOAD_FAILED";
+  HotUpdaterErrorCode["INCOMPLETE_DOWNLOAD"] = "INCOMPLETE_DOWNLOAD";
+  HotUpdaterErrorCode["EXTRACTION_FORMAT_ERROR"] = "EXTRACTION_FORMAT_ERROR";
+  HotUpdaterErrorCode["INVALID_BUNDLE"] = "INVALID_BUNDLE";
+  HotUpdaterErrorCode["INSUFFICIENT_DISK_SPACE"] = "INSUFFICIENT_DISK_SPACE";
+  HotUpdaterErrorCode["SIGNATURE_VERIFICATION_FAILED"] = "SIGNATURE_VERIFICATION_FAILED";
+  HotUpdaterErrorCode["MOVE_OPERATION_FAILED"] = "MOVE_OPERATION_FAILED";
+  HotUpdaterErrorCode["BUNDLE_IN_CRASHED_HISTORY"] = "BUNDLE_IN_CRASHED_HISTORY";
+  HotUpdaterErrorCode["SELF_DEALLOCATED"] = "SELF_DEALLOCATED";
+  HotUpdaterErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+  return HotUpdaterErrorCode;
+}({});
+/**
+ * Type guard to check if an error is a HotUpdaterError
+ */
+function isHotUpdaterError(error) {
+  return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" && Object.values(HotUpdaterErrorCode).includes(error.code);
+}
+
+/**
+ * Base error class for Hot Updater
+ */
 class HotUpdaterError extends Error {
   constructor(message) {
     super(message);

package/lib/commonjs/error.js.map

@@ -1 +1 @@
-{"version":3,"names":["HotUpdaterError","Error","constructor","message","name","exports"],"sourceRoot":"../../src","sources":["error.ts"],"mappings":";;;;;;AAAO,MAAMA,eAAe,SAASC,KAAK,CAAC;EACzCC,WAAWA,CAACC,OAAe,EAAE;IAC3B,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,iBAAiB;EAC/B;AACF;AAACC,OAAA,CAAAL,eAAA,GAAAA,eAAA","ignoreList":[]}
+{"version":3,"names":["HotUpdaterErrorCode","exports","isHotUpdaterError","error","code","Object","values","includes","HotUpdaterError","Error","constructor","message","name"],"sourceRoot":"../../src","sources":["error.ts"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAhBA,IAkBYA,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,0BAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAA,OAAnBA,mBAAmB;AAAA;AAmH/B;AACA;AACA;AACO,SAASE,iBAAiBA,CAC/BC,KAAc,EAC2C;EACzD,OACE,OAAOA,KAAK,KAAK,QAAQ,IACzBA,KAAK,KAAK,IAAI,IACd,MAAM,IAAIA,KAAK,IACf,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ,IAC9BC,MAAM,CAACC,MAAM,CAACN,mBAAmB,CAAC,CAACO,QAAQ,CACzCJ,KAAK,CAACC,IACR,CAAC;AAEL;;AAEA;AACA;AACA;AACO,MAAMI,eAAe,SAASC,KAAK,CAAC;EACzCC,WAAWA,CAACC,OAAe,EAAE;IAC3B,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,iBAAiB;EAC/B;AACF;AAACX,OAAA,CAAAO,eAAA,GAAAA,eAAA","ignoreList":[]}

package/lib/commonjs/fetchUpdateInfo.js

@@ -4,60 +4,22 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.fetchUpdateInfo = void 0;
-function buildRequestHeaders(params, requestHeaders) {
-  const updateStrategy = params.fingerprintHash ? "fingerprint" : "appVersion";
-  return {
-    "Content-Type": "application/json",
-    "x-app-platform": params.platform,
-    "x-bundle-id": params.bundleId,
-    ...(updateStrategy === "fingerprint" ? {
-      "x-fingerprint-hash": params.fingerprintHash
-    } : {
-      "x-app-version": params.appVersion
-    }),
-    ...(params.minBundleId && {
-      "x-min-bundle-id": params.minBundleId
-    }),
-    ...(params.channel && {
-      "x-channel": params.channel
-    }),
-    ...requestHeaders
-  };
-}
-async function resolveSource(source, params) {
-  if (typeof source !== "function") {
-    return {
-      url: source
-    };
-  }
-  const result = source(params);
-  if (typeof result === "string") {
-    return {
-      url: result
-    };
-  }
-  return {
-    info: await result
-  };
-}
 const fetchUpdateInfo = async ({
-  source,
-  params,
+  url,
   requestHeaders,
   onError,
   requestTimeout = 5000
 }) => {
   try {
-    const resolvedSource = await resolveSource(source, params);
-    if ("info" in resolvedSource) {
-      return resolvedSource.info;
-    }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => {
       controller.abort();
     }, requestTimeout);
-    const headers = buildRequestHeaders(params, requestHeaders);
-    const response = await fetch(resolvedSource.url, {
+    const headers = {
+      "Content-Type": "application/json",
+      ...requestHeaders
+    };
+    const response = await fetch(url, {
       signal: controller.signal,
       headers
     });
@@ -67,7 +29,7 @@ const fetchUpdateInfo = async ({
     }
     return response.json();
   } catch (error) {
-    if (error.name === "AbortError") {
+    if (error instanceof Error && error.name === "AbortError") {
       onError?.(new Error("Request timed out"));
     } else {
       onError?.(error);