@hot-updater/react-native 0.36.6 → 1.0.0-rc.0

package/ios/HotUpdater/Internal/HotUpdaterImpl.swift

@@ -17,6 +17,9 @@ private func hotUpdaterUpdateSignalLaunchStateSymbol(
 @_silgen_name("HotUpdaterPerformRecoveryReload")
 private func hotUpdaterPerformRecoveryReloadSymbol() -> ObjCBool
 
+@_silgen_name("HotUpdaterCopyMinBundleId")
+private func hotUpdaterCopyMinBundleIdSymbol() -> UnsafeMutableRawPointer
+
 private func hotUpdaterInstallSignalHandlers(_ crashMarkerPath: String) {
     hotUpdaterInstallSignalHandlersSymbol(crashMarkerPath as NSString)
 }
@@ -29,11 +32,18 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
     return hotUpdaterPerformRecoveryReloadSymbol().boolValue
 }
 
+private func hotUpdaterGetMinBundleId() -> String {
+    Unmanaged<NSString>
+        .fromOpaque(hotUpdaterCopyMinBundleIdSymbol())
+        .takeRetainedValue() as String
+}
+
 @objcMembers public class HotUpdaterImpl: NSObject {
     private let bundleStorage: BundleStorageService
     private let preferences: PreferencesService
     private let cohortService: CohortService
     private let recoveryManager: HotUpdaterRecoveryManager
+    private let releaseCatalogCache: ReleaseCatalogCacheService
     private var currentLaunchSelection: LaunchSelection?
 
     private static let DEFAULT_CHANNEL = "production"
@@ -56,11 +66,17 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
             downloadService: downloadService,
             decompressService: decompressService,
             preferences: preferences,
-            isolationKey: isolationKey
+            isolationKey: isolationKey,
+            builtInBundleIdProvider: { HotUpdaterImpl.minBundleId() }
         )
         let recoveryManager = HotUpdaterRecoveryManager.shared
 
-        self.init(bundleStorage: bundleStorage, preferences: preferences, recoveryManager: recoveryManager)
+        self.init(
+            bundleStorage: bundleStorage,
+            preferences: preferences,
+            recoveryManager: recoveryManager,
+            releaseCatalogCache: ReleaseCatalogCacheService()
+        )
     }
 
     /**
@@ -68,11 +84,17 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
      * @param bundleStorage Service for bundle storage operations
      * @param preferences Service for preference storage
      */
-    internal init(bundleStorage: BundleStorageService, preferences: PreferencesService, recoveryManager: HotUpdaterRecoveryManager) {
+    internal init(
+        bundleStorage: BundleStorageService,
+        preferences: PreferencesService,
+        recoveryManager: HotUpdaterRecoveryManager,
+        releaseCatalogCache: ReleaseCatalogCacheService = ReleaseCatalogCacheService()
+    ) {
         self.bundleStorage = bundleStorage
         self.preferences = preferences
         self.cohortService = CohortService()
         self.recoveryManager = recoveryManager
+        self.releaseCatalogCache = releaseCatalogCache
         super.init()
 
         // Configure preferences with isolation key
@@ -98,6 +120,10 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
         }
         return Bundle.main.object(forInfoDictionaryKey: "HOT_UPDATER_CHANNEL") as? String ?? Self.DEFAULT_CHANNEL
     }
+
+    public static func minBundleId() -> String {
+        hotUpdaterGetMinBundleId()
+    }
     
     /**
      * Gets the complete isolation key for preferences storage.
@@ -136,6 +162,11 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
      * @return The channel name or nil if not set
      */
     public func getChannel() -> String {
+        if let activeSelection = bundleStorage.getActiveUpdateState()["activeSelection"] as? [String: Any],
+           let channel = activeSelection["channel"] as? String,
+           !channel.isEmpty {
+            return channel
+        }
         if let override = HotUpdaterConfig.shared.channel, !override.isEmpty {
             return override
         }
@@ -282,6 +313,16 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
                     patch: patch
                 )
             }
+            let selection = (data["selection"] as? [String: Any]).flatMap(Self.parseSelection)
+            if let selection, !bundleStorage.stageReleaseSelection(selection) {
+                let error = NSError(
+                    domain: "HotUpdater",
+                    code: 0,
+                    userInfo: [NSLocalizedDescriptionKey: "Release catalog selection is stale"]
+                )
+                reject("UNKNOWN_ERROR", error.localizedDescription, error)
+                return
+            }
 
             // Extract progress callback if provided
             let progressCallback = data["progressCallback"] as? RCTResponseSenderBlock
@@ -345,6 +386,122 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
         }
     }
 
+    private static func parseSelection(_ data: [String: Any]) -> PersistedSelection? {
+        guard let kind = data["kind"] as? String,
+              let bundleId = data["bundleId"] as? String,
+              let channel = data["channel"] as? String else {
+            return nil
+        }
+        return PersistedSelection(
+            kind: kind,
+            releaseId: data["releaseId"] as? String,
+            bundleId: bundleId,
+            catalogId: data["catalogId"] as? String,
+            scopeKey: data["scopeKey"] as? String,
+            generation: (data["generation"] as? NSNumber)?.int64Value,
+            catalogHash: data["catalogHash"] as? String,
+            channel: channel,
+            selectionContextHash: data["selectionContextHash"] as? String
+        )
+    }
+
+    public func acceptReleaseCatalog(_ params: NSDictionary?) -> Bool {
+        guard let data = params as? [String: Any],
+              let catalogId = data["catalogId"] as? String,
+              let scopeKey = data["scopeKey"] as? String,
+              let generation = data["generation"] as? NSNumber,
+              let catalogHash = data["catalogHash"] as? String,
+              let channel = data["channel"] as? String,
+              let selectionContextHash = data["selectionContextHash"] as? String else {
+            return false
+        }
+        return bundleStorage.acceptReleaseCatalog(
+            catalogId: catalogId,
+            scopeKey: scopeKey,
+            generation: generation.int64Value,
+            catalogHash: catalogHash,
+            channel: channel,
+            selectionContextHash: selectionContextHash
+        )
+    }
+
+    public func getActiveUpdateState() -> [String: Any] {
+        bundleStorage.getActiveUpdateState()
+    }
+
+    public func getReleaseCatalogCache(
+        _ partition: String,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter _: @escaping RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.global(qos: .utility).async {
+            guard let value = self.releaseCatalogCache.get(partition: partition) else {
+                resolve(NSNull())
+                return
+            }
+            resolve(value)
+        }
+    }
+
+    public func setReleaseCatalogCache(
+        _ partition: String,
+        payload: String,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter _: @escaping RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.global(qos: .utility).async {
+            resolve(self.releaseCatalogCache.set(partition: partition, value: payload))
+        }
+    }
+
+    public func removeReleaseCatalogCache(
+        _ partition: String,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter _: @escaping RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.global(qos: .utility).async {
+            resolve(self.releaseCatalogCache.remove(partition: partition))
+        }
+    }
+
+    public func isReleaseSelectionCurrent(_ params: NSDictionary?) -> Bool {
+        guard let data = params as? [String: Any],
+              let catalogId = data["catalogId"] as? String,
+              let scopeKey = data["scopeKey"] as? String,
+              let generation = data["generation"] as? NSNumber,
+              let catalogHash = data["catalogHash"] as? String,
+              let channel = data["channel"] as? String,
+              let selectionContextHash = data["selectionContextHash"] as? String else {
+            return false
+        }
+        return bundleStorage.isReleaseSelectionCurrent(
+            catalogId: catalogId,
+            scopeKey: scopeKey,
+            generation: generation.int64Value,
+            catalogHash: catalogHash,
+            channel: channel,
+            selectionContextHash: selectionContextHash
+        )
+    }
+
+    public func commitReleaseSelection(
+        _ params: NSDictionary?,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let data = params?["selection"] as? [String: Any],
+              let selection = Self.parseSelection(data) else {
+            let error = NSError(
+                domain: "HotUpdater",
+                code: 0,
+                userInfo: [NSLocalizedDescriptionKey: "Invalid Release selection"]
+            )
+            reject("INVALID_SELECTION", error.localizedDescription, error)
+            return
+        }
+        resolve(bundleStorage.commitReleaseSelection(selection))
+    }
+
     /**
      * 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.
@@ -387,10 +544,6 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
 
     // MARK: - Rollback Support
 
-    /**
-     * Returns the native launch report for the current process.
-     * This is read-only; startup success and rollback are finalized before JS reads it.
-     */
     public func notifyAppReady() -> [String: Any] {
         return bundleStorage.notifyAppReady()
     }
@@ -411,6 +564,22 @@ private func hotUpdaterPerformRecoveryReload() -> Bool {
         return bundleStorage.clearCrashHistory()
     }
 
+    public func getInstallId() -> String {
+        return bundleStorage.getInstallId()
+    }
+
+    public func getUserId() -> String? {
+        return bundleStorage.getUserId()
+    }
+
+    public func getUsername() -> String? {
+        return bundleStorage.getUsername()
+    }
+
+    public func setUser(_ userId: String?, username: String?) {
+        bundleStorage.setUser(userId: userId, username: username)
+    }
+
     /**
      * Gets the base URL for the current active bundle directory.
      * Returns the file:// URL to the bundle directory with trailing slash.

package/ios/HotUpdater/Internal/ReleaseCatalogCacheService.swift

@@ -0,0 +1,213 @@
+import CryptoKit
+import Foundation
+
+final class ReleaseCatalogCacheService {
+    private static let maxCompiledCatalogBytes = 256 * 1024
+    private static let maxWireEnvelopeBytes = 4 * 1024
+    private static let maxETagBytes = 1024
+    private static let cacheFormatBytes = 3
+    static let defaultMaxEntries = 8
+    static let defaultMaxEntryBytes =
+        maxCompiledCatalogBytes + maxWireEnvelopeBytes + maxETagBytes + cacheFormatBytes
+    static let defaultMaxTotalBytes = defaultMaxEntries * (defaultMaxEntryBytes + 65)
+
+    private let fileManager: FileManager
+    private let rootDirectory: URL
+    private let maxEntries: Int
+    private let maxEntryBytes: Int
+    private let maxTotalBytes: Int
+    private let atomicWriter: (Data, URL) throws -> Void
+    private let lock = NSLock()
+
+    init(
+        rootDirectory: URL = ReleaseCatalogCacheService.defaultRootDirectory(),
+        fileManager: FileManager = .default,
+        maxEntries: Int = defaultMaxEntries,
+        maxEntryBytes: Int = defaultMaxEntryBytes,
+        maxTotalBytes: Int = defaultMaxTotalBytes,
+        atomicWriter: @escaping (Data, URL) throws -> Void = ReleaseCatalogCacheService.writeAtomically
+    ) {
+        self.rootDirectory = rootDirectory
+        self.fileManager = fileManager
+        self.maxEntries = maxEntries
+        self.maxEntryBytes = maxEntryBytes
+        self.maxTotalBytes = maxTotalBytes
+        self.atomicWriter = atomicWriter
+        recoverInterruptedWrites()
+        trim()
+    }
+
+    func get(partition: String) -> String? {
+        lock.lock()
+        defer { lock.unlock() }
+
+        let file = entryURL(partition: partition)
+        guard let attributes = try? fileManager.attributesOfItem(atPath: file.path),
+              let size = attributes[.size] as? NSNumber,
+              size.intValue <= maxEntryBytes + 65,
+              let stored = try? Data(contentsOf: file),
+              let separator = stored.firstIndex(of: 0x0a),
+              separator == 64 else {
+            try? fileManager.removeItem(at: file)
+            return nil
+        }
+
+        let expectedDigest = String(data: stored[..<separator], encoding: .ascii)
+        let payload = stored[stored.index(after: separator)...]
+        guard payload.count <= maxEntryBytes,
+              expectedDigest == sha256(Data(payload)),
+              let value = String(data: payload, encoding: .utf8) else {
+            try? fileManager.removeItem(at: file)
+            return nil
+        }
+
+        try? fileManager.setAttributes(
+            [.modificationDate: Date()],
+            ofItemAtPath: file.path
+        )
+        return value
+    }
+
+    @discardableResult
+    func set(partition: String, value: String) -> Bool {
+        guard let payload = value.data(using: .utf8), payload.count <= maxEntryBytes else {
+            return false
+        }
+
+        lock.lock()
+        defer { lock.unlock() }
+
+        do {
+            try fileManager.createDirectory(
+                at: rootDirectory,
+                withIntermediateDirectories: true
+            )
+            var cacheDirectory = rootDirectory
+            var resourceValues = URLResourceValues()
+            resourceValues.isExcludedFromBackup = true
+            try? cacheDirectory.setResourceValues(resourceValues)
+            var stored = Data(sha256(payload).utf8)
+            stored.append(0x0a)
+            stored.append(payload)
+            let destination = entryURL(partition: partition)
+            try atomicWriter(stored, destination)
+            try? fileManager.setAttributes(
+                [.modificationDate: Date()],
+                ofItemAtPath: destination.path
+            )
+            trim()
+            return true
+        } catch {
+            return false
+        }
+    }
+
+    @discardableResult
+    func remove(partition: String) -> Bool {
+        lock.lock()
+        defer { lock.unlock() }
+
+        let file = entryURL(partition: partition)
+        guard fileManager.fileExists(atPath: file.path) else { return true }
+        do {
+            try fileManager.removeItem(at: file)
+            return true
+        } catch {
+            return false
+        }
+    }
+
+    private func entryURL(partition: String) -> URL {
+        rootDirectory
+            .appendingPathComponent(sha256(Data(partition.utf8)))
+            .appendingPathExtension("catalog")
+    }
+
+    private func recoverInterruptedWrites() {
+        guard let entries = try? fileManager.contentsOfDirectory(
+            at: rootDirectory,
+            includingPropertiesForKeys: nil,
+            options: []
+        ) else {
+            return
+        }
+        for entry in entries
+        where entry.lastPathComponent.hasPrefix(".catalog-") && entry.pathExtension == "tmp" {
+            try? fileManager.removeItem(at: entry)
+        }
+    }
+
+    private func trim() {
+        let keys: Set<URLResourceKey> = [
+            .contentModificationDateKey,
+            .fileSizeKey,
+            .isRegularFileKey,
+        ]
+        let entries = (try? fileManager.contentsOfDirectory(
+            at: rootDirectory,
+            includingPropertiesForKeys: Array(keys),
+            options: [.skipsHiddenFiles]
+        ))?
+            .filter { url in
+                guard url.pathExtension == "catalog",
+                      let values = try? url.resourceValues(forKeys: keys) else {
+                    return false
+                }
+                return values.isRegularFile == true
+            }
+            .sorted { first, second in
+                let firstDate = (try? first.resourceValues(forKeys: keys))?.contentModificationDate ?? .distantPast
+                let secondDate = (try? second.resourceValues(forKeys: keys))?.contentModificationDate ?? .distantPast
+                return firstDate > secondDate
+            } ?? []
+
+        var retainedBytes = 0
+        for (index, entry) in entries.enumerated() {
+            let size = (try? entry.resourceValues(forKeys: keys))?.fileSize ?? 0
+            retainedBytes += size
+            if index >= maxEntries || retainedBytes > maxTotalBytes {
+                try? fileManager.removeItem(at: entry)
+            }
+        }
+    }
+
+    private func sha256(_ value: Data) -> String {
+        SHA256.hash(data: value).map { String(format: "%02x", $0) }.joined()
+    }
+
+    private static func writeAtomically(_ data: Data, to destination: URL) throws {
+        let temporary = destination
+            .deletingLastPathComponent()
+            .appendingPathComponent(".catalog-\(UUID().uuidString).tmp")
+        do {
+            try data.write(to: temporary, options: .withoutOverwriting)
+            let handle = try FileHandle(forWritingTo: temporary)
+            try handle.synchronize()
+            try handle.close()
+
+            if FileManager.default.fileExists(atPath: destination.path) {
+                _ = try FileManager.default.replaceItemAt(
+                    destination,
+                    withItemAt: temporary,
+                    backupItemName: nil,
+                    options: []
+                )
+            } else {
+                try FileManager.default.moveItem(at: temporary, to: destination)
+            }
+        } catch {
+            try? FileManager.default.removeItem(at: temporary)
+            throw error
+        }
+    }
+
+    private static func defaultRootDirectory() -> URL {
+        let base = FileManager.default.urls(
+            for: .applicationSupportDirectory,
+            in: .userDomainMask
+        ).first ?? FileManager.default.temporaryDirectory
+        return base
+            .appendingPathComponent("HotUpdater", isDirectory: true)
+            .appendingPathComponent("ReleaseCatalogCache", isDirectory: true)
+    }
+}

package/lib/commonjs/catalogCacheNative.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.writeNativeReleaseCatalogCache = exports.removeNativeReleaseCatalogCache = exports.readNativeReleaseCatalogCache = void 0;
+var _NativeHotUpdater = _interopRequireDefault(require("./specs/NativeHotUpdater.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const getModule = () => _NativeHotUpdater.default;
+const requireMethod = (method, name) => {
+  if (typeof method !== "function") {
+    throw new Error(`[HotUpdater] Native module is missing '${name}()'. Rebuild the native app before using Release catalogs.`);
+  }
+  return method;
+};
+const readNativeReleaseCatalogCache = async partition => {
+  const method = requireMethod(getModule().getReleaseCatalogCache, "getReleaseCatalogCache");
+  try {
+    const value = await method.call(_NativeHotUpdater.default, partition);
+    return typeof value === "string" ? value : null;
+  } catch {
+    return null;
+  }
+};
+exports.readNativeReleaseCatalogCache = readNativeReleaseCatalogCache;
+const writeNativeReleaseCatalogCache = async (partition, payload) => {
+  const method = requireMethod(getModule().setReleaseCatalogCache, "setReleaseCatalogCache");
+  try {
+    return await method.call(_NativeHotUpdater.default, partition, payload);
+  } catch {
+    return false;
+  }
+};
+exports.writeNativeReleaseCatalogCache = writeNativeReleaseCatalogCache;
+const removeNativeReleaseCatalogCache = async partition => {
+  const method = requireMethod(getModule().removeReleaseCatalogCache, "removeReleaseCatalogCache");
+  try {
+    await method.call(_NativeHotUpdater.default, partition);
+  } catch {
+    // Cache maintenance must not prevent a network update check.
+  }
+};
+exports.removeNativeReleaseCatalogCache = removeNativeReleaseCatalogCache;
+//# sourceMappingURL=catalogCacheNative.js.map

package/lib/commonjs/catalogCacheNative.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_NativeHotUpdater","_interopRequireDefault","require","e","__esModule","default","getModule","HotUpdaterNative","requireMethod","method","name","Error","readNativeReleaseCatalogCache","partition","getReleaseCatalogCache","value","call","exports","writeNativeReleaseCatalogCache","payload","setReleaseCatalogCache","removeNativeReleaseCatalogCache","removeReleaseCatalogCache"],"sourceRoot":"../../src","sources":["catalogCacheNative.ts"],"mappings":";;;;;;AAAA,IAAAA,iBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAAwD,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAaxD,MAAMG,SAAS,GAAGA,CAAA,KAChBC,yBAAsE;AAExE,MAAMC,aAAa,GAAGA,CACpBC,MAAqB,EACrBC,IAAkC,KAC5B;EACN,IAAI,OAAOD,MAAM,KAAK,UAAU,EAAE;IAChC,MAAM,IAAIE,KAAK,CACb,0CAA0CD,IAAI,4DAChD,CAAC;EACH;EACA,OAAOD,MAAM;AACf,CAAC;AAEM,MAAMG,6BAA6B,GAAG,MAC3CC,SAAiB,IACU;EAC3B,MAAMJ,MAAM,GAAGD,aAAa,CAC1BF,SAAS,CAAC,CAAC,CAACQ,sBAAsB,EAClC,wBACF,CAAC;EAED,IAAI;IACF,MAAMC,KAAK,GAAG,MAAMN,MAAM,CAACO,IAAI,CAACT,yBAAgB,EAAEM,SAAS,CAAC;IAC5D,OAAO,OAAOE,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAG,IAAI;EACjD,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF,CAAC;AAACE,OAAA,CAAAL,6BAAA,GAAAA,6BAAA;AAEK,MAAMM,8BAA8B,GAAG,MAAAA,CAC5CL,SAAiB,EACjBM,OAAe,KACM;EACrB,MAAMV,MAAM,GAAGD,aAAa,CAC1BF,SAAS,CAAC,CAAC,CAACc,sBAAsB,EAClC,wBACF,CAAC;EAED,IAAI;IACF,OAAO,MAAMX,MAAM,CAACO,IAAI,CAACT,yBAAgB,EAAEM,SAAS,EAAEM,OAAO,CAAC;EAChE,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF,CAAC;AAACF,OAAA,CAAAC,8BAAA,GAAAA,8BAAA;AAEK,MAAMG,+BAA+B,GAAG,MAC7CR,SAAiB,IACC;EAClB,MAAMJ,MAAM,GAAGD,aAAa,CAC1BF,SAAS,CAAC,CAAC,CAACgB,yBAAyB,EACrC,2BACF,CAAC;EAED,IAAI;IACF,MAAMb,MAAM,CAACO,IAAI,CAACT,yBAAgB,EAAEM,SAAS,CAAC;EAChD,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ,CAAC;AAACI,OAAA,CAAAI,+BAAA,GAAAA,+BAAA","ignoreList":[]}

package/lib/commonjs/catalogCacheNative.spec.js

@@ -0,0 +1,31 @@
+"use strict";
+
+var _vitest = require("vitest");
+var _catalogCacheNative = require("./catalogCacheNative.js");
+const nativeModule = _vitest.vi.hoisted(() => ({}));
+_vitest.vi.mock("./specs/NativeHotUpdater", () => ({
+  default: nativeModule
+}));
+(0, _vitest.describe)("Release Catalog native cache", () => {
+  (0, _vitest.beforeEach)(() => {
+    for (const key of Object.keys(nativeModule)) delete nativeModule[key];
+  });
+  (0, _vitest.it)("fails fast when the v1 native cache API is missing", async () => {
+    await (0, _vitest.expect)((0, _catalogCacheNative.readNativeReleaseCatalogCache)("partition")).rejects.toThrow("Native module is missing 'getReleaseCatalogCache()'. Rebuild the native app before using Release catalogs.");
+    await (0, _vitest.expect)((0, _catalogCacheNative.writeNativeReleaseCatalogCache)("partition", "payload")).rejects.toThrow("Native module is missing 'setReleaseCatalogCache()'. Rebuild the native app before using Release catalogs.");
+    await (0, _vitest.expect)((0, _catalogCacheNative.removeNativeReleaseCatalogCache)("partition")).rejects.toThrow("Native module is missing 'removeReleaseCatalogCache()'. Rebuild the native app before using Release catalogs.");
+  });
+  (0, _vitest.it)("normalizes an undefined iOS TurboModule cache miss to null", async () => {
+    nativeModule.getReleaseCatalogCache = _vitest.vi.fn().mockResolvedValue(undefined);
+    await (0, _vitest.expect)((0, _catalogCacheNative.readNativeReleaseCatalogCache)("partition")).resolves.toBeNull();
+  });
+  (0, _vitest.it)("treats native cache I/O failures as misses without hiding network work", async () => {
+    nativeModule.getReleaseCatalogCache = _vitest.vi.fn().mockRejectedValue(new Error("read"));
+    nativeModule.setReleaseCatalogCache = _vitest.vi.fn().mockRejectedValue(new Error("write"));
+    nativeModule.removeReleaseCatalogCache = _vitest.vi.fn().mockRejectedValue(new Error("remove"));
+    await (0, _vitest.expect)((0, _catalogCacheNative.readNativeReleaseCatalogCache)("partition")).resolves.toBeNull();
+    await (0, _vitest.expect)((0, _catalogCacheNative.writeNativeReleaseCatalogCache)("partition", "payload")).resolves.toBe(false);
+    await (0, _vitest.expect)((0, _catalogCacheNative.removeNativeReleaseCatalogCache)("partition")).resolves.toBeUndefined();
+  });
+});
+//# sourceMappingURL=catalogCacheNative.spec.js.map

package/lib/commonjs/catalogCacheNative.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_vitest","require","_catalogCacheNative","nativeModule","vi","hoisted","mock","default","describe","beforeEach","key","Object","keys","it","expect","readNativeReleaseCatalogCache","rejects","toThrow","writeNativeReleaseCatalogCache","removeNativeReleaseCatalogCache","getReleaseCatalogCache","fn","mockResolvedValue","undefined","resolves","toBeNull","mockRejectedValue","Error","setReleaseCatalogCache","removeReleaseCatalogCache","toBe","toBeUndefined"],"sourceRoot":"../../src","sources":["catalogCacheNative.spec.ts"],"mappings":";;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAQA,IAAAC,mBAAA,GAAAD,OAAA;AANA,MAAME,YAAY,GAAGC,UAAE,CAACC,OAAO,CAC7B,OAAO,CAAC,CAAC,CACX,CAAC;AAEDD,UAAE,CAACE,IAAI,CAAC,0BAA0B,EAAE,OAAO;EAAEC,OAAO,EAAEJ;AAAa,CAAC,CAAC,CAAC;AAQtE,IAAAK,gBAAQ,EAAC,8BAA8B,EAAE,MAAM;EAC7C,IAAAC,kBAAU,EAAC,MAAM;IACf,KAAK,MAAMC,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACT,YAAY,CAAC,EAAE,OAAOA,YAAY,CAACO,GAAG,CAAC;EACvE,CAAC,CAAC;EAEF,IAAAG,UAAE,EAAC,oDAAoD,EAAE,YAAY;IACnE,MAAM,IAAAC,cAAM,EAAC,IAAAC,iDAA6B,EAAC,WAAW,CAAC,CAAC,CAACC,OAAO,CAACC,OAAO,CACtE,4GACF,CAAC;IACD,MAAM,IAAAH,cAAM,EACV,IAAAI,kDAA8B,EAAC,WAAW,EAAE,SAAS,CACvD,CAAC,CAACF,OAAO,CAACC,OAAO,CACf,4GACF,CAAC;IACD,MAAM,IAAAH,cAAM,EAAC,IAAAK,mDAA+B,EAAC,WAAW,CAAC,CAAC,CAACH,OAAO,CAACC,OAAO,CACxE,+GACF,CAAC;EACH,CAAC,CAAC;EAEF,IAAAJ,UAAE,EAAC,4DAA4D,EAAE,YAAY;IAC3EV,YAAY,CAACiB,sBAAsB,GAAGhB,UAAE,CAACiB,EAAE,CAAC,CAAC,CAACC,iBAAiB,CAACC,SAAS,CAAC;IAE1E,MAAM,IAAAT,cAAM,EACV,IAAAC,iDAA6B,EAAC,WAAW,CAC3C,CAAC,CAACS,QAAQ,CAACC,QAAQ,CAAC,CAAC;EACvB,CAAC,CAAC;EAEF,IAAAZ,UAAE,EAAC,wEAAwE,EAAE,YAAY;IACvFV,YAAY,CAACiB,sBAAsB,GAAGhB,UAAE,CACrCiB,EAAE,CAAC,CAAC,CACJK,iBAAiB,CAAC,IAAIC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvCxB,YAAY,CAACyB,sBAAsB,GAAGxB,UAAE,CACrCiB,EAAE,CAAC,CAAC,CACJK,iBAAiB,CAAC,IAAIC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxCxB,YAAY,CAAC0B,yBAAyB,GAAGzB,UAAE,CACxCiB,EAAE,CAAC,CAAC,CACJK,iBAAiB,CAAC,IAAIC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEzC,MAAM,IAAAb,cAAM,EACV,IAAAC,iDAA6B,EAAC,WAAW,CAC3C,CAAC,CAACS,QAAQ,CAACC,QAAQ,CAAC,CAAC;IACrB,MAAM,IAAAX,cAAM,EACV,IAAAI,kDAA8B,EAAC,WAAW,EAAE,SAAS,CACvD,CAAC,CAACM,QAAQ,CAACM,IAAI,CAAC,KAAK,CAAC;IACtB,MAAM,IAAAhB,cAAM,EACV,IAAAK,mDAA+B,EAAC,WAAW,CAC7C,CAAC,CAACK,QAAQ,CAACO,aAAa,CAAC,CAAC;EAC5B,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}