@experiaapp/webchat-react-native 2.0.1

package/lib/core/types.d.ts

@@ -0,0 +1,320 @@
+export type SessionStatus = "idle" | "connecting" | "connected" | "session-pending" | "session-confirmed" | "reconnecting" | "disconnected" | "session-failed";
+export type WebChatErrorCode = "connection" | "session-timeout" | "send" | "config-fetch" | "permission-denied" | "media-webrtc";
+export interface QuickReply {
+    title: string;
+    payload: string;
+}
+/**
+ * A configurable image reference (web parity — agent `avatar`, `closeImage`,
+ * `openLauncherImage`, `closeLauncherImage`). Web stores `{ name, size, url }`;
+ * the SDK only needs `url` to render and `name` for a11y/labels, so `size` is
+ * intentionally omitted. Both fields are optional — an empty object means "no
+ * custom image" and the consumer falls back to the built-in glyph.
+ */
+export interface ConfigImage {
+    url?: string;
+    name?: string;
+}
+/**
+ * The two feedback reactions a user can apply to a received (bot/agent) message
+ * (web parity). The stored `Message.userReaction` widens this to allow `null`
+ * (no/cleared reaction); the toggle verbs (`unlike`/`undislike`) are transport
+ * strings on the wire, not reaction states.
+ */
+export type MessageReaction = "like" | "dislike";
+export interface Message {
+    /** client-generated stable key for reconciliation (the SDK's own id). */
+    key: string;
+    /**
+     * Server-assigned stable message id (web `messageKey`). Distinct from `key`
+     * (the SDK's client-side reconciliation id). Carried through verbatim from the
+     * `bot_uttered` payload; it is the id echoed on the `activity`/`activityAck`
+     * reaction events. Present only on server-originated messages.
+     */
+    messageKey?: string;
+    sender: "user" | "response";
+    text?: string;
+    quick_replies?: QuickReply[];
+    media?: string[];
+    files?: unknown[];
+    mediaUrl?: string;
+    /**
+     * Message-level MIME (web `message.type`). Backstops attachment classification
+     * when a hosted media URL has no file extension and the file object carries no
+     * own mime — so a received image/video still renders inline instead of as a
+     * document tile / browser link.
+     */
+    type?: string;
+    timestamp: number;
+    status?: "pending" | "sent" | "failed";
+    /**
+     * The user's current feedback reaction on this message (web parity). `null`
+     * (or absent) = no reaction. Mutually exclusive — set by the `REACT` reducer
+     * action / inbound `activityAck`.
+     */
+    userReaction?: MessageReaction | null;
+    /**
+     * Per-message server options carried verbatim from `bot_uttered`. `enableReaction`
+     * gates the thumbs-up/down feedback row (web `options.enableReaction`); the index
+     * signature preserves any other server-sent option keys untouched.
+     */
+    options?: {
+        enableReaction?: boolean;
+    } & Record<string, any>;
+}
+export interface OutgoingPayload {
+    message: string;
+    text?: string;
+    session_id: string;
+    customData: {
+        language: string;
+    };
+    /**
+     * Base64 data-URL STRINGS (web parity: `media: filesBase64`). NOT objects — the
+     * backend reads each entry as a string and rejects objects with
+     * "MsgToExp: invalid media string".
+     */
+    media?: string[];
+    /** Web parity: the first attachment's MIME type (web `typeMedia: files[0].type`). */
+    typeMedia?: string;
+    messageKey?: string;
+    type?: string;
+    /** S9: free-form host metadata passed through to the backend untouched. */
+    metadata?: Record<string, unknown>;
+    /**
+     * Pre-chat form submission (web parity: ChatContainer sends the collected fields as
+     * `prechatFormSubmission` on the /chitchat.greet message). Only present on the greet.
+     */
+    prechatFormSubmission?: Record<string, string>;
+}
+/**
+ * Full webchat configuration (S8). Fields split conceptually into:
+ *  - connection (channelId/configUrl/connectionUrl) — required to talk to a tenant
+ *  - server-driven theming/i18n (interfaceTheme, publicStyle, language)
+ *  - behaviour flags the host or server can toggle.
+ *
+ * `mergeConfig` (configClient) applies precedence prop > server > default, so every
+ * non-connection field is optional here; the connection trio is required.
+ */
+export interface Config {
+    /** Tenant channel id — selects the socket path and storage namespace. */
+    channelId: string;
+    /** Remote endpoint that returns the server-side config JSON. */
+    configUrl: string;
+    /** WebSocket host (no scheme — the socket factory prepends `wss://`). */
+    connectionUrl: string;
+    /** Theme variant key (interfaceThemeEnum: '' | 'experia' | 'digitalGovernment'). */
+    interfaceTheme?: string;
+    /** Tenant colour/font overrides (themeColor, defaultFontColor, …). */
+    publicStyle?: PublicStyle;
+    /** Tenant chat-bubble style overrides (sentMsgBg, receivedMsgBg, …) — server-driven. */
+    chatSectionStyle?: Record<string, any>;
+    /** Tenant header style overrides (bgColor, titleColor, videoCallBtn*, …) — server-driven. */
+    headerSectionStyle?: Record<string, any>;
+    /** Tenant composer/send style overrides (textFieldBg, sendBtnBg, …) — server-driven. */
+    sendSectionStyle?: Record<string, any>;
+    /** Tenant launcher (FAB) style overrides (buttonColor, buttonBg, buttonWidth, …) — server-driven (web `wedgitSectionStyle`). */
+    wedgitSectionStyle?: Record<string, any>;
+    /** Initial language ('en' | 'ar' | …); drives dir = 'ar' ? 'rtl' : 'ltr'. */
+    language?: string;
+    /** Connect the socket automatically (vs. waiting for an explicit open). */
+    autoConnection?: boolean;
+    /** Master switch: when false the socket never connects regardless of open state. */
+    enableConnection?: boolean;
+    /** Open the chat surface on first load. */
+    openOnLoad?: boolean;
+    /** Send the welcome/greet flow on a new session. */
+    sendWelcomeMessage?: boolean;
+    /** Disable the composer input (read-only / bot-driven conversations). */
+    disabledInput?: boolean;
+    /** Expose the video-call entry point. */
+    makeVideoCall?: boolean;
+    /** Auto-join an incoming video call without an explicit tap (web `autoJoinVideoCall`; default false). */
+    autoJoinVideoCall?: boolean;
+    /** Show the file/image upload control (web `uploadMedia`; default true). */
+    uploadMedia?: boolean;
+    /** Show the voice-note recorder (web `uploadAudio`; default true). */
+    uploadAudio?: boolean;
+    /** Show the image option in the attach menu (web `uploadImage`; default true). */
+    uploadImage?: boolean;
+    /** Show the document option in the attach menu (web `uploadDocuments`; default true). */
+    uploadDocuments?: boolean;
+    /** Show the video option in the attach menu (web `uploadVideo`; default true). */
+    uploadVideo?: boolean;
+    /** Show the emoji-picker button (web `emoji`; default false per web defaultConfig). */
+    emoji?: boolean;
+    /** Show the header close/back button (default shown; only `false` hides it). */
+    showCloseButton?: boolean;
+    /** Show the floating launcher button (web `showButtonChat`; default true). */
+    showButtonChat?: boolean;
+    /** Render the per-message timestamp row (web `showMessageDate`; default true). */
+    showMessageDate?: boolean;
+    /** Render the typing indicator while the agent is typing (web `displayTypingIndication`; default false). */
+    displayTypingIndication?: boolean;
+    /** Render the "powered by" badge below the message list (web `showPoweredBy`; default true). */
+    showPoweredBy?: boolean;
+    /** Show the agent avatar on header + received messages (web `showAvatar`; default true). */
+    showAvatar?: boolean;
+    /** Agent avatar image (web `config.avatar`; `{ url, name }`). */
+    avatar?: ConfigImage;
+    /** Custom header close-button image (web `config.closeImage`; `{ url, name }`). */
+    closeImage?: ConfigImage;
+    /** Custom launcher (open) image (web `config.openLauncherImage`; `{ url, name }`). */
+    openLauncherImage?: ConfigImage;
+    /** Custom launcher (close/minimized) image (web `config.closeLauncherImage`; `{ url, name }`). */
+    closeLauncherImage?: ConfigImage;
+    /** Header title text (web `config.title`; falls back to host prop when absent). */
+    title?: string;
+    /** Header subtitle text under the title (web `config.subTitle`). */
+    subTitle?: string;
+    /** Text shown in the header "connecting" banner (web `config.connectingText`). */
+    connectingText?: string;
+    /** Composer placeholder override (web `config.inputTextFieldHint`). */
+    inputTextFieldHint?: string;
+    /** Where to place the online/offline status indicator (web `config.statusIndicatorPosition`; default 'top-right'). */
+    statusIndicatorPosition?: string;
+    /** Pre-chat form descriptor (web `config.prechatForm`); `.enabled` gates the form. */
+    prechatForm?: PrechatForm;
+    /**
+     * Persisted-history storage backend (web `config.storage`). On web this selects
+     * `localStorage` vs `sessionStorage` vs in-memory. The RN analog (Tier C #33):
+     *  - "localStorage" (default) -> the persistent AsyncStorage-backed store (history
+     *    survives across app launches; the 24h sliding TTL still applies).
+     *  - "sessionStorage" | "memory" -> an EPHEMERAL in-memory store (history does NOT
+     *    survive an app relaunch; closest RN analog to a per-session/non-durable store).
+     * Only honored when the host injects NO store of its own — a host-supplied store
+     * always wins (see `selectStore` in persistence.ts). Default "localStorage".
+     */
+    storage?: "localStorage" | "sessionStorage" | "memory";
+    /**
+     * Hide the launcher/surface while not connected (web `config.hideWhenNotConnected`,
+     * default true on web — though effectively dead there). RN semantics (Tier C #34):
+     * the launcher/surface is hidden ONLY after a connection was established and then
+     * lost (status left "connected"/"session-confirmed" having previously reached it),
+     * NEVER on the initial pre-connect — otherwise the user could never open to connect.
+     * Default false (opt-in) so the SDK's open-to-connect flow is unchanged unless set.
+     */
+    hideWhenNotConnected?: boolean;
+    /**
+     * Inline-embedded vs floating-widget layout (web `config.embedded`). RN analog
+     * (Tier C #31): when true the OPEN surface lays out inline within its parent
+     * (no absolute/floating positioning, no launcher-overlay padding) so a host can
+     * embed it in a screen; when false (default) the surface fills its mount as today.
+     * Host mounting ultimately controls placement in RN — this flag only adjusts the
+     * Surface's own container style. Default false.
+     */
+    embedded?: boolean;
+    /**
+     * Full-height vs bounded open-surface sizing (web `config.fullScreenHeight`). RN
+     * analog (Tier C #32): when true (or unset) the open surface fills available height
+     * (`flex: 1`, today's behaviour); when explicitly false it is capped to a bounded
+     * height (`maxHeight`) so it does not consume the whole mount. Host mounting also
+     * influences final height in RN. Default true (omit/true => full height).
+     */
+    fullScreenHeight?: boolean;
+    /**
+     * Widget shell type (web `config.typeWidget`: "default" | "drawer" | embedded
+     * shell). Tier C #30: the SDK has a SINGLE Surface + optional FAB Launcher and no
+     * DrawerWidget/embedded-shell analog beyond the `embedded` flag, so only "default"
+     * maps; any non-default value is treated as "default" (no error). Resolved by
+     * DOCUMENTATION, not new behaviour. Default "default".
+     */
+    typeWidget?: string;
+    /** Sliding session TTL in ms (24h default applied by consumers). */
+    ttlMs?: number;
+    /**
+     * DEV-only: trace every socket message (outbound emits + inbound events +
+     * lifecycle) to the console/Metro for debugging. Never enable in production —
+     * full payloads (incl. session ids / content) are logged.
+     */
+    debug?: boolean;
+}
+/**
+ * A `{ en, ar }` localized string pair (web parity — `interfaces/index.ts`
+ * `LocalizedText`). The renderer reads `text[language] || text.en` so an absent
+ * translation falls back to English rather than blanking.
+ */
+export type LocalizedText = {
+    en: string;
+    ar: string;
+};
+/** Supported pre-chat field input kinds (web parity). */
+export type PrechatFieldType = "text" | "email" | "phone" | "dropdown";
+/** A single selectable option for a `dropdown` field (web parity). */
+export interface PrechatFieldOption {
+    value: string;
+    label: LocalizedText;
+}
+/**
+ * One pre-chat form field (web `interfaces/index.ts` `PrechatField`). `label`,
+ * `placeholder`, and `errorMessage` are localized `{en,ar}` pairs; `required`
+ * defaults to TRUE (web semantics — only an explicit `false` makes it optional).
+ * `options` is required only for `type === "dropdown"`.
+ */
+export interface PrechatField {
+    key: string;
+    type: PrechatFieldType;
+    label: LocalizedText;
+    placeholder?: LocalizedText;
+    required?: boolean;
+    errorMessage?: LocalizedText;
+    options?: PrechatFieldOption[];
+}
+/**
+ * Pre-chat form descriptor (web `config.prechatForm`). Now fully typed at parity
+ * with the web schema: `.enabled` gates the form, `.fields[]` drives per-field
+ * rendering/validation, and `.headline`/`.submitLabel` are optional localized
+ * `{en,ar}` strings. The trailing index signature is retained so an unknown
+ * server key on the object never breaks the structural type.
+ */
+export interface PrechatForm {
+    /** Master gate — only show the form when explicitly enabled. */
+    enabled?: boolean;
+    /** Form fields rendered in order (text / email / phone / dropdown). */
+    fields?: PrechatField[];
+    /** Optional localized headline shown above the fields. */
+    headline?: LocalizedText;
+    /** Optional localized submit-button label (falls back to the i18n default). */
+    submitLabel?: LocalizedText;
+    [k: string]: any;
+}
+/**
+ * Tenant style overrides carried on `Config.publicStyle`. Kept structurally
+ * identical to the theme layer's `PublicStyle` so `buildTheme` can consume it
+ * directly without a cross-import (core stays framework-agnostic).
+ */
+export interface PublicStyle {
+    themeColor?: string;
+    defaultFontColor?: string;
+    defaultFontSize?: number;
+    defaultFontWeight?: string;
+    /**
+     * Tenant custom font (web `publicStyle.defaultFontFamily`). Web injects an
+     * `@font-face` per weight at runtime; RN registers each weight as its own font
+     * family via `expo-font` loadAsync (see {@link createExpoFontLoader}). `fonts`
+     * holds one remote TTF per weight (ExtraLight..Black). All fields optional.
+     */
+    defaultFontFamily?: {
+        name?: string;
+        fonts?: Array<{
+            url: string;
+            fontWeight?: string;
+            fontName?: string;
+        }>;
+    };
+}
+/**
+ * Maps the backend's string error keys (web parity — emitted on the socket) to
+ * the SDK's typed {@link WebChatErrorCode}. Unknown keys fall back to
+ * 'connection' at the call site.
+ */
+export declare const WEB_ERROR_CODE_MAP: Record<string, WebChatErrorCode>;
+/** Translate a backend error key to a typed code, defaulting to 'connection'. */
+export declare const mapWebErrorCode: (key: string | undefined) => WebChatErrorCode;
+export declare class WebChatError extends Error {
+    code: WebChatErrorCode | "session-timeout";
+    recoverable: boolean;
+    cause?: unknown | undefined;
+    constructor(code: WebChatErrorCode | "session-timeout", message: string, recoverable: boolean, cause?: unknown | undefined);
+}
+export declare const isWebChatError: (e: unknown) => e is WebChatError;

package/lib/core/types.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWebChatError = exports.WebChatError = exports.mapWebErrorCode = exports.WEB_ERROR_CODE_MAP = void 0;
+/**
+ * Maps the backend's string error keys (web parity — emitted on the socket) to
+ * the SDK's typed {@link WebChatErrorCode}. Unknown keys fall back to
+ * 'connection' at the call site.
+ */
+exports.WEB_ERROR_CODE_MAP = {
+    send_message_fail: "send",
+    request_socket_session_fail: "session-timeout",
+    get_config_fail: "config-fetch",
+    socket_connection_fail: "connection",
+    media_upload_fail: "send",
+};
+/** Translate a backend error key to a typed code, defaulting to 'connection'. */
+const mapWebErrorCode = (key) => (key && exports.WEB_ERROR_CODE_MAP[key]) || "connection";
+exports.mapWebErrorCode = mapWebErrorCode;
+class WebChatError extends Error {
+    constructor(code, message, recoverable, cause) {
+        super(message);
+        this.code = code;
+        this.recoverable = recoverable;
+        this.cause = cause;
+        this.name = "WebChatError";
+    }
+}
+exports.WebChatError = WebChatError;
+const isWebChatError = (e) => e instanceof WebChatError;
+exports.isWebChatError = isWebChatError;

package/lib/core/unread.d.ts

@@ -0,0 +1,2 @@
+import type { Message } from "./types";
+export declare const unreadCount: (messages: Message[], lastReadAt: number) => number;

package/lib/core/unread.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unreadCount = void 0;
+const unreadCount = (messages, lastReadAt) => messages.filter((m) => m.sender === "response" && m.timestamp > lastReadAt).length;
+exports.unreadCount = unreadCount;

package/lib/i18n/ar.json

@@ -0,0 +1 @@
+{ "send": "إرسال", "open_chat": "افتح المحادثة", "start_chat": "ابدأ المحادثة", "type_message": "اكتب رسالة", "start_video_call": "بدء مكالمة فيديو", "back": "رجوع", "close": "إغلاق", "mute": "كتم الميكروفون", "unmute": "إلغاء كتم الميكروفون", "camera_on": "تشغيل الكاميرا", "camera_off": "إيقاف الكاميرا", "leave_call": "إنهاء المكالمة", "flip_camera": "تبديل الكاميرا", "speaker": "مكبر الصوت", "call_error": "الوصول إلى الكاميرا والميكروفون مطلوب لإجراء مكالمات الفيديو.", "open_settings": "فتح الإعدادات", "cancel": "إلغاء", "upload_image": "صورة", "upload_video": "فيديو", "upload_document": "مستند", "record_audio": "تسجيل صوتي", "connecting": "جارٍ الاتصال…", "camera_off_status": "الكاميرا متوقفة", "you": "أنت", "agent": "الوكيل" }

package/lib/i18n/en.json

@@ -0,0 +1 @@
+{ "send": "Send", "open_chat": "Open chat", "start_chat": "Start chat", "type_message": "Type a message", "start_video_call": "Start video call", "back": "Back", "close": "Close", "mute": "Mute microphone", "unmute": "Unmute microphone", "camera_on": "Turn camera on", "camera_off": "Turn camera off", "leave_call": "Leave call", "flip_camera": "Flip camera", "speaker": "Speaker", "call_error": "Camera and microphone access is required for video calls.", "open_settings": "Open Settings", "cancel": "Cancel", "upload_image": "Photo", "upload_video": "Video", "upload_document": "Document", "record_audio": "Record audio", "connecting": "Connecting…", "camera_off_status": "Camera off", "you": "You", "agent": "Agent" }

package/lib/i18n/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Language-keyed string lookup with an EN fallback (audit #8 — no hardcoded
+ * English). Returns the key itself when neither the requested language nor EN
+ * has it, so a missing key is visible rather than silently blank.
+ */
+export declare function makeT(language?: string): (key: string) => string;
+export declare function initI18n(language?: string): any;

package/lib/i18n/index.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeT = makeT;
+exports.initI18n = initI18n;
+// src/i18n/index.ts
+//
+// Two i18n surfaces share the SAME bundled JSON strings:
+//
+//   - makeT(language): a tiny, synchronous, language-keyed lookup with an EN
+//     fallback. It imports en/ar JSON as plain objects so NO native peer
+//     (react-native-localize) is pulled in, and it works before initI18n has run.
+//     This is the helper every prop-driven UI component (Composer/Header/
+//     CallControls/VideoCall/WebChat launcher) uses to translate (audit #8).
+//
+//   - initI18n(language): the full i18next runtime, lazily wired by the provider.
+//     It is the only consumer of react-native-localize, which is lazy-required
+//     INSIDE the function so a static `import { makeT } from "../i18n"` never
+//     loads the native peer.
+const en_json_1 = __importDefault(require("./en.json"));
+const ar_json_1 = __importDefault(require("./ar.json"));
+const STRINGS = { en: en_json_1.default, ar: ar_json_1.default };
+/**
+ * Language-keyed string lookup with an EN fallback (audit #8 — no hardcoded
+ * English). Returns the key itself when neither the requested language nor EN
+ * has it, so a missing key is visible rather than silently blank.
+ */
+function makeT(language) {
+    const lang = language === "ar" ? "ar" : "en";
+    return (key) => { var _a, _b, _c; return (_c = (_b = (_a = STRINGS[lang]) === null || _a === void 0 ? void 0 : _a[key]) !== null && _b !== void 0 ? _b : STRINGS.en[key]) !== null && _c !== void 0 ? _c : key; };
+}
+function initI18n(language) {
+    var _a, _b;
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const i18n = (_a = require("i18next").default) !== null && _a !== void 0 ? _a : require("i18next");
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const { getLocales } = require("react-native-localize");
+    const lng = language !== null && language !== void 0 ? language : (((_b = getLocales()[0]) === null || _b === void 0 ? void 0 : _b.languageCode) === "ar" ? "ar" : "en");
+    i18n.init({ resources: { en: { translation: en_json_1.default }, ar: { translation: ar_json_1.default } }, lng, fallbackLng: "en", interpolation: { escapeValue: false } });
+    return i18n;
+}

package/lib/index.d.ts

@@ -0,0 +1,59 @@
+export { createWebchatClient } from "./core/WebchatClient";
+export type { MinimalSocket, WebchatClientOptions } from "./core/WebchatClient";
+export { createSocket } from "./core/socketFactory";
+export { messagesReducer, initialState } from "./core/messagesReducer";
+export type { MessagesState, MessagesAction } from "./core/messagesReducer";
+export { unreadCount } from "./core/unread";
+export { buildGreet, shouldGreet } from "./core/greet";
+export { MemoryStore, saveSession, loadSession, clearSession, } from "./core/persistence";
+export type { KeyValueStore, PersistedSession } from "./core/persistence";
+export { linkify, isSafeHref } from "./core/linkify";
+export type { Token } from "./core/linkify";
+export { dirStyles } from "./theme/dir";
+export type { Dir } from "./theme/dir";
+export { resolveVariant, buildTheme } from "./theme/themeFactory";
+export type { Variant, PublicStyle, WebChatTheme } from "./theme/themeFactory";
+export * from "./core/types";
+export { fetchConfig, mergeConfig, DEFAULT_CONFIG } from "./core/configClient";
+export type { FetchLike, ServerConfig } from "./core/configClient";
+export { createLogger, logger } from "./core/logger";
+export type { Logger } from "./core/logger";
+export { validateSelection, acceptedMimeTypes, stripBase64OnAck, DEFAULT_LIMITS, } from "./core/media";
+export type { MediaFile, MediaLimits, RejectReason, RejectedFile, ValidationResult, } from "./core/media";
+export { toDataUrl, toMediaEntry } from "./adapters/picker";
+export type { Asset, PickerAdapter, PickImagesOptions, PickDocumentsOptions, MediaEntry, } from "./adapters/picker";
+export { CANONICAL_AUDIO_MIME, NoopAudioAdapter } from "./adapters/audio";
+export type { AudioAdapter, RecordingResult } from "./adapters/audio";
+export { createExpoPicker, createExpoAudioAdapter, createExpoReadBase64, } from "./adapters/expoDefaults";
+export { WebChat } from "./ui/WebChat";
+export type { WebChatHandle } from "./ui/WebChat";
+export { ImageBubble } from "./ui/ImageBubble";
+export type { ImageBubbleProps } from "./ui/ImageBubble";
+export { FileTile } from "./ui/FileTile";
+export type { FileTileProps } from "./ui/FileTile";
+export { AttachButton } from "./ui/AttachButton";
+export type { AttachButtonProps, PendingAttachment } from "./ui/AttachButton";
+export { MediaUploadMenu } from "./ui/MediaUploadMenu";
+export type { MediaUploadMenuProps, MediaUploadOption } from "./ui/MediaUploadMenu";
+export { Icon } from "./ui/Icon";
+export type { IconName, IconProps } from "./ui/Icon";
+export { AudioRecorder } from "./ui/AudioRecorder";
+export type { AudioRecorderProps } from "./ui/AudioRecorder";
+export { VoiceMessage } from "./ui/VoiceMessage";
+export type { VoiceMessageProps } from "./ui/VoiceMessage";
+export { TypingIndicator } from "./ui/TypingIndicator";
+export { PoweredBy } from "./ui/PoweredBy";
+export { createVideoCallClient } from "./core/VideoCallClient";
+export type { VideoCallClient, VideoCallClientOptions, VideoCallEvent, WebRTCFactory, FakeableStream, FakeableTrack, FakeablePeerConnection, MinimalSocket as VideoCallSocket, } from "./core/VideoCallClient";
+export { iceServers, isForwardableCandidate, TURN_URL, TURN_USERNAME, TURN_CREDENTIAL, STUN_URL, } from "./core/ice";
+export type { PcConfig, IceServer as VideoIceServer, CandidateType } from "./core/ice";
+export { reactNativeWebRTCFactory, teardownPeerConnection } from "./adapters/webrtc";
+export type { RTCPeerConnectionLike, MediaStreamLike, MediaStreamTrackLike, PeerConnectionConfig, MediaStreamConstraints, } from "./adapters/webrtc";
+export { AudioRoute, reactNativeAudioRoute } from "./adapters/audioRoute";
+export type { InCallManagerLike, AudioRouteStartOptions } from "./adapters/audioRoute";
+export { VideoCall } from "./ui/VideoCall";
+export type { VideoCallProps, AudioRouteLike } from "./ui/VideoCall";
+export { CallControls } from "./ui/CallControls";
+export type { CallControlsProps } from "./ui/CallControls";
+export { VideoTile } from "./ui/VideoTile";
+export type { VideoTileProps, VideoTileStream } from "./ui/VideoTile";

package/lib/index.js

@@ -0,0 +1,142 @@
+"use strict";
+// Public entrypoint — framework-agnostic core + theme layer (Phase 0 + Phase 1 logic).
+// The React `state/` provider and `ui/` components are added with the RN toolchain layer.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reactNativeWebRTCFactory = exports.STUN_URL = exports.TURN_CREDENTIAL = exports.TURN_USERNAME = exports.TURN_URL = exports.isForwardableCandidate = exports.iceServers = exports.createVideoCallClient = exports.PoweredBy = exports.TypingIndicator = exports.VoiceMessage = exports.AudioRecorder = exports.Icon = exports.MediaUploadMenu = exports.AttachButton = exports.FileTile = exports.ImageBubble = exports.WebChat = exports.createExpoReadBase64 = exports.createExpoAudioAdapter = exports.createExpoPicker = exports.NoopAudioAdapter = exports.CANONICAL_AUDIO_MIME = exports.toMediaEntry = exports.toDataUrl = exports.DEFAULT_LIMITS = exports.stripBase64OnAck = exports.acceptedMimeTypes = exports.validateSelection = exports.logger = exports.createLogger = exports.DEFAULT_CONFIG = exports.mergeConfig = exports.fetchConfig = exports.buildTheme = exports.resolveVariant = exports.dirStyles = exports.isSafeHref = exports.linkify = exports.clearSession = exports.loadSession = exports.saveSession = exports.MemoryStore = exports.shouldGreet = exports.buildGreet = exports.unreadCount = exports.initialState = exports.messagesReducer = exports.createSocket = exports.createWebchatClient = void 0;
+exports.VideoTile = exports.CallControls = exports.VideoCall = exports.reactNativeAudioRoute = exports.AudioRoute = exports.teardownPeerConnection = void 0;
+// Transport + protocol
+var WebchatClient_1 = require("./core/WebchatClient");
+Object.defineProperty(exports, "createWebchatClient", { enumerable: true, get: function () { return WebchatClient_1.createWebchatClient; } });
+var socketFactory_1 = require("./core/socketFactory");
+Object.defineProperty(exports, "createSocket", { enumerable: true, get: function () { return socketFactory_1.createSocket; } });
+// State logic
+var messagesReducer_1 = require("./core/messagesReducer");
+Object.defineProperty(exports, "messagesReducer", { enumerable: true, get: function () { return messagesReducer_1.messagesReducer; } });
+Object.defineProperty(exports, "initialState", { enumerable: true, get: function () { return messagesReducer_1.initialState; } });
+var unread_1 = require("./core/unread");
+Object.defineProperty(exports, "unreadCount", { enumerable: true, get: function () { return unread_1.unreadCount; } });
+var greet_1 = require("./core/greet");
+Object.defineProperty(exports, "buildGreet", { enumerable: true, get: function () { return greet_1.buildGreet; } });
+Object.defineProperty(exports, "shouldGreet", { enumerable: true, get: function () { return greet_1.shouldGreet; } });
+// Persistence
+var persistence_1 = require("./core/persistence");
+Object.defineProperty(exports, "MemoryStore", { enumerable: true, get: function () { return persistence_1.MemoryStore; } });
+Object.defineProperty(exports, "saveSession", { enumerable: true, get: function () { return persistence_1.saveSession; } });
+Object.defineProperty(exports, "loadSession", { enumerable: true, get: function () { return persistence_1.loadSession; } });
+Object.defineProperty(exports, "clearSession", { enumerable: true, get: function () { return persistence_1.clearSession; } });
+// Text rendering
+var linkify_1 = require("./core/linkify");
+Object.defineProperty(exports, "linkify", { enumerable: true, get: function () { return linkify_1.linkify; } });
+Object.defineProperty(exports, "isSafeHref", { enumerable: true, get: function () { return linkify_1.isSafeHref; } });
+// Theme + RTL
+var dir_1 = require("./theme/dir");
+Object.defineProperty(exports, "dirStyles", { enumerable: true, get: function () { return dir_1.dirStyles; } });
+var themeFactory_1 = require("./theme/themeFactory");
+Object.defineProperty(exports, "resolveVariant", { enumerable: true, get: function () { return themeFactory_1.resolveVariant; } });
+Object.defineProperty(exports, "buildTheme", { enumerable: true, get: function () { return themeFactory_1.buildTheme; } });
+// Shared types
+__exportStar(require("./core/types"), exports);
+// Config fetch + merge (S5/S8): server view + prop>server>default precedence
+var configClient_1 = require("./core/configClient");
+Object.defineProperty(exports, "fetchConfig", { enumerable: true, get: function () { return configClient_1.fetchConfig; } });
+Object.defineProperty(exports, "mergeConfig", { enumerable: true, get: function () { return configClient_1.mergeConfig; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return configClient_1.DEFAULT_CONFIG; } });
+// Dev-gated logger (C18): no-ops in release, never logs session_id/content
+var logger_1 = require("./core/logger");
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+// Media (Phase 2): policy/limit helpers — pure, no I/O
+var media_1 = require("./core/media");
+Object.defineProperty(exports, "validateSelection", { enumerable: true, get: function () { return media_1.validateSelection; } });
+Object.defineProperty(exports, "acceptedMimeTypes", { enumerable: true, get: function () { return media_1.acceptedMimeTypes; } });
+Object.defineProperty(exports, "stripBase64OnAck", { enumerable: true, get: function () { return media_1.stripBase64OnAck; } });
+Object.defineProperty(exports, "DEFAULT_LIMITS", { enumerable: true, get: function () { return media_1.DEFAULT_LIMITS; } });
+// Adapters (Phase 2): injectable picker + audio capabilities (real impls live in the example
+// apps; tests inject fakes — the core never calls a native module directly)
+var picker_1 = require("./adapters/picker");
+Object.defineProperty(exports, "toDataUrl", { enumerable: true, get: function () { return picker_1.toDataUrl; } });
+Object.defineProperty(exports, "toMediaEntry", { enumerable: true, get: function () { return picker_1.toMediaEntry; } });
+var audio_1 = require("./adapters/audio");
+Object.defineProperty(exports, "CANONICAL_AUDIO_MIME", { enumerable: true, get: function () { return audio_1.CANONICAL_AUDIO_MIME; } });
+Object.defineProperty(exports, "NoopAudioAdapter", { enumerable: true, get: function () { return audio_1.NoopAudioAdapter; } });
+// Batteries-included default adapters: auto-wired inside <WebChat> from installed
+// Expo peers (expo-image-picker / expo-document-picker / expo-file-system / expo-audio),
+// each returning undefined when its OPTIONAL peer is absent (graceful degradation).
+// Exported so a host can compose its own surface or override selectively.
+var expoDefaults_1 = require("./adapters/expoDefaults");
+Object.defineProperty(exports, "createExpoPicker", { enumerable: true, get: function () { return expoDefaults_1.createExpoPicker; } });
+Object.defineProperty(exports, "createExpoAudioAdapter", { enumerable: true, get: function () { return expoDefaults_1.createExpoAudioAdapter; } });
+Object.defineProperty(exports, "createExpoReadBase64", { enumerable: true, get: function () { return expoDefaults_1.createExpoReadBase64; } });
+// Public component
+var WebChat_1 = require("./ui/WebChat");
+Object.defineProperty(exports, "WebChat", { enumerable: true, get: function () { return WebChat_1.WebChat; } });
+// Media UI (Phase 2): exported for hosts that compose their own surface
+var ImageBubble_1 = require("./ui/ImageBubble");
+Object.defineProperty(exports, "ImageBubble", { enumerable: true, get: function () { return ImageBubble_1.ImageBubble; } });
+var FileTile_1 = require("./ui/FileTile");
+Object.defineProperty(exports, "FileTile", { enumerable: true, get: function () { return FileTile_1.FileTile; } });
+var AttachButton_1 = require("./ui/AttachButton");
+Object.defineProperty(exports, "AttachButton", { enumerable: true, get: function () { return AttachButton_1.AttachButton; } });
+// Media-upload selector: the controlled bottom-sheet menu the composer opens
+// from the attach button (image / document / record-audio rows).
+var MediaUploadMenu_1 = require("./ui/MediaUploadMenu");
+Object.defineProperty(exports, "MediaUploadMenu", { enumerable: true, get: function () { return MediaUploadMenu_1.MediaUploadMenu; } });
+// Themeable Material-style icon set (SVG with a Text-glyph fallback when the
+// optional react-native-svg peer is absent).
+var Icon_1 = require("./ui/Icon");
+Object.defineProperty(exports, "Icon", { enumerable: true, get: function () { return Icon_1.Icon; } });
+var AudioRecorder_1 = require("./ui/AudioRecorder");
+Object.defineProperty(exports, "AudioRecorder", { enumerable: true, get: function () { return AudioRecorder_1.AudioRecorder; } });
+var VoiceMessage_1 = require("./ui/VoiceMessage");
+Object.defineProperty(exports, "VoiceMessage", { enumerable: true, get: function () { return VoiceMessage_1.VoiceMessage; } });
+// Chrome features (Tier B-3a): typing indicator + powered-by badge.
+var TypingIndicator_1 = require("./ui/TypingIndicator");
+Object.defineProperty(exports, "TypingIndicator", { enumerable: true, get: function () { return TypingIndicator_1.TypingIndicator; } });
+var PoweredBy_1 = require("./ui/PoweredBy");
+Object.defineProperty(exports, "PoweredBy", { enumerable: true, get: function () { return PoweredBy_1.PoweredBy; } });
+// --- Phase 3: video calls (WebRTC) -----------------------------------------
+// Signaling core (answerer-only state machine) + its injectable seams. The WebRTC
+// factory is the only native seam; tests/chat-only consumers never load it.
+var VideoCallClient_1 = require("./core/VideoCallClient");
+Object.defineProperty(exports, "createVideoCallClient", { enumerable: true, get: function () { return VideoCallClient_1.createVideoCallClient; } });
+// Static ICE / pc_config helpers (web parity, B12) + the host-candidate filter (C7).
+var ice_1 = require("./core/ice");
+Object.defineProperty(exports, "iceServers", { enumerable: true, get: function () { return ice_1.iceServers; } });
+Object.defineProperty(exports, "isForwardableCandidate", { enumerable: true, get: function () { return ice_1.isForwardableCandidate; } });
+Object.defineProperty(exports, "TURN_URL", { enumerable: true, get: function () { return ice_1.TURN_URL; } });
+Object.defineProperty(exports, "TURN_USERNAME", { enumerable: true, get: function () { return ice_1.TURN_USERNAME; } });
+Object.defineProperty(exports, "TURN_CREDENTIAL", { enumerable: true, get: function () { return ice_1.TURN_CREDENTIAL; } });
+Object.defineProperty(exports, "STUN_URL", { enumerable: true, get: function () { return ice_1.STUN_URL; } });
+// Real native adapters (lazy-require native bindings inside; importing the type is free)
+// + the teardown helper that fully releases the camera/mic (C10).
+var webrtc_1 = require("./adapters/webrtc");
+Object.defineProperty(exports, "reactNativeWebRTCFactory", { enumerable: true, get: function () { return webrtc_1.reactNativeWebRTCFactory; } });
+Object.defineProperty(exports, "teardownPeerConnection", { enumerable: true, get: function () { return webrtc_1.teardownPeerConnection; } });
+var audioRoute_1 = require("./adapters/audioRoute");
+Object.defineProperty(exports, "AudioRoute", { enumerable: true, get: function () { return audioRoute_1.AudioRoute; } });
+Object.defineProperty(exports, "reactNativeAudioRoute", { enumerable: true, get: function () { return audioRoute_1.reactNativeAudioRoute; } });
+// Call UI: full in-call screen + the control bar + a single video tile (compose your own).
+var VideoCall_1 = require("./ui/VideoCall");
+Object.defineProperty(exports, "VideoCall", { enumerable: true, get: function () { return VideoCall_1.VideoCall; } });
+var CallControls_1 = require("./ui/CallControls");
+Object.defineProperty(exports, "CallControls", { enumerable: true, get: function () { return CallControls_1.CallControls; } });
+var VideoTile_1 = require("./ui/VideoTile");
+Object.defineProperty(exports, "VideoTile", { enumerable: true, get: function () { return VideoTile_1.VideoTile; } });
+// Expo config-plugin (Phase 2 / Task 7): permission injection for media + mic.
+// Hosts add it to app.json/app.config: `"plugins": ["@experiaapp/webchat-react-native"]`
+// (resolves to `app.plugin.js` at the package root). Not re-exported here because the
+// plugin module is consumed by the Expo CLI, not imported into app code.