Merged with master

Author: hiranya911

.gitignore

@@ -16,3 +16,5 @@ test/resources/apikey.txt
 
 # Release tarballs should not be checked in
 firebase-admin-*.tgz
+
+docgen/html/

.travis.yml

@@ -2,5 +2,3 @@ language: node_js
 node_js:
   - "10"
   - "8"
-  - "7"
-  - "6"

CHANGELOG.md

@@ -2,6 +2,24 @@
 
 -
 
+# v8.1.0
+
+- [added] `admin.projectManagement().listAppMetadata()` method to list the app summary of up to 100
+  apps in a Firebase project
+- [added] `admin.projectManagement().setDisplayName()` method to update the display name of a
+  Firebase project
+- [fixed] The SDK now automatically retries HTTP calls failing due to 503 errors.
+
+# v8.0.0
+
+- [changed] Dropped support for Node 6. Developers must use Node 8.13.0 or
+  higher.
+- [changed] Upgraded Cloud Firestore client to v2.0.0.
+
+# v7.4.0
+
+- [changed] Upgraded Cloud Firestore client to v1.3.0.
+
 # v7.3.0
 
 - [feature] Added the provider config management APIs for managing OIDC and SAML

CONTRIBUTING.md

@@ -85,6 +85,12 @@ information on using pull requests.
 
 ## <a name="local-setup"></a>Need to get set up locally?
 
+### Prerequisites
+
+1. Node.js 8.13.0 or higher.
+2. NPM 5 or higher (NPM 6 recommended).
+3. Google Cloud SDK ([`gcloud`](https://cloud.google.com/sdk/downloads) utility)
+
 ### Initial Setup
 
 Run the following commands from the command line to get your local environment set up:
@@ -95,9 +101,8 @@ $ cd firebase-admin-node    # go to the firebase-admin-node directory
 $ npm install               # install local npm build / test dependencies
 ```
 
-In order to run the tests, you also need to
-[download the `gcloud` CLI](https://cloud.google.com/sdk/downloads), run the following command, and
-follow the prompts:
+In order to run the tests, you also need to authorize the `gcloud` utility with
+Google application default credentials:
 
 ```bash
 $ gcloud beta auth application-default login
@@ -130,19 +135,31 @@ If you wish to skip the linter, and only run the unit tests:
 $ npm run test:unit
 ```
 
-The integration test suite requires a service account JSON key file, and an API key for a Firebase
-project. Create a new project in the [Firebase console](https://console.firebase.google.com) if
-you do not already have one. Use a separate, dedicated project for integration tests since the
-test suite makes a large number of writes to the Firebase realtime database. Download the service
-account key file from the "Settings > Service Accounts" page of the project, and copy it to
-`test/resources/key.json`. Also obtain the API key for the same project from "Settings > General",
-and save it to `test/resources/apikey.txt`.
-
-Some Auth integration tests require that you enable the IAM API for your Firebase/GCP project,
-and grant your service account ID the "Service Account Token Creator" role. These must be done
-via the Google Cloud Console. Refer to the
-[troubleshooting instructions](https://firebase.google.com/docs/auth/admin/create-custom-tokens#troubleshooting)
-in the official documentation for more details on how to achieve this.
+The integration tests run against an actual Firebase project. Create a new
+project in the [Firebase Console](https://console.firebase.google.com), if you
+do not already have one suitable for running the tests against. Then obtain the
+following credentials from the project:
+
+1. *Service account certificate*: This can be downloaded as a JSON file from
+   the "Settings > Service Accounts" tab of the Firebase console. Copy the
+   file into the repo so it's available at `test/resources/key.json`.
+2. *Web API key*: This is displayed in the "Settings > General" tab of the
+   console. Copy it and save to a new text file at `test/resources/apikey.txt`.
+
+Then set up your Firebase/GCP project as follows:
+
+1. Enable Firestore: Go to the Firebase Console, and select "Database" from
+   the "Develop" menu. Click on the "Create database" button. You may choose
+   to set up Firestore either in the locked mode or in the test mode.
+2. Enable password auth: Select "Authentication" from the "Develop" menu in
+   Firebase Console. Select the "Sign-in method" tab, and enable the
+   "Email/Password" sign-in method.
+3. Enable the IAM API: Go to the
+   [Google Cloud Platform Console](https://console.cloud.google.com) and make
+   sure your Firebase/GCP project is selected. Select "APIs & Services >
+   Dashboard" from the main menu, and click the "ENABLE APIS AND SERVICES"
+   button. Search for and enable the "Identity and Access Management (IAM)
+   API".
 
 Finally, to run the integration test suite:
 

README.md

@@ -55,9 +55,7 @@ requests, code review feedback, and also pull requests.
 
 ## Supported Environments
 
-We support Node.js 6 and higher. However, we recommend developers to use
-at least Node.js 8. Support for Node.js 6 is currently deprecated and
-will be discontinued in the future.
+We support Node.js 8.13.0 and higher.
 
 Please also note that the Admin SDK should only
 be used in server-side/back-end environments controlled by the app developer.

docgen/content-sources/node/HOME.md

@@ -0,0 +1,9 @@
+# Firebase Admin Node.js SDK Reference
+
+The Admin SDK lets you interact with Firebase from privileged environments.
+You can install it via our [npm package](https://www.npmjs.com/package/firebase-admin).
+
+To get started using the Firebase Admin Node.js SDK, see
+[Add the Firebase Admin SDK to your server](https://firebase.google.com/docs/admin/setup).
+
+For source code, see the [Firebase Admin Node.js SDK GitHub repo](https://github.com/firebase/firebase-admin-node).

docgen/content-sources/node/toc.yaml

@@ -0,0 +1,183 @@
+toc:
+- title: "admin"
+  path: /docs/reference/admin/node/admin
+  section:
+  - title: "AppOptions"
+    path: /docs/reference/admin/node/admin.AppOptions
+  - title: "FirebaseArrayIndexError"
+    path: /docs/reference/admin/node/admin.FirebaseArrayIndexError
+  - title: "FirebaseError"
+    path: /docs/reference/admin/node/admin.FirebaseError
+  - title: "GoogleOAuthAccessToken"
+    path: /docs/reference/admin/node/admin.GoogleOAuthAccessToken
+  - title: "ServiceAccount"
+    path: /docs/reference/admin/node/admin.ServiceAccount
+
+- title: "admin.app"
+  path: /docs/reference/admin/node/admin.app
+  section:
+  - title: "App"
+    path: /docs/reference/admin/node/admin.app.App
+
+- title: "admin.auth"
+  path: /docs/reference/admin/node/admin.auth
+  section:
+  - title: "Auth"
+    path: /docs/reference/admin/node/admin.auth.Auth
+  - title: "ActionCodeSettings"
+    path: /docs/reference/admin/node/admin.auth.ActionCodeSettings
+  - title: "AuthProviderConfig"
+    path: /docs/reference/admin/node/admin.auth.AuthProviderConfig
+  - title: "AuthProviderConfigFilter"
+    path: /docs/reference/admin/node/admin.auth.AuthProviderConfigFilter
+  - title: "CreateRequest"
+    path: /docs/reference/admin/node/admin.auth.CreateRequest
+  - title: "ListProviderConfigResults"
+    path: /docs/reference/admin/node/admin.auth.ListProviderConfigResults
+  - title: "OIDCAuthProviderConfig"
+    path: /docs/reference/admin/node/admin.auth.OIDCAuthProviderConfig
+  - title: "OIDCUpdateAuthProviderRequest"
+    path: /docs/reference/admin/node/admin.auth.OIDCUpdateAuthProviderRequest
+  - title: "SAMLAuthProviderConfig"
+    path: /docs/reference/admin/node/admin.auth.SAMLAuthProviderConfig
+  - title: "SAMLUpdateAuthProviderRequest"
+    path: /docs/reference/admin/node/admin.auth.SAMLUpdateAuthProviderRequest
+  - title: "UpdateRequest"
+    path: /docs/reference/admin/node/admin.auth.UpdateRequest
+  - title: "UserImportOptions"
+    path: /docs/reference/admin/node/admin.auth.UserImportOptions
+  - title: "UserImportRecord"
+    path: /docs/reference/admin/node/admin.auth.UserImportRecord
+  - title: "UserImportResult"
+    path: /docs/reference/admin/node/admin.auth.UserImportResult
+  - title: "DecodedIdToken"
+    path: /docs/reference/admin/node/admin.auth.DecodedIdToken
+  - title: "UserInfo"
+    path: /docs/reference/admin/node/admin.auth.UserInfo
+  - title: "UserMetadata"
+    path: /docs/reference/admin/node/admin.auth.UserMetadata
+  - title: "UserRecord"
+    path: /docs/reference/admin/node/admin.auth.UserRecord
+  - title: "SessionCookieOptions"
+    path: /docs/reference/admin/node/admin.auth.SessionCookieOptions
+  - title: "BaseAuth"
+    path: /docs/reference/admin/node/admin.auth.BaseAuth
+  - title: "ListUsersResult"
+    path: /docs/reference/admin/node/admin.auth.ListUsersResult
+
+- title: "admin.credential"
+  path: /docs/reference/admin/node/admin.credential
+  section:
+  - title: "Credential"
+    path: /docs/reference/admin/node/admin.credential.Credential
+
+- title: "admin.database"
+  path: /docs/reference/admin/node/admin.database
+  section:
+  - title: "Database"
+    path: /docs/reference/admin/node/admin.database.Database
+  - title: "DataSnapshot"
+    path: /docs/reference/admin/node/admin.database.DataSnapshot
+  - title: "OnDisconnect"
+    path: /docs/reference/admin/node/admin.database.OnDisconnect
+  - title: "Query"
+    path: /docs/reference/admin/node/admin.database.Query
+  - title: "Reference"
+    path: /docs/reference/admin/node/admin.database.Reference
+  - title: "ServerValue"
+    path: /docs/reference/admin/node/admin.database.ServerValue
+  - title: "ThenableReference"
+    path: /docs/reference/admin/node/admin.database.ThenableReference
+
+- title: "admin.firestore"
+  path: /docs/reference/admin/node/admin.firestore
+
+- title: "admin.instanceId"
+  path: /docs/reference/admin/node/admin.instanceId
+  section:
+  - title: "InstanceId"
+    path: /docs/reference/admin/node/admin.instanceId.InstanceId
+
+- title: "admin.messaging"
+  path: /docs/reference/admin/node/admin.messaging
+  section:
+  - title: "TopicMessage"
+    path: /docs/reference/admin/node/TopicMessage
+  - title: "TokenMessage"
+    path: /docs/reference/admin/node/TokenMessage
+  - title: "ConditionMessage"
+    path: /docs/reference/admin/node/ConditionMessage
+  - title: "AndroidConfig"
+    path: /docs/reference/admin/node/admin.messaging.AndroidConfig
+  - title: "AndroidNotification"
+    path: /docs/reference/admin/node/admin.messaging.AndroidNotification
+  - title: "Messaging"
+    path: /docs/reference/admin/node/admin.messaging.Messaging
+  - title: "MessagingConditionResponse"
+    path: /docs/reference/admin/node/admin.messaging.MessagingConditionResponse
+  - title: "MessagingDeviceGroupResponse"
+    path: /docs/reference/admin/node/admin.messaging.MessagingDeviceGroupResponse
+  - title: "MessagingDeviceResult"
+    path: /docs/reference/admin/node/admin.messaging.MessagingDeviceResult
+  - title: "MessagingDevicesResponse"
+    path: /docs/reference/admin/node/admin.messaging.MessagingDevicesResponse
+  - title: "MessagingOptions"
+    path: /docs/reference/admin/node/admin.messaging.MessagingOptions
+  - title: "MessagingPayload"
+    path: /docs/reference/admin/node/admin.messaging.MessagingPayload
+  - title: "MessagingTopicResponse"
+    path: /docs/reference/admin/node/admin.messaging.MessagingTopicResponse
+  - title: "MessagingTopicManagementResponse"
+    path: /docs/reference/admin/node/admin.messaging.MessagingTopicManagementResponse
+  - title: "NotificationMessagePayload"
+    path: /docs/reference/admin/node/admin.messaging.NotificationMessagePayload
+  - title: "MulticastMessage"
+    path: /docs/reference/admin/node/admin.messaging.MulticastMessage
+  - title: "WebpushNotification"
+    path: /docs/reference/admin/node/admin.messaging.WebpushNotification
+  - title: "WebpushFcmOptions"
+    path: /docs/reference/admin/node/admin.messaging.WebpushFcmOptions
+  - title: "DataMessagePayload"
+    path: /docs/reference/admin/node/admin.messaging.DataMessagePayload
+  - title: "BatchResponse"
+    path: /docs/reference/admin/node/admin.messaging.BatchResponse
+  - title: "SendResponse"
+    path: /docs/reference/admin/node/admin.messaging.SendResponse
+  - title: "ApnsConfig"
+    path: /docs/reference/admin/node/admin.messaging.ApnsConfig
+  - title: "ApnsPayload"
+    path: /docs/reference/admin/node/admin.messaging.ApnsPayload
+  - title: "Aps"
+    path: /docs/reference/admin/node/admin.messaging.Aps
+  - title: "ApsAlert"
+    path: /docs/reference/admin/node/admin.messaging.ApsAlert
+  - title: "CriticalSound"
+    path: /docs/reference/admin/node/admin.messaging.CriticalSound
+  - title: "Notification"
+    path: /docs/reference/admin/node/admin.messaging.Notification
+  - title: "WebpushConfig"
+    path: /docs/reference/admin/node/admin.messaging.WebpushConfig
+
+- title: "admin.projectManagement"
+  path: /docs/reference/admin/node/admin.projectManagement
+  section:
+  - title: "AndroidApp"
+    path: /docs/reference/admin/node/admin.projectManagement.AndroidApp
+  - title: "AndroidAppMetadata"
+    path: /docs/reference/admin/node/admin.projectManagement.AndroidAppMetadata
+  - title: "AppMetadata"
+    path: /docs/reference/admin/node/admin.projectManagement.AppMetadata
+  - title: "IosApp"
+    path: /docs/reference/admin/node/admin.projectManagement.IosApp
+  - title: "IosAppMetadata"
+    path: /docs/reference/admin/node/admin.projectManagement.IosAppMetadata
+  - title: "ProjectManagement"
+    path: /docs/reference/admin/node/admin.projectManagement.ProjectManagement
+  - title: "ShaCertificate"
+    path: /docs/reference/admin/node/admin.projectManagement.ShaCertificate
+
+- title: "admin.storage"
+  path: /docs/reference/admin/node/admin.storage
+  section:
+  - title: "Storage"
+    path: /docs/reference/admin/node/admin.storage.Storage