firebase-admin 11.9.0 → 11.10.1

package/lib/project-management/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/project-management/ios-app.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/ios-app.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/project-management/project-management-api-request-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/project-management-api-request-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/project-management/project-management-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/project-management/project-management-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/project-management/project-management.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/project-management.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/remote-config/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/remote-config/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/remote-config/remote-config-api-client-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/remote-config/remote-config-api-client-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/remote-config/remote-config-api.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/remote-config/remote-config-api.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/remote-config/remote-config-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/remote-config/remote-config-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/remote-config/remote-config.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/remote-config/remote-config.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/security-rules/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/security-rules/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/security-rules/security-rules-api-client-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/security-rules/security-rules-api-client-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/security-rules/security-rules-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/security-rules/security-rules-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/security-rules/security-rules-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/security-rules/security-rules-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/security-rules/security-rules.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/security-rules/security-rules.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/storage/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2020 Google Inc.
  *
@@ -19,6 +19,7 @@
  *
  * @packageDocumentation
  */
+import { File } from '@google-cloud/storage';
 import { App } from '../app';
 import { Storage } from './storage';
 export { Storage } from './storage';
@@ -42,3 +43,15 @@ export { Storage } from './storage';
  * ```
  */
 export declare function getStorage(app?: App): Storage;
+/**
+ * Gets the download URL for the given {@link https://cloud.google.com/nodejs/docs/reference/storage/latest/storage/file | File}.
+ *
+ * @example
+ * ```javascript
+ * // Get the downloadUrl for a given file ref
+ * const storage = getStorage();
+ * const myRef = ref(storage, 'images/mountains.jpg');
+ * const downloadUrl = await getDownloadURL(myRef);
+ * ```
+ */
+export declare function getDownloadURL(file: File): Promise<string>;

package/lib/storage/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.
@@ -16,14 +16,11 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getStorage = exports.Storage = void 0;
-/**
- * Cloud Storage for Firebase.
- *
- * @packageDocumentation
- */
+exports.getDownloadURL = exports.getStorage = exports.Storage = void 0;
 const app_1 = require("../app");
 const storage_1 = require("./storage");
+const error_1 = require("../utils/error");
+const utils_1 = require("./utils");
 var storage_2 = require("./storage");
 Object.defineProperty(exports, "Storage", { enumerable: true, get: function () { return storage_2.Storage; } });
 /**
@@ -53,3 +50,28 @@ function getStorage(app) {
     return firebaseApp.getOrInitService('storage', (app) => new storage_1.Storage(app));
 }
 exports.getStorage = getStorage;
+/**
+ * Gets the download URL for the given {@link https://cloud.google.com/nodejs/docs/reference/storage/latest/storage/file | File}.
+ *
+ * @example
+ * ```javascript
+ * // Get the downloadUrl for a given file ref
+ * const storage = getStorage();
+ * const myRef = ref(storage, 'images/mountains.jpg');
+ * const downloadUrl = await getDownloadURL(myRef);
+ * ```
+ */
+async function getDownloadURL(file) {
+    const endpoint = (process.env.STORAGE_EMULATOR_HOST ||
+        'https://firebasestorage.googleapis.com') + '/v0';
+    const { downloadTokens } = await (0, utils_1.getFirebaseMetadata)(endpoint, file);
+    if (!downloadTokens) {
+        throw new error_1.FirebaseError({
+            code: 'storage/no-download-token',
+            message: 'No download token available. Please create one in the Firebase Console.',
+        });
+    }
+    const [token] = downloadTokens.split(',');
+    return `${endpoint}/b/${file.bucket.name}/o/${encodeURIComponent(file.name)}?alt=media&token=${token}`;
+}
+exports.getDownloadURL = getDownloadURL;

package/lib/storage/storage-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/storage/storage-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/storage/storage.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/storage/storage.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * @license

package/lib/storage/utils.d.ts

@@ -0,0 +1,20 @@
+/*! firebase-admin v11.10.1 */
+import { File } from '@google-cloud/storage';
+export interface FirebaseMetadata {
+    name: string;
+    bucket: string;
+    generation: string;
+    metageneration: string;
+    contentType: string;
+    timeCreated: string;
+    updated: string;
+    storageClass: string;
+    size: string;
+    md5Hash: string;
+    contentEncoding: string;
+    contentDisposition: string;
+    crc32c: string;
+    etag: string;
+    downloadTokens?: string;
+}
+export declare function getFirebaseMetadata(endpoint: string, file: File): Promise<FirebaseMetadata>;

package/lib/storage/utils.js

@@ -0,0 +1,21 @@
+/*! firebase-admin v11.10.1 */
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFirebaseMetadata = void 0;
+function getFirebaseMetadata(endpoint, file) {
+    const uri = `${endpoint}/b/${file.bucket.name}/o/${encodeURIComponent(file.name)}`;
+    return new Promise((resolve, reject) => {
+        file.storage.makeAuthenticatedRequest({
+            method: 'GET',
+            uri,
+        }, (err, body) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(body);
+            }
+        });
+    });
+}
+exports.getFirebaseMetadata = getFirebaseMetadata;

package/lib/utils/api-request.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/utils/api-request.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * @license
@@ -347,14 +347,6 @@ class AsyncHttpCall {
         if (timeout) {
             // Listen to timeouts and throw an error.
             req.setTimeout(timeout, timeoutCallback);
-            req.on('socket', (socket) => {
-                socket.setMaxListeners(socket.getMaxListeners() + 1);
-                socket.setTimeout(timeout, timeoutCallback);
-                socket.on('end', () => {
-                    socket.setTimeout(0);
-                    socket.setMaxListeners(Math.max(socket.getMaxListeners() - 1, 0));
-                });
-            });
         }
         // Send the request
         req.end(this.entity);

package/lib/utils/crypto-signer.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * @license
  * Copyright 2021 Google Inc.

package/lib/utils/crypto-signer.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * @license

package/lib/utils/deep-copy.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/utils/deep-copy.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * @license

package/lib/utils/error.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/utils/error.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * @license

package/lib/utils/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/utils/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * @license

package/lib/utils/jwt.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/utils/jwt.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/utils/validator.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.
@@ -142,3 +142,11 @@ export declare function isURL(urlStr: any): boolean;
  * @returns Whether the provided topic is a valid FCM topic name.
  */
 export declare function isTopic(topic: any): boolean;
+/**
+ * Validates that the provided string can be used as a task ID
+ * for Cloud Tasks.
+ *
+ * @param taskId - the task ID to validate.
+ * @returns Whether the provided task ID is valid.
+ */
+export declare function isTaskId(taskId: any): boolean;

package/lib/utils/validator.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v11.9.0 */
+/*! firebase-admin v11.10.1 */
 "use strict";
 /*!
  * @license
@@ -17,7 +17,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isTopic = exports.isURL = exports.isUTCDateString = exports.isISODateString = exports.isPhoneNumber = exports.isEmail = exports.isPassword = exports.isUid = exports.isNonNullObject = exports.isObject = exports.isNonEmptyString = exports.isBase64String = exports.isString = exports.isNumber = exports.isBoolean = exports.isNonEmptyArray = exports.isArray = exports.isBuffer = void 0;
+exports.isTaskId = exports.isTopic = exports.isURL = exports.isUTCDateString = exports.isISODateString = exports.isPhoneNumber = exports.isEmail = exports.isPassword = exports.isUid = exports.isNonNullObject = exports.isObject = exports.isNonEmptyString = exports.isBase64String = exports.isString = exports.isNumber = exports.isBoolean = exports.isNonEmptyArray = exports.isArray = exports.isBuffer = void 0;
 const url = require("url");
 /**
  * Validates that a value is a byte buffer.
@@ -269,3 +269,18 @@ function isTopic(topic) {
     return VALID_TOPIC_REGEX.test(topic);
 }
 exports.isTopic = isTopic;
+/**
+ * Validates that the provided string can be used as a task ID
+ * for Cloud Tasks.
+ *
+ * @param taskId - the task ID to validate.
+ * @returns Whether the provided task ID is valid.
+ */
+function isTaskId(taskId) {
+    if (typeof taskId !== 'string') {
+        return false;
+    }
+    const VALID_TASK_ID_REGEX = /^[A-Za-z0-9_-]+$/;
+    return VALID_TASK_ID_REGEX.test(taskId);
+}
+exports.isTaskId = isTaskId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-admin",
-  "version": "11.9.0",
+  "version": "11.10.1",
   "description": "Firebase admin SDK for Node.js",
   "author": "Firebase <firebase-support@google.com> (https://firebase.google.com/)",
   "license": "Apache-2.0",