@upscopeio/react-native-sdk 2026.4.1 → 2026.4.2

package/lib/commonjs/index.js

@@ -27,12 +27,24 @@ Object.defineProperty(exports, "useConnectionState", {
     return _hooks.useConnectionState;
   }
 });
+Object.defineProperty(exports, "useFullDeviceSharingState", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useFullDeviceSharingState;
+  }
+});
 Object.defineProperty(exports, "useLookupCode", {
   enumerable: true,
   get: function () {
     return _hooks.useLookupCode;
   }
 });
+Object.defineProperty(exports, "useRemoteControlState", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useRemoteControlState;
+  }
+});
 Object.defineProperty(exports, "useSessionState", {
   enumerable: true,
   get: function () {

package/lib/commonjs/index.js.map

@@ -1 +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":[]}
+{"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;AAUA,IAAAE,cAAA,GAAAF,OAAA;AAAgD,SAAAD,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/lib/commonjs/version.js

@@ -5,5 +5,5 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.SDK_VERSION = void 0;
 // Auto-generated by scripts/generate-version.sh — do not edit manually
-const SDK_VERSION = exports.SDK_VERSION = "2026.4.1";
+const SDK_VERSION = exports.SDK_VERSION = "2026.4.2";
 //# sourceMappingURL=version.js.map

package/lib/module/NativeUpscopeModule.js.map

@@ -1 +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":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeUpscopeModule.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAmClD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}

package/lib/module/Upscope.js

@@ -1,16 +1,30 @@
 "use strict";
 
-import { NativeEventEmitter } from "react-native";
-import NativeUpscopeModule from "./NativeUpscopeModule";
-import { SDK_VERSION } from "./version";
+import { NativeEventEmitter, TurboModuleRegistry } from 'react-native';
+import { SDK_VERSION } from './version';
 
 /**
  * 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 NativeEventEmitter(NativeUpscopeModule);
+/**
+ * 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 ??= TurboModuleRegistry.getEnforcing('UpscopeModule');
+}
+
+// Lazily-created emitter — one instance for the lifetime of the JS runtime.
+let eventEmitter;
+function emitter() {
+  return eventEmitter ??= new NativeEventEmitter(native());
+}
 
 /**
  * Imperative JS API over the native Upscope TurboModule.
@@ -21,44 +35,68 @@ const emitter = new NativeEventEmitter(NativeUpscopeModule);
 const Upscope = {
   /** Initialise the SDK. Must be called before any other method. */
   initialize(config) {
-    NativeUpscopeModule.initialize({
+    native().initialize({
       ...config,
       wrapperVersion: SDK_VERSION
     });
   },
   /** Open a WebSocket connection to the Upscope service. */
   connect() {
-    NativeUpscopeModule.connect();
+    native().connect();
   },
   /** Close the WebSocket connection. */
   disconnect() {
-    NativeUpscopeModule.disconnect();
+    native().disconnect();
   },
   /**
    * Reset the connection state.
    * @param reconnect - Whether to reconnect immediately after reset. Defaults to true.
    */
   reset(reconnect = true) {
-    NativeUpscopeModule.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.updateConnection(params);
+    native().updateConnection(params);
   },
   /** Terminate the active co-browsing session. */
   stopSession() {
-    NativeUpscopeModule.stopSession();
+    native().stopSession();
   },
   /** Request that an agent join the current session. */
   requestAgent() {
-    NativeUpscopeModule.requestAgent();
+    native().requestAgent();
   },
   /** Cancel a pending agent-join request. */
   cancelAgentRequest() {
-    NativeUpscopeModule.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
@@ -66,19 +104,19 @@ const Upscope = {
    * asynchronously through the event system.
    */
   getLookupCode() {
-    NativeUpscopeModule.getLookupCode();
+    native().getLookupCode();
   },
   /** Resolve the current short ID, or null if not yet assigned. */
   getShortId() {
-    return NativeUpscopeModule.getShortId();
+    return native().getShortId();
   },
   /** Resolve the watch link for the current session, or null if unavailable. */
   getWatchLink() {
-    return NativeUpscopeModule.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.sendCustomMessage(message);
+    native().sendCustomMessage(message);
   },
   /**
    * Subscribe to a typed Upscope event.
@@ -88,7 +126,7 @@ const Upscope = {
    * @returns A subscription handle. Call `.remove()` to unsubscribe.
    */
   addListener(eventName, callback) {
-    return emitter.addListener(eventName, callback);
+    return emitter().addListener(eventName, callback);
   }
 };
 export default Upscope;

package/lib/module/Upscope.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeUpscopeModule","SDK_VERSION","emitter","Upscope","initialize","config","wrapperVersion","connect","disconnect","reset","reconnect","updateConnection","params","stopSession","requestAgent","cancelAgentRequest","getLookupCode","getShortId","getWatchLink","sendCustomMessage","message","addListener","eventName","callback"],"sourceRoot":"../../src","sources":["Upscope.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,cAAc;AACjD,OAAOC,mBAAmB,MAAM,uBAAuB;AACvD,SAASC,WAAW,QAAQ,WAAW;;AAQvC;AACA;AACA;AACA;;AAKA;AACA,MAAMC,OAAO,GAAG,IAAIH,kBAAkB,CAACC,mBAAmB,CAAC;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,OAAO,GAAG;EACd;EACAC,UAAUA,CAACC,MAAqB,EAAQ;IACtCL,mBAAmB,CAACI,UAAU,CAAC;MAC7B,GAAGC,MAAM;MACTC,cAAc,EAAEL;IAClB,CAAsB,CAAC;EACzB,CAAC;EAED;EACAM,OAAOA,CAAA,EAAS;IACdP,mBAAmB,CAACO,OAAO,CAAC,CAAC;EAC/B,CAAC;EAED;EACAC,UAAUA,CAAA,EAAS;IACjBR,mBAAmB,CAACQ,UAAU,CAAC,CAAC;EAClC,CAAC;EAED;AACF;AACA;AACA;EACEC,KAAKA,CAACC,SAAkB,GAAG,IAAI,EAAQ;IACrCV,mBAAmB,CAACS,KAAK,CAACC,SAAS,CAAC;EACtC,CAAC;EAED;AACF;AACA;AACA;EACEC,gBAAgBA,CAACC,MAA8B,EAAQ;IACrDZ,mBAAmB,CAACW,gBAAgB,CAACC,MAA2B,CAAC;EACnE,CAAC;EAED;EACAC,WAAWA,CAAA,EAAS;IAClBb,mBAAmB,CAACa,WAAW,CAAC,CAAC;EACnC,CAAC;EAED;EACAC,YAAYA,CAAA,EAAS;IACnBd,mBAAmB,CAACc,YAAY,CAAC,CAAC;EACpC,CAAC;EAED;EACAC,kBAAkBA,CAAA,EAAS;IACzBf,mBAAmB,CAACe,kBAAkB,CAAC,CAAC;EAC1C,CAAC;EAED;AACF;AACA;AACA;AACA;EACEC,aAAaA,CAAA,EAAS;IACpBhB,mBAAmB,CAACgB,aAAa,CAAC,CAAC;EACrC,CAAC;EAED;EACAC,UAAUA,CAAA,EAA2B;IACnC,OAAOjB,mBAAmB,CAACiB,UAAU,CAAC,CAAC;EACzC,CAAC;EAED;EACAC,YAAYA,CAAA,EAA2B;IACrC,OAAOlB,mBAAmB,CAACkB,YAAY,CAAC,CAAC;EAC3C,CAAC;EAED;EACAC,iBAAiBA,CAACC,OAAe,EAAQ;IACvCpB,mBAAmB,CAACmB,iBAAiB,CAACC,OAAO,CAAC;EAChD,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,WAAWA,CACTC,SAAY,EACZC,QAA6C,EAC1B;IACnB,OAAOrB,OAAO,CAACmB,WAAW,CAACC,SAAS,EAAEC,QAAQ,CAAC;EACjD;AACF,CAAU;AAEV,eAAepB,OAAO","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","TurboModuleRegistry","SDK_VERSION","nativeModule","native","getEnforcing","eventEmitter","emitter","Upscope","initialize","config","wrapperVersion","connect","disconnect","reset","reconnect","updateConnection","params","stopSession","requestAgent","cancelAgentRequest","stopRemoteControl","stopFullDeviceSharing","respondToFullDeviceRequest","requestId","accept","getLookupCode","getShortId","getWatchLink","sendCustomMessage","message","addListener","eventName","callback"],"sourceRoot":"../../src","sources":["Upscope.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks.js

@@ -18,12 +18,19 @@ export 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.
  */
 export function useSessionState() {
   const [state, setState] = useState("inactive");
   useEffect(() => {
+    const subState = Upscope.addListener("sessionStateChanged", event => {
+      setState(event.state);
+    });
     const subStart = Upscope.addListener("sessionStarted", () => {
       setState("active");
     });
@@ -31,6 +38,7 @@ export function useSessionState() {
       setState("inactive");
     });
     return () => {
+      subState.remove();
       subStart.remove();
       subEnd.remove();
     };
@@ -70,6 +78,36 @@ export function useLookupCode() {
   return code;
 }
 
+/**
+ * Returns whether an agent currently has remote control of the device.
+ * Defaults to "inactive" and stays in sync via `remoteControlStateChanged`.
+ */
+export function useRemoteControlState() {
+  const [state, setState] = useState("inactive");
+  useEffect(() => {
+    const sub = Upscope.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`.
+ */
+export function useFullDeviceSharingState() {
+  const [state, setState] = useState("inactive");
+  useEffect(() => {
+    const sub = Upscope.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`.
@@ -81,6 +119,9 @@ export function useUpscope() {
     stopSession: Upscope.stopSession,
     requestAgent: Upscope.requestAgent,
     cancelAgentRequest: Upscope.cancelAgentRequest,
+    stopRemoteControl: Upscope.stopRemoteControl,
+    stopFullDeviceSharing: Upscope.stopFullDeviceSharing,
+    respondToFullDeviceRequest: Upscope.respondToFullDeviceRequest,
     sendCustomMessage: Upscope.sendCustomMessage,
     getLookupCode: Upscope.getLookupCode,
     reset: Upscope.reset

package/lib/module/hooks.js.map

@@ -1 +1 @@
-{"version":3,"names":["useState","useEffect","useMemo","Upscope","useConnectionState","state","setState","sub","addListener","event","remove","useSessionState","subStart","subEnd","useShortId","shortId","setShortId","getShortId","then","useLookupCode","code","setCode","lookupCode","useUpscope","connect","disconnect","stopSession","requestAgent","cancelAgentRequest","sendCustomMessage","getLookupCode","reset"],"sourceRoot":"../../src","sources":["hooks.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,SAAS,EAAEC,OAAO,QAAQ,OAAO;AACpD,OAAOC,OAAO,MAAM,WAAW;AAG/B;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAoB;EACpD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGN,QAAQ,CAAkB,UAAU,CAAC;EAE/DC,SAAS,CAAC,MAAM;IACd,MAAMM,GAAG,GAAGJ,OAAO,CAACK,WAAW,CAAC,wBAAwB,EAAGC,KAAK,IAAK;MACnEH,QAAQ,CAACG,KAAK,CAACJ,KAAK,CAAC;IACvB,CAAC,CAAC;IACF,OAAO,MAAME,GAAG,CAACG,MAAM,CAAC,CAAC;EAC3B,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOL,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASM,eAAeA,CAAA,EAAiB;EAC9C,MAAM,CAACN,KAAK,EAAEC,QAAQ,CAAC,GAAGN,QAAQ,CAAe,UAAU,CAAC;EAE5DC,SAAS,CAAC,MAAM;IACd,MAAMW,QAAQ,GAAGT,OAAO,CAACK,WAAW,CAAC,gBAAgB,EAAE,MAAM;MAC3DF,QAAQ,CAAC,QAAQ,CAAC;IACpB,CAAC,CAAC;IACF,MAAMO,MAAM,GAAGV,OAAO,CAACK,WAAW,CAAC,cAAc,EAAE,MAAM;MACvDF,QAAQ,CAAC,UAAU,CAAC;IACtB,CAAC,CAAC;IACF,OAAO,MAAM;MACXM,QAAQ,CAACF,MAAM,CAAC,CAAC;MACjBG,MAAM,CAACH,MAAM,CAAC,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOL,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASS,UAAUA,CAAA,EAAkB;EAC1C,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGhB,QAAQ,CAAgB,IAAI,CAAC;EAE3DC,SAAS,CAAC,MAAM;IACd;IACAE,OAAO,CAACc,UAAU,CAAC,CAAC,CAACC,IAAI,CAACF,UAAU,CAAC;IACrC,MAAMT,GAAG,GAAGJ,OAAO,CAACK,WAAW,CAAC,gBAAgB,EAAGC,KAAK,IAAK;MAC3DO,UAAU,CAACP,KAAK,CAACM,OAAO,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO,MAAMR,GAAG,CAACG,MAAM,CAAC,CAAC;EAC3B,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOK,OAAO;AAChB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,aAAaA,CAAA,EAAkB;EAC7C,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAGrB,QAAQ,CAAgB,IAAI,CAAC;EAErDC,SAAS,CAAC,MAAM;IACd,MAAMM,GAAG,GAAGJ,OAAO,CAACK,WAAW,CAAC,mBAAmB,EAAGC,KAAK,IAAK;MAC9DY,OAAO,CAACZ,KAAK,CAACa,UAAU,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO,MAAMf,GAAG,CAACG,MAAM,CAAC,CAAC;EAC3B,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOU,IAAI;AACb;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASG,UAAUA,CAAA,EAAG;EAC3B,OAAOrB,OAAO,CACZ,OAAO;IACLsB,OAAO,EAAErB,OAAO,CAACqB,OAAO;IACxBC,UAAU,EAAEtB,OAAO,CAACsB,UAAU;IAC9BC,WAAW,EAAEvB,OAAO,CAACuB,WAAW;IAChCC,YAAY,EAAExB,OAAO,CAACwB,YAAY;IAClCC,kBAAkB,EAAEzB,OAAO,CAACyB,kBAAkB;IAC9CC,iBAAiB,EAAE1B,OAAO,CAAC0B,iBAAiB;IAC5CC,aAAa,EAAE3B,OAAO,CAAC2B,aAAa;IACpCC,KAAK,EAAE5B,OAAO,CAAC4B;EACjB,CAAC,CAAC,EACF,EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["useState","useEffect","useMemo","Upscope","useConnectionState","state","setState","sub","addListener","event","remove","useSessionState","subState","subStart","subEnd","useShortId","shortId","setShortId","getShortId","then","useLookupCode","code","setCode","lookupCode","useRemoteControlState","useFullDeviceSharingState","useUpscope","connect","disconnect","stopSession","requestAgent","cancelAgentRequest","stopRemoteControl","stopFullDeviceSharing","respondToFullDeviceRequest","sendCustomMessage","getLookupCode","reset"],"sourceRoot":"../../src","sources":["hooks.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -1,7 +1,7 @@
 "use strict";
 
-export { default } from "./Upscope";
-export { default as Upscope } from "./Upscope";
-export { useConnectionState, useSessionState, useShortId, useLookupCode, useUpscope } from "./hooks";
-export { UpscopeMasked } from "./UpscopeMasked";
+export { default } from './Upscope';
+export { default as Upscope } from './Upscope';
+export { useConnectionState, useSessionState, useShortId, useLookupCode, useRemoteControlState, useFullDeviceSharingState, useUpscope } from './hooks';
+export { UpscopeMasked } from './UpscopeMasked';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["default","Upscope","useConnectionState","useSessionState","useShortId","useLookupCode","useUpscope","UpscopeMasked"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,OAAkB,QAAQ,WAAW;AAC9C,SAASA,OAAO,IAAIC,OAAO,QAAQ,WAAW;AAG9C,SACEC,kBAAkB,EAClBC,eAAe,EACfC,UAAU,EACVC,aAAa,EACbC,UAAU,QACL,SAAS;AAEhB,SAASC,aAAa,QAAQ,iBAAiB","ignoreList":[]}
+{"version":3,"names":["default","Upscope","useConnectionState","useSessionState","useShortId","useLookupCode","useRemoteControlState","useFullDeviceSharingState","useUpscope","UpscopeMasked"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,OAAkB,QAAQ,WAAW;AAC9C,SAASA,OAAO,IAAIC,OAAO,QAAQ,WAAW;AAG9C,SACEC,kBAAkB,EAClBC,eAAe,EACfC,UAAU,EACVC,aAAa,EACbC,qBAAqB,EACrBC,yBAAyB,EACzBC,UAAU,QACL,SAAS;AAEhB,SAASC,aAAa,QAAQ,iBAAiB","ignoreList":[]}

package/lib/module/version.js

@@ -1,5 +1,5 @@
 "use strict";
 
 // Auto-generated by scripts/generate-version.sh — do not edit manually
-export const SDK_VERSION = "2026.4.1";
+export const SDK_VERSION = "2026.4.2";
 //# sourceMappingURL=version.js.map

package/lib/typescript/NativeUpscopeModule.d.ts

@@ -8,6 +8,9 @@ export interface Spec extends TurboModule {
     stopSession(): void;
     requestAgent(): void;
     cancelAgentRequest(): void;
+    stopRemoteControl(): void;
+    stopFullDeviceSharing(): void;
+    respondToFullDeviceRequest(requestId: string, accept: boolean): void;
     getLookupCode(): void;
     getShortId(): Promise<string | null>;
     getWatchLink(): Promise<string | null>;

package/lib/typescript/NativeUpscopeModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeUpscopeModule.d.ts","sourceRoot":"","sources":["../../src/NativeUpscopeModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAGjC,OAAO,IAAI,IAAI,CAAC;IAChB,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAGvC,WAAW,IAAI,IAAI,CAAC;IACpB,YAAY,IAAI,IAAI,CAAC;IACrB,kBAAkB,IAAI,IAAI,CAAC;IAG3B,aAAa,IAAI,IAAI,CAAC;IACtB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrC,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAGvC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGzC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAuE"}
+{"version":3,"file":"NativeUpscopeModule.d.ts","sourceRoot":"","sources":["../../src/NativeUpscopeModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAGjC,OAAO,IAAI,IAAI,CAAC;IAChB,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAGvC,WAAW,IAAI,IAAI,CAAC;IACpB,YAAY,IAAI,IAAI,CAAC;IACrB,kBAAkB,IAAI,IAAI,CAAC;IAG3B,iBAAiB,IAAI,IAAI,CAAC;IAC1B,qBAAqB,IAAI,IAAI,CAAC;IAC9B,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAGrE,aAAa,IAAI,IAAI,CAAC;IACtB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrC,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAGvC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGzC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAuE"}

package/lib/typescript/Upscope.d.ts

@@ -1,4 +1,4 @@
-import type { UpscopeConfig, ConnectionUpdateParams, UpscopeEventMap, UpscopeEventName } from "./types";
+import type { UpscopeConfig, ConnectionUpdateParams, UpscopeEventMap, UpscopeEventName } from './types';
 /**
  * Subscription handle returned by addListener. Callers must invoke remove()
  * to avoid memory leaks when the component/scope unmounts.
@@ -35,6 +35,24 @@ declare const Upscope: {
     readonly requestAgent: () => void;
     /** Cancel a pending agent-join request. */
     readonly cancelAgentRequest: () => void;
+    /**
+     * Revoke the agent's active remote control while keeping the session alive.
+     * No-op if remote control is not currently active.
+     */
+    readonly stopRemoteControl: () => void;
+    /**
+     * 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.
+     */
+    readonly stopFullDeviceSharing: () => void;
+    /**
+     * 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.
+     */
+    readonly respondToFullDeviceRequest: (requestId: string, accept: boolean) => void;
     /**
      * Ask the native layer to emit the current lookup code via the
      * `lookupCodeChanged` event. The lookup code itself is delivered
@@ -45,7 +63,7 @@ declare const Upscope: {
     readonly getShortId: () => Promise<string | null>;
     /** Resolve the watch link for the current session, or null if unavailable. */
     readonly getWatchLink: () => Promise<string | null>;
-    /** Send an arbitrary string message to all connected observers. */
+    /** Send an arbitrary string message to all connected viewers. */
     readonly sendCustomMessage: (message: string) => void;
     /**
      * Subscribe to a typed Upscope event.

package/lib/typescript/Upscope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Upscope.d.ts","sourceRoot":"","sources":["../../src/Upscope.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,IAAI,IAAI,CAAC;CAChB;AAKD;;;;;GAKG;AACH,QAAA,MAAM,OAAO;IACX,kEAAkE;kCAC/C,aAAa,KAAG,IAAI;IAOvC,0DAA0D;4BAC/C,IAAI;IAIf,sCAAsC;+BACxB,IAAI;IAIlB;;;OAGG;iCACc,OAAO,KAAU,IAAI;IAItC;;;OAGG;wCACsB,sBAAsB,KAAG,IAAI;IAItD,gDAAgD;gCACjC,IAAI;IAInB,sDAAsD;iCACtC,IAAI;IAIpB,2CAA2C;uCACrB,IAAI;IAI1B;;;;OAIG;kCACc,IAAI;IAIrB,iEAAiE;+BACnD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIpC,8EAA8E;iCAC9D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC,mEAAmE;0CACxC,MAAM,KAAG,IAAI;IAIxC;;;;;;OAMG;2BACS,CAAC,SAAS,gBAAgB,aACzB,CAAC,YACF,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,KAC5C,iBAAiB;CAGZ,CAAC;AAEX,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Upscope.d.ts","sourceRoot":"","sources":["../../src/Upscope.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,IAAI,IAAI,CAAC;CAChB;AAqBD;;;;;GAKG;AACH,QAAA,MAAM,OAAO;IACX,kEAAkE;kCAC/C,aAAa,KAAG,IAAI;IAOvC,0DAA0D;4BAC/C,IAAI;IAIf,sCAAsC;+BACxB,IAAI;IAIlB;;;OAGG;iCACc,OAAO,KAAU,IAAI;IAItC;;;OAGG;wCACsB,sBAAsB,KAAG,IAAI;IAItD,gDAAgD;gCACjC,IAAI;IAInB,sDAAsD;iCACtC,IAAI;IAIpB,2CAA2C;uCACrB,IAAI;IAI1B;;;OAGG;sCACkB,IAAI;IAIzB;;;OAGG;0CACsB,IAAI;IAI7B;;;;;;OAMG;qDACmC,MAAM,UAAU,OAAO,KAAG,IAAI;IAIpE;;;;OAIG;kCACc,IAAI;IAIrB,iEAAiE;+BACnD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIpC,8EAA8E;iCAC9D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC,iEAAiE;0CACtC,MAAM,KAAG,IAAI;IAIxC;;;;;;OAMG;2BACS,CAAC,SAAS,gBAAgB,aACzB,CAAC,YACF,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,KAC5C,iBAAiB;CAGZ,CAAC;AAEX,eAAe,OAAO,CAAC"}

package/lib/typescript/hooks.d.ts

@@ -1,12 +1,16 @@
-import type { ConnectionState, SessionState } from "./types";
+import type { ConnectionState, SessionState, RemoteControlState, FullDeviceSharingState } from "./types";
 /**
  * Returns the current WebSocket connection state, updated reactively via the
  * `connectionStateChanged` event. Starts as "inactive" before the first event.
  */
 export declare function useConnectionState(): ConnectionState;
 /**
- * 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.
  */
 export declare function useSessionState(): SessionState;
 /**
@@ -19,6 +23,16 @@ export declare function useShortId(): string | null;
  * Updated reactively via `lookupCodeChanged`.
  */
 export declare function useLookupCode(): string | null;
+/**
+ * Returns whether an agent currently has remote control of the device.
+ * Defaults to "inactive" and stays in sync via `remoteControlStateChanged`.
+ */
+export declare function useRemoteControlState(): RemoteControlState;
+/**
+ * Returns whether full-device (broadcast) screen sharing is currently running.
+ * Defaults to "inactive" and stays in sync via `fullDeviceSharingStateChanged`.
+ */
+export declare function useFullDeviceSharingState(): FullDeviceSharingState;
 /**
  * Returns a stable object of imperative Upscope action methods.
  * Safe to use as a dependency in `useCallback` / `useEffect`.
@@ -29,6 +43,9 @@ export declare function useUpscope(): {
     stopSession: () => void;
     requestAgent: () => void;
     cancelAgentRequest: () => void;
+    stopRemoteControl: () => void;
+    stopFullDeviceSharing: () => void;
+    respondToFullDeviceRequest: (requestId: string, accept: boolean) => void;
     sendCustomMessage: (message: string) => void;
     getLookupCode: () => void;
     reset: (reconnect?: boolean) => void;

package/lib/typescript/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAWpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAiB9C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAa1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAW7C;AAED;;;GAGG;AACH,wBAAgB,UAAU;;;;;;;;;EAczB"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAWpD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAqB9C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAa1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAW7C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAW1D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,sBAAsB,CAclE;AAED;;;GAGG;AACH,wBAAgB,UAAU;;;;;;;;;;;;EAiBzB"}

package/lib/typescript/index.d.ts

@@ -1,8 +1,8 @@
-export { default as default } from "./Upscope";
-export { default as Upscope } from "./Upscope";
-export type { EventSubscription } from "./Upscope";
-export { useConnectionState, useSessionState, useShortId, useLookupCode, useUpscope, } from "./hooks";
-export { UpscopeMasked } from "./UpscopeMasked";
-export type { UpscopeMaskedProps } from "./UpscopeMasked";
-export type { ConnectionState, SessionState, SessionEndReason, UpscopeError, UpscopeConfig, ConnectionUpdateParams, Observer, UpscopeEventMap, UpscopeEventName, ConnectionStateChangedEvent, SessionStartedEvent, SessionEndedEvent, CustomMessageEvent, ObserverCountChangedEvent, ObserverLeftEvent, ShortIdChangedEvent, LookupCodeChangedEvent, } from "./types";
+export { default as default } from './Upscope';
+export { default as Upscope } from './Upscope';
+export type { EventSubscription } from './Upscope';
+export { useConnectionState, useSessionState, useShortId, useLookupCode, useRemoteControlState, useFullDeviceSharingState, useUpscope, } from './hooks';
+export { UpscopeMasked } from './UpscopeMasked';
+export type { UpscopeMaskedProps } from './UpscopeMasked';
+export type { ConnectionState, SessionState, SessionEndReason, RemoteControlState, FullDeviceSharingState, UpscopeError, UpscopeConfig, LocalizedString, ConnectionUpdateParams, Viewer, UpscopeEventMap, UpscopeEventName, ConnectionStateChangedEvent, SessionStartedEvent, SessionEndedEvent, CustomMessageEvent, ViewerCountChangedEvent, ViewerLeftEvent, ShortIdChangedEvent, LookupCodeChangedEvent, SessionStateChangedEvent, RemoteControlStateChangedEvent, FullDeviceSharingStateChangedEvent, FullDeviceRequestEvent, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EACzB,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,MAAM,EACN,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/lib/typescript/types.d.ts

@@ -1,32 +1,63 @@
-export type ConnectionState = "inactive" | "connecting" | "connected" | "reconnecting" | "error";
-export type SessionState = "inactive" | "pendingRequest" | "active" | "paused" | "ended";
-export type SessionEndReason = "userStopped" | "agentStopped" | "timeout" | "error";
+export type ConnectionState = 'inactive' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+export type SessionState = 'inactive' | 'pendingRequest' | 'active' | 'paused' | 'ended';
+export type SessionEndReason = 'userStopped' | 'agentStopped' | 'timeout';
+/** Whether an agent currently has remote control of the device. */
+export type RemoteControlState = 'inactive' | 'active';
+/** Whether full-device (broadcast) screen sharing is currently running. */
+export type FullDeviceSharingState = 'inactive' | 'active';
 export interface UpscopeError {
     readonly code: string;
     readonly message: string;
 }
+/**
+ * A translated configuration value. Either a single string (same text for every
+ * user) or a language-keyed map whose keys are BCP-47 language tags such as
+ * `"en"`, `"it"`, or `"pt-PT"`. When a map is provided, the native SDK picks
+ * the best match against the device's preferred languages.
+ */
+export type LocalizedString = string | {
+    readonly [language: string]: string;
+};
 export interface UpscopeConfig {
     readonly apiKey: string;
     readonly requireAuthorizationForSession?: boolean;
     readonly autoConnect?: boolean;
     readonly region?: string;
-    readonly showBanner?: boolean;
+    /** Base domain for SDK endpoints (default `"upscope.io"`). Set for staging/on-prem, e.g. `"upscope.xyz"`. */
+    readonly baseDomain?: string;
     readonly showTerminateButton?: boolean;
     readonly authorizationPromptTitle?: string;
     readonly authorizationPromptMessage?: string;
     readonly endOfSessionMessage?: string;
-    readonly stopSessionText?: string;
+    readonly stopSessionText?: LocalizedString;
     readonly allowRemoteClick?: boolean;
     readonly allowRemoteScroll?: boolean;
+    /**
+     * When `true`, full-device sharing is declined while masked content is on
+     * screen (MediaProjection/ReplayKit capture the raw screen and can't apply
+     * view masking). Defaults to the server config. Set `false` to allow
+     * full-device sharing even with masked content present.
+     */
+    readonly disableFullScreenWhenMasked?: boolean;
     readonly requireControlRequest?: boolean;
     readonly controlRequestTitle?: string;
     readonly controlRequestMessage?: string;
     readonly enableLookupCodeOnShake?: boolean;
     readonly lookupCodeKeyTitle?: string;
     readonly lookupCodeKeyMessage?: string;
-    readonly translationsYes?: string;
-    readonly translationsNo?: string;
-    readonly translationsOk?: string;
+    readonly translationsYes?: LocalizedString;
+    readonly translationsNo?: LocalizedString;
+    readonly translationsOk?: LocalizedString;
+    /**
+     * iOS only. App Group identifier shared between the host app and its
+     * Broadcast Upload Extension, required to enable full-device sharing.
+     */
+    readonly broadcastAppGroupId?: string;
+    /**
+     * iOS only. Bundle identifier of the Broadcast Upload Extension target.
+     * Used to pre-select the extension in the broadcast picker.
+     */
+    readonly broadcastExtensionBundleId?: string;
 }
 export interface ConnectionUpdateParams {
     readonly uniqueId?: string;
@@ -36,11 +67,12 @@ export interface ConnectionUpdateParams {
     readonly integrationIds?: readonly string[];
     readonly metadata?: Readonly<Record<string, string>>;
 }
-export interface Observer {
+export interface Viewer {
     readonly id: string;
     readonly name: string | null;
     readonly screenWidth: number;
     readonly screenHeight: number;
+    readonly screenScale: number;
     readonly windowWidth: number;
     readonly windowHeight: number;
     readonly hasFocus: boolean;
@@ -54,17 +86,16 @@ export interface SessionStartedEvent {
 }
 export interface SessionEndedEvent {
     readonly reason: SessionEndReason;
-    readonly error?: UpscopeError;
 }
 export interface CustomMessageEvent {
     readonly message: string;
-    readonly observerId: string;
+    readonly viewerId: string;
 }
-export interface ObserverCountChangedEvent {
+export interface ViewerCountChangedEvent {
     readonly count: number;
 }
-export interface ObserverLeftEvent {
-    readonly observerId: string;
+export interface ViewerLeftEvent {
+    readonly viewerId: string;
 }
 export interface ShortIdChangedEvent {
     readonly shortId: string | null;
@@ -72,17 +103,33 @@ export interface ShortIdChangedEvent {
 export interface LookupCodeChangedEvent {
     readonly lookupCode: string | null;
 }
+export interface SessionStateChangedEvent {
+    readonly state: SessionState;
+}
+export interface RemoteControlStateChangedEvent {
+    readonly state: RemoteControlState;
+}
+export interface FullDeviceSharingStateChangedEvent {
+    readonly state: FullDeviceSharingState;
+}
+export interface FullDeviceRequestEvent {
+    readonly requestId: string;
+}
 export type UpscopeEventMap = {
     readonly connectionStateChanged: ConnectionStateChangedEvent;
+    readonly sessionStateChanged: SessionStateChangedEvent;
     readonly sessionStarted: SessionStartedEvent;
     readonly sessionEnded: SessionEndedEvent;
     readonly customMessageReceived: CustomMessageEvent;
     readonly error: UpscopeError;
-    readonly observerJoined: Observer;
-    readonly observerLeft: ObserverLeftEvent;
-    readonly observerCountChanged: ObserverCountChangedEvent;
+    readonly viewerJoined: Viewer;
+    readonly viewerLeft: ViewerLeftEvent;
+    readonly viewerCountChanged: ViewerCountChangedEvent;
     readonly shortIdChanged: ShortIdChangedEvent;
     readonly lookupCodeChanged: LookupCodeChangedEvent;
+    readonly remoteControlStateChanged: RemoteControlStateChangedEvent;
+    readonly fullDeviceSharingStateChanged: FullDeviceSharingStateChangedEvent;
+    readonly fullDeviceRequest: FullDeviceRequestEvent;
 };
 export type UpscopeEventName = keyof UpscopeEventMap;
 //# sourceMappingURL=types.d.ts.map