firebase-admin 13.10.0 → 14.0.0

package/lib/installations/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2021 Google LLC
@@ -16,7 +16,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InstallationsClientErrorCode = exports.FirebaseInstallationsError = exports.Installations = void 0;
+exports.InstallationsErrorCode = exports.FirebaseInstallationsError = exports.Installations = void 0;
 exports.getInstallations = getInstallations;
 /**
  * Firebase Instance ID service.
@@ -60,6 +60,6 @@ function getInstallations(app) {
     const firebaseApp = app;
     return firebaseApp.getOrInitService('installations', (app) => new installations_1.Installations(app));
 }
-var error_1 = require("../utils/error");
+var error_1 = require("./error");
 Object.defineProperty(exports, "FirebaseInstallationsError", { enumerable: true, get: function () { return error_1.FirebaseInstallationsError; } });
-Object.defineProperty(exports, "InstallationsClientErrorCode", { enumerable: true, get: function () { return error_1.InstallationsClientErrorCode; } });
+Object.defineProperty(exports, "InstallationsErrorCode", { enumerable: true, get: function () { return error_1.InstallationsErrorCode; } });

package/lib/installations/installations-request-handler.d.ts

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

package/lib/installations/installations-request-handler.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -18,7 +18,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FirebaseInstallationsRequestHandler = void 0;
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
+const error_2 = require("../utils/error");
 const api_request_1 = require("../utils/api-request");
 const utils = require("../utils/index");
 const validator = require("../utils/validator");
@@ -56,7 +57,7 @@ class FirebaseInstallationsRequestHandler {
     }
     deleteInstallation(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 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'));
     }
@@ -87,7 +88,12 @@ class FirebaseInstallationsRequestHandler {
                 const template = ERROR_CODES[response.status];
                 const message = template ?
                     `Installation ID "${apiSettings.getEndpoint()}": ${template}` : errorMessage;
-                throw new error_1.FirebaseInstallationsError(error_1.InstallationsClientErrorCode.API_ERROR, message);
+                throw new error_1.FirebaseInstallationsError({
+                    ...error_1.installationsClientErrorCode.API_ERROR,
+                    message,
+                    httpResponse: (0, error_2.toHttpResponse)(response),
+                    cause: err,
+                });
             }
             // In case of timeouts and other network errors, the HttpClient returns a
             // FirebaseError wrapped in the response. Simply throw it here.
@@ -102,7 +108,7 @@ class FirebaseInstallationsRequestHandler {
             .then((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 '
+                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.');
             }

package/lib/installations/installations.d.ts

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

package/lib/installations/installations.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2021 Google LLC
@@ -17,7 +17,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Installations = void 0;
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 const installations_request_handler_1 = require("./installations-request-handler");
 const validator = require("../utils/validator");
 /**
@@ -31,7 +31,7 @@ class Installations {
      */
     constructor(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.');
+            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);

package/lib/machine-learning/error.d.ts

@@ -0,0 +1,53 @@
+/*! firebase-admin v14.0.0 */
+/*!
+ * Copyright 2020 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 Machine Learning client error codes.
+ */
+export declare const MachineLearningErrorCode: {
+    readonly ALREADY_EXISTS: "already-exists";
+    readonly AUTHENTICATION_ERROR: "authentication-error";
+    readonly INTERNAL_ERROR: "internal-error";
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_SERVER_RESPONSE: "invalid-server-response";
+    readonly NOT_FOUND: "not-found";
+    readonly RESOURCE_EXHAUSTED: "resource-exhausted";
+    readonly SERVICE_UNAVAILABLE: "service-unavailable";
+    readonly UNKNOWN_ERROR: "unknown-error";
+    readonly CANCELLED: "cancelled";
+    readonly DEADLINE_EXCEEDED: "deadline-exceeded";
+    readonly PERMISSION_DENIED: "permission-denied";
+    readonly FAILED_PRECONDITION: "failed-precondition";
+    readonly ABORTED: "aborted";
+    readonly OUT_OF_RANGE: "out-of-range";
+    readonly DATA_LOSS: "data-loss";
+    readonly UNAUTHENTICATED: "unauthenticated";
+};
+/**
+ * The type definition for valid Machine Learning client error codes.
+ */
+export type MachineLearningErrorCode = typeof MachineLearningErrorCode[keyof typeof MachineLearningErrorCode];
+/**
+ * Firebase Machine Learning error code structure. This extends `FirebaseError`.
+ */
+export declare class FirebaseMachineLearningError extends FirebaseError {
+    /**
+     * @param info - The error code info.
+     * @param message - The error message. If provided, this will override the default message.
+     */
+    constructor(info: ErrorInfo, message?: string);
+}

package/lib/machine-learning/error.js

@@ -0,0 +1,84 @@
+/*! firebase-admin v14.0.0 */
+"use strict";
+/*!
+ * Copyright 2020 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.FirebaseMachineLearningError = exports.MachineLearningErrorCode = void 0;
+const error_1 = require("../utils/error");
+/**
+ * The constant mapping for valid Machine Learning client error codes.
+ */
+exports.MachineLearningErrorCode = {
+    ALREADY_EXISTS: 'already-exists',
+    AUTHENTICATION_ERROR: 'authentication-error',
+    INTERNAL_ERROR: 'internal-error',
+    INVALID_ARGUMENT: 'invalid-argument',
+    INVALID_SERVER_RESPONSE: 'invalid-server-response',
+    NOT_FOUND: 'not-found',
+    RESOURCE_EXHAUSTED: 'resource-exhausted',
+    SERVICE_UNAVAILABLE: 'service-unavailable',
+    UNKNOWN_ERROR: 'unknown-error',
+    CANCELLED: 'cancelled',
+    DEADLINE_EXCEEDED: 'deadline-exceeded',
+    PERMISSION_DENIED: 'permission-denied',
+    FAILED_PRECONDITION: 'failed-precondition',
+    ABORTED: 'aborted',
+    OUT_OF_RANGE: 'out-of-range',
+    DATA_LOSS: 'data-loss',
+    UNAUTHENTICATED: 'unauthenticated',
+};
+/**
+ * Firebase Machine Learning error code structure. This extends `FirebaseError`.
+ */
+class FirebaseMachineLearningError extends error_1.FirebaseError {
+    /** @internal */
+    static fromOperationError(code, message) {
+        switch (code) {
+            case 1: return new FirebaseMachineLearningError({ code: 'cancelled', message });
+            case 2: return new FirebaseMachineLearningError({ code: 'unknown-error', message });
+            case 3: return new FirebaseMachineLearningError({ code: 'invalid-argument', message });
+            case 4: return new FirebaseMachineLearningError({ code: 'deadline-exceeded', message });
+            case 5: return new FirebaseMachineLearningError({ code: 'not-found', message });
+            case 6: return new FirebaseMachineLearningError({ code: 'already-exists', message });
+            case 7: return new FirebaseMachineLearningError({ code: 'permission-denied', message });
+            case 8: return new FirebaseMachineLearningError({ code: 'resource-exhausted', message });
+            case 9: return new FirebaseMachineLearningError({ code: 'failed-precondition', message });
+            case 10: return new FirebaseMachineLearningError({ code: 'aborted', message });
+            case 11: return new FirebaseMachineLearningError({ code: 'out-of-range', message });
+            case 13: return new FirebaseMachineLearningError({ code: 'internal-error', message });
+            case 14: return new FirebaseMachineLearningError({ code: 'service-unavailable', message });
+            case 15: return new FirebaseMachineLearningError({ code: 'data-loss', message });
+            case 16: return new FirebaseMachineLearningError({ code: 'unauthenticated', message });
+            default:
+                return new FirebaseMachineLearningError({ code: 'unknown-error', message });
+        }
+    }
+    /**
+     * @param info - The error code info.
+     * @param message - The error message. If provided, this will override the default message.
+     */
+    constructor(info, message) {
+        super({
+            code: `machine-learning/${info.code}`,
+            message: message || info.message,
+            httpResponse: info.httpResponse,
+            cause: info.cause,
+        });
+        /** @internal */
+        this.codePrefix = 'machine-learning';
+    }
+}
+exports.FirebaseMachineLearningError = FirebaseMachineLearningError;

package/lib/machine-learning/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * Copyright 2020 Google LLC
  *
@@ -50,3 +50,4 @@ export { GcsTfliteModelOptions, ListModelsOptions, ModelOptions, ModelOptionsBas
  *   `MachineLearning` service associated with the provided app.
  */
 export declare function getMachineLearning(app?: App): MachineLearning;
+export { FirebaseMachineLearningError, MachineLearningErrorCode } from './error';

package/lib/machine-learning/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2020 Google LLC
@@ -16,7 +16,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Model = exports.MachineLearning = void 0;
+exports.MachineLearningErrorCode = exports.FirebaseMachineLearningError = exports.Model = exports.MachineLearning = void 0;
 exports.getMachineLearning = getMachineLearning;
 /**
  * Firebase Machine Learning.
@@ -61,3 +61,6 @@ function getMachineLearning(app) {
     const firebaseApp = app;
     return firebaseApp.getOrInitService('machineLearning', (app) => new machine_learning_1.MachineLearning(app));
 }
+var error_1 = require("./error");
+Object.defineProperty(exports, "FirebaseMachineLearningError", { enumerable: true, get: function () { return error_1.FirebaseMachineLearningError; } });
+Object.defineProperty(exports, "MachineLearningErrorCode", { enumerable: true, get: function () { return error_1.MachineLearningErrorCode; } });

package/lib/machine-learning/machine-learning-api-client.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * Copyright 2020 Google LLC
  *

package/lib/machine-learning/machine-learning-api-client.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2020 Google LLC
@@ -22,7 +22,7 @@ const api_request_1 = require("../utils/api-request");
 const error_1 = require("../utils/error");
 const utils = require("../utils/index");
 const validator = require("../utils/validator");
-const machine_learning_utils_1 = require("./machine-learning-utils");
+const error_2 = require("./error");
 const ML_V1BETA2_API = 'https://firebaseml.googleapis.com/v1beta2';
 const FIREBASE_VERSION_HEADER = {
     'X-Firebase-Client': `fire-admin-node/${utils.getSdkVersion()}`,
@@ -44,15 +44,18 @@ class MachineLearningApiClient {
     constructor(app) {
         this.app = app;
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'First argument passed to admin.machineLearning() must be a valid '
-                + 'Firebase app instance.');
+            throw new error_2.FirebaseMachineLearningError({
+                code: 'invalid-argument',
+                message: 'First argument passed to admin.machineLearning() must be a valid '
+                    + 'Firebase app instance.'
+            });
         }
         this.httpClient = new api_request_1.AuthorizedHttpClient(app);
     }
     createModel(model) {
         if (!validator.isNonNullObject(model) ||
             !validator.isNonEmptyString(model.displayName)) {
-            const err = new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Invalid model content.');
+            const err = new error_2.FirebaseMachineLearningError({ code: 'invalid-argument', message: 'Invalid model content.' });
             return Promise.reject(err);
         }
         return this.getProjectUrl()
@@ -69,7 +72,10 @@ class MachineLearningApiClient {
         if (!validator.isNonEmptyString(modelId) ||
             !validator.isNonNullObject(model) ||
             !validator.isNonEmptyArray(updateMask)) {
-            const err = new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Invalid model or mask content.');
+            const err = new error_2.FirebaseMachineLearningError({
+                code: 'invalid-argument',
+                message: 'Invalid model or mask content.',
+            });
             return Promise.reject(err);
         }
         return this.getProjectUrl()
@@ -99,25 +105,31 @@ class MachineLearningApiClient {
     }
     listModels(options = {}) {
         if (!validator.isNonNullObject(options)) {
-            const err = new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Invalid ListModelsOptions');
+            const err = new error_2.FirebaseMachineLearningError({ code: 'invalid-argument', message: 'Invalid ListModelsOptions' });
             return Promise.reject(err);
         }
         if (typeof options.filter !== 'undefined' && !validator.isNonEmptyString(options.filter)) {
-            const err = new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Invalid list filter.');
+            const err = new error_2.FirebaseMachineLearningError({ code: 'invalid-argument', message: 'Invalid list filter.' });
             return Promise.reject(err);
         }
         if (typeof options.pageSize !== 'undefined') {
             if (!validator.isNumber(options.pageSize)) {
-                const err = new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Invalid page size.');
+                const err = new error_2.FirebaseMachineLearningError({ code: 'invalid-argument', message: 'Invalid page size.' });
                 return Promise.reject(err);
             }
             if (options.pageSize < 1 || options.pageSize > 100) {
-                const err = new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Page size must be between 1 and 100.');
+                const err = new error_2.FirebaseMachineLearningError({
+                    code: 'invalid-argument',
+                    message: 'Page size must be between 1 and 100.'
+                });
                 return Promise.reject(err);
             }
         }
         if (typeof options.pageToken !== 'undefined' && !validator.isNonEmptyString(options.pageToken)) {
-            const err = new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Next page token must be a non-empty string.');
+            const err = new error_2.FirebaseMachineLearningError({
+                code: 'invalid-argument',
+                message: 'Next page token must be a non-empty string.'
+            });
             return Promise.reject(err);
         }
         return this.getProjectUrl()
@@ -153,11 +165,14 @@ class MachineLearningApiClient {
                 return Promise.resolve(op.response);
             }
             else if (op.error) {
-                const err = machine_learning_utils_1.FirebaseMachineLearningError.fromOperationError(op.error.code, op.error.message);
+                const err = error_2.FirebaseMachineLearningError.fromOperationError(op.error.code, op.error.message);
                 return Promise.reject(err);
             }
             // Done operations must have either a response or an error.
-            throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-server-response', 'Invalid operation response.');
+            throw new error_2.FirebaseMachineLearningError({
+                code: 'invalid-server-response',
+                message: 'Invalid operation response.'
+            });
         }
         // Operation is not done
         if (options?.wait) {
@@ -166,7 +181,10 @@ class MachineLearningApiClient {
         const metadata = op.metadata || {};
         const metadataType = metadata['@type'] || '';
         if (!metadataType.includes('ModelOperationMetadata')) {
-            throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-server-response', `Unknown Metadata type: ${JSON.stringify(metadata)}`);
+            throw new error_2.FirebaseMachineLearningError({
+                code: 'invalid-server-response',
+                message: `Unknown Metadata type: ${JSON.stringify(metadata)}`
+            });
         }
         return this.getModel(extractModelId(metadata.name));
     }
@@ -183,7 +201,7 @@ class MachineLearningApiClient {
                     return null;
                 }
                 if (responseData.error) {
-                    const err = machine_learning_utils_1.FirebaseMachineLearningError.fromOperationError(responseData.error.code, responseData.error.message);
+                    const err = error_2.FirebaseMachineLearningError.fromOperationError(responseData.error.code, responseData.error.message);
                     throw err;
                 }
                 return responseData.response;
@@ -231,20 +249,30 @@ class MachineLearningApiClient {
         });
     }
     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 machine_learning_utils_1.FirebaseMachineLearningError('unknown-error', `Unexpected response with status: ${response.status} and body: ${response.text}`);
+            return new error_2.FirebaseMachineLearningError({
+                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 ERROR_CODE_MAPPING) {
             code = ERROR_CODE_MAPPING[error.status];
         }
-        const message = error.message || `Unknown server error: ${response.text}`;
-        return new machine_learning_utils_1.FirebaseMachineLearningError(code, message);
+        const message = error.message || 'Unknown server error';
+        return new error_2.FirebaseMachineLearningError({
+            code,
+            message,
+            httpResponse: (0, error_1.toHttpResponse)(response),
+            cause: err
+        });
     }
     getProjectUrl() {
         return this.getProjectIdPrefix()
@@ -259,9 +287,12 @@ class MachineLearningApiClient {
         return utils.findProjectId(this.app)
             .then((projectId) => {
             if (!validator.isNonEmptyString(projectId)) {
-                throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', '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.FirebaseMachineLearningError({
+                    code: 'invalid-argument',
+                    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.projectIdPrefix = `projects/${projectId}`;
             return this.projectIdPrefix;
@@ -269,10 +300,16 @@ class MachineLearningApiClient {
     }
     getModelName(modelId) {
         if (!validator.isNonEmptyString(modelId)) {
-            throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Model ID must be a non-empty string.');
+            throw new error_2.FirebaseMachineLearningError({
+                code: 'invalid-argument',
+                message: 'Model ID must be a non-empty string.'
+            });
         }
         if (modelId.indexOf('/') !== -1) {
-            throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', 'Model ID must not contain any "/" characters.');
+            throw new error_2.FirebaseMachineLearningError({
+                code: 'invalid-argument',
+                message: 'Model ID must not contain any "/" characters.'
+            });
         }
         return `models/${modelId}`;
     }

package/lib/machine-learning/machine-learning.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * Copyright 2020 Google LLC
  *

package/lib/machine-learning/machine-learning.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2020 Google LLC
@@ -18,12 +18,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Model = exports.MachineLearning = void 0;
 const index_1 = require("../storage/index");
-const error_1 = require("../utils/error");
 const validator = require("../utils/validator");
 const deep_copy_1 = require("../utils/deep-copy");
 const utils = require("../utils");
 const machine_learning_api_client_1 = require("./machine-learning-api-client");
-const machine_learning_utils_1 = require("./machine-learning-utils");
+const error_1 = require("./error");
 /**
  * The Firebase `MachineLearning` service interface.
  */
@@ -35,8 +34,8 @@ class MachineLearning {
      */
     constructor(app) {
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new error_1.FirebaseError({
-                code: 'machine-learning/invalid-argument',
+            throw new error_1.FirebaseMachineLearningError({
+                code: 'invalid-argument',
                 message: 'First argument passed to admin.machineLearning() must be a ' +
                     'valid Firebase app instance.',
             });
@@ -126,7 +125,10 @@ class MachineLearning {
         return this.client.listModels(options)
             .then((resp) => {
             if (!validator.isNonNullObject(resp)) {
-                throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', `Invalid ListModels response: ${JSON.stringify(resp)}`);
+                throw new error_1.FirebaseMachineLearningError({
+                    code: 'invalid-argument',
+                    message: `Invalid ListModels response: ${JSON.stringify(resp)}`
+                });
             }
             let models = [];
             if (resp.models) {
@@ -163,7 +165,11 @@ class MachineLearning {
                 return modelOptions;
             })
                 .catch((err) => {
-                throw new machine_learning_utils_1.FirebaseMachineLearningError('internal-error', `Error during signing upload url: ${err.message}`);
+                throw new error_1.FirebaseMachineLearningError({
+                    code: 'internal-error',
+                    message: `Error during signing upload url: ${err.message}`,
+                    cause: err,
+                });
             });
         }
         return Promise.resolve(modelOptions);
@@ -174,7 +180,10 @@ class MachineLearning {
         const gcsRegex = /^gs:\/\/([a-z0-9_.-]{3,63})\/(.+)$/;
         const matches = gcsRegex.exec(unsignedUrl);
         if (!matches) {
-            throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-argument', `Invalid unsigned url: ${unsignedUrl}`);
+            throw new error_1.FirebaseMachineLearningError({
+                code: 'invalid-argument',
+                message: `Invalid unsigned url: ${unsignedUrl}`
+            });
         }
         const bucketName = matches[1];
         const blobName = matches[2];
@@ -314,7 +323,10 @@ class Model {
             !validator.isNonEmptyString(model.updateTime) ||
             !validator.isNonEmptyString(model.displayName) ||
             !validator.isNonEmptyString(model.etag)) {
-            throw new machine_learning_utils_1.FirebaseMachineLearningError('invalid-server-response', `Invalid Model response: ${JSON.stringify(model)}`);
+            throw new error_1.FirebaseMachineLearningError({
+                code: 'invalid-server-response',
+                message: `Invalid Model response: ${JSON.stringify(model)}`
+            });
         }
         const tmpModel = (0, deep_copy_1.deepCopy)(model);
         // If tflite Model is specified, it must have a source of {gcsTfliteUri}

package/lib/messaging/error.d.ts

@@ -0,0 +1,63 @@
+/*! 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 { ErrorInfo, FirebaseError } from '../utils/error';
+/**
+ * The constant mapping for valid Messaging client error codes.
+ */
+export declare const MessagingErrorCode: {
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_RECIPIENT: "invalid-recipient";
+    readonly INVALID_PAYLOAD: "invalid-payload";
+    readonly INVALID_DATA_PAYLOAD_KEY: "invalid-data-payload-key";
+    readonly PAYLOAD_SIZE_LIMIT_EXCEEDED: "payload-size-limit-exceeded";
+    readonly INVALID_OPTIONS: "invalid-options";
+    readonly INVALID_REGISTRATION_TOKEN: "invalid-registration-token";
+    readonly REGISTRATION_TOKEN_NOT_REGISTERED: "registration-token-not-registered";
+    readonly MISMATCHED_CREDENTIAL: "mismatched-credential";
+    readonly INVALID_PACKAGE_NAME: "invalid-package-name";
+    readonly DEVICE_MESSAGE_RATE_EXCEEDED: "device-message-rate-exceeded";
+    readonly TOPICS_MESSAGE_RATE_EXCEEDED: "topics-message-rate-exceeded";
+    readonly TOPICS_SUBSCRIPTION_RATE_EXCEEDED: "topics-subscription-rate-exceeded";
+    readonly MESSAGE_RATE_EXCEEDED: "message-rate-exceeded";
+    readonly THIRD_PARTY_AUTH_ERROR: "third-party-auth-error";
+    readonly TOO_MANY_TOPICS: "too-many-topics";
+    readonly AUTHENTICATION_ERROR: "authentication-error";
+    readonly SERVER_UNAVAILABLE: "server-unavailable";
+    readonly INTERNAL_ERROR: "internal-error";
+    readonly UNKNOWN_ERROR: "unknown-error";
+};
+/**
+ * The type definition for valid Messaging client error codes.
+ */
+export type MessagingErrorCode = typeof MessagingErrorCode[keyof typeof MessagingErrorCode];
+/**
+ * Internal Messaging client error code mapping used to construct ErrorInfo.
+ */
+export declare const messagingClientErrorCode: {
+    readonly [K in keyof typeof MessagingErrorCode]: ErrorInfo;
+};
+/**
+ * Firebase Messaging error code structure. This extends `FirebaseError`.
+ */
+export declare class FirebaseMessagingError 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);
+}