firebase-admin 13.9.0 → 14.0.0

package/lib/firestore/error.d.ts

@@ -0,0 +1,41 @@
+/*! 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 Firestore client error codes.
+ */
+export declare const FirestoreErrorCode: {
+    readonly FAILED_PRECONDITION: "failed-precondition";
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_CREDENTIAL: "invalid-credential";
+    readonly MISSING_DEPENDENCIES: "missing-dependencies";
+};
+/**
+ * The type definition for valid Firestore client error codes.
+ */
+export type FirestoreErrorCode = typeof FirestoreErrorCode[keyof typeof FirestoreErrorCode];
+/**
+ * Firebase Firestore error code structure. This extends `FirebaseError`.
+ */
+export declare class FirebaseFirestoreError 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/firestore/error.js

@@ -0,0 +1,51 @@
+/*! 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.FirebaseFirestoreError = exports.FirestoreErrorCode = void 0;
+const error_1 = require("../utils/error");
+/**
+ * The constant mapping for valid Firestore client error codes.
+ */
+exports.FirestoreErrorCode = {
+    FAILED_PRECONDITION: 'failed-precondition',
+    INVALID_ARGUMENT: 'invalid-argument',
+    INVALID_CREDENTIAL: 'invalid-credential',
+    MISSING_DEPENDENCIES: 'missing-dependencies',
+};
+/**
+ * Firebase Firestore error code structure. This extends `FirebaseError`.
+ */
+class FirebaseFirestoreError 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: `firestore/${info.code}`,
+            message: message || info.message,
+            httpResponse: info.httpResponse,
+            cause: info.cause,
+        });
+        /** @internal */
+        this.codePrefix = 'firestore';
+    }
+}
+exports.FirebaseFirestoreError = FirebaseFirestoreError;

package/lib/firestore/firestore-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2017 Google LLC
@@ -17,6 +17,7 @@
  */
 import { Firestore, Settings } from '@google-cloud/firestore';
 import { App } from '../app';
+export declare const DEFAULT_DATABASE_ID = "(default)";
 /**
  * Settings to pass to the Firestore constructor.
  *

package/lib/firestore/firestore-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,12 +17,13 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirestoreService = void 0;
+exports.FirestoreService = exports.DEFAULT_DATABASE_ID = void 0;
 exports.getFirestoreOptions = getFirestoreOptions;
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 const credential_internal_1 = require("../app/credential-internal");
 const validator = require("../utils/validator");
 const utils = require("../utils/index");
+exports.DEFAULT_DATABASE_ID = '(default)';
 class FirestoreService {
     constructor(app) {
         this.databases = new Map();
@@ -84,7 +85,6 @@ function getFirestoreOptions(app, firestoreSettings) {
     }
     const projectId = utils.getExplicitProjectId(app);
     const credential = app.options.credential;
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
     const sdkVersion = utils.getSdkVersion();
     const preferRest = firestoreSettings?.preferRest;
     if (credential instanceof credential_internal_1.ServiceAccountCredential) {
@@ -137,8 +137,8 @@ function initFirestore(app, databaseId, firestoreSettings) {
         throw new error_1.FirebaseFirestoreError({
             code: 'missing-dependencies',
             message: 'Failed to import the Cloud Firestore client library for Node.js. '
-                + 'Make sure to install the "@google-cloud/firestore" npm package. '
-                + `Original error: ${err}`,
+                + 'Make sure to install the "@google-cloud/firestore" npm package.',
+            cause: err,
         });
     }
     return new firestoreDatabase(options);

package/lib/firestore/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * Copyright 2020 Google LLC
  *
@@ -127,4 +127,4 @@ export declare function initializeFirestore(app: App, settings?: FirestoreSettin
  * @beta
  */
 export declare function initializeFirestore(app: App, settings: FirestoreSettings, databaseId: string): Firestore;
-export { FirebaseFirestoreError } from '../utils/error';
+export { FirestoreErrorCode, FirebaseFirestoreError } from './error';

package/lib/firestore/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2020 Google LLC
@@ -16,12 +16,11 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirebaseFirestoreError = exports.setLogFunction = exports.v1 = exports.WriteResult = exports.WriteBatch = exports.Transaction = exports.Timestamp = exports.QuerySnapshot = exports.QueryPartition = exports.QueryDocumentSnapshot = exports.Query = exports.GrpcStatus = exports.GeoPoint = exports.Firestore = exports.Filter = exports.FieldValue = exports.FieldPath = exports.DocumentSnapshot = exports.DocumentReference = exports.CollectionReference = exports.CollectionGroup = exports.BundleBuilder = exports.BulkWriter = exports.AggregateQuerySnapshot = exports.AggregateQuery = exports.AggregateField = void 0;
+exports.FirebaseFirestoreError = exports.FirestoreErrorCode = exports.setLogFunction = exports.v1 = exports.WriteResult = exports.WriteBatch = exports.Transaction = exports.Timestamp = exports.QuerySnapshot = exports.QueryPartition = exports.QueryDocumentSnapshot = exports.Query = exports.GrpcStatus = exports.GeoPoint = exports.Firestore = exports.Filter = exports.FieldValue = exports.FieldPath = exports.DocumentSnapshot = exports.DocumentReference = exports.CollectionReference = exports.CollectionGroup = exports.BundleBuilder = exports.BulkWriter = exports.AggregateQuerySnapshot = exports.AggregateQuery = exports.AggregateField = void 0;
 exports.getFirestore = getFirestore;
 exports.initializeFirestore = initializeFirestore;
 const app_1 = require("../app");
 const firestore_internal_1 = require("./firestore-internal");
-const path_1 = require("@google-cloud/firestore/build/src/path");
 var firestore_1 = require("@google-cloud/firestore");
 Object.defineProperty(exports, "AggregateField", { enumerable: true, get: function () { return firestore_1.AggregateField; } });
 Object.defineProperty(exports, "AggregateQuery", { enumerable: true, get: function () { return firestore_1.AggregateQuery; } });
@@ -50,17 +49,18 @@ Object.defineProperty(exports, "v1", { enumerable: true, get: function () { retu
 Object.defineProperty(exports, "setLogFunction", { enumerable: true, get: function () { return firestore_1.setLogFunction; } });
 function getFirestore(appOrDatabaseId, optionalDatabaseId) {
     const app = typeof appOrDatabaseId === 'object' ? appOrDatabaseId : (0, app_1.getApp)();
-    const databaseId = (typeof appOrDatabaseId === 'string' ? appOrDatabaseId : optionalDatabaseId) || path_1.DEFAULT_DATABASE_ID;
+    const databaseId = (typeof appOrDatabaseId === 'string' ? appOrDatabaseId : optionalDatabaseId) || firestore_internal_1.DEFAULT_DATABASE_ID;
     const firebaseApp = app;
     const firestoreService = firebaseApp.getOrInitService('firestore', (app) => new firestore_internal_1.FirestoreService(app));
     return firestoreService.getDatabase(databaseId);
 }
 function initializeFirestore(app, settings, databaseId) {
-    settings ?? (settings = {});
-    databaseId ?? (databaseId = path_1.DEFAULT_DATABASE_ID);
+    settings ??= {};
+    databaseId ??= firestore_internal_1.DEFAULT_DATABASE_ID;
     const firebaseApp = app;
     const firestoreService = firebaseApp.getOrInitService('firestore', (app) => new firestore_internal_1.FirestoreService(app));
     return firestoreService.initializeDatabase(databaseId, settings);
 }
-var error_1 = require("../utils/error");
+var error_1 = require("./error");
+Object.defineProperty(exports, "FirestoreErrorCode", { enumerable: true, get: function () { return error_1.FirestoreErrorCode; } });
 Object.defineProperty(exports, "FirebaseFirestoreError", { enumerable: true, get: function () { return error_1.FirebaseFirestoreError; } });

package/lib/functions/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';
+/** @const {Record<string, FunctionsErrorCode>} Cloud Functions server to client error code mapping. */
+export declare const FUNCTIONS_ERROR_CODE_MAPPING: Record<string, FunctionsErrorCode>;
+/**
+ * The constant mapping for valid Cloud Functions client error codes.
+ */
+export declare const FunctionsErrorCode: {
+    readonly ABORTED: "aborted";
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_CREDENTIAL: "invalid-credential";
+    readonly INTERNAL_ERROR: "internal-error";
+    readonly FAILED_PRECONDITION: "failed-precondition";
+    readonly PERMISSION_DENIED: "permission-denied";
+    readonly UNAUTHENTICATED: "unauthenticated";
+    readonly NOT_FOUND: "not-found";
+    readonly UNKNOWN_ERROR: "unknown-error";
+    readonly TASK_ALREADY_EXISTS: "task-already-exists";
+};
+/**
+ * The type definition for valid Cloud Functions client error codes.
+ */
+export type FunctionsErrorCode = typeof FunctionsErrorCode[keyof typeof FunctionsErrorCode];
+/**
+ * Cloud Functions error code structure. This extends `FirebaseError`.
+ */
+export declare class FirebaseFunctionsError 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/functions/error.js

@@ -0,0 +1,67 @@
+/*! 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.FirebaseFunctionsError = exports.FunctionsErrorCode = exports.FUNCTIONS_ERROR_CODE_MAPPING = void 0;
+const error_1 = require("../utils/error");
+/** @const {Record<string, FunctionsErrorCode>} Cloud Functions server to client error code mapping. */
+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',
+};
+/**
+ * The constant mapping for valid Cloud Functions client error codes.
+ */
+exports.FunctionsErrorCode = {
+    ABORTED: 'aborted',
+    INVALID_ARGUMENT: 'invalid-argument',
+    INVALID_CREDENTIAL: 'invalid-credential',
+    INTERNAL_ERROR: 'internal-error',
+    FAILED_PRECONDITION: 'failed-precondition',
+    PERMISSION_DENIED: 'permission-denied',
+    UNAUTHENTICATED: 'unauthenticated',
+    NOT_FOUND: 'not-found',
+    UNKNOWN_ERROR: 'unknown-error',
+    TASK_ALREADY_EXISTS: 'task-already-exists',
+};
+/**
+ * Cloud Functions error code structure. This extends `FirebaseError`.
+ */
+class FirebaseFunctionsError extends error_1.FirebaseError {
+    /**
+     * @param info - The error code info.
+     * @param message - The error message. If provided, this will override the default message.
+     */
+    constructor(info, message) {
+        super({
+            code: `functions/${info.code}`,
+            message: message || info.message,
+            httpResponse: info.httpResponse,
+            cause: info.cause,
+        });
+        /** @internal */
+        this.codePrefix = 'functions';
+    }
+}
+exports.FirebaseFunctionsError = FirebaseFunctionsError;

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

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC
@@ -15,7 +15,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { PrefixedFirebaseError } from '../utils/error';
 export declare const EMULATED_SERVICE_ACCOUNT_DEFAULT = "emulated-service-acct@email.com";
 /**
  * Task is a limited subset of https://cloud.google.com/tasks/docs/reference/rest/v2/projects.locations.queues.tasks#resource:-task
@@ -36,17 +35,3 @@ export interface Task {
         };
     };
 }
-export declare const FUNCTIONS_ERROR_CODE_MAPPING: {
-    [key: string]: FunctionsErrorCode;
-};
-export type FunctionsErrorCode = 'aborted' | 'invalid-argument' | 'invalid-credential' | 'internal-error' | 'failed-precondition' | 'permission-denied' | 'unauthenticated' | 'not-found' | 'unknown-error' | 'task-already-exists';
-/**
- * Firebase Functions error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-export declare class FirebaseFunctionsError extends PrefixedFirebaseError {
-    constructor(code: FunctionsErrorCode, message: string);
-}