Feature Request - Passing State in Email Actions #1146

Author: EddyVerbruggen

docs/AUTHENTICATION.md

@@ -746,14 +746,46 @@ When this happens (or to prevent it from happening), re-authenticate the user.
 Sending an "email confirmation" email can be done after the user logged in:
 
 ```js
-  firebase.sendEmailVerification().then(
-      function () {
-        console.log("Email verification sent");
-      },
-      function (error) {
-        console.log("Error sending email verification: " + error);
-      }
-  );
+firebase.sendEmailVerification().then(
+  function () {
+    console.log("Email verification sent");
+  },
+  function (error) {
+    console.log("Error sending email verification: " + error);
+  }
+);
+```
+
+You can also pass state to this function - for details on the properties, see [the Firebase docs](https://firebase.google.com/docs/auth/web/passing-state-in-email-actions).
+
+```js
+firebase.sendEmailVerification({
+   url: "https://www.google.com",
+   handleCodeInApp: true,
+   iOS: {
+     bundleId: "com.bla.hoopla",
+     dynamicLinkDomain: "xyz"
+   },
+   android: {
+     minimumVersion: "13",
+     installApp: true,
+     packageName: "x.y.z"
+   }
+ }).then(
+  function () {
+    console.log("Email verification sent");
+  },
+  function (error) {
+    console.log("Error sending email verification: " + error);
+  }
+);
 ```
 
+Note that you can also use this with the Web API:
+
+```js
+const firebaseWebApi = require("nativescript-plugin-firebase/app");
+const user = firebaseWebApi.auth().currentUser;
 
+user.sendEmailVerification() // see the implementation above 
+```

src/app/auth/index.ts

@@ -5,6 +5,7 @@ export module auth {
   export class Auth {
     private authStateChangedHandler;
     public currentUser: User;
+    public languageCode: string | null;
 
     public onAuthStateChanged(handler: (user: User) => void): void {
       this.authStateChangedHandler = handler;

src/firebase.android.ts

@@ -3,6 +3,7 @@ import { AndroidActivityResultEventData } from "tns-core-modules/application";
 import lazy from "tns-core-modules/utils/lazy";
 import { ad as AndroidUtils } from "tns-core-modules/utils/utils";
 import {
+  ActionCodeSettings,
   DataSnapshot,
   FBDataSingleEvent,
   FBErrorData,
@@ -631,7 +632,7 @@ firebase.getCurrentUser = arg => {
   });
 };
 
-firebase.sendEmailVerification = () => {
+firebase.sendEmailVerification = (actionCodeSettings?: ActionCodeSettings) => {
   return new Promise((resolve, reject) => {
     try {
       const firebaseAuth = com.google.firebase.auth.FirebaseAuth.getInstance();
@@ -647,7 +648,24 @@ firebase.sendEmailVerification = () => {
           }
         });
 
-        user.sendEmailVerification().addOnCompleteListener(addOnCompleteListener);
+        if (actionCodeSettings) {
+          const settingsBuilder = new com.google.firebase.auth.ActionCodeSettings.newBuilder();
+          if (actionCodeSettings.handleCodeInApp !== undefined) {
+            settingsBuilder.setHandleCodeInApp(actionCodeSettings.handleCodeInApp);
+          }
+          if (actionCodeSettings.url) {
+            settingsBuilder.setUrl(actionCodeSettings.url);
+          }
+          if (actionCodeSettings.iOS && actionCodeSettings.iOS.bundleId) {
+            settingsBuilder.setIOSBundleId(actionCodeSettings.iOS.bundleId);
+          }
+          if (actionCodeSettings.android && actionCodeSettings.android.packageName) {
+            settingsBuilder.setAndroidPackageName(actionCodeSettings.android.packageName, actionCodeSettings.android.installApp, actionCodeSettings.android.minimumVersion || null);
+          }
+          user.sendEmailVerification(settingsBuilder.build()).addOnCompleteListener(addOnCompleteListener);
+        } else {
+          user.sendEmailVerification().addOnCompleteListener(addOnCompleteListener);
+        }
       } else {
         reject("Log in first");
       }
@@ -783,7 +801,8 @@ function toLoginResult(user, additionalUserInfo?): User {
     metadata: {
       creationTimestamp: user.getMetadata() ? new Date(user.getMetadata().getCreationTimestamp() as number) : null,
       lastSignInTimestamp: user.getMetadata() ? new Date(user.getMetadata().getLastSignInTimestamp() as number) : null
-    }
+    },
+    sendEmailVerification: (actionCodeSettings?: ActionCodeSettings) => firebase.sendEmailVerification(actionCodeSettings)
   };
 
   if (firebase.currentAdditionalUserInfo) {

src/firebase.d.ts

@@ -322,6 +322,20 @@ export interface ReauthenticateOptions {
   password?: string;
 }
 
+type ActionCodeSettings = {
+  url: string;
+  handleCodeInApp?: boolean;
+  android?: {
+    installApp?: boolean;
+    minimumVersion?: string;
+    packageName: string;
+  };
+  iOS?: {
+    bundleId: string;
+    dynamicLinkDomain?: string;
+  };
+};
+
 /**
  * The returned object from the login function.
  */
@@ -339,6 +353,8 @@ export interface User {
   additionalUserInfo?: AdditionalUserInfo;
   /** iOS only */
   refreshToken?: string;
+
+  sendEmailVerification(actionCodeSettings?: ActionCodeSettings): Promise<void>;
 }
 
 /**
@@ -943,7 +959,7 @@ export function fetchProvidersForEmail(email: string): Promise<Array<string>>;
 
 export function fetchSignInMethodsForEmail(email: string): Promise<Array<string>>;
 
-export function sendEmailVerification(): Promise<any>;
+export function sendEmailVerification(actionCodeSettings?: ActionCodeSettings): Promise<any>;
 
 export function createUser(options: CreateUserOptions): Promise<User>;
 

src/firebase.ios.ts

@@ -1,5 +1,6 @@
 import * as application from "tns-core-modules/application/application";
 import {
+  ActionCodeSettings,
   DataSnapshot,
   FBDataSingleEvent,
   firestore,
@@ -543,7 +544,7 @@ firebase.getCurrentUser = arg => {
   });
 };
 
-firebase.sendEmailVerification = () => {
+firebase.sendEmailVerification = (actionCodeSettings?: ActionCodeSettings) => {
   return new Promise((resolve, reject) => {
     try {
       const fAuth = FIRAuth.auth();
@@ -561,7 +562,29 @@ firebase.sendEmailVerification = () => {
             resolve(true);
           }
         };
-        user.sendEmailVerificationWithCompletion(onCompletion);
+        if (actionCodeSettings) {
+          const firActionCodeSettings = FIRActionCodeSettings.new();
+          if (actionCodeSettings.handleCodeInApp !== undefined) {
+            firActionCodeSettings.handleCodeInApp = actionCodeSettings.handleCodeInApp;
+          }
+          if (actionCodeSettings.url) {
+            firActionCodeSettings.URL = NSURL.URLWithString(actionCodeSettings.url);
+          }
+          if (actionCodeSettings.iOS) {
+            if (actionCodeSettings.iOS.bundleId) {
+              firActionCodeSettings.setIOSBundleID(actionCodeSettings.iOS.bundleId);
+            }
+            if (actionCodeSettings.iOS.dynamicLinkDomain) {
+              firActionCodeSettings.dynamicLinkDomain = actionCodeSettings.iOS.dynamicLinkDomain;
+            }
+          }
+          if (actionCodeSettings.android && actionCodeSettings.android.packageName) {
+            firActionCodeSettings.setAndroidPackageNameInstallIfNotAvailableMinimumVersion(actionCodeSettings.android.packageName, actionCodeSettings.android.installApp, actionCodeSettings.android.minimumVersion || null);
+          }
+          user.sendEmailVerificationWithActionCodeSettingsCompletion(firActionCodeSettings, onCompletion);
+        } else {
+          user.sendEmailVerificationWithCompletion(onCompletion);
+        }
       } else {
         reject("Log in first");
       }
@@ -660,7 +683,8 @@ function toLoginResult(user, additionalUserInfo?: FIRAdditionalUserInfo): User {
     metadata: {
       creationTimestamp: user.metadata.creationDate as Date,
       lastSignInTimestamp: user.metadata.lastSignInDate as Date
-    }
+    },
+    sendEmailVerification: (actionCodeSettings?: ActionCodeSettings) => firebase.sendEmailVerification(actionCodeSettings)
   };
 
   if (firebase.currentAdditionalUserInfo) {