firebase-admin
Version:
Firebase admin SDK for Node.js
269 lines (268 loc) • 11.6 kB
JavaScript
/*! firebase-admin v13.2.0 */
;
/*!
* Copyright 2018 Google Inc.
*
* 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.
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.ProjectManagementRequestHandler = void 0;
exports.assertServerResponse = assertServerResponse;
const api_request_1 = require("../utils/api-request");
const error_1 = require("../utils/error");
const index_1 = require("../utils/index");
const validator = require("../utils/validator");
/** Project management backend host and port. */
const PROJECT_MANAGEMENT_HOST_AND_PORT = 'firebase.googleapis.com:443';
/** Project management backend path. */
const PROJECT_MANAGEMENT_PATH = '/v1/';
/** Project management beta backend path. */
const PROJECT_MANAGEMENT_BETA_PATH = '/v1beta1/';
/** Project management request header. */
const PROJECT_MANAGEMENT_HEADERS = {
'X-Client-Version': `Node/Admin/${(0, index_1.getSdkVersion)()}`,
};
/** Project management request timeout duration in milliseconds. */
const PROJECT_MANAGEMENT_TIMEOUT_MILLIS = 10000;
const LIST_APPS_MAX_PAGE_SIZE = 100;
const CERT_TYPE_API_MAP = {
sha1: 'SHA_1',
sha256: 'SHA_256',
};
function assertServerResponse(condition, responseData, message) {
if (!condition) {
throw new error_1.FirebaseProjectManagementError('invalid-server-response', `${message} Response data: ${JSON.stringify(responseData, null, 2)}`);
}
}
/**
* Class that provides mechanism to send requests to the Firebase project management backend
* endpoints.
*
* @internal
*/
class ProjectManagementRequestHandler {
static wrapAndRethrowHttpError(errStatusCode, errText) {
let errorCode;
let errorMessage;
switch (errStatusCode) {
case 400:
errorCode = 'invalid-argument';
errorMessage = 'Invalid argument provided.';
break;
case 401:
case 403:
errorCode = 'authentication-error';
errorMessage = 'An error occurred when trying to authenticate. Make sure the credential '
+ 'used to authenticate this SDK has the proper permissions. See '
+ 'https://firebase.google.com/docs/admin/setup for setup instructions.';
break;
case 404:
errorCode = 'not-found';
errorMessage = 'The specified entity could not be found.';
break;
case 409:
errorCode = 'already-exists';
errorMessage = 'The specified entity already exists.';
break;
case 500:
errorCode = 'internal-error';
errorMessage = 'An internal error has occurred. Please retry the request.';
break;
case 503:
errorCode = 'service-unavailable';
errorMessage = 'The server could not process the request in time. See the error '
+ 'documentation for more details.';
break;
default:
errorCode = 'unknown-error';
errorMessage = 'An unknown server error was returned.';
}
if (!errText) {
errText = '<missing>';
}
throw new error_1.FirebaseProjectManagementError(errorCode, `${errorMessage} Status code: ${errStatusCode}. Raw server response: "${errText}".`);
}
/**
* @param app - The app used to fetch access tokens to sign API requests.
* @constructor
*/
constructor(app) {
this.baseUrl = `https://${PROJECT_MANAGEMENT_HOST_AND_PORT}${PROJECT_MANAGEMENT_PATH}`;
this.baseBetaUrl = `https://${PROJECT_MANAGEMENT_HOST_AND_PORT}${PROJECT_MANAGEMENT_BETA_PATH}`;
this.httpClient = new api_request_1.AuthorizedHttpClient(app);
}
/**
* @param parentResourceName - Fully-qualified resource name of the project whose Android
* apps you want to list.
*/
listAndroidApps(parentResourceName) {
return this.invokeRequestHandler('GET', `${parentResourceName}/androidApps?page_size=${LIST_APPS_MAX_PAGE_SIZE}`,
/* requestData */ null, 'v1beta1');
}
/**
* @param parentResourceName - Fully-qualified resource name of the project whose iOS apps
* you want to list.
*/
listIosApps(parentResourceName) {
return this.invokeRequestHandler('GET', `${parentResourceName}/iosApps?page_size=${LIST_APPS_MAX_PAGE_SIZE}`,
/* requestData */ null, 'v1beta1');
}
/**
* @param parentResourceName - Fully-qualified resource name of the project whose iOS apps
* you want to list.
*/
listAppMetadata(parentResourceName) {
return this.invokeRequestHandler('GET', `${parentResourceName}:searchApps?page_size=${LIST_APPS_MAX_PAGE_SIZE}`,
/* requestData */ null, 'v1beta1');
}
/**
* @param parentResourceName - Fully-qualified resource name of the project that you want
* to create the Android app within.
*/
createAndroidApp(parentResourceName, packageName, displayName) {
const requestData = {
packageName,
};
if (validator.isNonEmptyString(displayName)) {
requestData.displayName = displayName;
}
return this
.invokeRequestHandler('POST', `${parentResourceName}/androidApps`, requestData, 'v1beta1')
.then((responseData) => {
assertServerResponse(validator.isNonNullObject(responseData), responseData, 'createAndroidApp\'s responseData must be a non-null object.');
assertServerResponse(validator.isNonEmptyString(responseData.name), responseData, 'createAndroidApp\'s responseData.name must be a non-empty string.');
return this.pollRemoteOperationWithExponentialBackoff(responseData.name);
});
}
/**
* @param parentResourceName - Fully-qualified resource name of the project that you want
* to create the iOS app within.
*/
createIosApp(parentResourceName, bundleId, displayName) {
const requestData = {
bundleId,
};
if (validator.isNonEmptyString(displayName)) {
requestData.displayName = displayName;
}
return this
.invokeRequestHandler('POST', `${parentResourceName}/iosApps`, requestData, 'v1beta1')
.then((responseData) => {
assertServerResponse(validator.isNonNullObject(responseData), responseData, 'createIosApp\'s responseData must be a non-null object.');
assertServerResponse(validator.isNonEmptyString(responseData.name), responseData, 'createIosApp\'s responseData.name must be a non-empty string.');
return this.pollRemoteOperationWithExponentialBackoff(responseData.name);
});
}
/**
* @param resourceName - Fully-qualified resource name of the entity whose display name you
* want to set.
*/
setDisplayName(resourceName, newDisplayName) {
const requestData = {
displayName: newDisplayName,
};
return this
.invokeRequestHandler('PATCH', `${resourceName}?update_mask=display_name`, requestData, 'v1beta1')
.then(() => undefined);
}
/**
* @param parentResourceName - Fully-qualified resource name of the Android app whose SHA
* certificates you want to get.
*/
getAndroidShaCertificates(parentResourceName) {
return this.invokeRequestHandler('GET', `${parentResourceName}/sha`, /* requestData */ null, 'v1beta1');
}
/**
* @param parentResourceName - Fully-qualified resource name of the Android app that you
* want to add the given SHA certificate to.
*/
addAndroidShaCertificate(parentResourceName, certificate) {
const requestData = {
shaHash: certificate.shaHash,
certType: CERT_TYPE_API_MAP[certificate.certType],
};
return this
.invokeRequestHandler('POST', `${parentResourceName}/sha`, requestData, 'v1beta1')
.then(() => undefined);
}
/**
* @param parentResourceName - Fully-qualified resource name of the app whose config you
* want to get.
*/
getConfig(parentResourceName) {
return this.invokeRequestHandler('GET', `${parentResourceName}/config`, /* requestData */ null, 'v1beta1');
}
/**
* @param parentResourceName - Fully-qualified resource name of the entity that you want to
* get.
*/
getResource(parentResourceName) {
return this.invokeRequestHandler('GET', parentResourceName, /* requestData */ null, 'v1beta1');
}
/**
* @param resourceName - Fully-qualified resource name of the entity that you want to
* delete.
*/
deleteResource(resourceName) {
return this
.invokeRequestHandler('DELETE', resourceName, /* requestData */ null, 'v1beta1')
.then(() => undefined);
}
pollRemoteOperationWithExponentialBackoff(operationResourceName) {
const poller = new api_request_1.ExponentialBackoffPoller();
return poller.poll(() => {
return this.invokeRequestHandler('GET', operationResourceName, /* requestData */ null)
.then((responseData) => {
if (responseData.error) {
const errStatusCode = responseData.error.code || 500;
const errText = responseData.error.message || JSON.stringify(responseData.error);
ProjectManagementRequestHandler.wrapAndRethrowHttpError(errStatusCode, errText);
}
if (!responseData.done) {
// Continue polling.
return null;
}
// Polling complete. Resolve with operation response JSON.
return responseData.response;
});
});
}
/**
* Invokes the request handler with the provided request data.
*/
invokeRequestHandler(method, path, requestData, apiVersion = 'v1') {
const baseUrlToUse = (apiVersion === 'v1') ? this.baseUrl : this.baseBetaUrl;
const request = {
method,
url: `${baseUrlToUse}${path}`,
headers: PROJECT_MANAGEMENT_HEADERS,
data: requestData,
timeout: PROJECT_MANAGEMENT_TIMEOUT_MILLIS,
};
return this.httpClient.send(request)
.then((response) => {
// Send non-JSON responses to the catch() below, where they will be treated as errors.
if (!response.isJson()) {
throw new api_request_1.RequestResponseError(response);
}
return response.data;
})
.catch((err) => {
if (err instanceof api_request_1.RequestResponseError) {
ProjectManagementRequestHandler.wrapAndRethrowHttpError(err.response.status, err.response.text);
}
throw err;
});
}
}
exports.ProjectManagementRequestHandler = ProjectManagementRequestHandler;