@experiaapp/webchat-react-native 2.0.1

package/lib/ui/WebChat.js

@@ -0,0 +1,386 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebChat = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// src/ui/WebChat.tsx
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const react_native_safe_area_context_1 = require("react-native-safe-area-context");
+const WebchatProvider_1 = require("../state/WebchatProvider");
+const useWebchat_1 = require("../state/useWebchat");
+const socketFactory_1 = require("../core/socketFactory");
+const MessageList_1 = require("./MessageList");
+const Composer_1 = require("./Composer");
+const Header_1 = require("./Header");
+const Icon_1 = require("./Icon");
+const PoweredBy_1 = require("./PoweredBy");
+const PrechatForm_1 = require("./PrechatForm");
+const dir_1 = require("../theme/dir");
+const i18n_1 = require("../i18n");
+const expoDefaults_1 = require("../adapters/expoDefaults");
+const webrtc_1 = require("../adapters/webrtc");
+// <VideoCall> is lazy-required (NOT statically imported) so the native binding it
+// transitively pulls in (react-native-webrtc's RTCView, which runs a top-level
+// NativeEventEmitter at module load) is only loaded when a call is actually rendered.
+// This keeps chat-only consumers — and every non-video test that renders <WebChat>
+// without mocking react-native-webrtc — free of the native module (C15/C16).
+function loadVideoCall() {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    return require("./VideoCall").VideoCall;
+}
+// secureScreen (S10): when the host opts in, lazily flag the surface as
+// screen-capture-protected. expo-screen-capture (preventScreenCaptureAsync) is an
+// OPTIONAL peer; the require is guarded so a chat-only consumer without it — and every
+// unit test — degrades to a no-op rather than crashing. Default off (tenant opts in).
+function applySecureScreen() {
+    var _a;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const cap = require("expo-screen-capture");
+        (_a = cap.preventScreenCaptureAsync) === null || _a === void 0 ? void 0 : _a.call(cap);
+        return () => {
+            var _a;
+            try {
+                (_a = cap.allowScreenCaptureAsync) === null || _a === void 0 ? void 0 : _a.call(cap);
+            }
+            catch {
+                /* best-effort release */
+            }
+        };
+    }
+    catch {
+        // expo-screen-capture absent — secure-screen is best-effort, so no-op.
+        return undefined;
+    }
+}
+function Surface({ config, title, prechatFields, prechatHeadline: prechatHeadlineProp, prechatSubmitLabel: prechatSubmitLabelProp, onPrechatSubmit, prechatDone, picker, audioAdapter: audioAdapterProp, secureScreen, disabledInput, onClose, }) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    // Context contract: theme / dir / language / resolvedConfig are the single source of
+    // truth (provider derives them from prop>server>default). The Surface NEVER hardcodes
+    // a palette/direction — it reads them here and threads them to Header/MessageList/Composer.
+    // audioAdapter (received-voice playback, #23) and setSpeaker (in-call route, #25) are read
+    // from context so the live path reaches them; an explicit prop still wins (testability).
+    const { messages, send, attach, isStorageReady, language, theme, dir, resolvedConfig, videoCallStarted, startCall, endCall, _video, status, awaitingReply, wasConnected, audioAdapter: audioAdapterCtx, setSpeaker, resumedSession, } = (0, useWebchat_1.useWebchat)();
+    const audioAdapter = audioAdapterProp !== null && audioAdapterProp !== void 0 ? audioAdapterProp : audioAdapterCtx;
+    const variant = theme === null || theme === void 0 ? void 0 : theme.variant; // experia | digitalGovernment (resolved from interfaceTheme)
+    // Connection status for the header's online/offline indicator (web parity).
+    const connected = status === "connected" || status === "session-confirmed";
+    // typeWidget (Tier C #30): the SDK has a SINGLE Surface (+ optional FAB Launcher)
+    // and no DrawerWidget/embedded-shell analog beyond the `embedded` flag below, so
+    // any non-"default" value is treated as "default" — accepted, never errors. This
+    // key is resolved by DOCUMENTATION, not new behaviour (see CONFIG-PARITY-AUDIT.md).
+    // (Intentionally not branched on: there is only one shell to render.)
+    // MOBILE LAYOUT: the chat surface ALWAYS fills its parent (flex:1) — it is full
+    // screen on a phone, full stop. The web `fullScreenHeight` flag (Tier C #32) is a
+    // DESKTOP floating-panel notion (a bounded corner widget capped to part of the
+    // viewport) that does NOT translate to mobile, where the chat takes the whole screen
+    // (or fills whatever container a host deliberately mounts WebChat into). So we still
+    // ACCEPT `fullScreenHeight` in config (web parity, never errors) but intentionally
+    // DO NOT apply it here — it must never shrink the mobile view. (The bug: a server
+    // config with `fullScreenHeight:false` left the surface capped at maxHeight:"80%".)
+    // `embedded` (#31) stays a host opt-in for inline layouts: it still flex-fills, so
+    // the bounding is governed by the container the host provides, not a web flag.
+    const embedded = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.embedded) === true;
+    const containerStyle = embedded
+        ? { alignSelf: "stretch", flex: 1 }
+        : { flex: 1 };
+    // hideWhenNotConnected (Tier C #34): hide the surface ONLY after a real
+    // established-then-lost drop — i.e. we reached a CONFIRMED session at least once
+    // (wasConnected, latched in the provider on "session-confirmed") and are now no
+    // longer connected. NEVER on the initial pre-connect / handshake (wasConnected
+    // false) — otherwise an open surface mounted before the first connection would
+    // vanish and the user could never connect. Default off (opt-in). When the gate is
+    // active we render the empty surface shell (keeps the testID stable) — no chrome.
+    const hideWhenNotConnected = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.hideWhenNotConnected) === true;
+    const hiddenForDisconnect = hideWhenNotConnected && wasConnected && !connected;
+    // subTitle / statusIndicator are server-driven config keys the header reads
+    // (web parity). They are not in the core Config type yet, so read them off a
+    // loosely-typed view of the resolved config rather than widening the type here.
+    const headerConfig = (resolvedConfig !== null && resolvedConfig !== void 0 ? resolvedConfig : {});
+    // Header title: the host prop wins; otherwise fall back to server config.title
+    // (web parity — config.title drives the header when the host omits it).
+    const headerTitle = title !== null && title !== void 0 ? title : headerConfig.title;
+    // Per-message timestamp toggle (web showMessageDate; default true). Threaded
+    // resolvedConfig -> MessageList -> Bubble so the server flag actually reaches it.
+    const showMessageDate = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.showMessageDate) !== false;
+    // Typing indicator (item 23, web Body/index.tsx:134): shown only when the server
+    // flag is on AND we're awaiting a bot reply (the SDK-faithful trigger from the
+    // provider). Threaded resolvedConfig + awaitingReply -> MessageList -> TypingIndicator.
+    const showTyping = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.displayTypingIndication) === true && awaitingReply;
+    // Powered-by badge (item 24, web Body/index.tsx:92): rendered below the message
+    // list, gated by showPoweredBy (default ON — only an explicit false hides it).
+    const showPoweredBy = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.showPoweredBy) !== false;
+    // Agent avatar (item 25, web showAvatar/avatar; default showAvatar true). Threaded
+    // to the Header (header avatar + status dot) and each received Bubble (per-message
+    // avatar). A graceful fallback applies when no avatar.url is configured.
+    const showAvatar = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.showAvatar) !== false;
+    const avatar = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.avatar;
+    // Custom header close image + launcher images (item 29, web close/launcher images).
+    const closeImage = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.closeImage;
+    // B21 focus-on-open: move the accessibility focus to the header when the surface
+    // mounts so a screen-reader user lands on the chat title, not wherever it was.
+    const headerRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        const node = (0, react_native_1.findNodeHandle)(headerRef.current);
+        if (node != null)
+            react_native_1.AccessibilityInfo.setAccessibilityFocus(node);
+    }, []);
+    // secureScreen (S10): apply on mount when the host opted in; release on unmount.
+    (0, react_1.useEffect)(() => {
+        if (!secureScreen)
+            return;
+        const release = applySecureScreen();
+        return release;
+    }, [secureScreen]);
+    // B9: don't render/evaluate prechat until hydrated.
+    if (!isStorageReady)
+        return (0, jsx_runtime_1.jsx)(react_native_safe_area_context_1.SafeAreaView, { testID: "webchat-surface" });
+    // hideWhenNotConnected (item 34): after a connect-then-disconnect, collapse the
+    // surface to an empty shell (keeps the testID for the harness; renders no chrome).
+    if (hiddenForDisconnect)
+        return (0, jsx_runtime_1.jsx)(react_native_safe_area_context_1.SafeAreaView, { testID: "webchat-surface" });
+    // Attach flow (P2): the composer's attach button opens a media selector with
+    // up to three rows (image / document / record-audio). Each picker row runs the
+    // injected PickerAdapter method, then routes the picked assets through the
+    // provider's attach(). Rows are feature-detected: a method absent on the
+    // adapter simply omits its row. The audio row is driven by audioAdapter inside
+    // the Composer. Documents are restricted to the allow-listed mime set.
+    // Server-config gating (web parity: FooterIcons reads `config.uploadMedia` /
+    // `config.uploadAudio`, default true). A flag set to false hides that control
+    // even when an adapter is wired. Received-voice PLAYBACK is NOT gated (below).
+    //
+    // Upload sub-types (web parity, audit #17): the web widget gates image /
+    // document / video INDEPENDENTLY. `uploadMedia` is the master gate; each
+    // sub-type then has its own flag (uploadImage / uploadDocuments / uploadVideo),
+    // all default true. A row shows only when BOTH the master and its sub-flag are
+    // not false.
+    const uploadMedia = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.uploadMedia) !== false;
+    const uploadAudio = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.uploadAudio) !== false;
+    const uploadImage = uploadMedia && (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.uploadImage) !== false;
+    const uploadDocuments = uploadMedia && (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.uploadDocuments) !== false;
+    // uploadVideo (web parity, audit #17): the master uploadMedia gate AND the
+    // per-type uploadVideo flag must both be enabled. The video row shows only when
+    // the picker exposes a `pickVideos` capability (feature-detected below) so a
+    // picker without it stays hidden rather than faking a non-functional row.
+    const uploadVideo = uploadMedia && (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.uploadVideo) !== false;
+    // Web parity (handleSetFileValue): picking only STAGES the assets — the Composer
+    // previews them and SENDS on the Send tap (via onAttach), NOT immediately on pick.
+    // So these just RETURN the picked Asset[] for the Composer to stage; the actual
+    // attach()/emit happens when the user taps Send.
+    const onPickVideos = uploadVideo && (picker === null || picker === void 0 ? void 0 : picker.pickVideos)
+        ? () => picker.pickVideos({ allowsMultiple: true })
+        : undefined;
+    const onPickImages = uploadImage && (picker === null || picker === void 0 ? void 0 : picker.pickImages)
+        ? () => picker.pickImages({ allowsMultiple: true })
+        : undefined;
+    const onPickDocuments = uploadDocuments && (picker === null || picker === void 0 ? void 0 : picker.pickDocuments)
+        ? // No `type` filter: the allow-list contains PARAMETRIZED mimes (e.g.
+            // "audio/ogg;codecs=opus") that iOS can't map to a UTI, which wedges
+            // UIDocumentPickerViewController and HANGS getDocumentAsync (it never
+            // presents or resolves). Present a universal picker; the picked file is
+            // still enforced against the allow-list post-pick by validateSelection.
+            () => picker.pickDocuments()
+        : undefined;
+    // Voice RECORDING is gated by config.uploadAudio; received-voice PLAYBACK
+    // (MessageList) keeps the full adapter so the agent's notes still play.
+    const recordAudioAdapter = uploadAudio ? audioAdapter : undefined;
+    // When prechat is enabled and there is no session yet, render <PrechatForm/>;
+    // its submit feeds prechatValues into the greet flow. Otherwise render the thread.
+    //
+    // Gate (audit #20): the form shows when it is NOT done AND either (a) the server
+    // config explicitly enables it (resolvedConfig.prechatForm.enabled) OR (b) the
+    // existing host-prop path supplied a non-empty prechatFields array. (a) lets a
+    // server-driven prechat config turn the form on without the host hand-passing
+    // fields; (b) preserves the current host-only behaviour.
+    const prechatConfigEnabled = ((_a = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.prechatForm) === null || _a === void 0 ? void 0 : _a.enabled) === true;
+    const hasHostFields = Array.isArray(prechatFields) && prechatFields.length > 0;
+    // Prefer host-supplied fields; otherwise use the server-config fields (so a
+    // server-enabled form has something to render).
+    const effectivePrechatFields = hasHostFields
+        ? prechatFields
+        : (_b = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.prechatForm) === null || _b === void 0 ? void 0 : _b.fields;
+    // Web parity (ChatContainer `!sessionId` gate): show the form only for a NEW session.
+    // A RESUMED session (returning user, restored session id) continues the conversation
+    // without re-asking. `prechatDone` is the one-shot per-mount submit latch.
+    const showPrechat = !prechatDone &&
+        !resumedSession &&
+        (prechatConfigEnabled || hasHostFields) &&
+        Array.isArray(effectivePrechatFields) &&
+        effectivePrechatFields.length > 0;
+    // Localized headline / submit label come from the server prechat config (web
+    // parity: PrechatForm.tsx headline, PrechatSubmitFooter.tsx submitLabel). Host
+    // props still win when supplied (mirrors the fields precedence above).
+    const prechatHeadline = prechatHeadlineProp !== null && prechatHeadlineProp !== void 0 ? prechatHeadlineProp : (_c = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.prechatForm) === null || _c === void 0 ? void 0 : _c.headline;
+    const prechatSubmitLabel = prechatSubmitLabelProp !== null && prechatSubmitLabelProp !== void 0 ? prechatSubmitLabelProp : (_d = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.prechatForm) === null || _d === void 0 ? void 0 : _d.submitLabel;
+    // P3: video is opt-out (web parity: defualtConfig.makeVideoCall === true). Gate on the
+    // RESOLVED config (prop > server > default true) so BOTH a host prop AND a server
+    // config can disable it with makeVideoCall:false — matching web, which hides the
+    // button on a server-driven flag. Default-on flows from DEFAULT_CONFIG.makeVideoCall.
+    const videoEnabled = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.makeVideoCall) !== false;
+    // #disabledInput: the composer is hard-disabled when the host prop OR the resolved
+    // config asks for it (server can lock input per tenant/conversation state).
+    const inputDisabled = disabledInput !== null && disabledInput !== void 0 ? disabledInput : (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.disabledInput) === true;
+    // Close button (BUG 4): shown unless the config explicitly disables it. Closing the
+    // surface also tears down any active call so we never leave a dangling call behind.
+    const showClose = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.showCloseButton) !== false;
+    const onHeaderClose = () => {
+        try {
+            endCall === null || endCall === void 0 ? void 0 : endCall();
+        }
+        catch { /* no active call */ }
+        onClose === null || onClose === void 0 ? void 0 : onClose();
+    };
+    // P3: once a call is ACTIVE, render <VideoCall> ABOVE the thread — gated on
+    // videoCallStarted only, NOT videoEnabled, so an auto-joined call (autoJoinVideoCall)
+    // always shows even under a contradictory config (makeVideoCall:false + auto-join).
+    // It renders as a view over the PROVIDER's single VideoCallClient (createClient returns
+    // it; the provider owns the audio session). start()/stop() stay no-ops here because the
+    // provider already brackets the call's audio, but setSpeaker DELEGATES to the provider's
+    // real AudioRoute (audit #25) so the in-call speaker toggle reaches the live audio route
+    // rather than a stub. onEnd routes back through endCall so leave/inbound-hangup flips the flag.
+    if (videoCallStarted && (_video === null || _video === void 0 ? void 0 : _video.socket)) {
+        const VideoCall = loadVideoCall();
+        return ((0, jsx_runtime_1.jsx)(react_native_safe_area_context_1.SafeAreaView, { testID: "webchat-surface", style: containerStyle, children: (0, jsx_runtime_1.jsx)(VideoCall, { socket: _video.socket, getSessionId: _video.getSessionId, onEnd: endCall, createClient: () => _video.client, audioRoute: { start() { }, stop() { }, setSpeaker: (on) => setSpeaker(on) }, dir: dir, theme: theme, language: language, 
+                // Agent identity for the "connecting" placeholder (before the remote joins):
+                // the header title (agent/tenant name) + the configured avatar, gated by showAvatar.
+                agentName: headerTitle !== null && headerTitle !== void 0 ? headerTitle : avatar === null || avatar === void 0 ? void 0 : avatar.name, agentAvatarUrl: showAvatar ? avatar === null || avatar === void 0 ? void 0 : avatar.url : undefined }) }));
+    }
+    // Surface sits on the chat background (web bgChatColor / theme.chat.bg) so the
+    // thread area matches the message list; falls back to the surface colour.
+    const surfaceBg = (_f = (_e = theme === null || theme === void 0 ? void 0 : theme.chat) === null || _e === void 0 ? void 0 : _e.bg) !== null && _f !== void 0 ? _f : (_g = theme === null || theme === void 0 ? void 0 : theme.colors) === null || _g === void 0 ? void 0 : _g.surface;
+    return (
+    // edges EXCLUDE "top": the Header owns the top safe-area inset itself
+    // (paddingTop: insets.top) so its brand color fills the status-bar strip. If
+    // this SafeAreaView also padded the top, the inset would be applied TWICE
+    // (surface + header) AND the strip would show the chat bg, not the header color.
+    (0, jsx_runtime_1.jsxs)(react_native_safe_area_context_1.SafeAreaView, { testID: "webchat-surface", edges: ["left", "right", "bottom"], style: { ...containerStyle, backgroundColor: surfaceBg }, children: [(0, jsx_runtime_1.jsx)(react_native_1.View, { ref: headerRef, accessible: true, accessibilityRole: "header", children: (0, jsx_runtime_1.jsx)(Header_1.Header, { variant: variant, dir: dir, theme: theme, title: headerTitle, subtitle: headerConfig.subTitle, language: language, onClose: onHeaderClose, showClose: showClose, connected: connected, statusIndicator: headerConfig.statusIndicator !== false, 
+                    // Connecting banner (web parity): show the configured connectingText
+                    // while not yet connected (the Header hides it once connected).
+                    connectingText: headerConfig.connectingText, 
+                    // Agent avatar + status dot (item 25) and custom close image (item 29).
+                    avatar: avatar, showAvatar: showAvatar, closeImage: closeImage, 
+                    // Video-call button lives INSIDE the header now (web parity). Wired only
+                    // when video is enabled and the thread (not prechat) is showing; pressing
+                    // it starts the call exactly like the old floating button did.
+                    onStartCall: videoEnabled && !showPrechat ? startCall : undefined }) }), showPrechat ? ((0, jsx_runtime_1.jsx)(PrechatForm_1.PrechatForm, { fields: effectivePrechatFields, onSubmit: onPrechatSubmit, dir: dir, theme: theme, language: language, headline: prechatHeadline, submitLabel: prechatSubmitLabel })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(MessageList_1.MessageList, { messages: messages, dir: dir, theme: theme, audioAdapter: audioAdapter, showMessageDate: showMessageDate, showTyping: showTyping, showAvatar: showAvatar, avatar: avatar }), showPoweredBy ? (0, jsx_runtime_1.jsx)(PoweredBy_1.PoweredBy, { theme: theme }) : null, (0, jsx_runtime_1.jsx)(Composer_1.Composer, { onSend: send, onPickImages: onPickImages, onPickDocuments: onPickDocuments, onPickVideos: onPickVideos, onAttach: attach, audioAdapter: recordAudioAdapter, disabledInput: inputDisabled, dir: dir, theme: theme, language: language, 
+                        // web config.emoji gates the emoji affordance (default false per web).
+                        emojiEnabled: (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.emoji) === true, 
+                        // web config.inputTextFieldHint overrides the composer placeholder.
+                        placeholder: headerConfig.inputTextFieldHint })] }))] }));
+}
+// Bridges the imperative handle into provider state (clearHistory/resetSession/unread).
+function ImperativeBridge({ handleRef, setOpen }) {
+    const { send, clearHistory, resetSession, unread } = (0, useWebchat_1.useWebchat)();
+    (0, react_1.useImperativeHandle)(handleRef, () => ({
+        open: () => setOpen(true),
+        close: () => setOpen(false),
+        sendMessage: (t) => send(t),
+        getUnreadCount: () => unread, // real value (B19/B20)
+        clearHistory, // real purge (B19)
+        resetSession, // real reset (B19)
+    }), [send, clearHistory, resetSession, unread]);
+    return null;
+}
+// Default FAB launcher. Reads theme/dir from context (NOT props) so the brand color and
+// logical-end placement follow the resolved config: the FAB anchors to the logical end
+// (left under RTL) instead of a hardcoded 'right'.
+function Launcher({ renderLauncher, setOpen }) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const { theme, dir, language, resolvedConfig, status, wasConnected } = (0, useWebchat_1.useWebchat)();
+    const d = (0, dir_1.dirStyles)(dir);
+    const t = (0, i18n_1.makeT)(language);
+    // showButtonChat (item 27, web parity): hide the launcher FAB entirely when the
+    // server config explicitly disables it. Only an explicit `false` hides it (default on).
+    if ((resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.showButtonChat) === false)
+        return null;
+    // hideWhenNotConnected (item 34): hide the launcher ONLY after a real
+    // connect-then-disconnect (reached "up" once, then dropped). NEVER on the initial
+    // pre-connect (wasConnected false) — the user must still be able to tap to connect.
+    // Default off (opt-in). Mirrors the Surface gate so launcher + surface hide together.
+    const connected = status === "connected" || status === "session-confirmed";
+    if ((resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.hideWhenNotConnected) === true && wasConnected && !connected)
+        return null;
+    if (renderLauncher)
+        return renderLauncher({ open: () => setOpen(true) });
+    // Launcher dimensions/colors come from the launcher token group (web
+    // wedgitSectionStyle). Defaults match the historical hardcoded look (56×56,
+    // r28, primary bg, white icon) so an unset config keeps today's launcher.
+    const launcher = (_a = theme === null || theme === void 0 ? void 0 : theme.launcher) !== null && _a !== void 0 ? _a : {};
+    const buttonBg = (_b = launcher.buttonBg) !== null && _b !== void 0 ? _b : theme.colors.primary;
+    const buttonColor = (_c = launcher.buttonColor) !== null && _c !== void 0 ? _c : "#fff";
+    // Dimensions are typed number|string on the token (web allows e.g. "56px");
+    // RN's DimensionValue is stricter, so cast at the style boundary.
+    const buttonWidth = ((_d = launcher.buttonWidth) !== null && _d !== void 0 ? _d : 56);
+    const buttonHeight = ((_e = launcher.buttonHeight) !== null && _e !== void 0 ? _e : 56);
+    const buttonBorderRadius = ((_f = launcher.buttonBorderRadius) !== null && _f !== void 0 ? _f : 28);
+    // Custom launcher image (item 29, web `openLauncherImage`/`closeLauncherImage`):
+    // when an open-launcher image url is configured, render it as an <Image> instead
+    // of the built-in chat Icon (the closed/minimized variant maps to closeLauncherImage).
+    // Closed surface => the launcher is the "open" affordance, so prefer openLauncherImage;
+    // fall back to closeLauncherImage, then the Icon.
+    const launcherImageUrl = (_h = (_g = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.openLauncherImage) === null || _g === void 0 ? void 0 : _g.url) !== null && _h !== void 0 ? _h : (_j = resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.closeLauncherImage) === null || _j === void 0 ? void 0 : _j.url;
+    return ((0, jsx_runtime_1.jsx)(react_native_1.Pressable, { testID: "webchat-launcher", accessibilityRole: "button", accessibilityLabel: t("open_chat"), onPress: () => setOpen(true), style: {
+            position: "absolute",
+            bottom: 24,
+            right: d.isRtl ? undefined : 24,
+            left: d.isRtl ? 24 : undefined,
+            backgroundColor: launcherImageUrl ? undefined : buttonBg,
+            borderRadius: buttonBorderRadius,
+            width: buttonWidth,
+            height: buttonHeight,
+            alignItems: "center",
+            justifyContent: "center",
+            overflow: "hidden",
+        }, children: launcherImageUrl ? ((0, jsx_runtime_1.jsx)(react_native_1.Image, { testID: "webchat-launcher-image", accessibilityRole: "image", source: { uri: launcherImageUrl }, resizeMode: "cover", style: { width: buttonWidth, height: buttonHeight, borderRadius: buttonBorderRadius } })) : ((0, jsx_runtime_1.jsx)(Icon_1.Icon, { name: "chat", color: buttonColor, size: 26 })) }));
+}
+exports.WebChat = (0, react_1.forwardRef)(function WebChat(props, ref) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    const { config, renderLauncher, onOpen, onClose, title, prechatFields, prechatHeadline, prechatSubmitLabel, } = props;
+    const [open, setOpenState] = (0, react_1.useState)((_a = props.open) !== null && _a !== void 0 ? _a : false);
+    const [prechatDone, setPrechatDone] = (0, react_1.useState)(false);
+    const [prechatValues, setPrechatValues] = (0, react_1.useState)(props.prechatValues);
+    const setOpen = (v) => {
+        setOpenState(v);
+        v ? onOpen === null || onOpen === void 0 ? void 0 : onOpen() : onClose === null || onClose === void 0 ? void 0 : onClose();
+    };
+    const onPrechatSubmit = (values) => {
+        setPrechatValues(values);
+        setPrechatDone(true);
+    };
+    // BATTERIES-INCLUDED defaults (zero-adapter path): build each default adapter
+    // ONCE per mount and let an injected prop (or the `_`-prefixed test seam) ALWAYS
+    // win (`prop ?? default`). Each create*() lazily requires its Expo peer in
+    // try/catch and returns `undefined` when absent — so a host without the peer
+    // degrades exactly like the absent-prop case (attach row hidden, recorder
+    // suppressed, throwing-reader fallback). Memoized so the factories aren't rebuilt
+    // every render (and so the peer require runs at most once per mount).
+    const defaultPicker = (0, react_1.useMemo)(() => (0, expoDefaults_1.createExpoPicker)(), []);
+    const defaultAudioAdapter = (0, react_1.useMemo)(() => (0, expoDefaults_1.createExpoAudioAdapter)(), []);
+    const defaultReadBase64 = (0, react_1.useMemo)(() => (0, expoDefaults_1.createExpoReadBase64)(), []);
+    // webrtcFactory already defaults to reactNativeWebRTCFactory() lazily inside the
+    // provider's startCall; we thread the memoized real factory here too so the
+    // default is explicit at the public seam (a host/test prop still wins).
+    const defaultWebrtcFactory = (0, react_1.useMemo)(() => (0, webrtc_1.reactNativeWebRTCFactory)(), []);
+    const picker = (_c = (_b = props._picker) !== null && _b !== void 0 ? _b : props.picker) !== null && _c !== void 0 ? _c : defaultPicker;
+    const audioAdapter = (_e = (_d = props._audioAdapter) !== null && _d !== void 0 ? _d : props.audioAdapter) !== null && _e !== void 0 ? _e : defaultAudioAdapter;
+    const readBase64 = (_g = (_f = props._readBase64) !== null && _f !== void 0 ? _f : props.readBase64) !== null && _g !== void 0 ? _g : defaultReadBase64;
+    const webrtcFactory = (_j = (_h = props._webrtcFactory) !== null && _h !== void 0 ? _h : props.webrtcFactory) !== null && _j !== void 0 ? _j : defaultWebrtcFactory;
+    // Provider always mounts so the socket can stay connected while closed (S7) and the
+    // imperative handle/callbacks remain live. Surface toggles on open. theme/dir/language
+    // are owned by the provider (context contract) — WebChat no longer carries hardcoded
+    // theme/dir defaults; consumers read them from useWebchat().
+    return ((0, jsx_runtime_1.jsxs)(WebchatProvider_1.WebchatProvider, { config: config, socketFactory: (_k = props._socketFactory) !== null && _k !== void 0 ? _k : ((cfg) => (0, socketFactory_1.createSocket)(cfg.connectionUrl, cfg.channelId, cfg.debug)), store: props._store, 
+        // config-fetch seam: `_fetch` (tests) or a host-provided `fetchImpl`; the provider
+        // falls back to the ambient global fetch when neither is set.
+        fetchImpl: (_l = props._fetch) !== null && _l !== void 0 ? _l : props.fetchImpl, onMessageReceived: props.onMessageReceived, onConnected: props.onConnected, onDisconnected: props.onDisconnected, onError: props.onError, onUnreadChange: props.onUnreadChange, prechatValues: prechatValues, 
+        // Host-prop prechat fields present — lets the provider know a form will collect
+        // data (so it defers the greet until submit), alongside server prechatForm.enabled.
+        hasPrechatFields: Array.isArray(prechatFields) && prechatFields.length > 0, 
+        // Web parity (!sessionId gate): a session reset re-presents the prechat form.
+        // resetSession() fires this so the one-time prechatDone latch is cleared and the
+        // next (fresh) session shows the form again instead of dropping into an empty thread.
+        onSessionReset: () => {
+            setPrechatDone(false);
+            setPrechatValues(undefined);
+        }, readBase64: readBase64, mediaLimits: props.mediaLimits, webrtcFactory: webrtcFactory, audioRoute: (_m = props._audioRoute) !== null && _m !== void 0 ? _m : props.audioRoute, createVideoClient: props._createVideoClient, audioAdapter: audioAdapter, children: [(0, jsx_runtime_1.jsx)(ImperativeBridge, { handleRef: ref, setOpen: setOpen }), open ? ((0, jsx_runtime_1.jsx)(Surface, { config: config, title: title, prechatFields: prechatFields, prechatHeadline: prechatHeadline, prechatSubmitLabel: prechatSubmitLabel, onPrechatSubmit: onPrechatSubmit, prechatDone: prechatDone, picker: picker, audioAdapter: audioAdapter, secureScreen: props.secureScreen, disabledInput: props.disabledInput, onClose: () => setOpen(false) })) : ((0, jsx_runtime_1.jsx)(react_native_1.View, { style: { flex: 1 }, pointerEvents: "box-none", children: (0, jsx_runtime_1.jsx)(Launcher, { renderLauncher: renderLauncher, setOpen: setOpen }) }))] }));
+});

package/lib/ui/openLink.d.ts

@@ -0,0 +1 @@
+export declare function openLink(href: string): Promise<any>;

package/lib/ui/openLink.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openLink = openLink;
+// src/ui/openLink.ts — the ONE shared scheme gate (reused by Phase 2 attachment-open too)
+const react_native_1 = require("react-native");
+async function openLink(href) {
+    if (/^https:\/\//.test(href))
+        return react_native_1.Linking.openURL(href); // safe: open
+    if (/^(mailto:|tel:)/.test(href)) { // confirm first
+        return new Promise((resolve) => react_native_1.Alert.alert("Open link?", href, [
+            { text: "Cancel", style: "cancel", onPress: () => resolve() },
+            { text: "Open", onPress: () => { react_native_1.Linking.openURL(href); resolve(); } },
+        ]));
+    }
+    return; // reject ftp:/file:/intent:/custom — bot text is untrusted (B13)
+}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@experiaapp/webchat-react-native",
+  "version": "2.0.1",
+  "description": "Experia App live-chat SDK for React Native — drop a real-time support channel (chat, media & video calls) into your app so your customers can reach you with ease.",
+  "license": "UNLICENSED",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "react-native": "lib/index.js",
+  "files": [
+    "lib",
+    "app.plugin.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-assets.js",
+    "prepack": "npm run build",
+    "test": "jest",
+    "test:core": "jest src/core src/theme",
+    "setup:example": "npm run build && npm pack && node -e \"const v=require('./package.json').version;require('fs').copyFileSync('experiaapp-webchat-react-native-'+v+'.tgz','example/webchat-sdk.tgz')\" && cd example && npm install ./webchat-sdk.tgz",
+    "smoke:live": "npm run build && node scripts/live-smoke.js",
+    "sync:example": "npm run build && node scripts/sync-example.js"
+  },
+  "dependencies": {
+    "expo-audio": "~56.0.12",
+    "expo-font": "~56.0.5",
+    "expo-video": "~56.1.4",
+    "i18next": "^26.3.1",
+    "socket.io-client": "2.5.0"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.21",
+    "react": ">=18",
+    "react-native": ">=0.74",
+    "react-native-incall-manager": ">=4",
+    "react-native-localize": ">=3",
+    "react-native-safe-area-context": ">=4",
+    "react-native-webrtc": ">=124",
+    "react-native-svg": ">=13",
+    "@react-native-community/netinfo": ">=11",
+    "expo-image-picker": ">=14",
+    "expo-document-picker": ">=11",
+    "expo-file-system": ">=15"
+  },
+  "peerDependenciesMeta": {
+    "react-native-webrtc": {
+      "optional": true
+    },
+    "react-native-incall-manager": {
+      "optional": true
+    },
+    "react-native-svg": {
+      "optional": true
+    },
+    "@react-native-community/netinfo": {
+      "optional": true
+    },
+    "expo-image-picker": {
+      "optional": true
+    },
+    "expo-document-picker": {
+      "optional": true
+    },
+    "expo-file-system": {
+      "optional": true
+    }
+  },
+  "//peerNote": "The expo-* peers above are OPTIONAL and auto-wired by <WebChat> when installed. In a bare React Native app (no Expo prebuild) they require the expo-modules-core runtime: run `npx install-expo-modules` once so the autolinked native side exists. Expo-managed / dev-client apps already have it. Pin SDK-correct versions with `npx expo install`.",
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^3.1.1",
+    "@react-native-community/netinfo": "^12.0.1",
+    "@react-native/babel-preset": "^0.85.3",
+    "@react-native/jest-preset": "^0.85.3",
+    "@testing-library/react-native": "^13.3.3",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.30",
+    "@types/react": "~19.0.0",
+    "jest": "^29.7.0",
+    "react": "^19.2.3",
+    "react-native": "^0.85.3",
+    "react-native-incall-manager": "^4.2.1",
+    "react-native-localize": "^3.7.0",
+    "react-native-safe-area-context": "^5.8.0",
+    "react-native-webrtc": "^124.0.7",
+    "react-test-renderer": "^19.2.3",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.4.5"
+  }
+}