Initial commit

2021-12-29 01:57:42 -08:00
commit ce39a60b42
4634 changed files with 997667 additions and 0 deletions
@@ -0,0 +1,52 @@
+/*! firebase-admin v10.0.1 */
+/*!
+ * Copyright 2021 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.
+ */
+/**
+ * Firebase Instance ID service.
+ *
+ * @packageDocumentation
+ */
+import { App } from '../app/index';
+import { Installations } from './installations';
+export { Installations };
+/**
+  * Gets the {@link Installations} service for the default app or a given app.
+  *
+  * `getInstallations()` can be called with no arguments to access the default
+  * app's `Installations` service or as `getInstallations(app)` to access the
+  * `Installations` service associated with a specific app.
+  *
+  * @example
+  * ```javascript
+  * // Get the Installations service for the default app
+  * const defaultInstallations = getInstallations();
+  * ```
+  *
+  * @example
+  * ```javascript
+  * // Get the Installations service for a given app
+  * const otherInstallations = getInstallations(otherApp);
+  *```
+  *
+  * @param app - Optional app whose `Installations` service to
+  *   return. If not provided, the default `Installations` service will be
+  *   returned.
+  *
+  * @returns The default `Installations` service if
+  *   no app is provided or the `Installations` service associated with the
+  *   provided app.
+  */
+export declare function getInstallations(app?: App): Installations;
@@ -0,0 +1,62 @@
+/*! firebase-admin v10.0.1 */
+"use strict";
+/*!
+ * Copyright 2021 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.getInstallations = exports.Installations = void 0;
+/**
+ * Firebase Instance ID service.
+ *
+ * @packageDocumentation
+ */
+var index_1 = require("../app/index");
+var installations_1 = require("./installations");
+Object.defineProperty(exports, "Installations", { enumerable: true, get: function () { return installations_1.Installations; } });
+/**
+  * Gets the {@link Installations} service for the default app or a given app.
+  *
+  * `getInstallations()` can be called with no arguments to access the default
+  * app's `Installations` service or as `getInstallations(app)` to access the
+  * `Installations` service associated with a specific app.
+  *
+  * @example
+  * ```javascript
+  * // Get the Installations service for the default app
+  * const defaultInstallations = getInstallations();
+  * ```
+  *
+  * @example
+  * ```javascript
+  * // Get the Installations service for a given app
+  * const otherInstallations = getInstallations(otherApp);
+  *```
+  *
+  * @param app - Optional app whose `Installations` service to
+  *   return. If not provided, the default `Installations` service will be
+  *   returned.
+  *
+  * @returns The default `Installations` service if
+  *   no app is provided or the `Installations` service associated with the
+  *   provided app.
+  */
+function getInstallations(app) {
+    if (typeof app === 'undefined') {
+        app = index_1.getApp();
+    }
+    var firebaseApp = app;
+    return firebaseApp.getOrInitService('installations', function (app) { return new installations_1.Installations(app); });
+}
+exports.getInstallations = getInstallations;
@@ -0,0 +1,55 @@
+/*! firebase-admin v10.0.1 */
+/*!
+ * Copyright 2021 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.
+ */
+import { App } from '../app/index';
+import { Installations as TInstallations } from './installations';
+/**
+ * Gets the {@link firebase-admin.installations#Installations} service for the
+ * default app or a given app.
+ *
+ * `admin.installations()` can be called with no arguments to access the default
+ * app's {@link firebase-admin.installations#Installations} service or as
+ * `admin.installations(app)` to access the
+ * {@link firebase-admin.installations#Installations} service associated with a
+ * specific app.
+ *
+ * @example
+ * ```javascript
+ * // Get the Installations service for the default app
+ * var defaultInstallations = admin.installations();
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // Get the Installations service for a given app
+ * var otherInstallations = admin.installations(otherApp);
+ *```
+ *
+ * @param app - Optional app whose `Installations` service to
+ *   return. If not provided, the default `Installations` service is
+ *   returned.
+ *
+ * @returns The default `Installations` service if
+ *   no app is provided or the `Installations` service associated with the
+ *   provided app.
+ */
+export declare function installations(app?: App): installations.Installations;
+export declare namespace installations {
+    /**
+     * Type alias to {@link firebase-admin.installations#Installations}.
+     */
+    type Installations = TInstallations;
+}
@@ -0,0 +1,18 @@
+/*! firebase-admin v10.0.1 */
+"use strict";
+/*!
+ * Copyright 2021 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 });
@@ -0,0 +1,43 @@
+/*! firebase-admin v10.0.1 */
+/*!
+ * @license
+ * Copyright 2021 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.
+ */
+import { App } from '../app/index';
+/**
+ * Class that provides mechanism to send requests to the FIS backend endpoints.
+ */
+export declare class FirebaseInstallationsRequestHandler {
+    private readonly app;
+    private readonly host;
+    private readonly timeout;
+    private readonly httpClient;
+    private path;
+    /**
+     * @param app - The app used to fetch access tokens to sign API requests.
+     *
+     * @constructor
+     */
+    constructor(app: App);
+    deleteInstallation(fid: string): Promise<void>;
+    /**
+     * Invokes the request handler based on the API settings object passed.
+     *
+     * @param apiSettings - The API endpoint settings to apply to request and response.
+     * @returns A promise that resolves when the request is complete.
+     */
+    private invokeRequestHandler;
+    private getPathPrefix;
+}
@@ -0,0 +1,117 @@
+/*! firebase-admin v10.0.1 */
+"use strict";
+/*!
+ * @license
+ * Copyright 2021 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.FirebaseInstallationsRequestHandler = void 0;
+var error_1 = require("../utils/error");
+var api_request_1 = require("../utils/api-request");
+var utils = require("../utils/index");
+var validator = require("../utils/validator");
+/** Firebase IID backend host. */
+var FIREBASE_IID_HOST = 'console.firebase.google.com';
+/** Firebase IID backend path. */
+var FIREBASE_IID_PATH = '/v1/';
+/** Firebase IID request timeout duration in milliseconds. */
+var FIREBASE_IID_TIMEOUT = 10000;
+/** HTTP error codes raised by the backend server. */
+var ERROR_CODES = {
+    400: 'Malformed installation ID argument.',
+    401: 'Request not authorized.',
+    403: 'Project does not match installation ID or the client does not have sufficient privileges.',
+    404: 'Failed to find the installation ID.',
+    409: 'Already deleted.',
+    429: 'Request throttled out by the backend server.',
+    500: 'Internal server error.',
+    503: 'Backend servers are over capacity. Try again later.',
+};
+/**
+ * Class that provides mechanism to send requests to the FIS backend endpoints.
+ */
+var FirebaseInstallationsRequestHandler = /** @class */ (function () {
+    /**
+     * @param app - The app used to fetch access tokens to sign API requests.
+     *
+     * @constructor
+     */
+    function FirebaseInstallationsRequestHandler(app) {
+        this.app = app;
+        this.host = FIREBASE_IID_HOST;
+        this.timeout = FIREBASE_IID_TIMEOUT;
+        this.httpClient = new api_request_1.AuthorizedHttpClient(app);
+    }
+    FirebaseInstallationsRequestHandler.prototype.deleteInstallation = function (fid) {
+        if (!validator.isNonEmptyString(fid)) {
+            return Promise.reject(new error_1.FirebaseInstallationsError(error_1.InstallationsClientErrorCode.INVALID_INSTALLATION_ID, 'Installation ID must be a non-empty string.'));
+        }
+        return this.invokeRequestHandler(new api_request_1.ApiSettings(fid, 'DELETE'));
+    };
+    /**
+     * Invokes the request handler based on the API settings object passed.
+     *
+     * @param apiSettings - The API endpoint settings to apply to request and response.
+     * @returns A promise that resolves when the request is complete.
+     */
+    FirebaseInstallationsRequestHandler.prototype.invokeRequestHandler = function (apiSettings) {
+        var _this = this;
+        return this.getPathPrefix()
+            .then(function (path) {
+            var req = {
+                url: "https://" + _this.host + path + apiSettings.getEndpoint(),
+                method: apiSettings.getHttpMethod(),
+                timeout: _this.timeout,
+            };
+            return _this.httpClient.send(req);
+        })
+            .then(function () {
+            // return nothing on success
+        })
+            .catch(function (err) {
+            if (err instanceof api_request_1.HttpError) {
+                var response = err.response;
+                var errorMessage = (response.isJson() && 'error' in response.data) ?
+                    response.data.error : response.text;
+                var template = ERROR_CODES[response.status];
+                var message = template ?
+                    "Installation ID \"" + apiSettings.getEndpoint() + "\": " + template : errorMessage;
+                throw new error_1.FirebaseInstallationsError(error_1.InstallationsClientErrorCode.API_ERROR, message);
+            }
+            // In case of timeouts and other network errors, the HttpClient returns a
+            // FirebaseError wrapped in the response. Simply throw it here.
+            throw err;
+        });
+    };
+    FirebaseInstallationsRequestHandler.prototype.getPathPrefix = function () {
+        var _this = this;
+        if (this.path) {
+            return Promise.resolve(this.path);
+        }
+        return utils.findProjectId(this.app)
+            .then(function (projectId) {
+            if (!validator.isNonEmptyString(projectId)) {
+                // Assert for an explicit projct ID (either via AppOptions or the cert itself).
+                throw new error_1.FirebaseInstallationsError(error_1.InstallationsClientErrorCode.INVALID_PROJECT_ID, 'Failed to determine project ID for Installations. Initialize the '
+                    + 'SDK with service account credentials or set project ID as an app option. '
+                    + 'Alternatively set the GOOGLE_CLOUD_PROJECT environment variable.');
+            }
+            _this.path = FIREBASE_IID_PATH + ("project/" + projectId + "/instanceId/");
+            return _this.path;
+        });
+    };
+    return FirebaseInstallationsRequestHandler;
+}());
+exports.FirebaseInstallationsRequestHandler = FirebaseInstallationsRequestHandler;
@@ -0,0 +1,38 @@
+/*! firebase-admin v10.0.1 */
+/*!
+ * Copyright 2021 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.
+ */
+import { App } from '../app/index';
+/**
+ * The `Installations` service for the current app.
+ */
+export declare class Installations {
+    private app_;
+    private requestHandler;
+    /**
+     * Deletes the specified installation ID and the associated data from Firebase.
+     *
+     * @param fid - The Firebase installation ID to be deleted.
+     *
+     * @returns A promise fulfilled when the installation ID is deleted.
+     */
+    deleteInstallation(fid: string): Promise<void>;
+    /**
+     * Returns the app associated with this Installations instance.
+     *
+     * @returns The app associated with this Installations instance.
+     */
+    get app(): App;
+}
@@ -0,0 +1,63 @@
+/*! firebase-admin v10.0.1 */
+"use strict";
+/*!
+ * Copyright 2021 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.Installations = void 0;
+var error_1 = require("../utils/error");
+var installations_request_handler_1 = require("./installations-request-handler");
+var validator = require("../utils/validator");
+/**
+ * The `Installations` service for the current app.
+ */
+var Installations = /** @class */ (function () {
+    /**
+     * @param app - The app for this Installations service.
+     * @constructor
+     * @internal
+     */
+    function Installations(app) {
+        if (!validator.isNonNullObject(app) || !('options' in app)) {
+            throw new error_1.FirebaseInstallationsError(error_1.InstallationsClientErrorCode.INVALID_ARGUMENT, 'First argument passed to admin.installations() must be a valid Firebase app instance.');
+        }
+        this.app_ = app;
+        this.requestHandler = new installations_request_handler_1.FirebaseInstallationsRequestHandler(app);
+    }
+    /**
+     * Deletes the specified installation ID and the associated data from Firebase.
+     *
+     * @param fid - The Firebase installation ID to be deleted.
+     *
+     * @returns A promise fulfilled when the installation ID is deleted.
+     */
+    Installations.prototype.deleteInstallation = function (fid) {
+        return this.requestHandler.deleteInstallation(fid);
+    };
+    Object.defineProperty(Installations.prototype, "app", {
+        /**
+         * Returns the app associated with this Installations instance.
+         *
+         * @returns The app associated with this Installations instance.
+         */
+        get: function () {
+            return this.app_;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    return Installations;
+}());
+exports.Installations = Installations;