feat: let host apps opt out of the notification permission request

PermissionsAndroid.request(POST_NOTIFICATIONS) fired unconditionally
whenever the bell button was tapped, with no way for a host app to
prevent it. Adds enableNotificationBell (default true, backward
compatible) to ChattyChatView — when false, the button is hidden and
the SDK never calls PermissionsAndroid.request, so integrating apps
fully control if/when/how it's requested. Camera/photo/mic already
never request permissions themselves (host-supplied callbacks).
Documents this in a new README Permissions section.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: tharindu20118

README.md

@@ -125,6 +125,7 @@ this release; color, radius, and header/bubble treatment carry most of a design'
   onMessage={(message) => void}
   onVoiceCallPress={() => void}
   onNotificationBellPress={() => void}
+  enableNotificationBell={boolean}  // optional, defaults to true — see Permissions
 />
 ```
 
@@ -148,6 +149,7 @@ The button color follows the active design's accent automatically — same as we
   onNotificationBellPress={() => void}  // optional, header notification-bell button — see Notes
   onClose={() => void}                // optional, renders a header close (✕) button.
                                        // ChattyLauncher passes this for you.
+  enableNotificationBell={boolean}    // optional, defaults to true — see Permissions
 />
 ```
 
@@ -176,6 +178,32 @@ layout.
 
 ### Notes
 
+<details open>
+<summary><strong id="permissions">Permissions — what this SDK requests, and how to opt out</strong></summary>
+
+<br>
+
+This SDK requests exactly one permission itself, and only in direct response to a button tap —
+never on load, never speculatively:
+
+| Permission | Risk | Used for | Requested when |
+|---|---|---|---|
+| `POST_NOTIFICATIONS` (Android 13+) | Runtime-gated | Header bell button → local notification-permission ask | User taps the bell, only if `enableNotificationBell` (default `true`) |
+
+Set `enableNotificationBell={false}` to hide the bell button entirely — the SDK then never calls
+`PermissionsAndroid.request` at all, so your app fully controls if/when/how notification
+permission is ever requested. Your app remains free to request it itself, on its own schedule,
+for its own purposes.
+
+**Camera, photo library, and microphone are never requested by this SDK at all** — as noted
+above, `onCameraPress` / `onPhotoLibraryPress` / `onMicPress` are plain callbacks; your app
+supplies its own picker/recorder package (`expo-image-picker`, `react-native-image-picker`,
+`expo-av`, etc.) and that package's own permission flow runs entirely under your control. This
+SDK adds no `CAMERA`/`RECORD_AUDIO`/photo-library manifest entries or Info.plist keys of its own —
+whatever picker/recorder you choose documents what it needs.
+
+</details>
+
 <details open>
 <summary><strong>Security — <code>bot_id</code> and domain restriction</strong></summary>
 

dist/ChattyChatView.d.ts

@@ -33,5 +33,12 @@ export interface ChattyChatViewProps extends UseChattyChatOptions {
      * your own close bar above ChattyChatView (e.g. in a modal wrapper), so there's one header,
      * not two stacked ones. ChattyLauncher already does this for you. */
     onClose?: () => void;
+    /** Shows the header's notification-bell button and, on Android, requests
+     * POST_NOTIFICATIONS (a runtime permission on API 33+) when tapped. Set `false` to hide the
+     * button entirely — the SDK then never calls PermissionsAndroid.request at all, so your app
+     * fully controls if/when/how notification permission is ever requested. Default `true`.
+     * Camera/photo/mic aren't listed here because this SDK never requests those permissions
+     * itself — see onCameraPress/onPhotoLibraryPress/onMicPress above. */
+    enableNotificationBell?: boolean;
 }
 export declare function ChattyChatView(props: ChattyChatViewProps): React.JSX.Element;

dist/ChattyChatView.js

@@ -122,9 +122,9 @@ export function ChattyChatView(props) {
           {theme?.voice_enabled ? (<TouchableOpacity style={styles.headerActionButton} onPress={() => props.onVoiceCallPress?.()}>
               <Text style={{ fontSize: 16 }}>📞</Text>
             </TouchableOpacity>) : null}
-          <TouchableOpacity style={styles.headerActionButton} onPress={handleBellPress}>
-            <Text style={{ fontSize: 16 }}>🔔</Text>
-          </TouchableOpacity>
+          {props.enableNotificationBell !== false ? (<TouchableOpacity style={styles.headerActionButton} onPress={handleBellPress}>
+              <Text style={{ fontSize: 16 }}>🔔</Text>
+            </TouchableOpacity>) : null}
           <TouchableOpacity style={styles.headerActionButton} onPress={() => void clearChat()}>
             <Text style={{ fontSize: 16 }}>↺</Text>
           </TouchableOpacity>

src/ChattyChatView.tsx

@@ -64,6 +64,13 @@ export interface ChattyChatViewProps extends UseChattyChatOptions {
    * your own close bar above ChattyChatView (e.g. in a modal wrapper), so there's one header,
    * not two stacked ones. ChattyLauncher already does this for you. */
   onClose?: () => void;
+  /** Shows the header's notification-bell button and, on Android, requests
+   * POST_NOTIFICATIONS (a runtime permission on API 33+) when tapped. Set `false` to hide the
+   * button entirely — the SDK then never calls PermissionsAndroid.request at all, so your app
+   * fully controls if/when/how notification permission is ever requested. Default `true`.
+   * Camera/photo/mic aren't listed here because this SDK never requests those permissions
+   * itself — see onCameraPress/onPhotoLibraryPress/onMicPress above. */
+  enableNotificationBell?: boolean;
 }
 
 /** bot/logo(no logoUrl)/custom(no avatarUrl) fall back to a generic chat
@@ -196,9 +203,11 @@ export function ChattyChatView(props: ChattyChatViewProps) {
               <Text style={{ fontSize: 16 }}>📞</Text>
             </TouchableOpacity>
           ) : null}
-          <TouchableOpacity style={styles.headerActionButton} onPress={handleBellPress}>
-            <Text style={{ fontSize: 16 }}>🔔</Text>
-          </TouchableOpacity>
+          {props.enableNotificationBell !== false ? (
+            <TouchableOpacity style={styles.headerActionButton} onPress={handleBellPress}>
+              <Text style={{ fontSize: 16 }}>🔔</Text>
+            </TouchableOpacity>
+          ) : null}
           <TouchableOpacity style={styles.headerActionButton} onPress={() => void clearChat()}>
             <Text style={{ fontSize: 16 }}>↺</Text>
           </TouchableOpacity>