@sigx/lynx-updates 0.8.0 → 0.8.1

package/ios/UpdatesEventBus.swift

@@ -1,59 +1,59 @@
-import Foundation
-import CryptoKit
-
-/// Module → publisher event bus (the `BackgroundEventBus` pattern). The
-/// module emits download progress / foreground events here; the per-LynxView
-/// `UpdatesLifecyclePublisher` pumps them into JS via `sendGlobalEvent` on
-/// the `__sigxUpdatesEvent` channel.
-final class UpdatesEventBus {
-
-    static let shared = UpdatesEventBus()
-    static let channel = "__sigxUpdatesEvent"
-
-    typealias Payload = [String: Any]
-    typealias Listener = (Payload) -> Void
-
-    private let queue = DispatchQueue(label: "com.sigx.updates.bus")
-    private var listeners: [(token: UUID, fn: Listener)] = []
-
-    @discardableResult
-    func addListener(_ fn: @escaping Listener) -> UUID {
-        let token = UUID()
-        queue.sync { listeners.append((token, fn)) }
-        return token
-    }
-
-    func removeListener(_ token: UUID) {
-        queue.sync { listeners.removeAll { $0.token == token } }
-    }
-
-    func emit(_ payload: Payload) {
-        let snapshot = queue.sync { listeners }
-        for (_, fn) in snapshot { fn(payload) }
-    }
-
-    func emitProgress(receivedBytes: Int64, totalBytes: Int64?) {
-        var payload: Payload = ["kind": "progress", "receivedBytes": receivedBytes]
-        if let total = totalBytes, total >= 0 { payload["totalBytes"] = total }
-        emit(payload)
-    }
-
-    func emitForeground() {
-        emit(["kind": "foreground"])
-    }
-}
-
-/// Streaming SHA-256 helpers (CryptoKit).
-enum Sha256 {
-    static func fileHex(_ url: URL) -> String? {
-        guard let handle = try? FileHandle(forReadingFrom: url) else { return nil }
-        defer { try? handle.close() }
-        var hasher = SHA256()
-        while true {
-            let chunk = handle.readData(ofLength: 64 * 1024)
-            if chunk.isEmpty { break }
-            hasher.update(data: chunk)
-        }
-        return hasher.finalize().map { String(format: "%02x", $0) }.joined()
-    }
-}
+import Foundation
+import CryptoKit
+
+/// Module → publisher event bus (the `BackgroundEventBus` pattern). The
+/// module emits download progress / foreground events here; the per-LynxView
+/// `UpdatesLifecyclePublisher` pumps them into JS via `sendGlobalEvent` on
+/// the `__sigxUpdatesEvent` channel.
+final class UpdatesEventBus {
+
+    static let shared = UpdatesEventBus()
+    static let channel = "__sigxUpdatesEvent"
+
+    typealias Payload = [String: Any]
+    typealias Listener = (Payload) -> Void
+
+    private let queue = DispatchQueue(label: "com.sigx.updates.bus")
+    private var listeners: [(token: UUID, fn: Listener)] = []
+
+    @discardableResult
+    func addListener(_ fn: @escaping Listener) -> UUID {
+        let token = UUID()
+        queue.sync { listeners.append((token, fn)) }
+        return token
+    }
+
+    func removeListener(_ token: UUID) {
+        queue.sync { listeners.removeAll { $0.token == token } }
+    }
+
+    func emit(_ payload: Payload) {
+        let snapshot = queue.sync { listeners }
+        for (_, fn) in snapshot { fn(payload) }
+    }
+
+    func emitProgress(receivedBytes: Int64, totalBytes: Int64?) {
+        var payload: Payload = ["kind": "progress", "receivedBytes": receivedBytes]
+        if let total = totalBytes, total >= 0 { payload["totalBytes"] = total }
+        emit(payload)
+    }
+
+    func emitForeground() {
+        emit(["kind": "foreground"])
+    }
+}
+
+/// Streaming SHA-256 helpers (CryptoKit).
+enum Sha256 {
+    static func fileHex(_ url: URL) -> String? {
+        guard let handle = try? FileHandle(forReadingFrom: url) else { return nil }
+        defer { try? handle.close() }
+        var hasher = SHA256()
+        while true {
+            let chunk = handle.readData(ofLength: 64 * 1024)
+            if chunk.isEmpty { break }
+            hasher.update(data: chunk)
+        }
+        return hasher.finalize().map { String(format: "%02x", $0) }.joined()
+    }
+}

package/ios/UpdatesLifecyclePublisher.swift

@@ -1,48 +1,48 @@
-import Foundation
-import UIKit
-import Lynx
-
-/// Per-LynxView publisher: pumps `UpdatesEventBus` payloads into JS
-/// (`__sigxUpdatesEvent`), registers the view with `UpdateStore` so
-/// `applyNow` has a reload target, and converts background→active app
-/// transitions into `foreground` events for `checkOn: ['foreground']`.
-/// Instantiated by the generated `GeneratedLifecyclePublishers.attachAll(to:)`.
-final class UpdatesLifecyclePublisher {
-
-    private weak var lynxView: LynxView?
-    private var token: UUID?
-    private var observers: [NSObjectProtocol] = []
-    private var sawBackground = false
-
-    init(lynxView: LynxView) {
-        self.lynxView = lynxView
-        UpdateStore.shared.attachView(lynxView)
-        token = UpdatesEventBus.shared.addListener { [weak self] payload in
-            guard let view = self?.lynxView else { return }
-            view.sendGlobalEvent(UpdatesEventBus.channel, withParams: [payload])
-        }
-
-        // Foreground detection: only resume-after-background counts — cold
-        // start is covered by the JS 'launch' trigger.
-        let center = NotificationCenter.default
-        observers.append(center.addObserver(
-            forName: UIApplication.didEnterBackgroundNotification, object: nil, queue: .main
-        ) { [weak self] _ in
-            self?.sawBackground = true
-        })
-        observers.append(center.addObserver(
-            forName: UIApplication.didBecomeActiveNotification, object: nil, queue: .main
-        ) { [weak self] _ in
-            guard let self, self.sawBackground else { return }
-            self.sawBackground = false
-            UpdatesEventBus.shared.emitForeground()
-        })
-    }
-
-    deinit {
-        if let token { UpdatesEventBus.shared.removeListener(token) }
-        for observer in observers {
-            NotificationCenter.default.removeObserver(observer)
-        }
-    }
-}
+import Foundation
+import UIKit
+import Lynx
+
+/// Per-LynxView publisher: pumps `UpdatesEventBus` payloads into JS
+/// (`__sigxUpdatesEvent`), registers the view with `UpdateStore` so
+/// `applyNow` has a reload target, and converts background→active app
+/// transitions into `foreground` events for `checkOn: ['foreground']`.
+/// Instantiated by the generated `GeneratedLifecyclePublishers.attachAll(to:)`.
+final class UpdatesLifecyclePublisher {
+
+    private weak var lynxView: LynxView?
+    private var token: UUID?
+    private var observers: [NSObjectProtocol] = []
+    private var sawBackground = false
+
+    init(lynxView: LynxView) {
+        self.lynxView = lynxView
+        UpdateStore.shared.attachView(lynxView)
+        token = UpdatesEventBus.shared.addListener { [weak self] payload in
+            guard let view = self?.lynxView else { return }
+            view.sendGlobalEvent(UpdatesEventBus.channel, withParams: [payload])
+        }
+
+        // Foreground detection: only resume-after-background counts — cold
+        // start is covered by the JS 'launch' trigger.
+        let center = NotificationCenter.default
+        observers.append(center.addObserver(
+            forName: UIApplication.didEnterBackgroundNotification, object: nil, queue: .main
+        ) { [weak self] _ in
+            self?.sawBackground = true
+        })
+        observers.append(center.addObserver(
+            forName: UIApplication.didBecomeActiveNotification, object: nil, queue: .main
+        ) { [weak self] _ in
+            guard let self, self.sawBackground else { return }
+            self.sawBackground = false
+            UpdatesEventBus.shared.emitForeground()
+        })
+    }
+
+    deinit {
+        if let token { UpdatesEventBus.shared.removeListener(token) }
+        for observer in observers {
+            NotificationCenter.default.removeObserver(observer)
+        }
+    }
+}

package/ios/UpdatesModule.swift

@@ -1,178 +1,178 @@
-import Foundation
-import Lynx
-
-/// JS bridge for OTA updates.
-/// JS usage: NativeModules.Updates.downloadUpdate({...}, callback)
-class UpdatesModule: NSObject, LynxModule {
-
-    @objc static var name: String { "Updates" }
-
-    @objc static var methodLookup: [String: String] {
-        [
-            "getInstalledRuntimeVersion": NSStringFromSelector(#selector(getInstalledRuntimeVersion)),
-            "getPlatform": NSStringFromSelector(#selector(getPlatform)),
-            "getCurrentUpdate": NSStringFromSelector(#selector(getCurrentUpdate(_:))),
-            "getState": NSStringFromSelector(#selector(getState(_:))),
-            "downloadUpdate": NSStringFromSelector(#selector(downloadUpdate(_:callback:))),
-            "applyOnNextLaunch": NSStringFromSelector(#selector(applyOnNextLaunch(_:callback:))),
-            "applyNow": NSStringFromSelector(#selector(applyNow(_:callback:))),
-            "markReady": NSStringFromSelector(#selector(markReady(_:))),
-            "setRollbackOptions": NSStringFromSelector(#selector(setRollbackOptions(_:callback:))),
-            "clearUpdates": NSStringFromSelector(#selector(clearUpdates(_:))),
-        ]
-    }
-
-    private static let downloadQueue = DispatchQueue(label: "com.sigx.updates.download")
-
-    required override init() { super.init() }
-    required init(param: Any) { super.init() }
-
-    private func errorMap(_ message: String, code: String? = nil) -> [String: Any] {
-        var map: [String: Any] = ["error": message]
-        if let code { map["code"] = code }
-        return map
-    }
-
-    @objc func getInstalledRuntimeVersion() -> String {
-        UpdateStore.shared.installedRuntimeVersion()
-    }
-
-    @objc func getPlatform() -> String { "ios" }
-
-    @objc func getCurrentUpdate(_ callback: LynxCallbackBlock?) {
-        let store = UpdateStore.shared
-        var map: [String: Any] = [
-            "runtimeVersion": store.installedRuntimeVersion(),
-            // Store-shipped app version — providers receive it as
-            // UpdateCheckContext.embeddedVersion.
-            "embeddedVersion": (Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String) ?? "",
-            "isFirstLaunchAfterUpdate": store.isFirstLaunchAfterUpdate,
-            "didRollBack": store.didRollBack,
-        ]
-        if let updateId = store.launchedUpdateId {
-            map["updateId"] = updateId
-            map["isEmbedded"] = false
-            if let data = try? Data(contentsOf: store.updateJsonFile(updateId)),
-               let meta = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any],
-               let version = meta["version"] as? String {
-                map["version"] = version
-            }
-        } else {
-            map["isEmbedded"] = true
-        }
-        if let rolledBack = store.rolledBackUpdateId {
-            map["rolledBackUpdateId"] = rolledBack
-        }
-        callback?(map)
-    }
-
-    @objc func getState(_ callback: LynxCallbackBlock?) {
-        let store = UpdateStore.shared
-        var map: [String: Any] = ["runningUpdateId": store.launchedUpdateId ?? ""]
-        if let state = store.readState() {
-            map["currentUpdateId"] = state.currentUpdateId ?? ""
-            map["previousUpdateId"] = state.previousUpdateId ?? ""
-            map["pendingUpdateId"] = state.pendingUpdateId ?? ""
-            map["pendingLaunchAttempts"] = state.pendingLaunchAttempts
-            map["maxLaunchAttempts"] = state.maxLaunchAttempts
-            map["lastRollbackUpdateId"] = state.lastRollbackUpdateId ?? ""
-            map["lastRollbackReason"] = state.lastRollbackReason ?? ""
-        }
-        callback?(map)
-    }
-
-    @objc func downloadUpdate(_ params: [String: Any]?, callback: LynxCallbackBlock?) {
-        guard let url = params?["url"] as? String, !url.isEmpty,
-              let sha256 = params?["sha256"] as? String, !sha256.isEmpty,
-              let updateId = params?["updateId"] as? String, !updateId.isEmpty else {
-            callback?(errorMap("url, sha256 and updateId are required"))
-            return
-        }
-
-        // Refuse incompatible bundles at the door — defense in depth on top
-        // of the JS-side check.
-        let installed = UpdateStore.shared.installedRuntimeVersion()
-        if let runtimeVersion = params?["runtimeVersion"] as? String,
-           !runtimeVersion.isEmpty, runtimeVersion != installed {
-            callback?(errorMap(
-                "Update requires runtime \(runtimeVersion) but binary is \(installed)",
-                code: "E_RUNTIME_MISMATCH"))
-            return
-        }
-
-        let headers = (params?["headers"] as? [String: String]) ?? [:]
-        let manifestJson = (params?["manifestJson"] as? String) ?? "{}"
-
-        Self.downloadQueue.async {
-            let result = UpdateDownloader.download(
-                url: url, expectedSha256: sha256, updateId: updateId,
-                headers: headers, manifestJson: manifestJson)
-            if let result {
-                let code: String? = result.hasPrefix("E_DOWNLOAD_IN_PROGRESS") ? "E_DOWNLOAD_IN_PROGRESS"
-                    : result.hasPrefix("E_HASH_MISMATCH") ? "hash-mismatch"
-                    : nil
-                callback?(self.errorMap(result, code: code))
-            } else {
-                callback?(["ok": true])
-            }
-        }
-    }
-
-    @objc func applyOnNextLaunch(_ updateId: String?, callback: LynxCallbackBlock?) {
-        guard let updateId, !updateId.isEmpty else {
-            callback?(errorMap("updateId is required"))
-            return
-        }
-        if let failure = UpdateStore.shared.stagePending(updateId) {
-            callback?(errorMap(failure))
-        } else {
-            callback?(["ok": true])
-        }
-    }
-
-    @objc func applyNow(_ updateId: String?, callback: LynxCallbackBlock?) {
-        guard let updateId, !updateId.isEmpty else {
-            callback?(errorMap("updateId is required"))
-            return
-        }
-        let store = UpdateStore.shared
-        let bundle = store.bundleFile(updateId)
-        guard FileManager.default.fileExists(atPath: bundle.path) else {
-            callback?(errorMap("Update \(updateId) is not on disk"))
-            return
-        }
-        guard let view = store.currentView() else {
-            callback?(errorMap("No LynxView attached — cannot reload in place", code: "E_NO_VIEW"))
-            return
-        }
-        // Stage first so a crash mid-reload still gets crash-guarded rollback
-        // (the reload bypasses the startup resolver).
-        _ = store.stagePending(updateId)
-        store.recordReloadAttempt(updateId)
-        DispatchQueue.main.async {
-            guard let data = try? Data(contentsOf: bundle) else {
-                callback?(self.errorMap("Could not read \(bundle.path)", code: "apply-failed"))
-                return
-            }
-            view.loadTemplate(data, withURL: bundle.path)
-            // JS context is replaced — the callback never reaches the old
-            // context on success, which is the documented contract.
-        }
-    }
-
-    @objc func markReady(_ callback: LynxCallbackBlock?) {
-        UpdateStore.shared.markReady()
-        callback?(["ok": true])
-    }
-
-    @objc func setRollbackOptions(_ params: [String: Any]?, callback: LynxCallbackBlock?) {
-        let max = (params?["maxFailedLaunches"] as? Int) ?? 2
-        UpdateStore.shared.setMaxLaunchAttempts(max)
-        callback?(["ok": true])
-    }
-
-    @objc func clearUpdates(_ callback: LynxCallbackBlock?) {
-        UpdateStore.shared.clearAll()
-        callback?(["ok": true])
-    }
-}
+import Foundation
+import Lynx
+
+/// JS bridge for OTA updates.
+/// JS usage: NativeModules.Updates.downloadUpdate({...}, callback)
+class UpdatesModule: NSObject, LynxModule {
+
+    @objc static var name: String { "Updates" }
+
+    @objc static var methodLookup: [String: String] {
+        [
+            "getInstalledRuntimeVersion": NSStringFromSelector(#selector(getInstalledRuntimeVersion)),
+            "getPlatform": NSStringFromSelector(#selector(getPlatform)),
+            "getCurrentUpdate": NSStringFromSelector(#selector(getCurrentUpdate(_:))),
+            "getState": NSStringFromSelector(#selector(getState(_:))),
+            "downloadUpdate": NSStringFromSelector(#selector(downloadUpdate(_:callback:))),
+            "applyOnNextLaunch": NSStringFromSelector(#selector(applyOnNextLaunch(_:callback:))),
+            "applyNow": NSStringFromSelector(#selector(applyNow(_:callback:))),
+            "markReady": NSStringFromSelector(#selector(markReady(_:))),
+            "setRollbackOptions": NSStringFromSelector(#selector(setRollbackOptions(_:callback:))),
+            "clearUpdates": NSStringFromSelector(#selector(clearUpdates(_:))),
+        ]
+    }
+
+    private static let downloadQueue = DispatchQueue(label: "com.sigx.updates.download")
+
+    required override init() { super.init() }
+    required init(param: Any) { super.init() }
+
+    private func errorMap(_ message: String, code: String? = nil) -> [String: Any] {
+        var map: [String: Any] = ["error": message]
+        if let code { map["code"] = code }
+        return map
+    }
+
+    @objc func getInstalledRuntimeVersion() -> String {
+        UpdateStore.shared.installedRuntimeVersion()
+    }
+
+    @objc func getPlatform() -> String { "ios" }
+
+    @objc func getCurrentUpdate(_ callback: LynxCallbackBlock?) {
+        let store = UpdateStore.shared
+        var map: [String: Any] = [
+            "runtimeVersion": store.installedRuntimeVersion(),
+            // Store-shipped app version — providers receive it as
+            // UpdateCheckContext.embeddedVersion.
+            "embeddedVersion": (Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String) ?? "",
+            "isFirstLaunchAfterUpdate": store.isFirstLaunchAfterUpdate,
+            "didRollBack": store.didRollBack,
+        ]
+        if let updateId = store.launchedUpdateId {
+            map["updateId"] = updateId
+            map["isEmbedded"] = false
+            if let data = try? Data(contentsOf: store.updateJsonFile(updateId)),
+               let meta = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any],
+               let version = meta["version"] as? String {
+                map["version"] = version
+            }
+        } else {
+            map["isEmbedded"] = true
+        }
+        if let rolledBack = store.rolledBackUpdateId {
+            map["rolledBackUpdateId"] = rolledBack
+        }
+        callback?(map)
+    }
+
+    @objc func getState(_ callback: LynxCallbackBlock?) {
+        let store = UpdateStore.shared
+        var map: [String: Any] = ["runningUpdateId": store.launchedUpdateId ?? ""]
+        if let state = store.readState() {
+            map["currentUpdateId"] = state.currentUpdateId ?? ""
+            map["previousUpdateId"] = state.previousUpdateId ?? ""
+            map["pendingUpdateId"] = state.pendingUpdateId ?? ""
+            map["pendingLaunchAttempts"] = state.pendingLaunchAttempts
+            map["maxLaunchAttempts"] = state.maxLaunchAttempts
+            map["lastRollbackUpdateId"] = state.lastRollbackUpdateId ?? ""
+            map["lastRollbackReason"] = state.lastRollbackReason ?? ""
+        }
+        callback?(map)
+    }
+
+    @objc func downloadUpdate(_ params: [String: Any]?, callback: LynxCallbackBlock?) {
+        guard let url = params?["url"] as? String, !url.isEmpty,
+              let sha256 = params?["sha256"] as? String, !sha256.isEmpty,
+              let updateId = params?["updateId"] as? String, !updateId.isEmpty else {
+            callback?(errorMap("url, sha256 and updateId are required"))
+            return
+        }
+
+        // Refuse incompatible bundles at the door — defense in depth on top
+        // of the JS-side check.
+        let installed = UpdateStore.shared.installedRuntimeVersion()
+        if let runtimeVersion = params?["runtimeVersion"] as? String,
+           !runtimeVersion.isEmpty, runtimeVersion != installed {
+            callback?(errorMap(
+                "Update requires runtime \(runtimeVersion) but binary is \(installed)",
+                code: "E_RUNTIME_MISMATCH"))
+            return
+        }
+
+        let headers = (params?["headers"] as? [String: String]) ?? [:]
+        let manifestJson = (params?["manifestJson"] as? String) ?? "{}"
+
+        Self.downloadQueue.async {
+            let result = UpdateDownloader.download(
+                url: url, expectedSha256: sha256, updateId: updateId,
+                headers: headers, manifestJson: manifestJson)
+            if let result {
+                let code: String? = result.hasPrefix("E_DOWNLOAD_IN_PROGRESS") ? "E_DOWNLOAD_IN_PROGRESS"
+                    : result.hasPrefix("E_HASH_MISMATCH") ? "hash-mismatch"
+                    : nil
+                callback?(self.errorMap(result, code: code))
+            } else {
+                callback?(["ok": true])
+            }
+        }
+    }
+
+    @objc func applyOnNextLaunch(_ updateId: String?, callback: LynxCallbackBlock?) {
+        guard let updateId, !updateId.isEmpty else {
+            callback?(errorMap("updateId is required"))
+            return
+        }
+        if let failure = UpdateStore.shared.stagePending(updateId) {
+            callback?(errorMap(failure))
+        } else {
+            callback?(["ok": true])
+        }
+    }
+
+    @objc func applyNow(_ updateId: String?, callback: LynxCallbackBlock?) {
+        guard let updateId, !updateId.isEmpty else {
+            callback?(errorMap("updateId is required"))
+            return
+        }
+        let store = UpdateStore.shared
+        let bundle = store.bundleFile(updateId)
+        guard FileManager.default.fileExists(atPath: bundle.path) else {
+            callback?(errorMap("Update \(updateId) is not on disk"))
+            return
+        }
+        guard let view = store.currentView() else {
+            callback?(errorMap("No LynxView attached — cannot reload in place", code: "E_NO_VIEW"))
+            return
+        }
+        // Stage first so a crash mid-reload still gets crash-guarded rollback
+        // (the reload bypasses the startup resolver).
+        _ = store.stagePending(updateId)
+        store.recordReloadAttempt(updateId)
+        DispatchQueue.main.async {
+            guard let data = try? Data(contentsOf: bundle) else {
+                callback?(self.errorMap("Could not read \(bundle.path)", code: "apply-failed"))
+                return
+            }
+            view.loadTemplate(data, withURL: bundle.path)
+            // JS context is replaced — the callback never reaches the old
+            // context on success, which is the documented contract.
+        }
+    }
+
+    @objc func markReady(_ callback: LynxCallbackBlock?) {
+        UpdateStore.shared.markReady()
+        callback?(["ok": true])
+    }
+
+    @objc func setRollbackOptions(_ params: [String: Any]?, callback: LynxCallbackBlock?) {
+        let max = (params?["maxFailedLaunches"] as? Int) ?? 2
+        UpdateStore.shared.setMaxLaunchAttempts(max)
+        callback?(["ok": true])
+    }
+
+    @objc func clearUpdates(_ callback: LynxCallbackBlock?) {
+        UpdateStore.shared.clearAll()
+        callback?(["ok": true])
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sigx/lynx-updates",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "OTA bundle updates for sigx-lynx — pluggable backends, update modes, crash rollback",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,8 +19,8 @@
     "signalx-module.json"
   ],
   "dependencies": {
-    "@sigx/lynx-core": "^0.8.0",
-    "@sigx/lynx": "^0.8.0"
+    "@sigx/lynx": "^0.8.1",
+    "@sigx/lynx-core": "^0.8.1"
   },
   "devDependencies": {
     "@typescript/native-preview": "7.0.0-dev.20260521.1",