@robono/messaging-react-native 0.11.1 → 0.13.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.12.0 — unpublished candidate
+
+## 0.13.0
+
+- Share the Messenger sign-in, country/phone controls and loading/recovery screen with website integrations.
+- Require the messaging core update for direct hosted routing and clearer connection errors.
+
+
+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

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 {
@@ -310,10 +324,7 @@ 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.
+first answer is final. Both use the same app-height popup frame as tracking and social previews. The hosted service supplies the required message and media support.
 
 ### Optional downloads in the viewer
 
@@ -419,8 +430,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 +469,50 @@ 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.
+
+### Shared sign-in presentation
+
+`MessagingSignIn`, `MessagingPhoneInput` and `MessagingChoicePicker` are optional
+shared UI components, also exported by `@robono/messaging-web`. Robono's new
+consumer app uses these same components. The card, code cells, consent row,
+buttons and field proportions follow the existing Messenger.
+
+Continue using your existing login when embedding Messenger. These components
+add **no second account, SMS provider, credential storage or authentication
+service**. Your host controls `stage`, field values, validation, busy/error state,
+verification expiry and `onSubmit`. Supply your own company logo/name through
+`logo` or `appearance`, your colors through `appearance.colors`, consent copy and
+policy links through `consent`, and translated text through `labels`.
+
+Render your `MessagingPhoneInput` and its `MessagingChoicePicker` together inside
+`MessagingSignIn.phoneField`; profile choices belong in `profileFields`. This
+keeps website pickers inside the sign-in container. The host supplies supported
+countries and validates/normalizes numbers with its own authentication provider.
+Use `secondsRemaining` only with an expiry returned by that provider. An expired
+code changes the submit action to “Send a new code”; the host performs that action.
+Never include private integration keys in these props.
+
+`MessagingConnectionState` is the shared waiting/recovery screen used by customer
+starters and Robono Messenger. Pass `error`, `onRetry`, optional `onSignOut`,
+`appearance`, and translated `labels`. Account actions appear only on failure,
+never during normal connection startup. The hosted connection selects Robono's
+approved direct transport automatically; no extra phone setup is required.