FIS getAuthToken implementation. (#769)

* FIS getAuthToken implementation.

* FIS getAuthToken implementation.

* 1. Addressing Ciaran's comments
2. Renaming InstallationTokenResult TokenExpirationTimestampMillis field to TokenExpirationInSecs

* 1. Addressing Ciaran's comments
2. Renaming InstallationTokenResult TokenExpirationTimestampMillis field to TokenExpirationInSecs

* Updated IntDef usage in firebase-installations

*  Using CountDownLatch to await instead of executor.awaitTermination

* Addressing Di's comments.

* Addressing Di's comments.

* Addressing Ciaran's comments to replace latch with a custom listener.

* Adding onSuccess to AwaitListener.

* Cleaning up the code as per the ciaran's comments.

* Addressing Di's comments.

* 1. Handling multiple calls to getAUthToken()
2. Minor code changes as per the offline discussion with Rayo

* Fixing api-information presubmit check.

* updating api.txt for firbase-installations-interop

* Addressing Ciaran's comments.

* Fixing check-changed - GoogleJavaFormat error.

* Addressing ciaran`s comments

* nit fixes to executor : use unblocking queue.

Author: ankitaj224

firebase-installations-interop/api.txt

@@ -5,15 +5,15 @@ package com.google.firebase.installations {
     ctor public InstallationTokenResult();
     method @NonNull public static com.google.firebase.installations.InstallationTokenResult.Builder builder();
     method @NonNull public abstract String getToken();
-    method @NonNull public abstract long getTokenExpirationTimestampMillis();
+    method @NonNull public abstract long getTokenExpirationInSecs();
     method @NonNull public abstract com.google.firebase.installations.InstallationTokenResult.Builder toBuilder();
   }
 
   public abstract static class InstallationTokenResult.Builder {
     ctor public InstallationTokenResult.Builder();
     method @NonNull public abstract com.google.firebase.installations.InstallationTokenResult build();
     method @NonNull public abstract com.google.firebase.installations.InstallationTokenResult.Builder setToken(@NonNull String);
-    method @NonNull public abstract com.google.firebase.installations.InstallationTokenResult.Builder setTokenExpirationTimestampMillis(@NonNull long);
+    method @NonNull public abstract com.google.firebase.installations.InstallationTokenResult.Builder setTokenExpirationInSecs(long);
   }
 
 }

firebase-installations-interop/src/main/java/com/google/firebase/installations/FirebaseInstallationsApi.java

@@ -14,7 +14,11 @@
 
 package com.google.firebase.installations;
 
+import static java.lang.annotation.RetentionPolicy.SOURCE;
+
+import androidx.annotation.IntDef;
 import com.google.android.gms.tasks.Task;
+import java.lang.annotation.Retention;
 
 /**
  * This is an interface of {@code FirebaseInstallations} that is only exposed to 2p via component
@@ -24,14 +28,29 @@
  */
 public interface FirebaseInstallationsApi {
 
+  /** Specifies the options to get a FIS AuthToken. */
+  @IntDef({DO_NOT_FORCE_REFRESH, FORCE_REFRESH})
+  @Retention(SOURCE)
+  @interface AuthTokenOption {}
+  /**
+   * AuthToken is not refreshed until requested by the developer or if one doesn't exist, is expired
+   * or about to expire.
+   */
+  int DO_NOT_FORCE_REFRESH = 0;
+  /**
+   * AuthToken is forcefully refreshed on calling the {@link
+   * FirebaseInstallationsApi#getAuthToken(int)}.
+   */
+  int FORCE_REFRESH = 1;
+
   /**
    * Async function that returns a globally unique identifier of this Firebase app installation.
    * This is a url-safe base64 string of a 128-bit integer.
    */
   Task<String> getId();
 
   /** Async function that returns a auth token(public key) of this Firebase app installation. */
-  Task<InstallationTokenResult> getAuthToken(boolean forceRefresh);
+  Task<InstallationTokenResult> getAuthToken(@AuthTokenOption int authTokenOption);
 
   /**
    * Async function that deletes this Firebase app installation from Firebase backend. This call

firebase-installations-interop/src/main/java/com/google/firebase/installations/InstallationTokenResult.java

@@ -25,11 +25,10 @@ public abstract class InstallationTokenResult {
   @NonNull
   public abstract String getToken();
   /**
-   * The amount of time, in milliseconds, before the auth-token expires for this Firebase
-   * Installation.
+   * The amount of time, in seconds, before the auth-token expires for this Firebase Installation.
    */
   @NonNull
-  public abstract long getTokenExpirationTimestampMillis();
+  public abstract long getTokenExpirationInSecs();
 
   @NonNull
   public abstract Builder toBuilder();
@@ -46,7 +45,7 @@ public abstract static class Builder {
     public abstract Builder setToken(@NonNull String value);
 
     @NonNull
-    public abstract Builder setTokenExpirationTimestampMillis(@NonNull long value);
+    public abstract Builder setTokenExpirationInSecs(long value);
 
     @NonNull
     public abstract InstallationTokenResult build();

firebase-installations/api.txt

@@ -3,7 +3,7 @@ package com.google.firebase.installations {
 
   public class FirebaseInstallations {
     method @NonNull public Task<Void> delete();
-    method @NonNull public Task<InstallationTokenResult> getAuthToken(boolean);
+    method @NonNull public Task<InstallationTokenResult> getAuthToken(int);
     method @NonNull public Task<String> getId();
     method @NonNull public static com.google.firebase.installations.FirebaseInstallations getInstance();
     method @NonNull public static com.google.firebase.installations.FirebaseInstallations getInstance(@NonNull FirebaseApp);