@robono/messaging-react-native 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 0.3.0 — 2026-11-03
+
+Add the complete ExpoMessenger setup and supplied inbox search, contact/shared-media, group owner, replies and pinned-message screens. Reuse Messenger popup boundaries and composer. Add opt-in native Apple/Google notification registration with account-safe logout, and expiring local received history. Notification credentials remain on the customer server.
+
+Requires matching service migrations 181–186 and coordinated package publication. Physical-device notification delivery is a separate acceptance check.
+
+
+Correct navigation scope: Saved is in the account-level Messages menu, not the contact menu. Search this chat uses an inline bar with previous/next matches. The native inbox has separate chat-list search and retains media adapters when opening Saved.
+
+Refine popup interiors with grouped Saved/Search rows, aligned translation controls, consistent form fields, a subtle header divider, and a readable content width on desktop. Preserve the approved app-height black frame and existing translation behavior.
+
+Use one Messenger popup frame and title/X row across search, contact options, Saved, forwarding, polls, confirmations, weather, tracking and social previews. Use the same app-height, black frame, raised title/X, and narrow 0/8/4/8 inner spacing as tracking/social, including forms and confirmations. Keep the frame inside phone safe areas. Keep inbox actions and delete confirmation in the same modal.
+
+Move Saved from a standalone header bookmark into its own three-dot menu entry, matching Messenger’s Saved navigation. Dismiss the options modal before opening Saved on iOS.
+
+When Privacy Lens is enabled, place messages above the clear reading strip. Keep short chats scrollable into the strip and leave new arrivals above it until the user scrolls.
+
+Tighten Yes/No bubbles to content width, with an inline poll icon and compact answer row. Give polls an outlined neutral card and remove inline timestamps; time remains in the swipe details.
+
+Show Messenger’s condition-specific weather artwork for current, hourly and daily forecasts, using compact inline icons.
+
+Expand weather to the same safe-area popup as tracking and social, with the raised header and dark backdrop. Let forecast content scroll within the available space.
+
+Circle the centered latest-message arrow. Fade it out during scrolling and restore it after a 600ms pause when still away from the latest message.
+
+Preserve independently consented address shares while moving between chats or the inbox. Stop only the selected share when End tracking is pressed; app background/logout still stop capture.
+
+Place social-share Preview buttons beside the bubble and omit inline timestamps. Use the expanded safe-area popup, dark backdrop and raised header shared with tracking; let the social player fill available space.
+
+Keep the sharing button and single avatar row within the measured address-bubble height.
+
+Enlarge tracking names, speed/distance and ETA details. Pass the selected units and current time to map adapters so participant callouts stay synchronized.
+
+Keep the expanded tracking popup within native safe areas. Size the map from the remaining popup space, with compact controls and a bounded scrolling participant list.
+
+Expand live tracking to an inset app-sized popup. Add 48-point circular participant avatar buttons below the sharing control; tapping an avatar opens the map with that person selected.
+
+Open live tracking from the full address-bubble body while keeping the address link and sharing button separate. Darken the shared popup backdrop to 85% black.
+
+Keep city, state and ZIP in address links when the street is not followed by a comma. Reduce address-bubble vertical padding.
+
+Tighten address bubbles: place a compact outlined “Allow tracking” button with a location icon beside the bubble toward the center of the chat, omit the empty participant row, and show the time only in the swipe information reveal.
+
+Place enabled Camera capture inside Attach beside the photo/video library options, matching Messenger. Keep it available when library browsing is hidden, and stage captured media before Send.
+
+Fix photo pinch-to-zoom and panning: Messenger’s 1–5× range, actual image bounds, smooth transitions when fingers join/leave, and no accidental toolbar toggle after a gesture. Support browser touch and trackpad pinch.
+
+Match Messenger’s information/quote swipe travel and return timing; reveal sent/read information behind ordinary bubbles. Remove photo/video timestamp overlays and redundant sent/read checkmarks.
+
+Select multiple photos, videos or files in one picker visit, preserving order, draft thumbnails, the remaining ten-file limit, and local-until-Send behavior. Keep editing/call replies single-file. Preserve pending attachments when a host recreates its preview callback while typing. Use Messenger’s full reaction catalogue.
+
+## 0.2.0
+
+Use the compact Messenger media toolbar, autoplay video after audio setup, and offer native full-screen playback. Dismiss iOS menus before presenting Saved media, Forward/Delete/Report or Search; keep native pickers free of a competing modal. Reserve the actual timestamp width so edited messages do not overlap it.
+
+Add shared Edit/Delete actions, draft-preserving composer editing, delete confirmation and search/quote navigation. Media adapters report opening/playback independently of bubble visibility. Media replacement/removal, authorized forwarding, persistent Saved copies and native outgoing draft recovery are implemented. Physical iPhone checks cover selected flows; physical Android acceptance remains outstanding.
+
+Add text/voice translation to text or voice, shared translation popup, browser/Expo spoken playback and expiring-result cleanup. Add optional viewer downloads (off by default): device photo library, iPhone Save to Files sheet and bounded Android folder export. Streamed video exports an authorized local copy without replacing playback. Requires expo-file-system >=55.0.5. iPhone checks cover playback, Saved files, restart recovery and popup transitions. Android device acceptance and physical export-sheet checks remain pending.
+
+Add `MessagingInbox`, the shared search popup and optional expiring typing/online labels in the existing header. Clear private unread counts independently of public read receipts. Closed polls disable their controls on both native and web renderers. Requires the matching 0.2.0 core release; iPhone fixture acceptance is recorded separately from Android acceptance.
+
+Render unfinished sends as ordinary chat bubbles with compact status icons and in-place retry. Keep the composer available during attachment sends. Stage browser and Expo attachments locally until Send; add native thumbnails and preview without consuming the draft.
+
+Use the server-provided total member count for large groups instead of counting a partial member page.
+
 ## 0.1.0
 
 Optional messaging screens and media controls, attachment composer, recording, playback, quoting, reactions, polls, translation, transcription, block and report flows. Expo adapters and optional calling integration.

package/README.md

@@ -1,6 +1,43 @@
 # Optional Robono messaging screens
 
-Use a ready-made direct or group conversation screen, replace its sections, or compose the exported components into your own layout. This package is optional and adds no navigation, global audio configuration or push handlers to your app. The shared icon controls require `react-native-svg` (install it with your framework’s native dependency installer).
+Use a ready-made direct or group conversation screen, replace its sections, or compose the exported components into your own layout. Use `ExpoMessenger` for the complete inbox and conversation flow, or the individual components inside your existing navigation. Notification registration is explicit; nothing requests permission on mount. The shared icon controls require `react-native-svg` (install it with your framework’s native dependency installer).
+
+## Recommended installation
+
+Connect `createRobonoMessengerServer` from `@robono/server` at one authenticated
+HTTPS route. It supplies managed private attachments. Create one connection per
+signed-in account, outside repeated renders:
+
+```tsx
+import {createExpoMessenger, ExpoMessenger} from '@robono/messaging-react-native/expo';
+const messenger = createExpoMessenger({
+  endpoint: 'https://your-app.example/api/robono',
+  userId: session.userId,
+  getAccessToken: () => session.accessToken(),
+  isCallActive: () => calls.isActive(),
+});
+<ExpoMessenger {...messenger} userId={session.userId}
+  companyName="Your company" contacts={contacts} />
+// On logout, before destroying the user's session:
+try { await messenger.signOut(); } finally { await session.signOut(); }
+```
+
+Install the native dependencies below and rebuild both platforms. For alerts
+outside the app, use the explicit `./expo-notifications` connector and follow
+`@robono/server/NOTIFICATIONS.md`: iPhone needs **your** Apple Team ID, APNs Key ID,
+private .p8 key and Bundle ID; Android needs **your** Firebase project, app
+configuration and a server-only service account. Never ship private keys in the
+app. Website chat itself does not require these mobile credentials.
+
+The supplied group owner, shared-media, reply and pinned-message screens use the
+same popup boundaries as Messenger. Global search and group controls require the
+matching server and service migrations. Imported groups need a server-assigned
+owner before users can edit them. Optional offline received history is disabled
+by default; its network-selected expiry is honored and it is read-only offline.
+Revocation while disconnected is not known until reconnection or expiry. Logout
+clears the local account's history. `persistence:false` disables these local stores.
+
+## Individual screen inside existing navigation
 
 ```tsx
 import {MessagingScreen} from '@robono/messaging-react-native';
@@ -27,7 +64,7 @@ Text uses a send icon; `appearance.labels.send` remains its accessible label. Vo
 
 Supply `attachmentPreview(message)` to resolve `{uri?, waveform?}` after checking the current user's media access. `uri` is an image thumbnail (a poster frame for video); `waveform` contains 32 normalized amplitude values between 0 and 1. These stay in component state, not in the message payload. Without metadata the SDK shows a neutral media tile or waveform track. `openAttachment` remains responsible for authorized media access. The Expo screen supplies inline voice playback and the shared full-screen media viewer. To connect a different audio engine, supply `components.VoiceMessage` and render the exported `VoicePlayback` with its playback state and callbacks. `MediaViewer`, `ZoomablePhoto` and `MediaPlaybackControls` are also exported for hosts with their own media engines.
 
-Photos, videos and files share an Attach menu. Set `appearance.showCamera` to offer Camera alongside them; photo messaging must also be enabled. The option defaults off for existing integrations. Camera calls `pickAttachment('image', {...limits, source: 'camera'})`, so captures follow the same photo restrictions and review/upload process. Hosts supplying their own media callback must handle that source explicitly. The Expo adapter requests camera permission only on selection and opens the device camera on iOS and Android. Configure the `expo-image-picker` plugin's `cameraPermission` explanation in your native build. Cancelling or refusing permission sends nothing.
+Photos, videos and files share an Attach menu. Set `appearance.showCamera` to offer Camera inside that menu beside the library options; photo or video messaging must also be enabled. The option defaults off for existing integrations. Camera calls `pickAttachment('image', {...limits, source: 'camera'})`, so captures follow the same photo restrictions and review/upload process. Hosts supplying their own media callback must handle that source explicitly. The Expo adapter requests camera permission only on selection and opens the device camera on iOS and Android. Configure the `expo-image-picker` plugin's `cameraPermission` explanation in your native build. Cancelling or refusing permission sends nothing.
 
 ## Reuse or replace components
 
@@ -54,9 +91,15 @@ This entry targets Expo SDK 55–56; the core components do not require Expo. Co
 ```tsx
 import {
   ExpoMessagingScreen, createExpoMessagingStorage,
-  createExpoMessagingAudioSession,
+  createExpoMessagingAudioSession, createExpoMessagingClient,
 } from '@robono/messaging-react-native/expo';
 
+const messagingClient = createExpoMessagingClient({
+  url: appConfig.messagingEndpoint,
+  userId: session.userId,
+  getAccessToken: () => sessions.accessToken(),
+});
+
 const storage = createExpoMessagingStorage({
   url: appConfig.messagingMediaEndpoint,
   getAccessToken: () => sessions.accessToken(),
@@ -136,13 +179,13 @@ The website preview renders the same bubbles, inline voice controls, full-screen
 
 The standard chat uses compact grouped bubbles, timestamps at the lower right, inline voice controls and an expandable attachment tray below the composer. Attach dismisses the keyboard; tap it again to return to typing. Android Back closes the tray first. The microphone remains available beside the text field, including while text is typed; Send is enabled when there is text or a finished voice recording. Camera remains available when capture is enabled, including with typed text or a reviewed voice recording. Captures join the existing pending attachments. New designs start with a light chat palette; existing saved colors remain unchanged. The builder’s “Use classic chat colors” action applies the default palette to the draft without changing enabled features.
 
-Voice-only conversations use Robono Messenger’s compact composer: the duration-limit placeholder, embedded microphone and adjacent Send control. The Expo adapter records and reviews audio inline, with elapsed time, microphone metering, playback and removal before sending. The builder uses the same controls with a local browser microphone recording; no audio is uploaded from the preview. When texting is enabled, tap the microphone to record in the composer and tap it again to stop. Each completed recording becomes a separate playable attachment in the shared horizontal row, and the microphone is available for another recording. Typed text is preserved; Send submits the voice message and any accompanying text as separate messages. Custom media adapters can use `components.VoiceComposer`, `VoiceMessageComposer` and `VoiceDraftPlayback`; `renderTextComposer` restores the text controls alongside the reviewed recording.
+Voice-only conversations use Robono Messenger’s compact composer: the duration-limit placeholder, embedded microphone and adjacent Send control. The Expo adapter records and reviews audio inline, with elapsed time, microphone metering, playback and removal before sending. The builder uses the same controls with a local browser microphone recording; no audio is uploaded from the preview. When texting is enabled, tap the microphone to record in the composer and tap it again to stop. Each completed recording becomes a separate playable attachment in the shared horizontal row, and the microphone is available for another recording. Typed text is preserved; Send puts accompanying text on the last attachment as its caption. Custom media adapters can use `components.VoiceComposer`, `VoiceMessageComposer` and `VoiceDraftPlayback`; `renderTextComposer` restores the text controls alongside the reviewed recording.
 
-Recent attachments can appear directly beneath the attachment buttons. Photos, Videos and Document filter this strip; tapping the selected category again shows all enabled types. Tapping a thumbnail adds it above the composer as a pending attachment; its magnifying-glass button opens a preview instead. Remove unwanted attachments or press Send to submit the selection with any typed text. Camera starts capture. When no recent-media source is supplied, the category buttons open the device picker. Supply `attachmentChoices` with an ID, kind, name, and optional thumbnail URI/duration. Only enabled attachment types appear. With `MessagingScreen`, selecting a tile calls `pickAttachment` with `options.attachmentId`; use `options.intent` to distinguish selection (`send`, retained for adapter compatibility) from preview. Returning photo, video or document media stages it in the composer; returning null cancels without selecting it. Voice recordings also become pending attachments after recording stops. With `ExpoMessagingScreen`, supply `resolveAttachmentChoice(id, signal)` to return an authorized cache copy; the standard preview, validation, send and cleanup flow handles the rest. Keep originals in the user's library untouched. The host controls library access and which recent items it supplies.
+Recent attachments can appear directly beneath the attachment buttons. Photos, Videos and Files filter this strip; tapping the selected category again shows all enabled types. Tapping a thumbnail adds it above the composer as a pending attachment; its magnifying-glass button opens a preview instead. Remove unwanted attachments or press Send to submit the selection with any typed text. Camera starts capture. When no recent-media source is supplied, the category buttons open the device picker. Supply `attachmentChoices` with an ID, kind, name, and optional thumbnail URI/duration. Only enabled attachment types appear. With `MessagingScreen`, selecting a tile calls `pickAttachment` with `options.attachmentId`; use `options.intent` to distinguish selection (`send`, retained for adapter compatibility) from preview. Returning photo, video or document media stages it in the composer; returning null cancels without selecting it. Voice recordings also become pending attachments after recording stops. With `ExpoMessagingScreen`, supply `resolveAttachmentChoice(id, signal)` to return an authorized cache copy; the standard preview, validation, send and cleanup flow handles the rest. Keep originals in the user's library untouched. The host controls library access and which recent items it supplies.
 
 Camera capture and library selection are separate controls. `appearance.showPhotoLibrary` and `showVideoLibrary` hide library choices without removing the corresponding message-type permission needed for camera captures. Both default to true for existing integrations. The builder manages these together with Camera, so enabling capture does not select Photos/Videos or insert example media. Parent and network message-type permissions remain enforced.
 
-The Expo adapter prepares voice assets in private storage when recording stops, retaining local playback copies until removal, submission or disposal. This does not send a chat message. Send submits all selected attachments in order, followed by any typed text. Custom adapters can supply components.VoiceAttachment for draft playback and releaseAttachment for local cleanup.
+The Expo adapter keeps selected and recorded attachments locally until Send. Recording stops into a playable draft without uploading. Send immediately queues the bubbles, then uploads the selected files. A caption belongs to the final attachment; a quote belongs to the first. The batch preserves selection order when uploads finish out of order. Custom adapters can supply components.VoiceAttachment for draft playback and releaseAttachment for local cleanup.
 
 
 ## Group conversations, reactions and polls
@@ -159,8 +202,117 @@ Use `ExpoMessagingCallingScreen` from `@robono/messaging-react-native/expo-calli
 
 ### Blocking, reporting, reactions and language tools
 
-The default header’s three-dot menu provides Block/Unblock and Report when the authenticated backend advertises safety support. Hold a received bubble to report that message. `onContactOptions` optionally replaces the supplied contact menu with your existing safety flow. The exported `MessagingSafety` component can also be composed into your screen.
+The conversation header’s three-dot menu includes Search this chat, plus Block/Unblock and Report when the authenticated backend advertises safety support. Saved belongs to the account and is in the separate Messages menu, never under a contact’s name. Hold a received bubble to report that message. `onContactOptions` optionally replaces the supplied contact menu with your existing safety flow. The exported `MessagingSafety` component can also be composed into your screen.
 
 Blocking retains history and stops direct messages and calls for that pair in your app. Shared group messages remain visible. Reporting is separate: it shares the selected message, or up to five recent incoming messages, and the reason with your app’s moderators. It confirms success only after storage acknowledges the report. The SDK reuses the request ID on retry. Owners and administrators review reports in the Messaging workspace; private media is reviewed through your app’s authorized storage tools.
 
-Enable Reactions to show an emoji ribbon beside the long-pressed bubble, or the hover smile icon on desktop. Selected reactions stay attached below the message. Polls are interactive chat messages created from the attachment menu. Transcript and Translate toggle small text immediately under the original; the original timestamp stays with the source message.
+Enable Reactions to show an emoji ribbon beside the long-pressed bubble, or the hover smile icon on desktop. Selected reactions stay attached below the message. Polls are interactive chat messages created from the attachment menu. Transcript is a separate voice-message action. In the header's three-dot menu, choose translation **Off / Text / Voice** and languages once for the conversation. The saved choice controls Translate or Play Translation on eligible incoming messages; own messages and matching sender/target languages do not show it. The result has Show original / Show translation controls. Expo supplies translated-voice playback and its audio session; an explicit Play Translation action starts playback when ready. `language` supplies the initial target and `contact.language` / `participants[id].language` supply known sender languages, with a saved conversation incoming-language fallback. Defaults to Off. The Expo private outbox retains preferences across restarts on this device. Custom contact menus can call `client.setTranslationPreference({mode:'text',language:'es',sourceLanguage:'en'})`. Connect `MessagingClient.transformRequest` to the authenticated `createMessagingTransformBackendAdapter` on your server.
+
+### November 1 behavior update (unpublished)
+
+The default palette follows Messenger. Existing saved customer colors remain in
+place. Direct chats use the brand header; groups use Messenger’s blue header.
+Bubble padding is fixed; the legacy `compact` property is accepted for backwards
+compatibility but no longer changes core spacing.
+
+Photo/video/file selections remain removable drafts; tapping a draft opens its
+viewer without deleting the selection. Expo supplies small image/video previews
+using `expo-image-manipulator` and `expo-video-thumbnails`; add those optional peers
+when using the Expo entry. Copy uses `expo-clipboard`. Native media downloads use
+photo-library permission; sharing uses the platform share sheet. New managed photo/video uploads have an authenticated preview (at most 480 pixels and 128 KiB) after the updated storage worker, inspector, media handler and migration 178 are deployed. Previews count toward normal storage/transfer usage. Older large uploads without a preview remain tap-to-open; originals over 2 MiB are never automatically downloaded to build thumbnails.
+
+`appearance.showWaveform` controls display only. Verified waveform samples stay
+in `media.waveform`. The playback track remains seekable when the waveform is
+hidden. Managed storage computes waveform data independently of this preference.
+
+Groups offer polls; direct chats offer a recipient-only Yes/No question whose
+first answer is final. Both use the same app-height popup frame as tracking and social previews. Deploy migration
+`20261101017400_messaging_captions_questions.sql` and the updated messaging handler
+before releasing these SDK changes. Deploy the updated media inspector before the
+updated managed-media handler. These source changes have not been published.
+
+### Optional downloads in the viewer
+
+Select **Download button** in the website's **Features & preview → Appearance**, or
+set `appearance.showDownloadButton: true`. The Expo viewer shows the same Download
+action for photos, videos and files; it stays hidden by default. Photos and videos
+save to the device photo library after the user grants permission. On iPhone,
+documents open the native sheet with Save to Files. On Android, the user chooses a
+folder and the document is copied there in bounded chunks. Cancelling creates no
+file, and a failed copy removes its own partial output. Use `expo-file-system`
+55.0.5 or later for Android document saving. Originals remain in private storage.
+This setting controls the visible action, not the authorization needed to view media.
+
+`createExpoMessagingClient` keeps outgoing text, selected attachments and failed
+sends in your app's private document storage, separated by endpoint and user.
+`ExpoMessagingScreen` restores small previews and reuses the original upload/send
+identity when retrying. Call `client.signOut()` on logout to remove that user's
+saved work. `dispose()` preserves unfinished work for reopening. Use
+`persistence: false` to disable storage. No received history or download links are
+persisted by this store. The OS app sandbox protects these files; this is not an
+additional application encryption layer.
+
+The shared message menu and media preview include Forward and sender Delete.
+Forward checks both chats and uploads a separate private attachment copy; retrying
+uses the same send ID. Edits can replace/remove attachments before a recipient
+opens them. Removing the only attachment requires text. Caption edits keep the
+original file. The ordinary composer draft is retained throughout editing.
+
+`MessagingInbox` offers Mute/Unmute and Delete chat on long press (right-click on
+web), plus accessibility actions. Deletion clears only that user's view, up to the
+message shown when confirmation opened. New messages bring the chat back. When
+composing your own native navigation, pass
+`onDeleted={id => messagingClient.forgetConversation(id)}` to clear its local work.
+Updated backend support is required; old adapters hide these controls.
+
+### Saved and multiple-message actions
+
+Long press a message, then choose Select to select more rows. The compact action bar supports chronological forwarding and deletion of eligible unread outgoing messages. A single selection also supports Copy, Save and Edit. Back clears the selection.
+
+`createExpoMessagingClient` also supplies Saved: explicit local text and attachment copies in the app-private directory, separated by endpoint, account and namespace. The account-level Messages menu opens Saved from all conversations. Standalone chats have no account toolbar; place account navigation on the host inbox. For inbox navigation, keep one `MessagingProvider` mounted around `MessagingConversation` / `MessagingInbox` and pass `headerActions={<MessagingAccountMenu/>}` to the inbox; the Expo `renderConversation` callback supplies the same media adapters to that provider. Saving rechecks message access before and after making the copy, and marks incoming content consumed. Saved copies are independent of network retention; they never reuse signed URLs. `client.signOut()` deletes this account’s saved copies. Disabling persistence also disables Saved. Device storage is not a cloud backup or an additional app encryption layer. For a custom engine, supply a `MessagingSavedStore` to `MessagingClient` and `openSavedAttachment` to the shared screen.
+
+### Social previews
+
+Install `react-native-webview` with the Expo peer dependencies and rebuild the native app. `ExpoMessagingScreen` supplies the player and the standard shared popup; a custom engine can supply `components.SocialPlayer`. The updated server adapter and hosted messaging endpoint advertise support. Recognized links gain a small play action, while tapping the link still opens the original app/site. Players are loaded only after an explicit tap and fresh message authorization, require explicit playback, and are removed on close/background/navigation. Opening a player stops the current voice-message player and uses the supplied audio-session coordinator. No application cookies or local-file access are shared with the embedded page. Some providers/private posts cannot be embedded; the popup keeps an Open-original link.
+
+The same provider parser is used by Messenger, the browser and the backend, including Snapchat and Rumble. Preview opens contribute to the per-network `social.opened` metric. This source change still requires coordinated endpoint and package deployment; installing a newer UI against an older adapter does not enable unsupported controls.
+
+
+### Multiple selections from one picker
+
+The supplied Expo and browser pickers allow selecting several photos, videos, or
+files in one visit, up to ten total pending attachments. Selection stays local:
+each item has a removable thumbnail, preview is a separate tap, and upload begins
+only after Send. Order is preserved, the quote belongs to the first attachment,
+and the caption belongs to the last. Editing and call replies select one item.
+
+A custom `pickAttachment(kind, options)` may return one `MessageMedia`, an ordered
+`MessageMedia[]`, or `null`. Honor `options.maxCount` (the remaining slots) and the
+existing size/type/duration limits. Existing single-file adapters still work.
+The low-level `MessagingMediaDevice.pickMany` method is optional;
+`MessagingMediaController.pickMany` falls back to the single picker when absent.
+Cancellation or an invalid selection releases all private copies without sending
+or accepting a partial batch. Never delete the user's library originals.
+
+Conversation search stays inline below the chat header with a match count and previous/next controls. Its authenticated search remains scoped to the open conversation. `MessagingInbox` provides a separate Search chats field over loaded chat titles and last-message text; optional `searchText(row)` adds the host's local retained-message index (used in the native review). It does not imply a server-wide search across unloaded conversations.
+
+### Company, account and call controls
+
+`companyName` is the customer’s company name, not Robono’s. It labels the inbox
+only; when omitted, the configured appearance name is used. Conversation screens
+show only the friend/group header, never the company heading or account menu.
+The main three-dot dropdown contains Account and Saved. Supply `account` with
+`name`, optional `avatarUrl`, `phone`, and `email`. `onEditProfile` and `onSignOut`
+are optional host actions; unsupported actions are hidden. Sign-out must revoke
+your app session and call the messaging client’s `signOut()` to clear local data.
+The Account screen dismisses before opening the host’s profile/sign-out flow.
+
+Direct conversations keep the customer’s accent header. Groups use Messenger’s
+blue `#1F5F7A` header with light text and icons. Phone/video icons use the same ink.
+Supply `callActions.voice`/`video` only while the contact/group is eligible for
+those calls. `callActions.phoneNumber` supplies a direct contact’s callable number,
+and `callActions.phone(number)` can override opening the system `tel:` handler.
+The phone button opens Messenger’s method choices when a number exists; otherwise
+it starts the available internet call directly. Groups never show a carrier choice.
+`MessagingCallingScreen` and `ExpoMessagingCallingScreen` still accept existing
+`onCall`/`onVideoCall` callbacks and use these same controls.