@hot-updater/react-native 0.23.0 → 0.24.0

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/checkForUpdate.js

@@ -4,11 +4,28 @@ 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 baseURL for use within index.ts
+
+// Internal function to build update URL (not exported)
+function buildUpdateUrl(baseURL, updateStrategy, params) {
+  switch (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}`;
+      }
+  }
+}
 async function checkForUpdate(options) {
   if (__DEV__) {
     return null;
@@ -17,6 +34,10 @@ async function checkForUpdate(options) {
     options.onError?.(new _error.HotUpdaterError("HotUpdater is only supported on iOS and Android"));
     return null;
   }
+  if (!options.baseURL || !options.updateStrategy) {
+    options.onError?.(new _error.HotUpdaterError("'baseURL' and 'updateStrategy' are required"));
+    return null;
+  }
   const currentAppVersion = (0, _native.getAppVersion)();
   const platform = _reactNative.Platform.OS;
   const currentBundleId = (0, _native.getBundleId)();
@@ -27,16 +48,16 @@ async function checkForUpdate(options) {
     return null;
   }
   const fingerprintHash = (0, _native.getFingerprintHash)();
+  const url = buildUpdateUrl(options.baseURL, options.updateStrategy, {
+    platform,
+    appVersion: currentAppVersion,
+    fingerprintHash: fingerprintHash ?? null,
+    channel,
+    minBundleId,
+    bundleId: currentBundleId
+  });
   return (0, _fetchUpdateInfo.fetchUpdateInfo)({
-    source: options.source,
-    params: {
-      bundleId: currentBundleId,
-      appVersion: currentAppVersion,
-      platform,
-      minBundleId,
-      channel,
-      fingerprintHash
-    },
+    url,
     requestHeaders: options.requestHeaders,
     onError: options.onError,
     requestTimeout: options.requestTimeout
@@ -57,22 +78,4 @@ async function checkForUpdate(options) {
     };
   });
 }
-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","_fetchUpdateInfo","_native","buildUpdateUrl","baseURL","updateStrategy","params","fingerprintHash","HotUpdaterError","platform","channel","minBundleId","bundleId","appVersion","checkForUpdate","options","__DEV__","includes","Platform","OS","onError","currentAppVersion","getAppVersion","currentBundleId","getBundleId","getMinBundleId","getChannel","getFingerprintHash","url","fetchUpdateInfo","requestHeaders","requestTimeout","then","updateInfo","updateBundle","id","fileUrl","fileHash","status"],"sourceRoot":"../../src","sources":["checkForUpdate.ts"],"mappings":"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","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);

package/lib/commonjs/fetchUpdateInfo.js.map

@@ -1 +1 @@
-{"version":3,"names":["buildRequestHeaders","params","requestHeaders","updateStrategy","fingerprintHash","platform","bundleId","appVersion","minBundleId","channel","resolveSource","source","url","result","info","fetchUpdateInfo","onError","requestTimeout","resolvedSource","controller","AbortController","timeoutId","setTimeout","abort","headers","response","fetch","signal","clearTimeout","status","Error","statusText","json","error","name","exports"],"sourceRoot":"../../src","sources":["fetchUpdateInfo.ts"],"mappings":";;;;;;AAWA,SAASA,mBAAmBA,CAC1BC,MAA0B,EAC1BC,cAAuC,EACf;EACxB,MAAMC,cAA8B,GAAGF,MAAM,CAACG,eAAe,GACzD,aAAa,GACb,YAAY;EAEhB,OAAO;IACL,cAAc,EAAE,kBAAkB;IAClC,gBAAgB,EAAEH,MAAM,CAACI,QAAQ;IACjC,aAAa,EAAEJ,MAAM,CAACK,QAAQ;IAC9B,IAAIH,cAAc,KAAK,aAAa,GAChC;MAAE,oBAAoB,EAAEF,MAAM,CAACG;IAAiB,CAAC,GACjD;MAAE,eAAe,EAAEH,MAAM,CAACM;IAAW,CAAC,CAAC;IAC3C,IAAIN,MAAM,CAACO,WAAW,IAAI;MAAE,iBAAiB,EAAEP,MAAM,CAACO;IAAY,CAAC,CAAC;IACpE,IAAIP,MAAM,CAACQ,OAAO,IAAI;MAAE,WAAW,EAAER,MAAM,CAACQ;IAAQ,CAAC,CAAC;IACtD,GAAGP;EACL,CAAC;AACH;AAEA,eAAeQ,aAAaA,CAC1BC,MAAoB,EACpBV,MAA0B,EACiC;EAC3D,IAAI,OAAOU,MAAM,KAAK,UAAU,EAAE;IAChC,OAAO;MAAEC,GAAG,EAAED;IAAO,CAAC;EACxB;EACA,MAAME,MAAM,GAAGF,MAAM,CAACV,MAAM,CAAC;EAC7B,IAAI,OAAOY,MAAM,KAAK,QAAQ,EAAE;IAC9B,OAAO;MAAED,GAAG,EAAEC;IAAO,CAAC;EACxB;EACA,OAAO;IAAEC,IAAI,EAAE,MAAMD;EAAO,CAAC;AAC/B;AAEO,MAAME,eAAe,GAAG,MAAAA,CAAO;EACpCJ,MAAM;EACNV,MAAM;EACNC,cAAc;EACdc,OAAO;EACPC,cAAc,GAAG;AAOnB,CAAC,KAAoC;EACnC,IAAI;IACF,MAAMC,cAAc,GAAG,MAAMR,aAAa,CAACC,MAAM,EAAEV,MAAM,CAAC;IAC1D,IAAI,MAAM,IAAIiB,cAAc,EAAE;MAC5B,OAAOA,cAAc,CAACJ,IAAI;IAC5B;IAEA,MAAMK,UAAU,GAAG,IAAIC,eAAe,CAAC,CAAC;IACxC,MAAMC,SAAS,GAAGC,UAAU,CAAC,MAAM;MACjCH,UAAU,CAACI,KAAK,CAAC,CAAC;IACpB,CAAC,EAAEN,cAAc,CAAC;IAElB,MAAMO,OAAO,GAAGxB,mBAAmB,CAACC,MAAM,EAAEC,cAAc,CAAC;IAE3D,MAAMuB,QAAQ,GAAG,MAAMC,KAAK,CAACR,cAAc,CAACN,GAAG,EAAE;MAC/Ce,MAAM,EAAER,UAAU,CAACQ,MAAM;MACzBH;IACF,CAAC,CAAC;IACFI,YAAY,CAACP,SAAS,CAAC;IAEvB,IAAII,QAAQ,CAACI,MAAM,KAAK,GAAG,EAAE;MAC3B,MAAM,IAAIC,KAAK,CAACL,QAAQ,CAACM,UAAU,CAAC;IACtC;IACA,OAAON,QAAQ,CAACO,IAAI,CAAC,CAAC;EACxB,CAAC,CAAC,OAAOC,KAAU,EAAE;IACnB,IAAIA,KAAK,CAACC,IAAI,KAAK,YAAY,EAAE;MAC/BlB,OAAO,GAAG,IAAIc,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC3C,CAAC,MAAM;MACLd,OAAO,GAAGiB,KAAc,CAAC;IAC3B;IACA,OAAO,IAAI;EACb;AACF,CAAC;AAACE,OAAA,CAAApB,eAAA,GAAAA,eAAA","ignoreList":[]}
+{"version":3,"names":["fetchUpdateInfo","url","requestHeaders","onError","requestTimeout","controller","AbortController","timeoutId","setTimeout","abort","headers","response","fetch","signal","clearTimeout","status","Error","statusText","json","error","name","exports"],"sourceRoot":"../../src","sources":["fetchUpdateInfo.ts"],"mappings":";;;;;;AAEO,MAAMA,eAAe,GAAG,MAAAA,CAAO;EACpCC,GAAG;EACHC,cAAc;EACdC,OAAO;EACPC,cAAc,GAAG;AAMnB,CAAC,KAAoC;EACnC,IAAI;IACF,MAAMC,UAAU,GAAG,IAAIC,eAAe,CAAC,CAAC;IACxC,MAAMC,SAAS,GAAGC,UAAU,CAAC,MAAM;MACjCH,UAAU,CAACI,KAAK,CAAC,CAAC;IACpB,CAAC,EAAEL,cAAc,CAAC;IAElB,MAAMM,OAAO,GAAG;MACd,cAAc,EAAE,kBAAkB;MAClC,GAAGR;IACL,CAAC;IAED,MAAMS,QAAQ,GAAG,MAAMC,KAAK,CAACX,GAAG,EAAE;MAChCY,MAAM,EAAER,UAAU,CAACQ,MAAM;MACzBH;IACF,CAAC,CAAC;IACFI,YAAY,CAACP,SAAS,CAAC;IAEvB,IAAII,QAAQ,CAACI,MAAM,KAAK,GAAG,EAAE;MAC3B,MAAM,IAAIC,KAAK,CAACL,QAAQ,CAACM,UAAU,CAAC;IACtC;IACA,OAAON,QAAQ,CAACO,IAAI,CAAC,CAAC;EACxB,CAAC,CAAC,OAAOC,KAAc,EAAE;IACvB,IAAIA,KAAK,YAAYH,KAAK,IAAIG,KAAK,CAACC,IAAI,KAAK,YAAY,EAAE;MACzDjB,OAAO,GAAG,IAAIa,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC3C,CAAC,MAAM;MACLb,OAAO,GAAGgB,KAAc,CAAC;IAC3B;IACA,OAAO,IAAI;EACb;AACF,CAAC;AAACE,OAAA,CAAArB,eAAA,GAAAA,eAAA","ignoreList":[]}