@upscopeio/react-native-sdk 2026.3.0

package/lib/module/Upscope.js

@@ -0,0 +1,91 @@
+"use strict";
+
+import { NativeEventEmitter } from "react-native";
+import NativeUpscopeModule from "./NativeUpscopeModule";
+
+/**
+ * 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);
+
+/**
+ * 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.initialize(config);
+  },
+  /** Open a WebSocket connection to the Upscope service. */
+  connect() {
+    NativeUpscopeModule.connect();
+  },
+  /** Close the WebSocket connection. */
+  disconnect() {
+    NativeUpscopeModule.disconnect();
+  },
+  /**
+   * Reset the connection state.
+   * @param reconnect - Whether to reconnect immediately after reset. Defaults to true.
+   */
+  reset(reconnect = true) {
+    NativeUpscopeModule.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);
+  },
+  /** Terminate the active co-browsing session. */
+  stopSession() {
+    NativeUpscopeModule.stopSession();
+  },
+  /** Request that an agent join the current session. */
+  requestAgent() {
+    NativeUpscopeModule.requestAgent();
+  },
+  /** Cancel a pending agent-join request. */
+  cancelAgentRequest() {
+    NativeUpscopeModule.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.getLookupCode();
+  },
+  /** Resolve the current short ID, or null if not yet assigned. */
+  getShortId() {
+    return NativeUpscopeModule.getShortId();
+  },
+  /** Resolve the watch link for the current session, or null if unavailable. */
+  getWatchLink() {
+    return NativeUpscopeModule.getWatchLink();
+  },
+  /** Send an arbitrary string message to all connected observers. */
+  sendCustomMessage(message) {
+    NativeUpscopeModule.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);
+  }
+};
+export default Upscope;
+//# sourceMappingURL=Upscope.js.map

package/lib/module/Upscope.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeEventEmitter","NativeUpscopeModule","emitter","Upscope","initialize","config","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;;AAQvD;AACA;AACA;AACA;;AAKA;AACA,MAAMC,OAAO,GAAG,IAAIF,kBAAkB,CAACC,mBAAmB,CAAC;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA,MAAME,OAAO,GAAG;EACd;EACAC,UAAUA,CAACC,MAAqB,EAAQ;IACtCJ,mBAAmB,CAACG,UAAU,CAACC,MAA2B,CAAC;EAC7D,CAAC;EAED;EACAC,OAAOA,CAAA,EAAS;IACdL,mBAAmB,CAACK,OAAO,CAAC,CAAC;EAC/B,CAAC;EAED;EACAC,UAAUA,CAAA,EAAS;IACjBN,mBAAmB,CAACM,UAAU,CAAC,CAAC;EAClC,CAAC;EAED;AACF;AACA;AACA;EACEC,KAAKA,CAACC,SAAkB,GAAG,IAAI,EAAQ;IACrCR,mBAAmB,CAACO,KAAK,CAACC,SAAS,CAAC;EACtC,CAAC;EAED;AACF;AACA;AACA;EACEC,gBAAgBA,CAACC,MAA8B,EAAQ;IACrDV,mBAAmB,CAACS,gBAAgB,CAACC,MAA2B,CAAC;EACnE,CAAC;EAED;EACAC,WAAWA,CAAA,EAAS;IAClBX,mBAAmB,CAACW,WAAW,CAAC,CAAC;EACnC,CAAC;EAED;EACAC,YAAYA,CAAA,EAAS;IACnBZ,mBAAmB,CAACY,YAAY,CAAC,CAAC;EACpC,CAAC;EAED;EACAC,kBAAkBA,CAAA,EAAS;IACzBb,mBAAmB,CAACa,kBAAkB,CAAC,CAAC;EAC1C,CAAC;EAED;AACF;AACA;AACA;AACA;EACEC,aAAaA,CAAA,EAAS;IACpBd,mBAAmB,CAACc,aAAa,CAAC,CAAC;EACrC,CAAC;EAED;EACAC,UAAUA,CAAA,EAA2B;IACnC,OAAOf,mBAAmB,CAACe,UAAU,CAAC,CAAC;EACzC,CAAC;EAED;EACAC,YAAYA,CAAA,EAA2B;IACrC,OAAOhB,mBAAmB,CAACgB,YAAY,CAAC,CAAC;EAC3C,CAAC;EAED;EACAC,iBAAiBA,CAACC,OAAe,EAAQ;IACvClB,mBAAmB,CAACiB,iBAAiB,CAACC,OAAO,CAAC;EAChD,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,WAAWA,CACTC,SAAY,EACZC,QAA6C,EAC1B;IACnB,OAAOpB,OAAO,CAACkB,WAAW,CAACC,SAAS,EAAEC,QAAQ,CAAC;EACjD;AACF,CAAU;AAEV,eAAenB,OAAO","ignoreList":[]}

package/lib/module/UpscopeMasked.js

@@ -0,0 +1,17 @@
+"use strict";
+
+import React from "react";
+import NativeUpscopeMaskedView from "./NativeUpscopeMaskedView";
+import { jsx as _jsx } from "react/jsx-runtime";
+export function UpscopeMasked({
+  children,
+  style,
+  ...props
+}) {
+  return /*#__PURE__*/_jsx(NativeUpscopeMaskedView, {
+    style: style,
+    ...props,
+    children: children
+  });
+}
+//# sourceMappingURL=UpscopeMasked.js.map

package/lib/module/UpscopeMasked.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","NativeUpscopeMaskedView","jsx","_jsx","UpscopeMasked","children","style","props"],"sourceRoot":"../../src","sources":["UpscopeMasked.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AAEzB,OAAOC,uBAAuB,MAAM,2BAA2B;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAMhE,OAAO,SAASC,aAAaA,CAAC;EAC5BC,QAAQ;EACRC,KAAK;EACL,GAAGC;AACe,CAAC,EAAE;EACrB,oBACEJ,IAAA,CAACF,uBAAuB;IAACK,KAAK,EAAEA,KAAM;IAAA,GAAKC,KAAK;IAAAF,QAAA,EAC7CA;EAAQ,CACc,CAAC;AAE9B","ignoreList":[]}

package/lib/module/hooks.js

@@ -0,0 +1,89 @@
+"use strict";
+
+import { useState, useEffect, useMemo } from "react";
+import Upscope from "./Upscope";
+/**
+ * Returns the current WebSocket connection state, updated reactively via the
+ * `connectionStateChanged` event. Starts as "inactive" before the first event.
+ */
+export function useConnectionState() {
+  const [state, setState] = useState("inactive");
+  useEffect(() => {
+    const sub = Upscope.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`.
+ */
+export function useSessionState() {
+  const [state, setState] = useState("inactive");
+  useEffect(() => {
+    const subStart = Upscope.addListener("sessionStarted", () => {
+      setState("active");
+    });
+    const subEnd = Upscope.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`.
+ */
+export function useShortId() {
+  const [shortId, setShortId] = useState(null);
+  useEffect(() => {
+    // Seed with the current value; the listener handles all subsequent changes.
+    Upscope.getShortId().then(setShortId);
+    const sub = Upscope.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`.
+ */
+export function useLookupCode() {
+  const [code, setCode] = useState(null);
+  useEffect(() => {
+    const sub = Upscope.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`.
+ */
+export function useUpscope() {
+  return useMemo(() => ({
+    connect: Upscope.connect,
+    disconnect: Upscope.disconnect,
+    stopSession: Upscope.stopSession,
+    requestAgent: Upscope.requestAgent,
+    cancelAgentRequest: Upscope.cancelAgentRequest,
+    sendCustomMessage: Upscope.sendCustomMessage,
+    getLookupCode: Upscope.getLookupCode,
+    reset: Upscope.reset
+  }), []);
+}
+//# sourceMappingURL=hooks.js.map

package/lib/module/hooks.js.map

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

package/lib/module/index.js

@@ -0,0 +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";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

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

package/lib/module/package.json

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

package/lib/module/types.js

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

package/lib/module/types.js.map

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

package/lib/typescript/NativeUpscopeMaskedView.d.ts

@@ -0,0 +1,7 @@
+import type { ViewProps } from "react-native";
+import type { HostComponent } from "react-native";
+export interface NativeProps extends ViewProps {
+}
+declare const _default: HostComponent<NativeProps>;
+export default _default;
+//# sourceMappingURL=NativeUpscopeMaskedView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeUpscopeMaskedView.d.ts","sourceRoot":"","sources":["../../src/NativeUpscopeMaskedView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,WAAW,WAAY,SAAQ,SAAS;CAAG;wBAI5C,aAAa,CAAC,WAAW,CAAC;AAF/B,wBAEgC"}

package/lib/typescript/NativeUpscopeModule.d.ts

@@ -0,0 +1,20 @@
+import type { TurboModule } from "react-native";
+export interface Spec extends TurboModule {
+    initialize(config: Object): void;
+    connect(): void;
+    disconnect(): void;
+    reset(reconnect: boolean): void;
+    updateConnection(params: Object): void;
+    stopSession(): void;
+    requestAgent(): void;
+    cancelAgentRequest(): void;
+    getLookupCode(): void;
+    getShortId(): Promise<string | null>;
+    getWatchLink(): Promise<string | null>;
+    sendCustomMessage(message: string): void;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeUpscopeModule.d.ts.map

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

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

package/lib/typescript/Upscope.d.ts

@@ -0,0 +1,60 @@
+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.
+ */
+export interface EventSubscription {
+    remove(): void;
+}
+/**
+ * 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.
+ */
+declare const Upscope: {
+    /** Initialise the SDK. Must be called before any other method. */
+    readonly initialize: (config: UpscopeConfig) => void;
+    /** Open a WebSocket connection to the Upscope service. */
+    readonly connect: () => void;
+    /** Close the WebSocket connection. */
+    readonly disconnect: () => void;
+    /**
+     * Reset the connection state.
+     * @param reconnect - Whether to reconnect immediately after reset. Defaults to true.
+     */
+    readonly reset: (reconnect?: boolean) => void;
+    /**
+     * Update user identity and metadata sent to the Upscope service.
+     * Safe to call at any time; changes are pushed on the next sync.
+     */
+    readonly updateConnection: (params: ConnectionUpdateParams) => void;
+    /** Terminate the active co-browsing session. */
+    readonly stopSession: () => void;
+    /** Request that an agent join the current session. */
+    readonly requestAgent: () => void;
+    /** Cancel a pending agent-join request. */
+    readonly cancelAgentRequest: () => void;
+    /**
+     * 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.
+     */
+    readonly getLookupCode: () => void;
+    /** Resolve the current short ID, or null if not yet assigned. */
+    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. */
+    readonly sendCustomMessage: (message: string) => void;
+    /**
+     * 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.
+     */
+    readonly addListener: <E extends UpscopeEventName>(eventName: E, callback: (event: UpscopeEventMap[E]) => void) => EventSubscription;
+};
+export default Upscope;
+//# sourceMappingURL=Upscope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Upscope.d.ts","sourceRoot":"","sources":["../../src/Upscope.ts"],"names":[],"mappings":"AAEA,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;IAIvC,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"}

package/lib/typescript/UpscopeMasked.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import type { ViewProps } from "react-native";
+export interface UpscopeMaskedProps extends ViewProps {
+    children: React.ReactNode;
+}
+export declare function UpscopeMasked({ children, style, ...props }: UpscopeMaskedProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=UpscopeMasked.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UpscopeMasked.d.ts","sourceRoot":"","sources":["../../src/UpscopeMasked.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,KAAK,EACL,GAAG,KAAK,EACT,EAAE,kBAAkB,2CAMpB"}

package/lib/typescript/hooks.d.ts

@@ -0,0 +1,36 @@
+import type { ConnectionState, SessionState } 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`.
+ */
+export declare function useSessionState(): SessionState;
+/**
+ * Returns the SDK short ID, or null if not yet assigned.
+ * Resolves the current value on mount and stays in sync via `shortIdChanged`.
+ */
+export declare function useShortId(): string | null;
+/**
+ * Returns the current lookup code, or null until the native layer emits one.
+ * Updated reactively via `lookupCodeChanged`.
+ */
+export declare function useLookupCode(): string | null;
+/**
+ * Returns a stable object of imperative Upscope action methods.
+ * Safe to use as a dependency in `useCallback` / `useEffect`.
+ */
+export declare function useUpscope(): {
+    connect: () => void;
+    disconnect: () => void;
+    stopSession: () => void;
+    requestAgent: () => void;
+    cancelAgentRequest: () => void;
+    sendCustomMessage: (message: string) => void;
+    getLookupCode: () => void;
+    reset: (reconnect?: boolean) => void;
+};
+//# sourceMappingURL=hooks.d.ts.map

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

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

package/lib/typescript/index.d.ts

@@ -0,0 +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";
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/typescript/types.d.ts

@@ -0,0 +1,79 @@
+export type ConnectionState = "inactive" | "connecting" | "connected" | "reconnecting" | "error";
+export type SessionState = "inactive" | "pendingRequest" | "active" | "paused" | "ended";
+export type SessionEndReason = "userStopped" | "agentStopped" | "timeout" | "error";
+export interface UpscopeError {
+    readonly code: string;
+    readonly message: string;
+}
+export interface UpscopeConfig {
+    readonly apiKey: string;
+    readonly requireAuthorizationForSession?: boolean;
+    readonly autoConnect?: boolean;
+    readonly region?: string;
+    readonly showBanner?: boolean;
+    readonly showTerminateButton?: boolean;
+    readonly authorizationPromptTitle?: string;
+    readonly authorizationPromptMessage?: string;
+    readonly endOfSessionMessage?: string;
+    readonly stopSessionText?: string;
+    readonly allowRemoteClick?: boolean;
+    readonly allowRemoteScroll?: boolean;
+    readonly requireControlRequest?: boolean;
+}
+export interface ConnectionUpdateParams {
+    readonly uniqueId?: string;
+    readonly callName?: string;
+    readonly tags?: readonly string[];
+    readonly identities?: readonly string[];
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+export interface Observer {
+    readonly id: string;
+    readonly name: string | null;
+    readonly screenWidth: number;
+    readonly screenHeight: number;
+    readonly windowWidth: number;
+    readonly windowHeight: number;
+    readonly hasFocus: boolean;
+}
+export interface ConnectionStateChangedEvent {
+    readonly state: ConnectionState;
+    readonly error?: UpscopeError;
+}
+export interface SessionStartedEvent {
+    readonly agentName: string | null;
+}
+export interface SessionEndedEvent {
+    readonly reason: SessionEndReason;
+    readonly error?: UpscopeError;
+}
+export interface CustomMessageEvent {
+    readonly message: string;
+    readonly observerId: string;
+}
+export interface ObserverCountChangedEvent {
+    readonly count: number;
+}
+export interface ObserverLeftEvent {
+    readonly observerId: string;
+}
+export interface ShortIdChangedEvent {
+    readonly shortId: string | null;
+}
+export interface LookupCodeChangedEvent {
+    readonly lookupCode: string | null;
+}
+export type UpscopeEventMap = {
+    readonly connectionStateChanged: ConnectionStateChangedEvent;
+    readonly sessionStarted: SessionStartedEvent;
+    readonly sessionEnded: SessionEndedEvent;
+    readonly customMessageReceived: CustomMessageEvent;
+    readonly error: UpscopeError;
+    readonly observerJoined: Observer;
+    readonly observerLeft: ObserverLeftEvent;
+    readonly observerCountChanged: ObserverCountChangedEvent;
+    readonly shortIdChanged: ShortIdChangedEvent;
+    readonly lookupCodeChanged: LookupCodeChangedEvent;
+};
+export type UpscopeEventName = keyof UpscopeEventMap;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@upscopeio/react-native-sdk",
+  "version": "2026.3.0",
+  "description": "React Native SDK for Upscope cobrowsing",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "upscopeio-react-native-sdk.podspec",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "test": "jest",
+    "build": "bob build",
+    "prepublishOnly": "bob build"
+  },
+  "keywords": [
+    "react-native",
+    "upscope",
+    "cobrowsing",
+    "screen-sharing"
+  ],
+  "repository": "https://github.com/upscopeio/react-native-sdk",
+  "author": "Upscope <support@upscope.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/upscopeio/react-native-sdk#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@react-native/eslint-config": "^0.76.0",
+    "@testing-library/react-native": "12.7.2",
+    "@types/jest": "^29.5.0",
+    "@types/react": "^18.3.28",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0",
+    "react": "^18.3.1",
+    "react-native": "^0.76.0",
+    "react-native-builder-bob": "^0.35.0",
+    "react-test-renderer": "18.3.1",
+    "typescript": "^5.5.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-native": ">=0.76.0"
+  },
+  "codegenConfig": {
+    "name": "UpscopeSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "io.upscope.reactnative"
+    },
+    "ios": {
+      "modulesProvider": {
+        "UpscopeModule": "UpscopeModule"
+      }
+    }
+  },
+  "jest": {
+    "preset": "react-native",
+    "moduleFileExtensions": [
+      "ts",
+      "tsx",
+      "js",
+      "jsx"
+    ]
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/src/NativeUpscopeMaskedView.ts

@@ -0,0 +1,9 @@
+import type { ViewProps } from "react-native";
+import type { HostComponent } from "react-native";
+import codegenNativeComponent from "react-native/Libraries/Utilities/codegenNativeComponent";
+
+export interface NativeProps extends ViewProps {}
+
+export default codegenNativeComponent<NativeProps>(
+  "UpscopeMaskedView",
+) as HostComponent<NativeProps>;

package/src/NativeUpscopeModule.ts

@@ -0,0 +1,32 @@
+import type { TurboModule } from "react-native";
+import { TurboModuleRegistry } from "react-native";
+
+export interface Spec extends TurboModule {
+  // Initialization
+  initialize(config: Object): void;
+
+  // Connection
+  connect(): void;
+  disconnect(): void;
+  reset(reconnect: boolean): void;
+  updateConnection(params: Object): void;
+
+  // Session
+  stopSession(): void;
+  requestAgent(): void;
+  cancelAgentRequest(): void;
+
+  // Lookup
+  getLookupCode(): void;
+  getShortId(): Promise<string | null>;
+  getWatchLink(): Promise<string | null>;
+
+  // Messaging
+  sendCustomMessage(message: string): void;
+
+  // Event support
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>("UpscopeModule");