firebase-admin 13.9.0 → 14.0.0

package/lib/functions/functions-api-client-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,9 +17,10 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirebaseFunctionsError = exports.FUNCTIONS_ERROR_CODE_MAPPING = exports.FunctionsApiClient = exports.EMULATED_SERVICE_ACCOUNT_DEFAULT = void 0;
+exports.FunctionsApiClient = exports.EMULATED_SERVICE_ACCOUNT_DEFAULT = void 0;
 const api_request_1 = require("../utils/api-request");
 const error_1 = require("../utils/error");
+const error_2 = require("./error");
 const utils = require("../utils/index");
 const validator = require("../utils/validator");
 const credential_internal_1 = require("../app/credential-internal");
@@ -41,9 +42,14 @@ class FunctionsApiClient {
     constructor(app) {
         this.app = app;
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new FirebaseFunctionsError('invalid-argument', 'First argument passed to getFunctions() must be a valid Firebase app instance.');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'First argument passed to getFunctions() must be a valid Firebase app instance.'
+            });
         }
-        this.httpClient = new FunctionsHttpClient(app);
+        const emulatorHost = process.env.CLOUD_TASKS_EMULATOR_HOST?.trim();
+        this.emulatorHost = emulatorHost || undefined;
+        this.httpClient = new FunctionsHttpClient(app, this.emulatorHost);
     }
     /**
      * Deletes a task from a queue.
@@ -54,29 +60,42 @@ class FunctionsApiClient {
      */
     async delete(id, functionName, extensionId) {
         if (!validator.isNonEmptyString(functionName)) {
-            throw new FirebaseFunctionsError('invalid-argument', 'Function name must be a non empty string');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'Function name must be a non empty string'
+            });
         }
         if (!validator.isTaskId(id)) {
-            throw new FirebaseFunctionsError('invalid-argument', 'id can contain only letters ([A-Za-z]), numbers ([0-9]), '
-                + 'hyphens (-), or underscores (_). The maximum length is 500 characters.');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'id can contain only letters ([A-Za-z]), numbers ([0-9]), '
+                    + 'hyphens (-), or underscores (_). The maximum length is 500 characters.'
+            });
         }
         let resources;
         try {
             resources = utils.parseResourceName(functionName, 'functions');
         }
         catch (err) {
-            throw new FirebaseFunctionsError('invalid-argument', 'Function name must be a single string or a qualified resource name');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'Function name must be a single string or a qualified resource name',
+                cause: err,
+            });
         }
         resources.projectId = resources.projectId || await this.getProjectId();
         resources.locationId = resources.locationId || DEFAULT_LOCATION;
         if (!validator.isNonEmptyString(resources.resourceId)) {
-            throw new FirebaseFunctionsError('invalid-argument', 'No valid function name specified to enqueue tasks for.');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'No valid function name specified to enqueue tasks for.'
+            });
         }
         if (typeof extensionId !== 'undefined' && validator.isNonEmptyString(extensionId)) {
             resources.resourceId = `ext-${extensionId}-${resources.resourceId}`;
         }
         try {
-            const serviceUrl = tasksEmulatorUrl(resources)?.concat('/', id)
+            const serviceUrl = tasksEmulatorUrl(resources, this.emulatorHost)?.concat('/', id)
                 ?? await this.getUrl(resources, CLOUD_TASKS_API_URL_FORMAT.concat('/', id));
             const request = {
                 method: 'DELETE',
@@ -108,26 +127,36 @@ class FunctionsApiClient {
      */
     async enqueue(data, functionName, extensionId, opts) {
         if (!validator.isNonEmptyString(functionName)) {
-            throw new FirebaseFunctionsError('invalid-argument', 'Function name must be a non empty string');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'Function name must be a non empty string'
+            });
         }
         let resources;
         try {
             resources = utils.parseResourceName(functionName, 'functions');
         }
         catch (err) {
-            throw new FirebaseFunctionsError('invalid-argument', 'Function name must be a single string or a qualified resource name');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'Function name must be a single string or a qualified resource name',
+                cause: err,
+            });
         }
         resources.projectId = resources.projectId || await this.getProjectId();
         resources.locationId = resources.locationId || DEFAULT_LOCATION;
         if (!validator.isNonEmptyString(resources.resourceId)) {
-            throw new FirebaseFunctionsError('invalid-argument', 'No valid function name specified to enqueue tasks for.');
+            throw new error_2.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'No valid function name specified to enqueue tasks for.'
+            });
         }
         if (typeof extensionId !== 'undefined' && validator.isNonEmptyString(extensionId)) {
             resources.resourceId = `ext-${extensionId}-${resources.resourceId}`;
         }
         const task = this.validateTaskOptions(data, resources, opts);
         try {
-            const serviceUrl = tasksEmulatorUrl(resources) ??
+            const serviceUrl = tasksEmulatorUrl(resources, this.emulatorHost) ??
                 await this.getUrl(resources, CLOUD_TASKS_API_URL_FORMAT);
             const taskPayload = await this.updateTaskPayload(task, resources, extensionId);
             const request = {
@@ -143,7 +172,12 @@ class FunctionsApiClient {
         catch (err) {
             if (err instanceof api_request_1.RequestResponseError) {
                 if (err.response.status === 409) {
-                    throw new FirebaseFunctionsError('task-already-exists', `A task with ID ${opts?.id} already exists`);
+                    throw new error_2.FirebaseFunctionsError({
+                        code: 'task-already-exists',
+                        message: `A task with ID ${opts?.id} already exists`,
+                        httpResponse: (0, error_1.toHttpResponse)(err.response),
+                        cause: err,
+                    });
                 }
                 else {
                     throw this.toFirebaseError(err);
@@ -186,9 +220,12 @@ class FunctionsApiClient {
         return utils.findProjectId(this.app)
             .then((projectId) => {
             if (!validator.isNonEmptyString(projectId)) {
-                throw new FirebaseFunctionsError('unknown-error', 'Failed to determine project ID. Initialize the '
-                    + 'SDK with service account credentials or set project ID as an app option. '
-                    + 'Alternatively, set the GOOGLE_CLOUD_PROJECT environment variable.');
+                throw new error_2.FirebaseFunctionsError({
+                    code: 'unknown-error',
+                    message: 'Failed to determine project ID. Initialize the '
+                        + 'SDK with service account credentials or set project ID as an app option. '
+                        + 'Alternatively, set the GOOGLE_CLOUD_PROJECT environment variable.'
+                });
             }
             this.projectId = projectId;
             return projectId;
@@ -201,8 +238,11 @@ class FunctionsApiClient {
         return utils.findServiceAccountEmail(this.app)
             .then((accountId) => {
             if (!validator.isNonEmptyString(accountId)) {
-                throw new FirebaseFunctionsError('unknown-error', 'Failed to determine service account. Initialize the '
-                    + 'SDK with service account credentials or set service account ID as an app option.');
+                throw new error_2.FirebaseFunctionsError({
+                    code: 'unknown-error',
+                    message: 'Failed to determine service account. Initialize the '
+                        + 'SDK with service account credentials or set service account ID as an app option.'
+                });
             }
             this.accountId = accountId;
             return accountId;
@@ -224,21 +264,32 @@ class FunctionsApiClient {
         };
         if (typeof opts !== 'undefined') {
             if (!validator.isNonNullObject(opts)) {
-                throw new FirebaseFunctionsError('invalid-argument', 'TaskOptions must be a non-null object');
+                throw new error_2.FirebaseFunctionsError({
+                    code: 'invalid-argument',
+                    message: 'TaskOptions must be a non-null object'
+                });
             }
             if ('scheduleTime' in opts && 'scheduleDelaySeconds' in opts) {
-                throw new FirebaseFunctionsError('invalid-argument', 'Both scheduleTime and scheduleDelaySeconds are provided. '
-                    + 'Only one value should be set.');
+                throw new error_2.FirebaseFunctionsError({
+                    code: 'invalid-argument',
+                    message: 'Both scheduleTime and scheduleDelaySeconds are provided. Only one value should be set.'
+                });
             }
             if ('scheduleTime' in opts && typeof opts.scheduleTime !== 'undefined') {
                 if (!(opts.scheduleTime instanceof Date)) {
-                    throw new FirebaseFunctionsError('invalid-argument', 'scheduleTime must be a valid Date object.');
+                    throw new error_2.FirebaseFunctionsError({
+                        code: 'invalid-argument',
+                        message: 'scheduleTime must be a valid Date object.'
+                    });
                 }
                 task.scheduleTime = opts.scheduleTime.toISOString();
             }
             if ('scheduleDelaySeconds' in opts && typeof opts.scheduleDelaySeconds !== 'undefined') {
                 if (!validator.isNumber(opts.scheduleDelaySeconds) || opts.scheduleDelaySeconds < 0) {
-                    throw new FirebaseFunctionsError('invalid-argument', 'scheduleDelaySeconds must be a non-negative duration in seconds.');
+                    throw new error_2.FirebaseFunctionsError({
+                        code: 'invalid-argument',
+                        message: 'scheduleDelaySeconds must be a non-negative duration in seconds.'
+                    });
                 }
                 const date = new Date();
                 date.setSeconds(date.getSeconds() + opts.scheduleDelaySeconds);
@@ -247,15 +298,21 @@ class FunctionsApiClient {
             if (typeof opts.dispatchDeadlineSeconds !== 'undefined') {
                 if (!validator.isNumber(opts.dispatchDeadlineSeconds) || opts.dispatchDeadlineSeconds < 15
                     || opts.dispatchDeadlineSeconds > 1800) {
-                    throw new FirebaseFunctionsError('invalid-argument', 'dispatchDeadlineSeconds must be a non-negative duration in seconds '
-                        + 'and must be in the range of 15s to 30 mins.');
+                    throw new error_2.FirebaseFunctionsError({
+                        code: 'invalid-argument',
+                        message: 'dispatchDeadlineSeconds must be a non-negative duration in seconds '
+                            + 'and must be in the range of 15s to 30 mins.'
+                    });
                 }
                 task.dispatchDeadline = `${opts.dispatchDeadlineSeconds}s`;
             }
             if ('id' in opts && typeof opts.id !== 'undefined') {
                 if (!validator.isTaskId(opts.id)) {
-                    throw new FirebaseFunctionsError('invalid-argument', 'id can contain only letters ([A-Za-z]), numbers ([0-9]), '
-                        + 'hyphens (-), or underscores (_). The maximum length is 500 characters.');
+                    throw new error_2.FirebaseFunctionsError({
+                        code: 'invalid-argument',
+                        message: 'id can contain only letters ([A-Za-z]), numbers ([0-9]), '
+                            + 'hyphens (-), or underscores (_). The maximum length is 500 characters.'
+                    });
                 }
                 const resourcePath = utils.formatString(CLOUD_TASKS_API_RESOURCE_PATH, {
                     projectId: resources.projectId,
@@ -266,7 +323,10 @@ class FunctionsApiClient {
             }
             if (typeof opts.uri !== 'undefined') {
                 if (!validator.isURL(opts.uri)) {
-                    throw new FirebaseFunctionsError('invalid-argument', 'uri must be a valid URL string.');
+                    throw new error_2.FirebaseFunctionsError({
+                        code: 'invalid-argument',
+                        message: 'uri must be a valid URL string.'
+                    });
                 }
                 task.httpRequest.url = opts.uri;
             }
@@ -274,7 +334,7 @@ class FunctionsApiClient {
         return task;
     }
     async updateTaskPayload(task, resources, extensionId) {
-        const defaultUrl = process.env.CLOUD_TASKS_EMULATOR_HOST ?
+        const defaultUrl = this.emulatorHost ?
             ''
             : await this.getUrl(resources, FIREBASE_FUNCTION_URL_FORMAT);
         const functionUrl = validator.isNonEmptyString(task.httpRequest.url)
@@ -295,7 +355,7 @@ class FunctionsApiClient {
                 task.httpRequest.oidcToken = { serviceAccountEmail: account };
             }
             catch (e) {
-                if (process.env.CLOUD_TASKS_EMULATOR_HOST) {
+                if (this.emulatorHost) {
                     task.httpRequest.oidcToken = { serviceAccountEmail: exports.EMULATED_SERVICE_ACCOUNT_DEFAULT };
                 }
                 else {
@@ -306,20 +366,25 @@ class FunctionsApiClient {
         return task;
     }
     toFirebaseError(err) {
-        if (err instanceof error_1.PrefixedFirebaseError) {
+        if (err instanceof error_1.FirebaseError) {
             return err;
         }
         const response = err.response;
         if (!response.isJson()) {
-            return new FirebaseFunctionsError('unknown-error', `Unexpected response with status: ${response.status} and body: ${response.text}`);
+            return new error_2.FirebaseFunctionsError({
+                code: 'unknown-error',
+                message: `Unexpected response with status: ${response.status} and body: ${response.text}`,
+                httpResponse: (0, error_1.toHttpResponse)(response),
+                cause: err
+            });
         }
         const error = response.data.error || {};
         let code = 'unknown-error';
-        if (error.status && error.status in exports.FUNCTIONS_ERROR_CODE_MAPPING) {
-            code = exports.FUNCTIONS_ERROR_CODE_MAPPING[error.status];
+        if (error.status && error.status in error_2.FUNCTIONS_ERROR_CODE_MAPPING) {
+            code = error_2.FUNCTIONS_ERROR_CODE_MAPPING[error.status];
         }
-        const message = error.message || `Unknown server error: ${response.text}`;
-        return new FirebaseFunctionsError(code, message);
+        const message = error.message || 'Unknown server error';
+        return new error_2.FirebaseFunctionsError({ code, message, httpResponse: (0, error_1.toHttpResponse)(response), cause: err });
     }
 }
 exports.FunctionsApiClient = FunctionsApiClient;
@@ -328,45 +393,20 @@ exports.FunctionsApiClient = FunctionsApiClient;
  * when communicating with the Emulator.
  */
 class FunctionsHttpClient extends api_request_1.AuthorizedHttpClient {
+    constructor(app, emulatorHost) {
+        super(app);
+        this.emulatorHost = emulatorHost;
+    }
     getToken() {
-        if (process.env.CLOUD_TASKS_EMULATOR_HOST) {
+        if (this.emulatorHost) {
             return Promise.resolve('owner');
         }
         return super.getToken();
     }
 }
-exports.FUNCTIONS_ERROR_CODE_MAPPING = {
-    ABORTED: 'aborted',
-    INVALID_ARGUMENT: 'invalid-argument',
-    INVALID_CREDENTIAL: 'invalid-credential',
-    INTERNAL: 'internal-error',
-    FAILED_PRECONDITION: 'failed-precondition',
-    PERMISSION_DENIED: 'permission-denied',
-    UNAUTHENTICATED: 'unauthenticated',
-    NOT_FOUND: 'not-found',
-    UNKNOWN: 'unknown-error',
-};
-/**
- * Firebase Functions error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-class FirebaseFunctionsError extends error_1.PrefixedFirebaseError {
-    constructor(code, message) {
-        super('functions', code, message);
-        /* tslint:disable:max-line-length */
-        // Set the prototype explicitly. See the following link for more details:
-        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
-        /* tslint:enable:max-line-length */
-        this.__proto__ = FirebaseFunctionsError.prototype;
-    }
-}
-exports.FirebaseFunctionsError = FirebaseFunctionsError;
-function tasksEmulatorUrl(resources) {
-    if (process.env.CLOUD_TASKS_EMULATOR_HOST) {
-        return `http://${process.env.CLOUD_TASKS_EMULATOR_HOST}/projects/${resources.projectId}/locations/${resources.locationId}/queues/${resources.resourceId}/tasks`;
+function tasksEmulatorUrl(resources, emulatorHost) {
+    if (emulatorHost) {
+        return `http://${emulatorHost}/projects/${resources.projectId}/locations/${resources.locationId}/queues/${resources.resourceId}/tasks`;
     }
     return undefined;
 }

package/lib/functions/functions-api.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC

package/lib/functions/functions-api.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license

package/lib/functions/functions.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC

package/lib/functions/functions.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -19,6 +19,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskQueue = exports.Functions = void 0;
 const functions_api_client_internal_1 = require("./functions-api-client-internal");
+const error_1 = require("./error");
 const validator = require("../utils/validator");
 /**
  * The Firebase `Functions` service interface.
@@ -73,13 +74,22 @@ class TaskQueue {
         this.client = client;
         this.extensionId = extensionId;
         if (!validator.isNonEmptyString(functionName)) {
-            throw new functions_api_client_internal_1.FirebaseFunctionsError('invalid-argument', '`functionName` must be a non-empty string.');
+            throw new error_1.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: '`functionName` must be a non-empty string.'
+            });
         }
         if (!validator.isNonNullObject(client) || !('enqueue' in client)) {
-            throw new functions_api_client_internal_1.FirebaseFunctionsError('invalid-argument', 'Must provide a valid FunctionsApiClient instance to create a new TaskQueue.');
+            throw new error_1.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: 'Must provide a valid FunctionsApiClient instance to create a new TaskQueue.'
+            });
         }
         if (typeof extensionId !== 'undefined' && !validator.isString(extensionId)) {
-            throw new functions_api_client_internal_1.FirebaseFunctionsError('invalid-argument', '`extensionId` must be a string.');
+            throw new error_1.FirebaseFunctionsError({
+                code: 'invalid-argument',
+                message: '`extensionId` must be a string.'
+            });
         }
     }
     /**

package/lib/functions/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC
@@ -51,3 +51,4 @@ export { Functions, TaskQueue } from './functions';
  *   service associated with the provided app.
  */
 export declare function getFunctions(app?: App): Functions;
+export { FirebaseFunctionsError, FunctionsErrorCode } from './error';

package/lib/functions/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,7 +17,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TaskQueue = exports.Functions = void 0;
+exports.FunctionsErrorCode = exports.FirebaseFunctionsError = exports.TaskQueue = exports.Functions = void 0;
 exports.getFunctions = getFunctions;
 /**
  * Firebase Functions service.
@@ -62,3 +62,6 @@ function getFunctions(app) {
     const firebaseApp = app;
     return firebaseApp.getOrInitService('functions', (app) => new functions_1.Functions(app));
 }
+var error_1 = require("./error");
+Object.defineProperty(exports, "FirebaseFunctionsError", { enumerable: true, get: function () { return error_1.FirebaseFunctionsError; } });
+Object.defineProperty(exports, "FunctionsErrorCode", { enumerable: true, get: function () { return error_1.FunctionsErrorCode; } });

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2017 Google LLC
@@ -15,10 +15,15 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
-import * as admin from './default-namespace';
-
-declare module 'firebase-admin' {
-}
-
-export = admin;
+/**
+ * Firebase App and SDK initialization.
+ *
+ * @packageDocumentation
+ */
+export { App, AppOptions, FirebaseArrayIndexError } from './app/core';
+export { initializeApp, getApp, getApps, deleteApp } from './app/lifecycle';
+export { Credential, ServiceAccount, GoogleOAuthAccessToken } from './app/credential';
+export { applicationDefault, cert, refreshToken } from './app/credential-factory';
+export { FirebaseError, ErrorInfo, HttpResponse } from './utils/error';
+export { FirebaseAppError, AppErrorCode } from './app/error';
+export declare const SDK_VERSION: string;

package/lib/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -16,7 +16,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-const firebase = require("./default-namespace");
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_VERSION = exports.AppErrorCode = exports.FirebaseAppError = exports.FirebaseError = exports.refreshToken = exports.cert = exports.applicationDefault = exports.deleteApp = exports.getApps = exports.getApp = exports.initializeApp = void 0;
+const utils_1 = require("./utils");
 // Only Node.js has a process variable that is of [[Class]] process
 const processGlobal = typeof process !== 'undefined' ? process : 0;
 if (Object.prototype.toString.call(processGlobal) !== '[object process]') {
@@ -34,4 +36,18 @@ https://firebase.google.com/docs/web/setup
     // tslint:disable-next-line:no-console
     console.error(message);
 }
-module.exports = firebase;
+var lifecycle_1 = require("./app/lifecycle");
+Object.defineProperty(exports, "initializeApp", { enumerable: true, get: function () { return lifecycle_1.initializeApp; } });
+Object.defineProperty(exports, "getApp", { enumerable: true, get: function () { return lifecycle_1.getApp; } });
+Object.defineProperty(exports, "getApps", { enumerable: true, get: function () { return lifecycle_1.getApps; } });
+Object.defineProperty(exports, "deleteApp", { enumerable: true, get: function () { return lifecycle_1.deleteApp; } });
+var credential_factory_1 = require("./app/credential-factory");
+Object.defineProperty(exports, "applicationDefault", { enumerable: true, get: function () { return credential_factory_1.applicationDefault; } });
+Object.defineProperty(exports, "cert", { enumerable: true, get: function () { return credential_factory_1.cert; } });
+Object.defineProperty(exports, "refreshToken", { enumerable: true, get: function () { return credential_factory_1.refreshToken; } });
+var error_1 = require("./utils/error");
+Object.defineProperty(exports, "FirebaseError", { enumerable: true, get: function () { return error_1.FirebaseError; } });
+var error_2 = require("./app/error");
+Object.defineProperty(exports, "FirebaseAppError", { enumerable: true, get: function () { return error_2.FirebaseAppError; } });
+Object.defineProperty(exports, "AppErrorCode", { enumerable: true, get: function () { return error_2.AppErrorCode; } });
+exports.SDK_VERSION = (0, utils_1.getSdkVersion)();

package/lib/installations/error.d.ts

@@ -0,0 +1,48 @@
+/*! firebase-admin v14.0.0 */
+/*!
+ * Copyright 2026 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 { FirebaseError, ErrorInfo } from '../utils/error';
+/**
+ * The constant mapping for valid Installations client error codes.
+ */
+export declare const InstallationsErrorCode: {
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_PROJECT_ID: "invalid-project-id";
+    readonly INVALID_INSTALLATION_ID: "invalid-installation-id";
+    readonly API_ERROR: "api-error";
+};
+/**
+ * The type definition for valid Installations client error codes.
+ */
+export type InstallationsErrorCode = typeof InstallationsErrorCode[keyof typeof InstallationsErrorCode];
+/**
+ * Internal Installations client error code mapping used to construct ErrorInfo.
+ */
+export declare const installationsClientErrorCode: {
+    readonly [K in keyof typeof InstallationsErrorCode]: ErrorInfo;
+};
+/**
+ * Firebase Installations error code structure. This extends `FirebaseError`.
+ */
+export declare class FirebaseInstallationsError extends FirebaseError {
+    /**
+     *
+     * @param info - The error code info.
+     * @param message - The error message. This will override the default
+     *     message if provided.
+     */
+    constructor(info: ErrorInfo, message?: string);
+}

package/lib/installations/error.js

@@ -0,0 +1,73 @@
+/*! firebase-admin v14.0.0 */
+"use strict";
+/*!
+ * Copyright 2026 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirebaseInstallationsError = exports.installationsClientErrorCode = exports.InstallationsErrorCode = void 0;
+const error_1 = require("../utils/error");
+/**
+ * The constant mapping for valid Installations client error codes.
+ */
+exports.InstallationsErrorCode = {
+    INVALID_ARGUMENT: 'invalid-argument',
+    INVALID_PROJECT_ID: 'invalid-project-id',
+    INVALID_INSTALLATION_ID: 'invalid-installation-id',
+    API_ERROR: 'api-error',
+};
+/**
+ * Internal Installations client error code mapping used to construct ErrorInfo.
+ */
+exports.installationsClientErrorCode = {
+    INVALID_ARGUMENT: {
+        code: exports.InstallationsErrorCode.INVALID_ARGUMENT,
+        message: 'Invalid argument provided.',
+    },
+    INVALID_PROJECT_ID: {
+        code: exports.InstallationsErrorCode.INVALID_PROJECT_ID,
+        message: 'Invalid project ID provided.',
+    },
+    INVALID_INSTALLATION_ID: {
+        code: exports.InstallationsErrorCode.INVALID_INSTALLATION_ID,
+        message: 'Invalid installation ID provided.',
+    },
+    API_ERROR: {
+        code: exports.InstallationsErrorCode.API_ERROR,
+        message: 'Installation ID API call failed.',
+    },
+};
+/**
+ * Firebase Installations error code structure. This extends `FirebaseError`.
+ */
+class FirebaseInstallationsError extends error_1.FirebaseError {
+    /**
+     *
+     * @param info - The error code info.
+     * @param message - The error message. This will override the default
+     *     message if provided.
+     */
+    constructor(info, message) {
+        // Override default message if custom message provided.
+        super({
+            code: `installations/${info.code}`,
+            message: message || info.message,
+            httpResponse: info.httpResponse,
+            cause: info.cause,
+        });
+        /** @internal */
+        this.codePrefix = 'installations';
+    }
+}
+exports.FirebaseInstallationsError = FirebaseInstallationsError;

package/lib/installations/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * Copyright 2021 Google LLC
  *
@@ -50,4 +50,4 @@ export { Installations };
   *   provided app.
   */
 export declare function getInstallations(app?: App): Installations;
-export { FirebaseInstallationsError, InstallationsClientErrorCode } from '../utils/error';
+export { FirebaseInstallationsError, InstallationsErrorCode, } from './error';