fix(types): enable TypeScript libCheck & resolve type conflicts (invertase#4306)

* chore: enable TypeScript libcheck & remove "dom" lib
    "dom" conflicts with @types/react-native
* chore: add react types (referenced by admob types)
* refactor(types, app): move "app" exports to top-level exports, rather than module declarations with namespace extensions
* refactor(types): use top-level exports for module types, rather than declarations
* refactor(types): for JSON config, augment existing `ReactNativeFirebase` namespace from /app
    Re-exporting the namespace causes collision issues -- tramples previous values rather than merging
* fix(types, admob): Use string-indexing rather than dot-notation for referring to interface keys
* fix(types, analytics): convert missing interface to `any`
* fix(types, database): missing `value` type (treated as 'any')
* fix(types, dynamic-links): fix dynamic-links `onLink` function type
    "Function" is not generic
* fix(types, firestore): add missing generic to Promise type
    Keep current behavior with `any`
* fix(types, messaging): remove parameter initializer in typedef 
    Only allowed in implementations
* fix(types, messaging): avoid implicit `any` via `void` return type for `setBackgroundMessageHandler`
* fix(types, ml-vision): import non-ambient types in BarcodeDetectorTypes
* fix(types, ml-vision): import non-ambient types in root module from BarcodeDetectorTypes
* fix(types, ml-vision): repair invalid `extends` use by duplicating inherited key
    Could have Omit<>'ed the incompatible `bounds` key, but duplicating the one inherited key seemed less complex
* fix(types, perf): add void return types to untyped perf methods
* tests(admob): add type override to intentionally-wrong syntax
    Incorrect type is now caught by TS
* tests(types, ml-vision): fix ml-vision test typo, exposed by proper types
    VisionBarcodeFormat.ALL_POINTS does not exist
* chore(website): update typedoc to allow recursive types
    uses new syntax: TSConfigReader

Author: davidgovea

lib/index.d.ts

@@ -608,7 +608,7 @@ export namespace FirebaseMessagingTypes {
      * @param authorizedEntity The messaging sender ID. In most cases this will be the current default app.
      * @param scope The scope to assign a token, which the sever can use to target messages at.
      */
-    getToken(authorizedEntity?: string, scope?: string = 'FCM'): Promise<string>;
+    getToken(authorizedEntity?: string, scope?: string): Promise<string>;
 
     /**
      * Removes access to an FCM token previously authorized by it's scope. Messages sent by the server
@@ -623,7 +623,7 @@ export namespace FirebaseMessagingTypes {
      * @param authorizedEntity The messaging sender ID. In most cases this will be the current default app.
      * @param scope The scope to assign when token will be deleted.
      */
-    deleteToken(authorizedEntity?: string, scope?: string = 'FCM'): Promise<void>;
+    deleteToken(authorizedEntity?: string, scope?: string): Promise<void>;
 
     /**
      * When any FCM payload is received, the listener callback is called with a `RemoteMessage`.
@@ -897,7 +897,7 @@ export namespace FirebaseMessagingTypes {
      * ```
      *
      */
-    setBackgroundMessageHandler(handler: (message: RemoteMessage) => Promise<any>);
+    setBackgroundMessageHandler(handler: (message: RemoteMessage) => Promise<any>): void;
 
     /**
      * Send a new `RemoteMessage` to the FCM server.
@@ -949,21 +949,19 @@ export namespace FirebaseMessagingTypes {
   }
 }
 
-declare module '@react-native-firebase/messaging' {
-  // tslint:disable-next-line:no-duplicate-imports required otherwise doesn't work
-  import { ReactNativeFirebase } from '@react-native-firebase/app';
-  import ReactNativeFirebaseModule = ReactNativeFirebase.Module;
-  import FirebaseModuleWithStatics = ReactNativeFirebase.FirebaseModuleWithStatics;
+declare const defaultExport: ReactNativeFirebase.FirebaseModuleWithStatics<
+  FirebaseMessagingTypes.Module,
+  FirebaseMessagingTypes.Statics
+>;
 
-  const firebaseNamedExport: {} & ReactNativeFirebaseModule;
-  export const firebase = firebaseNamedExport;
+export const firebase: ReactNativeFirebase.Module & {
+  messaging: typeof defaultExport;
+  app(
+    name?: string,
+  ): ReactNativeFirebase.FirebaseApp & { messaging(): FirebaseMessagingTypes.Module };
+};
 
-  const defaultExport: FirebaseModuleWithStatics<
-    FirebaseMessagingTypes.Module,
-    FirebaseMessagingTypes.Statics
-  >;
-  export default defaultExport;
-}
+export default defaultExport;
 
 /**
  * Attach namespace to `firebase.` and `FirebaseApp.`.
@@ -981,23 +979,21 @@ declare module '@react-native-firebase/app' {
     interface FirebaseApp {
       messaging(): FirebaseMessagingTypes.Module;
     }
-  }
-}
 
-namespace ReactNativeFirebase {
-  interface FirebaseJsonConfig {
-    messaging_auto_init_enabled?: boolean;
-    messaging_android_headless_task_timeout?: number;
-    messaging_android_notification_channel_id?: string;
-    messaging_android_notification_color?: string;
-    /**
-     * Whether RNFirebase Messaging automatically calls `[[UIApplication sharedApplication] registerForRemoteNotifications];`
-     * automatically on app launch (recommended) - defaults to true.
-     *
-     * If set to false; make sure to call `firebase.messaging().registerDeviceForRemoteMessages()`
-     * early on in your app startup - otherwise you will NOT receive remote messages/notifications
-     * in your app.
-     */
-    messaging_ios_auto_register_for_remote_messages?: boolean;
+    interface FirebaseJsonConfig {
+      messaging_auto_init_enabled?: boolean;
+      messaging_android_headless_task_timeout?: number;
+      messaging_android_notification_channel_id?: string;
+      messaging_android_notification_color?: string;
+      /**
+       * Whether RNFirebase Messaging automatically calls `[[UIApplication sharedApplication] registerForRemoteNotifications];`
+       * automatically on app launch (recommended) - defaults to true.
+       *
+       * If set to false; make sure to call `firebase.messaging().registerDeviceForRemoteMessages()`
+       * early on in your app startup - otherwise you will NOT receive remote messages/notifications
+       * in your app.
+       */
+      messaging_ios_auto_register_for_remote_messages?: boolean;
+    }
   }
 }