react-native-permissions/src/methods.android.ts

An unified permissions API for React Native on iOS, Android and Windows

import {Alert, AlertButton} from 'react-native';
import type {Contract} from './contract';
import NativeModule from './NativePermissionsModule';
import type {NotificationsResponse, Permission, PermissionStatus, Rationale} from './types';
import {
  checkLocationAccuracy,
  openLimitedPhotoLibraryPicker,
  requestLocationAccuracy,
} from './unsupportedPlatformMethods';
import {platformVersion, uniq} from './utils';

const TIRAMISU_VERSION_CODE = 33;

async function openSettings(): Promise<void> {
  await NativeModule.openSettings();
}

function check(permission: Permission): Promise<PermissionStatus> {
  return NativeModule.checkPermission(permission) as Promise<PermissionStatus>;
}

async function request(permission: Permission, rationale?: Rationale): Promise<PermissionStatus> {
  if (rationale) {
    const shouldShowRationale = await NativeModule.shouldShowRequestPermissionRationale(permission);

    if (shouldShowRationale) {
      const {title, message, buttonPositive, buttonNegative, buttonNeutral} = rationale;

      return new Promise((resolve) => {
        const buttons: AlertButton[] = [];

        if (buttonNegative) {
          const onPress = () =>
            resolve(NativeModule.checkPermission(permission) as Promise<PermissionStatus>);

          buttonNeutral && buttons.push({text: buttonNeutral, onPress});
          buttons.push({text: buttonNegative, onPress});
        }

        buttons.push({
          text: buttonPositive,
          onPress: () =>
            resolve(NativeModule.requestPermission(permission) as Promise<PermissionStatus>),
        });

        Alert.alert(title, message, buttons, {cancelable: false});
      });
    }
  }

  return NativeModule.requestPermission(permission) as Promise<PermissionStatus>;
}

async function checkNotifications(): Promise<NotificationsResponse> {
  if (platformVersion < TIRAMISU_VERSION_CODE) {
    return NativeModule.checkNotifications() as Promise<NotificationsResponse>;
  }

  const status = await check('android.permission.POST_NOTIFICATIONS');
  return {status, settings: {}};
}

async function requestNotifications(): Promise<NotificationsResponse> {
  if (platformVersion < TIRAMISU_VERSION_CODE) {
    return NativeModule.checkNotifications() as Promise<NotificationsResponse>;
  }

  const status = await request('android.permission.POST_NOTIFICATIONS');
  return {status, settings: {}};
}

function checkMultiple<P extends Permission[]>(
  permissions: P,
): Promise<Record<P[number], PermissionStatus>> {
  const dedup = uniq(permissions);
  return NativeModule.checkMultiplePermissions(dedup) as Promise<
    Record<P[number], PermissionStatus>
  >;
}

function requestMultiple<P extends Permission[]>(
  permissions: P,
): Promise<Record<P[number], PermissionStatus>> {
  const dedup = uniq(permissions);
  return NativeModule.requestMultiplePermissions(dedup) as Promise<
    Record<P[number], PermissionStatus>
  >;
}

export const methods: Contract = {
  check,
  checkLocationAccuracy,
  checkMultiple,
  checkNotifications,
  openLimitedPhotoLibraryPicker,
  openSettings,
  request,
  requestLocationAccuracy,
  requestMultiple,
  requestNotifications,
};