@upscopeio/react-native-sdk 2026.3.0

package/ios/UpscopeMaskedView.swift

@@ -0,0 +1,18 @@
+import UIKit
+import UpscopeSDK
+
+class UpscopeMaskedView: UIView {
+
+    override func didMoveToWindow() {
+        super.didMoveToWindow()
+        if window != nil {
+            Task { @MainActor in
+                Upscope.shared.addMaskedView(self)
+            }
+        } else {
+            Task { @MainActor in
+                Upscope.shared.removeMaskedView(self)
+            }
+        }
+    }
+}

package/ios/UpscopeMaskedViewManager.mm

@@ -0,0 +1,4 @@
+#import <React/RCTViewManager.h>
+
+@interface RCT_EXTERN_MODULE(UpscopeMaskedViewManager, RCTViewManager)
+@end

package/ios/UpscopeMaskedViewManager.swift

@@ -0,0 +1,13 @@
+import React
+
+@objc(UpscopeMaskedViewManager)
+class UpscopeMaskedViewManager: RCTViewManager {
+
+    override static func requiresMainQueueSetup() -> Bool {
+        return true
+    }
+
+    override func view() -> UIView {
+        return UpscopeMaskedView()
+    }
+}

package/ios/UpscopeModule.mm

@@ -0,0 +1,31 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+#import <ReactCommon/RCTTurboModule.h>
+#import <UpscopeSpec/UpscopeSpec.h>
+
+@interface RCT_EXTERN_MODULE(UpscopeModule, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(initialize:(NSDictionary *)config)
+RCT_EXTERN_METHOD(connect)
+RCT_EXTERN_METHOD(disconnect)
+RCT_EXTERN_METHOD(reset:(BOOL)reconnect)
+RCT_EXTERN_METHOD(updateConnection:(NSDictionary *)params)
+RCT_EXTERN_METHOD(stopSession)
+RCT_EXTERN_METHOD(requestAgent)
+RCT_EXTERN_METHOD(cancelAgentRequest)
+RCT_EXTERN_METHOD(getLookupCode)
+RCT_EXTERN_METHOD(getShortId:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(getWatchLink:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(sendCustomMessage:(NSString *)message)
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:(const facebook::react::ObjCTurboModule::InitParams &)params {
+    return std::make_shared<facebook::react::NativeUpscopeModuleSpecJSI>(params);
+}
+
+@end
+
+@interface UpscopeModule (TurboModule) <RCTTurboModule>
+@end
+
+@implementation UpscopeModule (TurboModule)
+@end

package/ios/UpscopeModule.swift

@@ -0,0 +1,243 @@
+import Foundation
+import React
+import UpscopeSDK
+
+@objc(UpscopeModule)
+class UpscopeModule: RCTEventEmitter, UpscopeDelegate {
+
+    private var hasListeners = false
+
+    override init() {
+        super.init()
+    }
+
+    @objc override static func requiresMainQueueSetup() -> Bool {
+        return true
+    }
+
+    override func supportedEvents() -> [String] {
+        return [
+            "connectionStateChanged",
+            "sessionStarted",
+            "sessionEnded",
+            "customMessageReceived",
+            "error",
+            "observerJoined",
+            "observerLeft",
+            "observerCountChanged",
+            "shortIdChanged",
+            "lookupCodeChanged",
+        ]
+    }
+
+    override func startObserving() {
+        hasListeners = true
+        Task { @MainActor in
+            for await shortId in Upscope.shared.shortIdPublisher.values {
+                guard self.hasListeners else { break }
+                self.sendEvent(withName: "shortIdChanged", body: ["shortId": shortId as Any])
+            }
+        }
+        Task { @MainActor in
+            for await code in Upscope.shared.lookupCodePublisher.values {
+                guard self.hasListeners else { break }
+                self.sendEvent(withName: "lookupCodeChanged", body: ["lookupCode": code as Any])
+            }
+        }
+    }
+
+    override func stopObserving() {
+        hasListeners = false
+    }
+
+    // MARK: - Initialization
+
+    @objc func initialize(_ config: NSDictionary) {
+        guard let apiKey = config["apiKey"] as? String else { return }
+
+        let upscopeConfig = UpscopeConfiguration(
+            apiKey: apiKey,
+            requireAuthorizationForSession: config["requireAuthorizationForSession"] as? Bool ?? true,
+            autoconnect: config["autoConnect"] as? Bool ?? true,
+            region: config["region"] as? String,
+            showTerminateButton: config["showTerminateButton"] as? Bool ?? true,
+            authorizationPromptTitle: config["authorizationPromptTitle"] as? String ?? "Screen Sharing Request",
+            authorizationPromptMessage: config["authorizationPromptMessage"] as? String ?? "An agent wants to view your screen. Do you accept?",
+            endOfSessionMessage: config["endOfSessionMessage"] as? String,
+            stopSessionText: config["stopSessionText"] as? String ?? "Stop Sharing",
+            allowRemoteClick: config["allowRemoteClick"] as? Bool,
+            allowRemoteScroll: config["allowRemoteScroll"] as? Bool,
+            requireControlRequest: config["requireControlRequest"] as? Bool,
+            wrapper: "react-native"
+        )
+
+        Task { @MainActor in
+            try Upscope.shared.initialize(with: upscopeConfig)
+            Upscope.shared.delegate = self
+        }
+    }
+
+    // MARK: - Connection
+
+    @objc func connect() {
+        Task { @MainActor in Upscope.shared.connect() }
+    }
+
+    @objc func disconnect() {
+        Task { @MainActor in Upscope.shared.disconnect() }
+    }
+
+    @objc func reset(_ reconnect: Bool) {
+        Task { @MainActor in Upscope.shared.reset(reconnect: reconnect) }
+    }
+
+    @objc func updateConnection(_ params: NSDictionary) {
+        Task { @MainActor in
+            Upscope.shared.updateConnection(
+                uniqueId: params["uniqueId"] as? String,
+                callName: params["callName"] as? String,
+                tags: params["tags"] as? [String],
+                identities: params["identities"] as? [String],
+                metadata: params["metadata"] as? [String: String]
+            )
+        }
+    }
+
+    // MARK: - Session
+
+    @objc func stopSession() {
+        Task { @MainActor in Upscope.shared.stopSession() }
+    }
+
+    @objc func requestAgent() {
+        Task { @MainActor in Upscope.shared.requestAgent() }
+    }
+
+    @objc func cancelAgentRequest() {
+        Task { @MainActor in Upscope.shared.cancelAgentRequest() }
+    }
+
+    // MARK: - Lookup
+
+    @objc func getLookupCode() {
+        Task { @MainActor in Upscope.shared.getLookupCode() }
+    }
+
+    @objc func getShortId(_ resolve: @escaping RCTPromiseResolveBlock,
+                           reject: @escaping RCTPromiseRejectBlock) {
+        Task { @MainActor in
+            resolve(Upscope.shared.shortId)
+        }
+    }
+
+    @objc func getWatchLink(_ resolve: @escaping RCTPromiseResolveBlock,
+                             reject: @escaping RCTPromiseRejectBlock) {
+        Task { @MainActor in
+            resolve(Upscope.shared.watchLink)
+        }
+    }
+
+    // MARK: - Messaging
+
+    @objc func sendCustomMessage(_ message: String) {
+        Task { @MainActor in Upscope.shared.sendCustomMessage(message) }
+    }
+
+    // MARK: - UpscopeDelegate
+
+    @MainActor
+    func upscope(_ upscope: Upscope, didChangeConnectionState state: ConnectionState) {
+        guard hasListeners else { return }
+        var body: [String: Any] = ["state": serializeConnectionState(state)]
+        if case let .error(error) = state {
+            body["error"] = serializeError(error)
+        }
+        sendEvent(withName: "connectionStateChanged", body: body)
+    }
+
+    @MainActor
+    func upscopeSessionDidStart(_ upscope: Upscope, agentName: String?) {
+        guard hasListeners else { return }
+        sendEvent(withName: "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)
+    }
+
+    @MainActor
+    func upscope(_ upscope: Upscope, didReceiveCustomMessage message: String, from observerId: String) {
+        guard hasListeners else { return }
+        sendEvent(withName: "customMessageReceived", body: [
+            "message": message,
+            "observerId": observerId,
+        ])
+    }
+
+    @MainActor
+    func upscope(_ upscope: Upscope, didEncounterError error: UpscopeError) {
+        guard hasListeners else { return }
+        sendEvent(withName: "error", body: serializeError(error))
+    }
+
+    @MainActor
+    func upscope(_ upscope: Upscope, observerDidJoin observer: Observer) {
+        guard hasListeners else { return }
+        sendEvent(withName: "observerJoined", body: serializeObserver(observer))
+    }
+
+    @MainActor
+    func upscope(_ upscope: Upscope, observerDidLeave observerId: String) {
+        guard hasListeners else { return }
+        sendEvent(withName: "observerLeft", body: ["observerId": observerId])
+    }
+
+    @MainActor
+    func upscope(_ upscope: Upscope, observerCountDidChange count: Int) {
+        guard hasListeners else { return }
+        sendEvent(withName: "observerCountChanged", body: ["count": count])
+    }
+
+    // MARK: - Serialization
+
+    private func serializeConnectionState(_ state: ConnectionState) -> String {
+        switch state {
+        case .inactive: return "inactive"
+        case .connecting: return "connecting"
+        case .connected: return "connected"
+        case .reconnecting: return "reconnecting"
+        case .error: return "error"
+        }
+    }
+
+    private func serializeEndReason(_ reason: SessionEndReason) -> String {
+        switch reason {
+        case .userStopped: return "userStopped"
+        case .agentStopped: return "agentStopped"
+        case .timeout: return "timeout"
+        case .error: return "error"
+        }
+    }
+
+    private func serializeError(_ error: UpscopeError) -> [String: String] {
+        return ["code": error.code, "message": error.message]
+    }
+
+    private func serializeObserver(_ observer: Observer) -> [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,
+        ]
+    }
+}

package/lib/commonjs/NativeUpscopeMaskedView.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _codegenNativeComponent = _interopRequireDefault(require("react-native/Libraries/Utilities/codegenNativeComponent"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+var _default = exports.default = (0, _codegenNativeComponent.default)("UpscopeMaskedView");
+//# sourceMappingURL=NativeUpscopeMaskedView.js.map

package/lib/commonjs/NativeUpscopeMaskedView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_codegenNativeComponent","_interopRequireDefault","require","e","__esModule","default","_default","exports","codegenNativeComponent"],"sourceRoot":"../../src","sources":["NativeUpscopeMaskedView.ts"],"mappings":";;;;;;AAEA,IAAAA,uBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA6F,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,IAAAG,QAAA,GAAAC,OAAA,CAAAF,OAAA,GAI9E,IAAAG,+BAAsB,EACnC,mBACF,CAAC","ignoreList":[]}

package/lib/commonjs/NativeUpscopeModule.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _reactNative = require("react-native");
+var _default = exports.default = _reactNative.TurboModuleRegistry.getEnforcing("UpscopeModule");
+//# sourceMappingURL=NativeUpscopeModule.js.map

package/lib/commonjs/NativeUpscopeModule.js.map

@@ -0,0 +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":[]}

package/lib/commonjs/Upscope.js

@@ -0,0 +1,95 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _reactNative = require("react-native");
+var _NativeUpscopeModule = _interopRequireDefault(require("./NativeUpscopeModule"));
+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);
+
+/**
+ * Imperative JS API over the native Upscope TurboModule.
+ *
+ * All methods are thin typed wrappers; no business logic lives here.
+ * Prefer using the React hooks in this package inside components.
+ */
+const Upscope = {
+  /** Initialise the SDK. Must be called before any other method. */
+  initialize(config) {
+    _NativeUpscopeModule.default.initialize(config);
+  },
+  /** Open a WebSocket connection to the Upscope service. */
+  connect() {
+    _NativeUpscopeModule.default.connect();
+  },
+  /** Close the WebSocket connection. */
+  disconnect() {
+    _NativeUpscopeModule.default.disconnect();
+  },
+  /**
+   * Reset the connection state.
+   * @param reconnect - Whether to reconnect immediately after reset. Defaults to true.
+   */
+  reset(reconnect = true) {
+    _NativeUpscopeModule.default.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);
+  },
+  /** Terminate the active co-browsing session. */
+  stopSession() {
+    _NativeUpscopeModule.default.stopSession();
+  },
+  /** Request that an agent join the current session. */
+  requestAgent() {
+    _NativeUpscopeModule.default.requestAgent();
+  },
+  /** Cancel a pending agent-join request. */
+  cancelAgentRequest() {
+    _NativeUpscopeModule.default.cancelAgentRequest();
+  },
+  /**
+   * Ask the native layer to emit the current lookup code via the
+   * `lookupCodeChanged` event. The lookup code itself is delivered
+   * asynchronously through the event system.
+   */
+  getLookupCode() {
+    _NativeUpscopeModule.default.getLookupCode();
+  },
+  /** Resolve the current short ID, or null if not yet assigned. */
+  getShortId() {
+    return _NativeUpscopeModule.default.getShortId();
+  },
+  /** Resolve the watch link for the current session, or null if unavailable. */
+  getWatchLink() {
+    return _NativeUpscopeModule.default.getWatchLink();
+  },
+  /** Send an arbitrary string message to all connected observers. */
+  sendCustomMessage(message) {
+    _NativeUpscopeModule.default.sendCustomMessage(message);
+  },
+  /**
+   * Subscribe to a typed Upscope event.
+   *
+   * @param eventName - One of the well-known event names from UpscopeEventMap.
+   * @param callback  - Invoked with the strongly-typed payload on each event.
+   * @returns A subscription handle. Call `.remove()` to unsubscribe.
+   */
+  addListener(eventName, callback) {
+    return emitter.addListener(eventName, callback);
+  }
+};
+var _default = exports.default = Upscope;
+//# sourceMappingURL=Upscope.js.map

package/lib/commonjs/Upscope.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_NativeUpscopeModule","_interopRequireDefault","e","__esModule","default","emitter","NativeEventEmitter","NativeUpscopeModule","Upscope","initialize","config","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;AAAwD,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAQxD;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,CAACC,MAA2B,CAAC;EAC7D,CAAC;EAED;EACAC,OAAOA,CAAA,EAAS;IACdJ,4BAAmB,CAACI,OAAO,CAAC,CAAC;EAC/B,CAAC;EAED;EACAC,UAAUA,CAAA,EAAS;IACjBL,4BAAmB,CAACK,UAAU,CAAC,CAAC;EAClC,CAAC;EAED;AACF;AACA;AACA;EACEC,KAAKA,CAACC,SAAkB,GAAG,IAAI,EAAQ;IACrCP,4BAAmB,CAACM,KAAK,CAACC,SAAS,CAAC;EACtC,CAAC;EAED;AACF;AACA;AACA;EACEC,gBAAgBA,CAACC,MAA8B,EAAQ;IACrDT,4BAAmB,CAACQ,gBAAgB,CAACC,MAA2B,CAAC;EACnE,CAAC;EAED;EACAC,WAAWA,CAAA,EAAS;IAClBV,4BAAmB,CAACU,WAAW,CAAC,CAAC;EACnC,CAAC;EAED;EACAC,YAAYA,CAAA,EAAS;IACnBX,4BAAmB,CAACW,YAAY,CAAC,CAAC;EACpC,CAAC;EAED;EACAC,kBAAkBA,CAAA,EAAS;IACzBZ,4BAAmB,CAACY,kBAAkB,CAAC,CAAC;EAC1C,CAAC;EAED;AACF;AACA;AACA;AACA;EACEC,aAAaA,CAAA,EAAS;IACpBb,4BAAmB,CAACa,aAAa,CAAC,CAAC;EACrC,CAAC;EAED;EACAC,UAAUA,CAAA,EAA2B;IACnC,OAAOd,4BAAmB,CAACc,UAAU,CAAC,CAAC;EACzC,CAAC;EAED;EACAC,YAAYA,CAAA,EAA2B;IACrC,OAAOf,4BAAmB,CAACe,YAAY,CAAC,CAAC;EAC3C,CAAC;EAED;EACAC,iBAAiBA,CAACC,OAAe,EAAQ;IACvCjB,4BAAmB,CAACgB,iBAAiB,CAACC,OAAO,CAAC;EAChD,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,WAAWA,CACTC,SAAY,EACZC,QAA6C,EAC1B;IACnB,OAAOtB,OAAO,CAACoB,WAAW,CAACC,SAAS,EAAEC,QAAQ,CAAC;EACjD;AACF,CAAU;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAzB,OAAA,GAEII,OAAO","ignoreList":[]}

package/lib/commonjs/UpscopeMasked.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UpscopeMasked = UpscopeMasked;
+var _react = _interopRequireDefault(require("react"));
+var _NativeUpscopeMaskedView = _interopRequireDefault(require("./NativeUpscopeMaskedView"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function UpscopeMasked({
+  children,
+  style,
+  ...props
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_NativeUpscopeMaskedView.default, {
+    style: style,
+    ...props,
+    children: children
+  });
+}
+//# sourceMappingURL=UpscopeMasked.js.map

package/lib/commonjs/UpscopeMasked.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireDefault","require","_NativeUpscopeMaskedView","_jsxRuntime","e","__esModule","default","UpscopeMasked","children","style","props","jsx"],"sourceRoot":"../../src","sources":["UpscopeMasked.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AAEA,IAAAC,wBAAA,GAAAF,sBAAA,CAAAC,OAAA;AAAgE,IAAAE,WAAA,GAAAF,OAAA;AAAA,SAAAD,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAMzD,SAASG,aAAaA,CAAC;EAC5BC,QAAQ;EACRC,KAAK;EACL,GAAGC;AACe,CAAC,EAAE;EACrB,oBACE,IAAAP,WAAA,CAAAQ,GAAA,EAACT,wBAAA,CAAAI,OAAuB;IAACG,KAAK,EAAEA,KAAM;IAAA,GAAKC,KAAK;IAAAF,QAAA,EAC7CA;EAAQ,CACc,CAAC;AAE9B","ignoreList":[]}

package/lib/commonjs/hooks.js

@@ -0,0 +1,98 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useConnectionState = useConnectionState;
+exports.useLookupCode = useLookupCode;
+exports.useSessionState = useSessionState;
+exports.useShortId = useShortId;
+exports.useUpscope = useUpscope;
+var _react = require("react");
+var _Upscope = _interopRequireDefault(require("./Upscope"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Returns the current WebSocket connection state, updated reactively via the
+ * `connectionStateChanged` event. Starts as "inactive" before the first event.
+ */
+function useConnectionState() {
+  const [state, setState] = (0, _react.useState)("inactive");
+  (0, _react.useEffect)(() => {
+    const sub = _Upscope.default.addListener("connectionStateChanged", event => {
+      setState(event.state);
+    });
+    return () => sub.remove();
+  }, []);
+  return state;
+}
+
+/**
+ * Returns the current co-browsing session state. Transitions to "active" on
+ * `sessionStarted` and back to "inactive" on `sessionEnded`.
+ */
+function useSessionState() {
+  const [state, setState] = (0, _react.useState)("inactive");
+  (0, _react.useEffect)(() => {
+    const subStart = _Upscope.default.addListener("sessionStarted", () => {
+      setState("active");
+    });
+    const subEnd = _Upscope.default.addListener("sessionEnded", () => {
+      setState("inactive");
+    });
+    return () => {
+      subStart.remove();
+      subEnd.remove();
+    };
+  }, []);
+  return state;
+}
+
+/**
+ * Returns the SDK short ID, or null if not yet assigned.
+ * Resolves the current value on mount and stays in sync via `shortIdChanged`.
+ */
+function useShortId() {
+  const [shortId, setShortId] = (0, _react.useState)(null);
+  (0, _react.useEffect)(() => {
+    // Seed with the current value; the listener handles all subsequent changes.
+    _Upscope.default.getShortId().then(setShortId);
+    const sub = _Upscope.default.addListener("shortIdChanged", event => {
+      setShortId(event.shortId);
+    });
+    return () => sub.remove();
+  }, []);
+  return shortId;
+}
+
+/**
+ * Returns the current lookup code, or null until the native layer emits one.
+ * Updated reactively via `lookupCodeChanged`.
+ */
+function useLookupCode() {
+  const [code, setCode] = (0, _react.useState)(null);
+  (0, _react.useEffect)(() => {
+    const sub = _Upscope.default.addListener("lookupCodeChanged", event => {
+      setCode(event.lookupCode);
+    });
+    return () => sub.remove();
+  }, []);
+  return code;
+}
+
+/**
+ * Returns a stable object of imperative Upscope action methods.
+ * Safe to use as a dependency in `useCallback` / `useEffect`.
+ */
+function useUpscope() {
+  return (0, _react.useMemo)(() => ({
+    connect: _Upscope.default.connect,
+    disconnect: _Upscope.default.disconnect,
+    stopSession: _Upscope.default.stopSession,
+    requestAgent: _Upscope.default.requestAgent,
+    cancelAgentRequest: _Upscope.default.cancelAgentRequest,
+    sendCustomMessage: _Upscope.default.sendCustomMessage,
+    getLookupCode: _Upscope.default.getLookupCode,
+    reset: _Upscope.default.reset
+  }), []);
+}
+//# sourceMappingURL=hooks.js.map

package/lib/commonjs/hooks.js.map

@@ -0,0 +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":[]}

package/lib/commonjs/index.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Upscope", {
+  enumerable: true,
+  get: function () {
+    return _Upscope.default;
+  }
+});
+Object.defineProperty(exports, "UpscopeMasked", {
+  enumerable: true,
+  get: function () {
+    return _UpscopeMasked.UpscopeMasked;
+  }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _Upscope.default;
+  }
+});
+Object.defineProperty(exports, "useConnectionState", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useConnectionState;
+  }
+});
+Object.defineProperty(exports, "useLookupCode", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useLookupCode;
+  }
+});
+Object.defineProperty(exports, "useSessionState", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useSessionState;
+  }
+});
+Object.defineProperty(exports, "useShortId", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useShortId;
+  }
+});
+Object.defineProperty(exports, "useUpscope", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useUpscope;
+  }
+});
+var _Upscope = _interopRequireDefault(require("./Upscope"));
+var _hooks = require("./hooks");
+var _UpscopeMasked = require("./UpscopeMasked");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_Upscope","_interopRequireDefault","require","_hooks","_UpscopeMasked","e","__esModule","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,QAAA,GAAAC,sBAAA,CAAAC,OAAA;AAIA,IAAAC,MAAA,GAAAD,OAAA;AAQA,IAAAE,cAAA,GAAAF,OAAA;AAAgD,SAAAD,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/commonjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/NativeUpscopeMaskedView.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import codegenNativeComponent from "react-native/Libraries/Utilities/codegenNativeComponent";
+export default codegenNativeComponent("UpscopeMaskedView");
+//# sourceMappingURL=NativeUpscopeMaskedView.js.map

package/lib/module/NativeUpscopeMaskedView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["codegenNativeComponent"],"sourceRoot":"../../src","sources":["NativeUpscopeMaskedView.ts"],"mappings":";;AAEA,OAAOA,sBAAsB,MAAM,yDAAyD;AAI5F,eAAeA,sBAAsB,CACnC,mBACF,CAAC","ignoreList":[]}

package/lib/module/NativeUpscopeModule.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from "react-native";
+export default TurboModuleRegistry.getEnforcing("UpscopeModule");
+//# sourceMappingURL=NativeUpscopeModule.js.map

package/lib/module/NativeUpscopeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeUpscopeModule.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AA8BlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}