rewrite the internal interface

Author: ChaoqunCHEN

packages-exp/installations-exp/src/functions/config.ts

@@ -17,28 +17,43 @@
 
 import { _registerComponent } from '@firebase/app-exp';
 import { _FirebaseService } from '@firebase/app-types-exp';
-import { Component, ComponentType } from '@firebase/component';
-import { getInstallations, deleteInstallations } from '../api/index';
+import {
+  Component,
+  ComponentType,
+  InstanceFactory,
+  ComponentContainer
+} from '@firebase/component';
+import {
+  getInstallations,
+  deleteInstallations,
+  getId,
+  getToken,
+  onIdChange
+} from '../api/index';
+import { FirebaseInstallationsInternal } from '../interfaces/installation-internal';
 
-export function registerInstallations(): void {
-  const installationsName = 'installations-exp';
+const installationsName = 'installations-exp';
 
-  _registerComponent(
-    new Component(
-      installationsName,
-      container => {
-        const app = container.getProvider('app-exp').getImmediate();
+const factory: InstanceFactory<'installations-exp'> = (
+  container: ComponentContainer
+) => {
+  const app = container.getProvider('app-exp').getImmediate();
 
-        // Throws if app isn't configured properly.
-        const installations = getInstallations(app);
-        const installationsService: _FirebaseService = {
-          app,
-          delete: () => deleteInstallations(installations)
-        };
+  // Throws if app isn't configured properly.
+  const installations = getInstallations(app);
+  const installationsService: FirebaseInstallationsInternal = {
+    app,
+    getId: () => getId(installations),
+    getToken: (forceRefresh?: boolean) => getToken(installations, forceRefresh),
+    delete: () => deleteInstallations(installations),
+    onIdChange: (callback: (fid: string) => void) =>
+      onIdChange(installations, callback)
+  };
+  return installationsService;
+};
 
-        return installationsService;
-      },
-      ComponentType.PUBLIC
-    )
+export function registerInstallations(): void {
+  _registerComponent(
+    new Component(installationsName, factory, ComponentType.PUBLIC)
   );
 }

packages-exp/installations-exp/src/interfaces/installation-internal.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { _FirebaseService, FirebaseApp } from '@firebase/app-types-exp';
+
+/**
+ * An interface for Firebase internal SDKs use only.
+ */
+export interface FirebaseInstallationsInternal extends _FirebaseService {
+  /**
+   * FirebaseApp instance which carries Firebase app configurations.
+   */
+  app: FirebaseApp;
+
+  /**
+   * Creates a Firebase Installation if there isn't one for the app and
+   * returns the Installation ID.
+   */
+  getId(): Promise<string>;
+
+  /**
+   * Returns an Authentication Token for the current Firebase Installation.
+   */
+  getToken(forceRefresh?: boolean): Promise<string>;
+
+  /**
+   * Deletes the Firebase Installation and all associated data.
+   */
+  delete(): Promise<void>;
+
+  /**
+   * Sets a new callback that will get called when Installlation ID changes.
+   * Returns an unsubscribe function that will remove the callback when called.
+   */
+  onIdChange(callback: (installationId: string) => void): () => void;
+}

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

@@ -16,7 +16,7 @@
  */
 
 import { Provider } from '@firebase/component';
-import { _FirebaseService } from '@firebase/app-types-exp';
+import { FirebaseInstallationsInternal } from '../installations-exp/src/interfaces/installation-internal';
 
 export interface FirebaseInstallations {
   /**
@@ -52,6 +52,6 @@ export type FirebaseInstallationsName = 'installations-exp';
 
 declare module '@firebase/component' {
   interface NameServiceMapping {
-    'installations-exp': _FirebaseService;
+    'installations-exp': FirebaseInstallationsInternal;
   }
 }