Fis modularization (#3751)

* copied orginal FIS sdk into packages-expp and made unit tests passed

* migrated test app and fixed a test app bug to make it worked

* made installations-exp depend on app-exp

* Relocated public methods files into  folder

* Making installations mudularization step1, build success

* Making installations mudularization step2, unit tests pass

* update dependency version, merge master

* Apply suggestions from code review

Co-authored-by: Feiyang <[email protected]>

* update dependencies' version

* add getInstallation(app)

* correct deleteInstallations funciton name

* Place the call to registerVerion and registerInstallations at the same place

* remove dead code

* add api extractor config

* rewrite the internal interface

* fix build error

* Seperate internal interface from public interface.

* Change public methods to accept public interface

* Fixes and api extractor integration for @firebase/installations-exp (#3733)

* integrate api-extractor into installations-exp

* add release tag to APIs

* add _ prefix to the internal interface

* update api report

* add documentations to public apis

* refine public documentations

* refine public documentations

Co-authored-by: Feiyang <[email protected]>

Author: ChaoqunCHEN

common/api-review/installations-exp.api.md

@@ -7,22 +7,22 @@
 import { FirebaseApp } from '@firebase/app-types-exp';
 import { FirebaseInstallations } from '@firebase/installations-types-exp';
 
-// @public (undocumented)
+// @public
 export function deleteInstallations(installations: FirebaseInstallations): Promise<void>;
 
-// @public (undocumented)
+// @public
 export function getId(installations: FirebaseInstallations): Promise<string>;
 
-// @public (undocumented)
+// @public
 export function getInstallations(app: FirebaseApp): FirebaseInstallations;
 
-// @public (undocumented)
+// @public
 export function getToken(installations: FirebaseInstallations, forceRefresh?: boolean): Promise<string>;
 
-// @public (undocumented)
+// @public
 export type IdChangeCallbackFn = (installationId: string) => void;
 
-// @public (undocumented)
+// @public
 export type IdChangeUnsubscribeFn = () => void;
 
 // @public

packages-exp/installations-exp/src/api/delete-installations.ts

@@ -23,6 +23,8 @@ import { FirebaseInstallationsImpl } from '../interfaces/installation-impl';
 import { FirebaseInstallations } from '@firebase/installations-types-exp';
 
 /**
+ * Deletes the Firebase Installation and all associated data.
+ *
  * @public
  */
 export async function deleteInstallations(

packages-exp/installations-exp/src/api/get-id.ts

@@ -21,6 +21,9 @@ import { FirebaseInstallationsImpl } from '../interfaces/installation-impl';
 import { FirebaseInstallations } from '@firebase/installations-types-exp';
 
 /**
+ * Creates a Firebase Installation if there isn't one for the app and
+ * returns the Installation ID.
+ *
  * @public
  */
 export async function getId(

packages-exp/installations-exp/src/api/get-installations.ts

@@ -20,6 +20,8 @@ import { FirebaseInstallations } from '@firebase/installations-types-exp';
 import { _getProvider } from '@firebase/app-exp';
 
 /**
+ * Returns an instance of FirebaseInstallations associated with the given FirebaseApp instance.
+ *
  * @public
  */
 export function getInstallations(app: FirebaseApp): FirebaseInstallations {

packages-exp/installations-exp/src/api/get-token.ts

@@ -24,6 +24,8 @@ import {
 import { FirebaseInstallations } from '@firebase/installations-types-exp';
 
 /**
+ * Returns an Installation auth token, identifying the current Firebase Installation.
+ *
  * @public
  */
 export async function getToken(

packages-exp/installations-exp/src/api/on-id-change.ts

@@ -20,10 +20,14 @@ import { FirebaseInstallationsImpl } from '../interfaces/installation-impl';
 import { FirebaseInstallations } from '@firebase/installations-types-exp';
 
 /**
+ * An user defined callback function that gets called when Installations ID changes.
+ *
  * @public
  */
 export type IdChangeCallbackFn = (installationId: string) => void;
 /**
+ * Unsubscribe a callback function previously added via {@link #IdChangeCallbackFn}.
+ *
  * @public
  */
 export type IdChangeUnsubscribeFn = () => void;

packages-exp/installations-types-exp/index.d.ts

@@ -16,6 +16,8 @@
  */
 
 /**
+ * Public interface of the FirebaseInstallations SDK.
+ *
  * @public
  */
 export interface FirebaseInstallations {}

packages-exp/installations-types-exp/package.json

@@ -30,4 +30,4 @@
   "devDependencies": {
     "typescript": "4.0.2"
   }
-}
+}