@upscopeio/react-native-sdk 2026.4.1 → 2026.6.0

package/ios/UpscopeModule.swift

@@ -7,6 +7,17 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
 
     private var hasListeners = false
 
+    /// The emitter instance that currently has JS listeners attached. The bridge
+    /// can construct more than one `UpscopeModule`; delegate callbacks and
+    /// publisher subscriptions are routed through this stable reference so events
+    /// always reach the live emitter the JS side is actually subscribed to.
+    /// Fixes Bug #2 (session state stuck "inactive" with multiple instances).
+    private static weak var current: UpscopeModule?
+
+    /// Pending full-device requests awaiting a JS response, keyed by request id.
+    /// Access is confined to the main actor (where the handler fires).
+    private static var pendingFullDeviceRequests: [String: SessionRequestResponse] = [:]
+
     override init() {
         super.init()
     }
@@ -18,20 +29,27 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
     override func supportedEvents() -> [String] {
         return [
             "connectionStateChanged",
+            "sessionStateChanged",
             "sessionStarted",
             "sessionEnded",
             "customMessageReceived",
             "error",
-            "observerJoined",
-            "observerLeft",
-            "observerCountChanged",
+            "viewerJoined",
+            "viewerLeft",
+            "viewerCountChanged",
             "shortIdChanged",
             "lookupCodeChanged",
+            "remoteControlStateChanged",
+            "fullDeviceSharingStateChanged",
+            "fullDeviceRequest",
         ]
     }
 
     override func startObserving() {
         hasListeners = true
+        // Become the live emitter so delegate callbacks reach this instance.
+        UpscopeModule.current = self
+
         Task { @MainActor in
             for await shortId in Upscope.shared.shortIdPublisher.values {
                 guard self.hasListeners else { break }
@@ -44,10 +62,43 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
                 self.sendEvent(withName: "lookupCodeChanged", body: ["lookupCode": code as Any])
             }
         }
+        // Drive connection/session state from current-value publishers so a fresh
+        // subscription immediately receives the real state (core fix for Bug #2).
+        Task { @MainActor in
+            for await state in Upscope.shared.connectionStatePublisher.values {
+                guard self.hasListeners else { break }
+                var body: [String: Any] = ["state": self.serializeConnectionState(state)]
+                if case let .error(error) = state {
+                    body["error"] = self.serializeError(error)
+                }
+                self.sendEvent(withName: "connectionStateChanged", body: body)
+            }
+        }
+        Task { @MainActor in
+            for await state in Upscope.shared.sessionStatePublisher.values {
+                guard self.hasListeners else { break }
+                self.sendEvent(withName: "sessionStateChanged", body: ["state": self.serializeSessionState(state)])
+            }
+        }
+        Task { @MainActor in
+            for await state in Upscope.shared.remoteControlStatePublisher.values {
+                guard self.hasListeners else { break }
+                self.sendEvent(withName: "remoteControlStateChanged", body: ["state": self.serializeRemoteControlState(state)])
+            }
+        }
+        Task { @MainActor in
+            for await state in Upscope.shared.fullDeviceSharingStatePublisher.values {
+                guard self.hasListeners else { break }
+                self.sendEvent(withName: "fullDeviceSharingStateChanged", body: ["state": self.serializeFullDeviceSharingState(state)])
+            }
+        }
     }
 
     override func stopObserving() {
         hasListeners = false
+        if UpscopeModule.current === self {
+            UpscopeModule.current = nil
+        }
     }
 
     // MARK: - Initialization
@@ -55,7 +106,7 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
     @objc func initialize(_ config: NSDictionary) {
         guard let apiKey = config["apiKey"] as? String else { return }
 
-        let upscopeConfig = UpscopeConfiguration(
+        var upscopeConfig = UpscopeConfiguration(
             apiKey: apiKey,
             requireAuthorizationForSession: config["requireAuthorizationForSession"] as? Bool,
             autoconnect: config["autoConnect"] as? Bool,
@@ -64,7 +115,7 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
             authorizationPromptTitle: config["authorizationPromptTitle"] as? String,
             authorizationPromptMessage: config["authorizationPromptMessage"] as? String,
             endOfSessionMessage: config["endOfSessionMessage"] as? String,
-            stopSessionText: config["stopSessionText"] as? String,
+            stopSessionText: parseLocalizedString(config["stopSessionText"]),
             allowRemoteClick: config["allowRemoteClick"] as? Bool,
             allowRemoteScroll: config["allowRemoteScroll"] as? Bool,
             requireControlRequest: config["requireControlRequest"] as? Bool,
@@ -73,13 +124,37 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
             enableLookupCodeOnShake: config["enableLookupCodeOnShake"] as? Bool,
             lookupCodeKeyTitle: config["lookupCodeKeyTitle"] as? String,
             lookupCodeKeyMessage: config["lookupCodeKeyMessage"] as? String,
-            translationsYes: config["translationsYes"] as? String,
-            translationsNo: config["translationsNo"] as? String,
-            translationsOk: config["translationsOk"] as? String,
+            translationsYes: parseLocalizedString(config["translationsYes"]),
+            translationsNo: parseLocalizedString(config["translationsNo"]),
+            translationsOk: parseLocalizedString(config["translationsOk"]),
             wrapper: "react-native",
-            wrapperVersion: config["wrapperVersion"] as? String
+            wrapperVersion: config["wrapperVersion"] as? String,
+            broadcastAppGroupId: config["broadcastAppGroupId"] as? String,
+            broadcastExtensionBundleId: config["broadcastExtensionBundleId"] as? String
         )
 
+        // Base domain for SDK endpoints (staging/on-prem). `baseDomain` is a
+        // mutable property on the native config, so set it after construction.
+        if let baseDomain = config["baseDomain"] as? String {
+            upscopeConfig.baseDomain = baseDomain
+        }
+        if let disableFullScreenWhenMasked = config["disableFullScreenWhenMasked"] as? Bool {
+            upscopeConfig.disableFullScreenWhenMasked = disableFullScreenWhenMasked
+        }
+
+        // Bridge the native full-device request hook to the JS event layer.
+        // Stores the response keyed by a generated id, emits `fullDeviceRequest`,
+        // and returns a Cancellable that clears the stored entry. The JS side
+        // answers via respondToFullDeviceRequest(requestId, accept).
+        upscopeConfig.onFullDeviceRequest = { response in
+            let requestId = UUID().uuidString
+            UpscopeModule.pendingFullDeviceRequests[requestId] = response
+            UpscopeModule.current?.sendEvent(withName: "fullDeviceRequest", body: ["requestId": requestId])
+            return FullDeviceRequestCancellable {
+                UpscopeModule.pendingFullDeviceRequests.removeValue(forKey: requestId)
+            }
+        }
+
         Task { @MainActor in
             try Upscope.shared.initialize(with: upscopeConfig)
             Upscope.shared.delegate = self
@@ -127,6 +202,29 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
         Task { @MainActor in Upscope.shared.cancelAgentRequest() }
     }
 
+    // MARK: - Remote control / full-device sharing
+
+    @objc func stopRemoteControl() {
+        Task { @MainActor in Upscope.shared.stopRemoteControl() }
+    }
+
+    @objc func stopFullDeviceSharing() {
+        Task { @MainActor in Upscope.shared.stopFullDeviceSharing() }
+    }
+
+    @objc func respondToFullDeviceRequest(_ requestId: String, accept: Bool) {
+        Task { @MainActor in
+            guard let response = UpscopeModule.pendingFullDeviceRequests.removeValue(forKey: requestId) else {
+                return
+            }
+            if accept {
+                response.accept()
+            } else {
+                response.reject()
+            }
+        }
+    }
+
     // MARK: - Lookup
 
     @objc func getLookupCode() {
@@ -154,68 +252,94 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
     }
 
     // MARK: - UpscopeDelegate
+    //
+    // Delegate callbacks are routed through `UpscopeModule.current` (the live
+    // emitter) rather than `self`, because the bridge may have constructed a
+    // different instance than the one JS is subscribed to (Bug #2).
+    // `emit` no-ops when no emitter is active.
+
+    /// Forwards an event to the currently active emitter, if any.
+    @MainActor
+    private static func emit(_ name: String, body: Any?) {
+        guard let current = current, current.hasListeners else { return }
+        current.sendEvent(withName: name, body: body)
+    }
 
     @MainActor
     func upscope(_ upscope: Upscope, didChangeConnectionState state: ConnectionState) {
-        guard hasListeners else { return }
+        // Connection state is primarily driven by connectionStatePublisher in
+        // startObserving; this delegate path is kept as a redundant fast path.
         var body: [String: Any] = ["state": serializeConnectionState(state)]
         if case let .error(error) = state {
             body["error"] = serializeError(error)
         }
-        sendEvent(withName: "connectionStateChanged", body: body)
+        UpscopeModule.emit("connectionStateChanged", body: body)
     }
 
     @MainActor
     func upscopeSessionDidStart(_ upscope: Upscope, agentName: String?) {
-        guard hasListeners else { return }
-        sendEvent(withName: "sessionStarted", body: ["agentName": agentName as Any])
+        UpscopeModule.emit("sessionStarted", body: ["agentName": agentName as Any])
     }
 
     @MainActor
     func upscopeSessionDidEnd(_ upscope: Upscope, reason: SessionEndReason) {
-        guard hasListeners else { return }
-        var body: [String: Any] = ["reason": serializeEndReason(reason)]
-        if case let .error(error) = reason {
-            body["error"] = serializeError(error)
-        }
-        sendEvent(withName: "sessionEnded", body: body)
+        UpscopeModule.emit("sessionEnded", body: ["reason": serializeEndReason(reason)])
+    }
+
+    @MainActor
+    func upscope(_ upscope: Upscope, didChangeRemoteControlState state: RemoteControlState) {
+        UpscopeModule.emit("remoteControlStateChanged", body: ["state": serializeRemoteControlState(state)])
     }
 
     @MainActor
-    func upscope(_ upscope: Upscope, didReceiveCustomMessage message: String, from observerId: String) {
-        guard hasListeners else { return }
-        sendEvent(withName: "customMessageReceived", body: [
+    func upscope(_ upscope: Upscope, didChangeFullDeviceSharingState state: FullDeviceSharingState) {
+        UpscopeModule.emit("fullDeviceSharingStateChanged", body: ["state": serializeFullDeviceSharingState(state)])
+    }
+
+    @MainActor
+    func upscope(_ upscope: Upscope, didReceiveCustomMessage message: String, from viewerId: String) {
+        UpscopeModule.emit("customMessageReceived", body: [
             "message": message,
-            "observerId": observerId,
+            "viewerId": viewerId,
         ])
     }
 
     @MainActor
     func upscope(_ upscope: Upscope, didEncounterError error: UpscopeError) {
-        guard hasListeners else { return }
-        sendEvent(withName: "error", body: serializeError(error))
+        UpscopeModule.emit("error", body: serializeError(error))
     }
 
     @MainActor
-    func upscope(_ upscope: Upscope, observerDidJoin observer: Observer) {
-        guard hasListeners else { return }
-        sendEvent(withName: "observerJoined", body: serializeObserver(observer))
+    func upscope(_ upscope: Upscope, viewerDidJoin viewer: Viewer) {
+        UpscopeModule.emit("viewerJoined", body: serializeViewer(viewer))
     }
 
     @MainActor
-    func upscope(_ upscope: Upscope, observerDidLeave observerId: String) {
-        guard hasListeners else { return }
-        sendEvent(withName: "observerLeft", body: ["observerId": observerId])
+    func upscope(_ upscope: Upscope, viewerDidLeave viewerId: String) {
+        UpscopeModule.emit("viewerLeft", body: ["viewerId": viewerId])
     }
 
     @MainActor
-    func upscope(_ upscope: Upscope, observerCountDidChange count: Int) {
-        guard hasListeners else { return }
-        sendEvent(withName: "observerCountChanged", body: ["count": count])
+    func upscope(_ upscope: Upscope, viewerCountDidChange count: Int) {
+        UpscopeModule.emit("viewerCountChanged", body: ["count": count])
     }
 
     // MARK: - Serialization
 
+    /// Converts a JS-bridged value (either a String or a [String: String] map) into a
+    /// `LocalizedString`. Returns nil when the key is absent or holds an unsupported type
+    /// so the native SDK falls back to its server-provided default.
+    private func parseLocalizedString(_ value: Any?) -> LocalizedString? {
+        if let string = value as? String {
+            return .string(string)
+        }
+        if let dict = value as? [String: String] {
+            let entries = dict.map { LocalizedString.Entry(language: $0.key, value: $0.value) }
+            return .localized(entries)
+        }
+        return nil
+    }
+
     private func serializeConnectionState(_ state: ConnectionState) -> String {
         switch state {
         case .inactive: return "inactive"
@@ -226,12 +350,23 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
         }
     }
 
+    private func serializeSessionState(_ state: SessionState) -> String {
+        return state.rawValue
+    }
+
+    private func serializeRemoteControlState(_ state: RemoteControlState) -> String {
+        return state.rawValue
+    }
+
+    private func serializeFullDeviceSharingState(_ state: FullDeviceSharingState) -> String {
+        return state.rawValue
+    }
+
     private func serializeEndReason(_ reason: SessionEndReason) -> String {
         switch reason {
         case .userStopped: return "userStopped"
         case .agentStopped: return "agentStopped"
         case .timeout: return "timeout"
-        case .error: return "error"
         }
     }
 
@@ -239,15 +374,32 @@ class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
         return ["code": error.code, "message": error.message]
     }
 
-    private func serializeObserver(_ observer: Observer) -> [String: Any] {
+    private func serializeViewer(_ viewer: Viewer) -> [String: Any] {
         return [
-            "id": observer.id,
-            "name": observer.name as Any,
-            "screenWidth": observer.screenWidth,
-            "screenHeight": observer.screenHeight,
-            "windowWidth": observer.windowWidth,
-            "windowHeight": observer.windowHeight,
-            "hasFocus": observer.hasFocus,
+            "id": viewer.id,
+            "name": viewer.name as Any,
+            "screenWidth": viewer.screenWidth,
+            "screenHeight": viewer.screenHeight,
+            "screenScale": viewer.screenScale,
+            "windowWidth": viewer.windowWidth,
+            "windowHeight": viewer.windowHeight,
+            "hasFocus": viewer.hasFocus,
         ]
     }
 }
+
+/// Cancellable handed back from `onFullDeviceRequest`. When the SDK cancels the
+/// request externally (e.g. session ended before the visitor responded), it runs
+/// the closure that drops the stored `SessionRequestResponse` so a later JS
+/// response to a stale id is safely ignored.
+private final class FullDeviceRequestCancellable: Cancellable {
+    private let onCancel: () -> Void
+
+    init(onCancel: @escaping () -> Void) {
+        self.onCancel = onCancel
+    }
+
+    func cancel() {
+        onCancel()
+    }
+}

package/lib/commonjs/NativeUpscopeModule.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeUpscopeModule.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAAmD,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GA8BpCC,gCAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeUpscopeModule.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAAmD,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAmCpCC,gCAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}

package/lib/commonjs/Upscope.js

@@ -5,16 +5,29 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _reactNative = require("react-native");
-var _NativeUpscopeModule = _interopRequireDefault(require("./NativeUpscopeModule"));
 var _version = require("./version");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * Subscription handle returned by addListener. Callers must invoke remove()
  * to avoid memory leaks when the component/scope unmounts.
  */
 
-// Module-level emitter — one instance for the lifetime of the JS runtime.
-const emitter = new _reactNative.NativeEventEmitter(_NativeUpscopeModule.default);
+/**
+ * Resolve the native TurboModule lazily on first use. Resolving at import time
+ * runs during the initial JS bundle evaluation — before the bridgeless runtime
+ * has finished registering third-party TurboModules — which makes
+ * `getEnforcing` throw "UpscopeModule could not be found". Deferring until a
+ * method is actually called avoids that startup ordering issue.
+ */
+let nativeModule;
+function native() {
+  return nativeModule ??= _reactNative.TurboModuleRegistry.getEnforcing('UpscopeModule');
+}
+
+// Lazily-created emitter — one instance for the lifetime of the JS runtime.
+let eventEmitter;
+function emitter() {
+  return eventEmitter ??= new _reactNative.NativeEventEmitter(native());
+}
 
 /**
  * Imperative JS API over the native Upscope TurboModule.
@@ -25,44 +38,68 @@ const emitter = new _reactNative.NativeEventEmitter(_NativeUpscopeModule.default
 const Upscope = {
   /** Initialise the SDK. Must be called before any other method. */
   initialize(config) {
-    _NativeUpscopeModule.default.initialize({
+    native().initialize({
       ...config,
       wrapperVersion: _version.SDK_VERSION
     });
   },
   /** Open a WebSocket connection to the Upscope service. */
   connect() {
-    _NativeUpscopeModule.default.connect();
+    native().connect();
   },
   /** Close the WebSocket connection. */
   disconnect() {
-    _NativeUpscopeModule.default.disconnect();
+    native().disconnect();
   },
   /**
    * Reset the connection state.
    * @param reconnect - Whether to reconnect immediately after reset. Defaults to true.
    */
   reset(reconnect = true) {
-    _NativeUpscopeModule.default.reset(reconnect);
+    native().reset(reconnect);
   },
   /**
    * Update user identity and metadata sent to the Upscope service.
    * Safe to call at any time; changes are pushed on the next sync.
    */
   updateConnection(params) {
-    _NativeUpscopeModule.default.updateConnection(params);
+    native().updateConnection(params);
   },
   /** Terminate the active co-browsing session. */
   stopSession() {
-    _NativeUpscopeModule.default.stopSession();
+    native().stopSession();
   },
   /** Request that an agent join the current session. */
   requestAgent() {
-    _NativeUpscopeModule.default.requestAgent();
+    native().requestAgent();
   },
   /** Cancel a pending agent-join request. */
   cancelAgentRequest() {
-    _NativeUpscopeModule.default.cancelAgentRequest();
+    native().cancelAgentRequest();
+  },
+  /**
+   * Revoke the agent's active remote control while keeping the session alive.
+   * No-op if remote control is not currently active.
+   */
+  stopRemoteControl() {
+    native().stopRemoteControl();
+  },
+  /**
+   * End full-device (broadcast) sharing and revert to in-app sharing, keeping
+   * the session alive. No-op if full-device sharing is not currently active.
+   */
+  stopFullDeviceSharing() {
+    native().stopFullDeviceSharing();
+  },
+  /**
+   * Answer a pending full-device sharing request delivered via the
+   * `fullDeviceRequest` event.
+   *
+   * @param requestId - The id from the `fullDeviceRequest` event payload.
+   * @param accept    - `true` to allow full-device capture, `false` to reject.
+   */
+  respondToFullDeviceRequest(requestId, accept) {
+    native().respondToFullDeviceRequest(requestId, accept);
   },
   /**
    * Ask the native layer to emit the current lookup code via the
@@ -70,19 +107,19 @@ const Upscope = {
    * asynchronously through the event system.
    */
   getLookupCode() {
-    _NativeUpscopeModule.default.getLookupCode();
+    native().getLookupCode();
   },
   /** Resolve the current short ID, or null if not yet assigned. */
   getShortId() {
-    return _NativeUpscopeModule.default.getShortId();
+    return native().getShortId();
   },
   /** Resolve the watch link for the current session, or null if unavailable. */
   getWatchLink() {
-    return _NativeUpscopeModule.default.getWatchLink();
+    return native().getWatchLink();
   },
-  /** Send an arbitrary string message to all connected observers. */
+  /** Send an arbitrary string message to all connected viewers. */
   sendCustomMessage(message) {
-    _NativeUpscopeModule.default.sendCustomMessage(message);
+    native().sendCustomMessage(message);
   },
   /**
    * Subscribe to a typed Upscope event.
@@ -92,7 +129,7 @@ const Upscope = {
    * @returns A subscription handle. Call `.remove()` to unsubscribe.
    */
   addListener(eventName, callback) {
-    return emitter.addListener(eventName, callback);
+    return emitter().addListener(eventName, callback);
   }
 };
 var _default = exports.default = Upscope;

package/lib/commonjs/Upscope.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_NativeUpscopeModule","_interopRequireDefault","_version","e","__esModule","default","emitter","NativeEventEmitter","NativeUpscopeModule","Upscope","initialize","config","wrapperVersion","SDK_VERSION","connect","disconnect","reset","reconnect","updateConnection","params","stopSession","requestAgent","cancelAgentRequest","getLookupCode","getShortId","getWatchLink","sendCustomMessage","message","addListener","eventName","callback","_default","exports"],"sourceRoot":"../../src","sources":["Upscope.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,oBAAA,GAAAC,sBAAA,CAAAF,OAAA;AACA,IAAAG,QAAA,GAAAH,OAAA;AAAwC,SAAAE,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAQxC;AACA;AACA;AACA;;AAKA;AACA,MAAMG,OAAO,GAAG,IAAIC,+BAAkB,CAACC,4BAAmB,CAAC;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,OAAO,GAAG;EACd;EACAC,UAAUA,CAACC,MAAqB,EAAQ;IACtCH,4BAAmB,CAACE,UAAU,CAAC;MAC7B,GAAGC,MAAM;MACTC,cAAc,EAAEC;IAClB,CAAsB,CAAC;EACzB,CAAC;EAED;EACAC,OAAOA,CAAA,EAAS;IACdN,4BAAmB,CAACM,OAAO,CAAC,CAAC;EAC/B,CAAC;EAED;EACAC,UAAUA,CAAA,EAAS;IACjBP,4BAAmB,CAACO,UAAU,CAAC,CAAC;EAClC,CAAC;EAED;AACF;AACA;AACA;EACEC,KAAKA,CAACC,SAAkB,GAAG,IAAI,EAAQ;IACrCT,4BAAmB,CAACQ,KAAK,CAACC,SAAS,CAAC;EACtC,CAAC;EAED;AACF;AACA;AACA;EACEC,gBAAgBA,CAACC,MAA8B,EAAQ;IACrDX,4BAAmB,CAACU,gBAAgB,CAACC,MAA2B,CAAC;EACnE,CAAC;EAED;EACAC,WAAWA,CAAA,EAAS;IAClBZ,4BAAmB,CAACY,WAAW,CAAC,CAAC;EACnC,CAAC;EAED;EACAC,YAAYA,CAAA,EAAS;IACnBb,4BAAmB,CAACa,YAAY,CAAC,CAAC;EACpC,CAAC;EAED;EACAC,kBAAkBA,CAAA,EAAS;IACzBd,4BAAmB,CAACc,kBAAkB,CAAC,CAAC;EAC1C,CAAC;EAED;AACF;AACA;AACA;AACA;EACEC,aAAaA,CAAA,EAAS;IACpBf,4BAAmB,CAACe,aAAa,CAAC,CAAC;EACrC,CAAC;EAED;EACAC,UAAUA,CAAA,EAA2B;IACnC,OAAOhB,4BAAmB,CAACgB,UAAU,CAAC,CAAC;EACzC,CAAC;EAED;EACAC,YAAYA,CAAA,EAA2B;IACrC,OAAOjB,4BAAmB,CAACiB,YAAY,CAAC,CAAC;EAC3C,CAAC;EAED;EACAC,iBAAiBA,CAACC,OAAe,EAAQ;IACvCnB,4BAAmB,CAACkB,iBAAiB,CAACC,OAAO,CAAC;EAChD,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,WAAWA,CACTC,SAAY,EACZC,QAA6C,EAC1B;IACnB,OAAOxB,OAAO,CAACsB,WAAW,CAACC,SAAS,EAAEC,QAAQ,CAAC;EACjD;AACF,CAAU;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAA3B,OAAA,GAEII,OAAO","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_version","nativeModule","native","TurboModuleRegistry","getEnforcing","eventEmitter","emitter","NativeEventEmitter","Upscope","initialize","config","wrapperVersion","SDK_VERSION","connect","disconnect","reset","reconnect","updateConnection","params","stopSession","requestAgent","cancelAgentRequest","stopRemoteControl","stopFullDeviceSharing","respondToFullDeviceRequest","requestId","accept","getLookupCode","getShortId","getWatchLink","sendCustomMessage","message","addListener","eventName","callback","_default","exports","default"],"sourceRoot":"../../src","sources":["Upscope.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/hooks.js

@@ -4,7 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useConnectionState = useConnectionState;
+exports.useFullDeviceSharingState = useFullDeviceSharingState;
 exports.useLookupCode = useLookupCode;
+exports.useRemoteControlState = useRemoteControlState;
 exports.useSessionState = useSessionState;
 exports.useShortId = useShortId;
 exports.useUpscope = useUpscope;
@@ -27,12 +29,19 @@ function useConnectionState() {
 }
 
 /**
- * Returns the current co-browsing session state. Transitions to "active" on
- * `sessionStarted` and back to "inactive" on `sessionEnded`.
+ * Returns the current co-browsing session state.
+ *
+ * Seeds and stays in sync via the `sessionStateChanged` event, which the
+ * native layer drives from a current-value publisher — so a fresh subscription
+ * immediately receives the real state, even across remounts. The
+ * `sessionStarted`/`sessionEnded` events provide redundant fast-path updates.
  */
 function useSessionState() {
   const [state, setState] = (0, _react.useState)("inactive");
   (0, _react.useEffect)(() => {
+    const subState = _Upscope.default.addListener("sessionStateChanged", event => {
+      setState(event.state);
+    });
     const subStart = _Upscope.default.addListener("sessionStarted", () => {
       setState("active");
     });
@@ -40,6 +49,7 @@ function useSessionState() {
       setState("inactive");
     });
     return () => {
+      subState.remove();
       subStart.remove();
       subEnd.remove();
     };
@@ -79,6 +89,36 @@ function useLookupCode() {
   return code;
 }
 
+/**
+ * Returns whether an agent currently has remote control of the device.
+ * Defaults to "inactive" and stays in sync via `remoteControlStateChanged`.
+ */
+function useRemoteControlState() {
+  const [state, setState] = (0, _react.useState)("inactive");
+  (0, _react.useEffect)(() => {
+    const sub = _Upscope.default.addListener("remoteControlStateChanged", event => {
+      setState(event.state);
+    });
+    return () => sub.remove();
+  }, []);
+  return state;
+}
+
+/**
+ * Returns whether full-device (broadcast) screen sharing is currently running.
+ * Defaults to "inactive" and stays in sync via `fullDeviceSharingStateChanged`.
+ */
+function useFullDeviceSharingState() {
+  const [state, setState] = (0, _react.useState)("inactive");
+  (0, _react.useEffect)(() => {
+    const sub = _Upscope.default.addListener("fullDeviceSharingStateChanged", event => {
+      setState(event.state);
+    });
+    return () => sub.remove();
+  }, []);
+  return state;
+}
+
 /**
  * Returns a stable object of imperative Upscope action methods.
  * Safe to use as a dependency in `useCallback` / `useEffect`.
@@ -90,6 +130,9 @@ function useUpscope() {
     stopSession: _Upscope.default.stopSession,
     requestAgent: _Upscope.default.requestAgent,
     cancelAgentRequest: _Upscope.default.cancelAgentRequest,
+    stopRemoteControl: _Upscope.default.stopRemoteControl,
+    stopFullDeviceSharing: _Upscope.default.stopFullDeviceSharing,
+    respondToFullDeviceRequest: _Upscope.default.respondToFullDeviceRequest,
     sendCustomMessage: _Upscope.default.sendCustomMessage,
     getLookupCode: _Upscope.default.getLookupCode,
     reset: _Upscope.default.reset

package/lib/commonjs/hooks.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_Upscope","_interopRequireDefault","e","__esModule","default","useConnectionState","state","setState","useState","useEffect","sub","Upscope","addListener","event","remove","useSessionState","subStart","subEnd","useShortId","shortId","setShortId","getShortId","then","useLookupCode","code","setCode","lookupCode","useUpscope","useMemo","connect","disconnect","stopSession","requestAgent","cancelAgentRequest","sendCustomMessage","getLookupCode","reset"],"sourceRoot":"../../src","sources":["hooks.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","require","_Upscope","_interopRequireDefault","e","__esModule","default","useConnectionState","state","setState","useState","useEffect","sub","Upscope","addListener","event","remove","useSessionState","subState","subStart","subEnd","useShortId","shortId","setShortId","getShortId","then","useLookupCode","code","setCode","lookupCode","useRemoteControlState","useFullDeviceSharingState","useUpscope","useMemo","connect","disconnect","stopSession","requestAgent","cancelAgentRequest","stopRemoteControl","stopFullDeviceSharing","respondToFullDeviceRequest","sendCustomMessage","getLookupCode","reset"],"sourceRoot":"../../src","sources":["hooks.ts"],"mappings":"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","ignoreList":[]}