@upscopeio/react-native-sdk 2026.4.1 → 2026.6.0

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAGD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,sBAAsB,EAAE,2BAA2B,CAAC;IAC7D,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;IACzD,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,eAAe,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "2026.4.1";
+export declare const SDK_VERSION = "2026.6.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upscopeio/react-native-sdk",
-  "version": "2026.4.1",
+  "version": "2026.6.0",
   "description": "React Native SDK for Upscope cobrowsing",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/NativeUpscopeModule.ts

@@ -16,6 +16,11 @@ export interface Spec extends TurboModule {
   requestAgent(): void;
   cancelAgentRequest(): void;
 
+  // Remote control / full-device sharing
+  stopRemoteControl(): void;
+  stopFullDeviceSharing(): void;
+  respondToFullDeviceRequest(requestId: string, accept: boolean): void;
+
   // Lookup
   getLookupCode(): void;
   getShortId(): Promise<string | null>;

package/src/Upscope.ts

@@ -1,12 +1,12 @@
-import { NativeEventEmitter } from "react-native";
-import NativeUpscopeModule from "./NativeUpscopeModule";
-import { SDK_VERSION } from "./version";
+import { NativeEventEmitter, TurboModuleRegistry } from 'react-native';
+import type { Spec } from './NativeUpscopeModule';
+import { SDK_VERSION } from './version';
 import type {
   UpscopeConfig,
   ConnectionUpdateParams,
   UpscopeEventMap,
   UpscopeEventName,
-} from "./types";
+} from './types';
 
 /**
  * Subscription handle returned by addListener. Callers must invoke remove()
@@ -16,8 +16,24 @@ export interface EventSubscription {
   remove(): void;
 }
 
-// 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: Spec | undefined;
+function native(): Spec {
+  return (nativeModule ??=
+    TurboModuleRegistry.getEnforcing<Spec>('UpscopeModule'));
+}
+
+// Lazily-created emitter — one instance for the lifetime of the JS runtime.
+let eventEmitter: NativeEventEmitter | undefined;
+function emitter(): NativeEventEmitter {
+  return (eventEmitter ??= new NativeEventEmitter(native()));
+}
 
 /**
  * Imperative JS API over the native Upscope TurboModule.
@@ -28,7 +44,7 @@ const emitter = new NativeEventEmitter(NativeUpscopeModule);
 const Upscope = {
   /** Initialise the SDK. Must be called before any other method. */
   initialize(config: UpscopeConfig): void {
-    NativeUpscopeModule.initialize({
+    native().initialize({
       ...config,
       wrapperVersion: SDK_VERSION,
     } as unknown as Object);
@@ -36,12 +52,12 @@ const Upscope = {
 
   /** Open a WebSocket connection to the Upscope service. */
   connect(): void {
-    NativeUpscopeModule.connect();
+    native().connect();
   },
 
   /** Close the WebSocket connection. */
   disconnect(): void {
-    NativeUpscopeModule.disconnect();
+    native().disconnect();
   },
 
   /**
@@ -49,7 +65,7 @@ const Upscope = {
    * @param reconnect - Whether to reconnect immediately after reset. Defaults to true.
    */
   reset(reconnect: boolean = true): void {
-    NativeUpscopeModule.reset(reconnect);
+    native().reset(reconnect);
   },
 
   /**
@@ -57,22 +73,49 @@ const Upscope = {
    * Safe to call at any time; changes are pushed on the next sync.
    */
   updateConnection(params: ConnectionUpdateParams): void {
-    NativeUpscopeModule.updateConnection(params as unknown as Object);
+    native().updateConnection(params as unknown as Object);
   },
 
   /** Terminate the active co-browsing session. */
   stopSession(): void {
-    NativeUpscopeModule.stopSession();
+    native().stopSession();
   },
 
   /** Request that an agent join the current session. */
   requestAgent(): void {
-    NativeUpscopeModule.requestAgent();
+    native().requestAgent();
   },
 
   /** Cancel a pending agent-join request. */
   cancelAgentRequest(): void {
-    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(): void {
+    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(): void {
+    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: string, accept: boolean): void {
+    native().respondToFullDeviceRequest(requestId, accept);
   },
 
   /**
@@ -81,22 +124,22 @@ const Upscope = {
    * asynchronously through the event system.
    */
   getLookupCode(): void {
-    NativeUpscopeModule.getLookupCode();
+    native().getLookupCode();
   },
 
   /** Resolve the current short ID, or null if not yet assigned. */
   getShortId(): Promise<string | null> {
-    return NativeUpscopeModule.getShortId();
+    return native().getShortId();
   },
 
   /** Resolve the watch link for the current session, or null if unavailable. */
   getWatchLink(): Promise<string | null> {
-    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: string): void {
-    NativeUpscopeModule.sendCustomMessage(message);
+    native().sendCustomMessage(message);
   },
 
   /**
@@ -110,7 +153,7 @@ const Upscope = {
     eventName: E,
     callback: (event: UpscopeEventMap[E]) => void,
   ): EventSubscription {
-    return emitter.addListener(eventName, callback);
+    return emitter().addListener(eventName, callback);
   },
 } as const;
 

package/src/hooks.ts

@@ -1,6 +1,11 @@
 import { useState, useEffect, useMemo } from "react";
 import Upscope from "./Upscope";
-import type { ConnectionState, SessionState } from "./types";
+import type {
+  ConnectionState,
+  SessionState,
+  RemoteControlState,
+  FullDeviceSharingState,
+} from "./types";
 
 /**
  * Returns the current WebSocket connection state, updated reactively via the
@@ -20,13 +25,20 @@ export 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 function useSessionState(): SessionState {
   const [state, setState] = useState<SessionState>("inactive");
 
   useEffect(() => {
+    const subState = Upscope.addListener("sessionStateChanged", (event) => {
+      setState(event.state);
+    });
     const subStart = Upscope.addListener("sessionStarted", () => {
       setState("active");
     });
@@ -34,6 +46,7 @@ export function useSessionState(): SessionState {
       setState("inactive");
     });
     return () => {
+      subState.remove();
       subStart.remove();
       subEnd.remove();
     };
@@ -78,6 +91,43 @@ export function useLookupCode(): string | null {
   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(): RemoteControlState {
+  const [state, setState] = useState<RemoteControlState>("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(): FullDeviceSharingState {
+  const [state, setState] = useState<FullDeviceSharingState>("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`.
@@ -90,6 +140,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/src/index.ts

@@ -1,34 +1,43 @@
-export { default as default } from "./Upscope";
-export { default as Upscope } from "./Upscope";
-export type { EventSubscription } from "./Upscope";
+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";
+} from './hooks';
 
-export { UpscopeMasked } from "./UpscopeMasked";
-export type { UpscopeMaskedProps } from "./UpscopeMasked";
+export { UpscopeMasked } from './UpscopeMasked';
+export type { UpscopeMaskedProps } from './UpscopeMasked';
 
 export type {
   ConnectionState,
   SessionState,
   SessionEndReason,
+  RemoteControlState,
+  FullDeviceSharingState,
   UpscopeError,
   UpscopeConfig,
+  LocalizedString,
   ConnectionUpdateParams,
-  Observer,
+  Viewer,
   UpscopeEventMap,
   UpscopeEventName,
   ConnectionStateChangedEvent,
   SessionStartedEvent,
   SessionEndedEvent,
   CustomMessageEvent,
-  ObserverCountChangedEvent,
-  ObserverLeftEvent,
+  ViewerCountChangedEvent,
+  ViewerLeftEvent,
   ShortIdChangedEvent,
   LookupCodeChangedEvent,
-} from "./types";
+  SessionStateChangedEvent,
+  RemoteControlStateChangedEvent,
+  FullDeviceSharingStateChangedEvent,
+  FullDeviceRequestEvent,
+} from './types';

package/src/types.ts

@@ -1,50 +1,78 @@
 export type ConnectionState =
-  | "inactive"
-  | "connecting"
-  | "connected"
-  | "reconnecting"
-  | "error";
+  | 'inactive'
+  | 'connecting'
+  | 'connected'
+  | 'reconnecting'
+  | 'error';
 
 export type SessionState =
-  | "inactive"
-  | "pendingRequest"
-  | "active"
-  | "paused"
-  | "ended";
-
-export type SessionEndReason =
-  | "userStopped"
-  | "agentStopped"
-  | "timeout"
-  | "error";
+  | '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 {
@@ -56,11 +84,12 @@ export interface ConnectionUpdateParams {
   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;
@@ -78,20 +107,19 @@ 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 {
@@ -102,17 +130,37 @@ 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;

package/src/version.ts

@@ -1,2 +1,2 @@
 // Auto-generated by scripts/generate-version.sh — do not edit manually
-export const SDK_VERSION = "2026.4.1";
+export const SDK_VERSION = "2026.6.0";

package/upscopeio-react-native-sdk.podspec

@@ -11,7 +11,7 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift}"
   s.swift_version = "5.9"
 
-  s.dependency "UpscopeSDK", "2026.4.7"
+  s.dependency "UpscopeSDK", "2026.6.0"
 
   install_modules_dependencies(s)
 end