@robono/messaging-react-native 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
+## 0.12.0 — unpublished candidate
+
+Keep Android recording alive through microphone permission dialogs; process two bounded thumbnails concurrently with permission-safe reuse. Add authenticated host downloads and host-controlled links/addresses. Keep Expo 55 audio handling compatible. Add self-chat and consumer integration hooks, stable forwarded-message delivery states and group-invitation eligibility.
+
 ## 0.10.0 — release candidate
 
+## 0.11.1
+
+- Automatically install the shared calling UI package used by the account device-check panel, including chat-only installations. Native camera/calling dependencies remain optional.
+
 ## 0.11.0
 
 Connects the supplied Messenger to recording/caption controls, on-device background blur and account device checks, using its existing call integration.

package/README.md

@@ -168,7 +168,21 @@ Install native dependencies with your Expo project's installer so their versions
 npx expo install expo-audio expo-image-picker expo-document-picker expo-file-system expo-sharing expo-video expo-crypto react-native-safe-area-context react-native-svg
 ```
 
-This entry targets Expo SDK 55–56; the core components do not require Expo. Configure the `expo-audio` plugin's `microphonePermission` with your app's explanation (for example, “Allow microphone access to record voice messages”). Keep background recording disabled. Native dependency or permission changes need a new development/store build; screen changes do not. The standard system photo picker does not require full photo-library access. Documents use the platform's file picker, without broad storage access.
+This entry targets Expo SDK 55–56; the core components do not require Expo.
+
+| Project | Supplied integration |
+| --- | --- |
+| Expo 55 or 56 | Use the `/expo` entry and `npx expo install` for matching native packages. |
+| Expo 54 or earlier | The supplied Expo adapter is not supported. Upgrade Expo before running setup; do not force incompatible peer dependencies. |
+| React Native without Expo | Use the core UI and documented device/storage adapters. The Expo version range does not apply to these components. |
+
+The installer checks the Expo version before changing files. Pin the Robono version
+in your lockfile and update through the setup command so required native changes
+are reported. Optional calling and background movement require a rebuilt native
+app; Expo Go does not include those modules. A successful package installation is
+not a guarantee that unsupported Expo versions will work.
+
+ Configure the `expo-audio` plugin's `microphonePermission` with your app's explanation (for example, “Allow microphone access to record voice messages”). Keep background recording disabled. Native dependency or permission changes need a new development/store build; screen changes do not. The standard system photo picker does not require full photo-library access. Documents use the platform's file picker, without broad storage access.
 
 ```tsx
 import {
@@ -257,7 +271,7 @@ import { MessagingCallingScreen } from '@robono/messaging-react-native/calling';
 />
 ```
 
-The `/calling` entry additionally needs the optional `@robono/calling-react-native` peer. Mount the calling overlay and configure native audio/notifications through the existing calling integration. This entry creates no call client and requests no permission. Omit `onCall` to hide the action; backend admission remains authoritative. `MessagingHeader` also accepts children for custom header actions.
+The shared `@robono/calling-react-native` UI package is installed automatically, including for the account device-check panel. Native call media and notification adapters remain optional. Mount the calling overlay and configure native audio/notifications through the existing calling integration. This entry creates no call client and requests no permission. Omit `onCall` to hide the action; backend admission remains authoritative. `MessagingHeader` also accepts children for custom header actions.
 
 The website preview renders the same bubbles, inline voice controls, full-screen photo/file viewer and video transport controls through React Native Web. Phone/tablet and portrait/landscape choices resize the real layout viewport without reloading the conversation. Browser media elements and Expo players drive the shared controls; the browser preview does not substitute native browser player controls or a generic dialog. Camera/library/file selection and OS permission prompts still follow the platform. Preview interactions never contact real users or send billable events.
 
@@ -419,8 +433,9 @@ sender. Times are stored in UTC and displayed in the device's current time zone.
 Scheduling uploads selected attachments before confirming the queue; closing the
 app does not prevent server delivery afterward. The selected time is approximate
 to the minute. Current access, screening and spending rules still apply at send
-time. In-app voice recording and poll creation retain their existing immediate-send
-flows; custom composers can schedule their finalized content through the same API.
+time. Stop a voice recording to stage it, then hold Send to schedule it just like
+a photo, video or file. Poll creation sends immediately; custom composers can
+schedule finalized content through the same API.
 
 ### Screen sharing in the complete messenger
 
@@ -457,3 +472,22 @@ Robono hosts optional call recording and transcription. Enable recording once in
 The supplied adapters also offer camera/microphone/speaker checks and camera background blur. Screen sharing is separate. Phone blur requires rebuilding the native app; browser blur downloads its model only when selected and needs the documented content-security policy. Background processing stays on the device.
 
 See the [recording and call tools guide](https://robono.com/guides/call-recording.html) for prices, retention, short-lived downloads, deletion, platform requirements and label customization. Captions arrive in short batches with several seconds of delay and can be inaccurate; incomplete transcripts are marked.
+
+### Customer-controlled links, downloads and account actions
+
+`linkHandling` can disable URLs/addresses independently or route their taps through
+`openUrl(url, message)` / `openAddress(address, message)`. A disabled link renders
+as ordinary text. Host overrides also suppress social/tracking shortcuts that
+would otherwise bypass the host's navigation policy.
+
+`onDownloadAttachment({file,message,signal})` changes the standard viewer's Download
+action to a host-owned destination. Enable `appearance.showDownloadButton`. The
+SDK rechecks access, supplies a private temporary file, and cleans it up afterward;
+copy it to your destination before resolving the callback. Do not retain its URI
+as a permanent saved file. Cancellation and permission changes still apply.
+
+`ExpoMessenger` offers `onNewConversation` and `inboxOverlay` for a host-owned
+contact picker using the exported `MessagingPopup`. Account callbacks include
+`onEditProfile`, `onDeleteAccount`, and `onSignOut`; the host supplies its own
+confirmation and account service. These optional callbacks do not grant service
+permissions or delete an account by themselves.