react-native 0.70.4 → 0.71.0-rc.0

package/Libraries/PermissionsAndroid/PermissionsAndroid.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+export interface Rationale {
+  title: string;
+  message: string;
+  buttonPositive: string;
+  buttonNegative?: string | undefined;
+  buttonNeutral?: string | undefined;
+}
+
+export type Permission =
+  | 'android.permission.READ_CALENDAR'
+  | 'android.permission.WRITE_CALENDAR'
+  | 'android.permission.CAMERA'
+  | 'android.permission.READ_CONTACTS'
+  | 'android.permission.WRITE_CONTACTS'
+  | 'android.permission.GET_ACCOUNTS'
+  | 'android.permission.ACCESS_BACKGROUND_LOCATION'
+  | 'android.permission.ACCESS_FINE_LOCATION'
+  | 'android.permission.ACCESS_COARSE_LOCATION'
+  | 'android.permission.RECORD_AUDIO'
+  | 'android.permission.READ_PHONE_STATE'
+  | 'android.permission.CALL_PHONE'
+  | 'android.permission.READ_CALL_LOG'
+  | 'android.permission.WRITE_CALL_LOG'
+  | 'com.android.voicemail.permission.ADD_VOICEMAIL'
+  | 'com.android.voicemail.permission.READ_VOICEMAIL'
+  | 'com.android.voicemail.permission.WRITE_VOICEMAIL'
+  | 'android.permission.USE_SIP'
+  | 'android.permission.PROCESS_OUTGOING_CALLS'
+  | 'android.permission.BODY_SENSORS'
+  | 'android.permission.BODY_SENSORS_BACKGROUND'
+  | 'android.permission.SEND_SMS'
+  | 'android.permission.RECEIVE_SMS'
+  | 'android.permission.READ_SMS'
+  | 'android.permission.RECEIVE_WAP_PUSH'
+  | 'android.permission.RECEIVE_MMS'
+  | 'android.permission.READ_EXTERNAL_STORAGE'
+  | 'android.permission.READ_MEDIA_IMAGES'
+  | 'android.permission.READ_MEDIA_VIDEO'
+  | 'android.permission.READ_MEDIA_AUDIO'
+  | 'android.permission.WRITE_EXTERNAL_STORAGE'
+  | 'android.permission.BLUETOOTH_CONNECT'
+  | 'android.permission.BLUETOOTH_SCAN'
+  | 'android.permission.BLUETOOTH_ADVERTISE'
+  | 'android.permission.ACCESS_MEDIA_LOCATION'
+  | 'android.permission.ACCEPT_HANDOVER'
+  | 'android.permission.ACTIVITY_RECOGNITION'
+  | 'android.permission.ANSWER_PHONE_CALLS'
+  | 'android.permission.READ_PHONE_NUMBERS'
+  | 'android.permission.UWB_RANGING'
+  | 'android.permission.POST_NOTIFICATIONS'
+  | 'android.permission.NEARBY_WIFI_DEVICES';
+
+export type PermissionStatus = 'granted' | 'denied' | 'never_ask_again';
+
+export interface PermissionsAndroidStatic {
+  /**
+   * A list of permission results that are returned
+   */
+  RESULTS: {[key: string]: PermissionStatus};
+  /**
+   * A list of specified "dangerous" permissions that require prompting the user
+   */
+  PERMISSIONS: {[key: string]: Permission};
+  new (): PermissionsAndroidStatic;
+  /**
+   * @deprecated Use check instead
+   */
+  checkPermission(permission: Permission): Promise<boolean>;
+  /**
+   * Returns a promise resolving to a boolean value as to whether the specified
+   * permissions has been granted
+   */
+  check(permission: Permission): Promise<boolean>;
+  /**
+   * @deprecated Use request instead
+   */
+  requestPermission(
+    permission: Permission,
+    rationale?: Rationale,
+  ): Promise<boolean>;
+  /**
+   * Prompts the user to enable a permission and returns a promise resolving to a
+   * string value indicating whether the user allowed or denied the request
+   *
+   * If the optional rationale argument is included (which is an object with a
+   * title and message), this function checks with the OS whether it is necessary
+   * to show a dialog explaining why the permission is needed
+   * (https://developer.android.com/training/permissions/requesting.html#explain)
+   * and then shows the system permission dialog
+   */
+  request(
+    permission: Permission,
+    rationale?: Rationale,
+  ): Promise<PermissionStatus>;
+  /**
+   * Prompts the user to enable multiple permissions in the same dialog and
+   * returns an object with the permissions as keys and strings as values
+   * indicating whether the user allowed or denied the request
+   */
+  requestMultiple(
+    permissions: Array<Permission>,
+  ): Promise<{[key in Permission]: PermissionStatus}>;
+}
+
+export const PermissionsAndroid: PermissionsAndroidStatic;
+export type PermissionsAndroid = PermissionsAndroidStatic;

package/Libraries/PermissionsAndroid/PermissionsAndroid.js

@@ -8,16 +8,17 @@
  * @flow strict
  */
 
-const Platform = require('../Utilities/Platform');
-
-import NativeDialogManagerAndroid from '../NativeModules/specs/NativeDialogManagerAndroid';
-import NativePermissionsAndroid from './NativePermissionsAndroid';
 import type {
   PermissionStatus,
   PermissionType,
 } from './NativePermissionsAndroid';
+
+import NativeDialogManagerAndroid from '../NativeModules/specs/NativeDialogManagerAndroid';
+import NativePermissionsAndroid from './NativePermissionsAndroid';
 import invariant from 'invariant';
 
+const Platform = require('../Utilities/Platform');
+
 export type Rationale = {
   title: string,
   message: string,

package/Libraries/Pressability/Pressability.js

@@ -8,24 +8,25 @@
  * @format
  */
 
-import {isHoverEnabled} from './HoverState';
-import invariant from 'invariant';
-import SoundManager from '../Components/Sound/SoundManager';
-import {normalizeRect, type RectOrSize} from '../StyleSheet/Rect';
+import type {HostComponent} from '../Renderer/shims/ReactNativeTypes';
 import type {
   BlurEvent,
   FocusEvent,
-  PressEvent,
   MouseEvent,
+  PressEvent,
 } from '../Types/CoreEventTypes';
+
+import SoundManager from '../Components/Sound/SoundManager';
+import ReactNativeFeatureFlags from '../ReactNative/ReactNativeFeatureFlags';
+import UIManager from '../ReactNative/UIManager';
+import {type RectOrSize, normalizeRect} from '../StyleSheet/Rect';
+import {type PointerEvent} from '../Types/CoreEventTypes';
+import Platform from '../Utilities/Platform';
+import {isHoverEnabled} from './HoverState';
 import PressabilityPerformanceEventEmitter from './PressabilityPerformanceEventEmitter.js';
 import {type PressabilityTouchSignal as TouchSignal} from './PressabilityTypes.js';
-import Platform from '../Utilities/Platform';
-import UIManager from '../ReactNative/UIManager';
-import type {HostComponent} from '../Renderer/shims/ReactNativeTypes';
+import invariant from 'invariant';
 import * as React from 'react';
-import ReactNativeFeatureFlags from '../ReactNative/ReactNativeFeatureFlags';
-import {type PointerEvent} from '../Types/CoreEventTypes';
 
 export type PressabilityConfig = $ReadOnly<{|
   /**
@@ -549,6 +550,7 @@ export default class Pressability {
 
     if (process.env.NODE_ENV === 'test') {
       // We are setting this in order to find this node in ReactNativeTestTools
+      // $FlowFixMe[prop-missing]
       responderEventHandlers.onStartShouldSetResponder.testOnly_pressabilityConfig =
         () => this._config;
     }

package/Libraries/Pressability/PressabilityDebug.js

@@ -8,11 +8,11 @@
  * @format
  */
 
-import normalizeColor from '../StyleSheet/normalizeColor';
 import type {ColorValue} from '../StyleSheet/StyleSheet';
-import {normalizeRect, type RectOrSize} from '../StyleSheet/Rect';
 
 import View from '../Components/View/View';
+import normalizeColor from '../StyleSheet/normalizeColor';
+import {type RectOrSize, normalizeRect} from '../StyleSheet/Rect';
 import * as React from 'react';
 
 type Props = $ReadOnly<{|

package/Libraries/PushNotificationIOS/NativePushNotificationManagerIOS.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 type Permissions = {|

package/Libraries/PushNotificationIOS/PushNotificationIOS.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+export interface PushNotificationPermissions {
+  alert?: boolean | undefined;
+  badge?: boolean | undefined;
+  sound?: boolean | undefined;
+}
+
+export interface PushNotification {
+  /**
+   * An alias for `getAlert` to get the notification's main message string
+   */
+  getMessage(): string | Object;
+
+  /**
+   * Gets the sound string from the `aps` object
+   */
+  getSound(): string;
+
+  /**
+   * Gets the category string from the `aps` object
+   */
+  getCategory(): string;
+
+  /**
+   * Gets the notification's main message from the `aps` object
+   */
+  getAlert(): string | Object;
+
+  /**
+   * Gets the content-available number from the `aps` object
+   */
+  getContentAvailable(): number;
+
+  /**
+   * Gets the badge count number from the `aps` object
+   */
+  getBadgeCount(): number;
+
+  /**
+   * Gets the data object on the notif
+   */
+  getData(): Object;
+
+  /**
+   * iOS Only
+   * Signifies remote notification handling is complete
+   */
+  finish(result: string): void;
+}
+
+type PresentLocalNotificationDetails = {
+  alertBody: string;
+  alertAction: string;
+  alertTitle?: string | undefined;
+  soundName?: string | undefined;
+  category?: string | undefined;
+  userInfo?: Object | undefined;
+  applicationIconBadgeNumber?: number | undefined;
+};
+
+type ScheduleLocalNotificationDetails = {
+  alertAction?: string | undefined;
+  alertBody?: string | undefined;
+  alertTitle?: string | undefined;
+  applicationIconBadgeNumber?: number | undefined;
+  category?: string | undefined;
+  fireDate?: number | string | undefined;
+  isSilent?: boolean | undefined;
+  repeatInterval?:
+    | 'year'
+    | 'month'
+    | 'week'
+    | 'day'
+    | 'hour'
+    | 'minute'
+    | undefined;
+  soundName?: string | undefined;
+  userInfo?: Object | undefined;
+};
+
+export type PushNotificationEventName =
+  | 'notification'
+  | 'localNotification'
+  | 'register'
+  | 'registrationError';
+
+type FetchResult = {
+  NewData: 'UIBackgroundFetchResultNewData';
+  NoData: 'UIBackgroundFetchResultNoData';
+  ResultFailed: 'UIBackgroundFetchResultFailed';
+};
+
+/**
+ * Handle push notifications for your app, including permission handling and icon badge number.
+ * @see https://reactnative.dev/docs/pushnotificationios#content
+ *
+ * //FIXME: BGR: The documentation seems completely off compared to the actual js implementation. I could never get the example to run
+ */
+export interface PushNotificationIOSStatic {
+  /**
+   * Schedules the localNotification for immediate presentation.
+   * details is an object containing:
+   * alertBody : The message displayed in the notification alert.
+   * alertAction : The "action" displayed beneath an actionable notification. Defaults to "view";
+   * soundName : The sound played when the notification is fired (optional).
+   * category : The category of this notification, required for actionable notifications (optional).
+   * userInfo : An optional object containing additional notification data.
+   * applicationIconBadgeNumber (optional) : The number to display as the app's icon badge. The default value of this property is 0, which means that no badge is displayed.
+   */
+  presentLocalNotification(details: PresentLocalNotificationDetails): void;
+
+  /**
+   * Schedules the localNotification for future presentation.
+   * details is an object containing:
+   * fireDate : The date and time when the system should deliver the notification.
+   * alertBody : The message displayed in the notification alert.
+   * alertAction : The "action" displayed beneath an actionable notification. Defaults to "view";
+   * soundName : The sound played when the notification is fired (optional).
+   * category : The category of this notification, required for actionable notifications (optional).
+   * userInfo : An optional object containing additional notification data.
+   * applicationIconBadgeNumber (optional) : The number to display as the app's icon badge. Setting the number to 0 removes the icon badge.
+   */
+  scheduleLocalNotification(details: ScheduleLocalNotificationDetails): void;
+
+  /**
+   * Cancels all scheduled localNotifications
+   */
+  cancelAllLocalNotifications(): void;
+
+  /**
+   * Cancel local notifications.
+   * Optionally restricts the set of canceled notifications to those notifications whose userInfo fields match the corresponding fields in the userInfo argument.
+   */
+  cancelLocalNotifications(userInfo: Object): void;
+
+  /**
+   * Sets the badge number for the app icon on the home screen
+   */
+  setApplicationIconBadgeNumber(number: number): void;
+
+  /**
+   * Gets the current badge number for the app icon on the home screen
+   */
+  getApplicationIconBadgeNumber(callback: (badge: number) => void): void;
+
+  /**
+   * Gets the local notifications that are currently scheduled.
+   */
+  getScheduledLocalNotifications(
+    callback: (notifications: ScheduleLocalNotificationDetails[]) => void,
+  ): void;
+
+  /**
+   * Attaches a listener to remote notifications while the app is running in the
+   * foreground or the background.
+   *
+   * The handler will get be invoked with an instance of `PushNotificationIOS`
+   *
+   * The type MUST be 'notification'
+   */
+  addEventListener(
+    type: 'notification' | 'localNotification',
+    handler: (notification: PushNotification) => void,
+  ): void;
+
+  /**
+   * Fired when the user registers for remote notifications.
+   *
+   * The handler will be invoked with a hex string representing the deviceToken.
+   *
+   * The type MUST be 'register'
+   */
+  addEventListener(
+    type: 'register',
+    handler: (deviceToken: string) => void,
+  ): void;
+
+  /**
+   * Fired when the user fails to register for remote notifications.
+   * Typically occurs when APNS is having issues, or the device is a simulator.
+   *
+   * The handler will be invoked with {message: string, code: number, details: any}.
+   *
+   * The type MUST be 'registrationError'
+   */
+  addEventListener(
+    type: 'registrationError',
+    handler: (error: {message: string; code: number; details: any}) => void,
+  ): void;
+
+  /**
+   * Removes the event listener. Do this in `componentWillUnmount` to prevent
+   * memory leaks
+   */
+  removeEventListener(
+    type: PushNotificationEventName,
+    handler:
+      | ((notification: PushNotification) => void)
+      | ((deviceToken: string) => void)
+      | ((error: {message: string; code: number; details: any}) => void),
+  ): void;
+
+  /**
+   * Requests all notification permissions from iOS, prompting the user's
+   * dialog box.
+   */
+  requestPermissions(permissions?: PushNotificationPermissions[]): void;
+
+  /**
+   * Requests all notification permissions from iOS, prompting the user's
+   * dialog box.
+   */
+  requestPermissions(
+    permissions?: PushNotificationPermissions,
+  ): Promise<PushNotificationPermissions>;
+
+  /**
+   * Unregister for all remote notifications received via Apple Push
+   * Notification service.
+   * You should call this method in rare circumstances only, such as when
+   * a new version of the app removes support for all types of remote
+   * notifications. Users can temporarily prevent apps from receiving
+   * remote notifications through the Notifications section of the
+   * Settings app. Apps unregistered through this method can always
+   * re-register.
+   */
+  abandonPermissions(): void;
+
+  /**
+   * See what push permissions are currently enabled. `callback` will be
+   * invoked with a `permissions` object:
+   *
+   *  - `alert` :boolean
+   *  - `badge` :boolean
+   *  - `sound` :boolean
+   */
+  checkPermissions(
+    callback: (permissions: PushNotificationPermissions) => void,
+  ): void;
+
+  /**
+   * This method returns a promise that resolves to either the notification
+   * object if the app was launched by a push notification, or `null` otherwise.
+   */
+  getInitialNotification(): Promise<PushNotification | null>;
+
+  /**
+   * iOS fetch results that best describe the result of a finished remote notification handler.
+   * For a list of possible values, see `PushNotificationIOS.FetchResult`.
+   */
+  FetchResult: FetchResult;
+}
+
+/**
+ * PushNotificationIOS has been extracted from react-native core and will be removed in a future release.
+ * It can now be installed and imported from `@react-native-community/push-notification-ios` instead of 'react-native'.
+ * @see https://github.com/react-native-community/react-native-push-notification-ios
+ * @deprecated
+ */
+export const PushNotificationIOS: PushNotificationIOSStatic;
+/**
+ * PushNotificationIOS has been extracted from react-native core and will be removed in a future release.
+ * It can now be installed and imported from `@react-native-community/push-notification-ios` instead of 'react-native'.
+ * @see https://github.com/react-native-community/react-native-push-notification-ios
+ * @deprecated
+ */
+export type PushNotificationIOS = PushNotificationIOSStatic;

package/Libraries/PushNotificationIOS/PushNotificationIOS.js

@@ -8,10 +8,12 @@
  * @flow
  */
 
+import type {EventSubscription} from '../vendor/emitter/EventEmitter';
+
 import NativeEventEmitter from '../EventEmitter/NativeEventEmitter';
+import Platform from '../Utilities/Platform';
 import NativePushNotificationManagerIOS from './NativePushNotificationManagerIOS';
 import invariant from 'invariant';
-import Platform from '../Utilities/Platform';
 
 type NativePushNotificationIOSEventDefinitions = {
   remoteNotificationReceived: [
@@ -44,7 +46,7 @@ const PushNotificationEmitter =
     Platform.OS !== 'ios' ? null : NativePushNotificationManagerIOS,
   );
 
-const _notifHandlers = new Map();
+const _notifHandlers = new Map<string, void | EventSubscription>();
 
 const DEVICE_NOTIF_EVENT = 'remoteNotificationReceived';
 const NOTIF_REGISTER_EVENT = 'remoteNotificationsRegistered';
@@ -118,7 +120,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#presentlocalnotification
    */
-  static presentLocalNotification(details: Object) {
+  static presentLocalNotification(details: Object): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -131,7 +133,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#schedulelocalnotification
    */
-  static scheduleLocalNotification(details: Object) {
+  static scheduleLocalNotification(details: Object): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -144,7 +146,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#cancelalllocalnotifications
    */
-  static cancelAllLocalNotifications() {
+  static cancelAllLocalNotifications(): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -198,7 +200,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#setapplicationiconbadgenumber
    */
-  static setApplicationIconBadgeNumber(number: number) {
+  static setApplicationIconBadgeNumber(number: number): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -211,7 +213,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#getapplicationiconbadgenumber
    */
-  static getApplicationIconBadgeNumber(callback: Function) {
+  static getApplicationIconBadgeNumber(callback: Function): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -224,7 +226,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#cancellocalnotification
    */
-  static cancelLocalNotifications(userInfo: Object) {
+  static cancelLocalNotifications(userInfo: Object): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -237,7 +239,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#getscheduledlocalnotifications
    */
-  static getScheduledLocalNotifications(callback: Function) {
+  static getScheduledLocalNotifications(callback: Function): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -251,7 +253,10 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#addeventlistener
    */
-  static addEventListener(type: PushNotificationEventName, handler: Function) {
+  static addEventListener(
+    type: PushNotificationEventName,
+    handler: Function,
+  ): void {
     invariant(
       type === 'notification' ||
         type === 'register' ||
@@ -301,7 +306,7 @@ class PushNotificationIOS {
   static removeEventListener(
     type: PushNotificationEventName,
     handler: Function,
-  ) {
+  ): void {
     invariant(
       type === 'notification' ||
         type === 'register' ||
@@ -362,7 +367,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#abandonpermissions
    */
-  static abandonPermissions() {
+  static abandonPermissions(): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -376,7 +381,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#checkpermissions
    */
-  static checkPermissions(callback: Function) {
+  static checkPermissions(callback: Function): void {
     invariant(typeof callback === 'function', 'Must provide a valid callback');
     invariant(
       NativePushNotificationManagerIOS,
@@ -463,7 +468,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#finish
    */
-  finish(fetchResult: string) {
+  finish(fetchResult: string): void {
     if (
       !this._isRemote ||
       !this._notificationId ||

package/Libraries/PushNotificationIOS/RCTPushNotificationManager.h

@@ -17,7 +17,8 @@ typedef void (^RCTRemoteNotificationCallback)(UIBackgroundFetchResult result);
 + (void)didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings;
 + (void)didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken;
 + (void)didReceiveRemoteNotification:(NSDictionary *)notification;
-+ (void)didReceiveRemoteNotification:(NSDictionary *)notification fetchCompletionHandler:(RCTRemoteNotificationCallback)completionHandler;
++ (void)didReceiveRemoteNotification:(NSDictionary *)notification
+              fetchCompletionHandler:(RCTRemoteNotificationCallback)completionHandler;
 + (void)didReceiveLocalNotification:(UILocalNotification *)notification;
 + (void)didFailToRegisterForRemoteNotificationsWithError:(NSError *)error;
 #endif