firebase-admin 13.9.0 → 14.0.0

package/lib/eventarc/eventarc-client-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -20,9 +20,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventarcApiClient = void 0;
 const validator = require("../utils/validator");
 const eventarc_utils_1 = require("./eventarc-utils");
+const error_1 = require("./error");
 const api_request_1 = require("../utils/api-request");
 const utils = require("../utils");
-const error_1 = require("../utils/error");
+const error_2 = require("../utils/error");
 const EVENTARC_API = 'https://eventarcpublishing.googleapis.com/v1';
 const FIREBASE_VERSION_HEADER = {
     'X-Firebase-Client': `fire-admin-node/${utils.getSdkVersion()}`,
@@ -39,7 +40,10 @@ class EventarcApiClient {
         this.app = app;
         this.channel = channel;
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new eventarc_utils_1.FirebaseEventarcError('invalid-argument', 'First argument passed to Channel() must be a valid Eventarc service instance.');
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: 'First argument passed to Channel() must be a valid Eventarc service instance.'
+            });
         }
         this.httpClient = new api_request_1.AuthorizedHttpClient(app);
         this.resolvedChannelName = this.resolveChannelName(channel.name);
@@ -51,9 +55,12 @@ class EventarcApiClient {
         return utils.findProjectId(this.app)
             .then((projectId) => {
             if (!validator.isNonEmptyString(projectId)) {
-                throw new eventarc_utils_1.FirebaseEventarcError('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_1.FirebaseEventarcError({
+                    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;
@@ -100,11 +107,16 @@ class EventarcApiClient {
         });
     }
     toFirebaseError(err) {
-        if (err instanceof error_1.PrefixedFirebaseError) {
+        if (err instanceof error_2.FirebaseError) {
             return err;
         }
         const response = err.response;
-        return new eventarc_utils_1.FirebaseEventarcError('unknown-error', `Unexpected response with status: ${response.status} and body: ${response.text}`);
+        return new error_1.FirebaseEventarcError({
+            code: 'unknown-error',
+            message: `Unexpected response with status: ${response.status}.`,
+            httpResponse: (0, error_2.toHttpResponse)(response),
+            cause: err,
+        });
     }
     resolveChannelName(name) {
         if (!name.includes('/')) {
@@ -115,7 +127,10 @@ class EventarcApiClient {
         else {
             const match = CHANNEL_NAME_REGEX.exec(name);
             if (match === null || match.length < 4) {
-                throw new eventarc_utils_1.FirebaseEventarcError('invalid-argument', 'Invalid channel name format.');
+                throw new error_1.FirebaseEventarcError({
+                    code: 'invalid-argument',
+                    message: 'Invalid channel name format.'
+                });
             }
             const projectId = match[2];
             const location = match[3];

package/lib/eventarc/eventarc-utils.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2022 Google LLC
@@ -15,17 +15,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { PrefixedFirebaseError } from '../utils/error';
 import { CloudEvent } from './cloudevent';
-export type EventarcErrorCode = 'unknown-error' | 'invalid-argument';
-/**
- * Firebase Eventarc error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-export declare class FirebaseEventarcError extends PrefixedFirebaseError {
-    constructor(code: EventarcErrorCode, message: string);
-}
 export declare function toCloudEventProtoFormat(ce: CloudEvent): any;

package/lib/eventarc/eventarc-utils.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,45 +17,40 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirebaseEventarcError = void 0;
 exports.toCloudEventProtoFormat = toCloudEventProtoFormat;
-const error_1 = require("../utils/error");
-const uuid_1 = require("uuid");
+const error_1 = require("./error");
 const validator = require("../utils/validator");
+const node_crypto_1 = require("node:crypto");
 // List of CloudEvent properties that are handled "by hand" and should be skipped by
 // automatic attribute copy.
 const TOP_LEVEL_CE_ATTRS = ['id', 'type', 'specversion', 'source', 'data', 'time', 'datacontenttype', 'subject'];
-/**
- * Firebase Eventarc error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-class FirebaseEventarcError extends error_1.PrefixedFirebaseError {
-    constructor(code, message) {
-        super('eventarc', code, message);
-    }
-}
-exports.FirebaseEventarcError = FirebaseEventarcError;
 function toCloudEventProtoFormat(ce) {
     const source = ce.source ?? process.env.EVENTARC_CLOUD_EVENT_SOURCE;
     if (typeof source === 'undefined' || !validator.isNonEmptyString(source)) {
-        throw new FirebaseEventarcError('invalid-argument', "CloudEvent 'source' is required.");
+        throw new error_1.FirebaseEventarcError({
+            code: 'invalid-argument',
+            message: "CloudEvent 'source' is required."
+        });
     }
     if (!validator.isNonEmptyString(ce.type)) {
-        throw new FirebaseEventarcError('invalid-argument', "CloudEvent 'type' is required.");
+        throw new error_1.FirebaseEventarcError({
+            code: 'invalid-argument',
+            message: "CloudEvent 'type' is required."
+        });
     }
     const out = {
         '@type': 'type.googleapis.com/io.cloudevents.v1.CloudEvent',
-        'id': ce.id ?? (0, uuid_1.v4)(),
+        'id': ce.id ?? (0, node_crypto_1.randomUUID)(),
         'type': ce.type,
         'specVersion': ce.specversion ?? '1.0',
         'source': source
     };
     if (typeof ce.time !== 'undefined') {
         if (!validator.isISODateString(ce.time)) {
-            throw new FirebaseEventarcError('invalid-argument', "CloudEvent 'tyme' must be in ISO date format.");
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: "CloudEvent 'tyme' must be in ISO date format."
+            });
         }
         setAttribute(out, 'time', {
             'ceTimestamp': ce.time
@@ -68,7 +63,10 @@ function toCloudEventProtoFormat(ce) {
     }
     if (typeof ce.datacontenttype !== 'undefined') {
         if (!validator.isNonEmptyString(ce.datacontenttype)) {
-            throw new FirebaseEventarcError('invalid-argument', "CloudEvent 'datacontenttype' if specified must be non-empty string.");
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: "CloudEvent 'datacontenttype' if specified must be non-empty string."
+            });
         }
         setAttribute(out, 'datacontenttype', {
             'ceString': ce.datacontenttype
@@ -76,14 +74,20 @@ function toCloudEventProtoFormat(ce) {
     }
     if (ce.subject) {
         if (!validator.isNonEmptyString(ce.subject)) {
-            throw new FirebaseEventarcError('invalid-argument', "CloudEvent 'subject' if specified must be non-empty string.");
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: "CloudEvent 'subject' if specified must be non-empty string."
+            });
         }
         setAttribute(out, 'subject', {
             'ceString': ce.subject
         });
     }
     if (typeof ce.data === 'undefined') {
-        throw new FirebaseEventarcError('invalid-argument', "CloudEvent 'data' is required.");
+        throw new error_1.FirebaseEventarcError({
+            code: 'invalid-argument',
+            message: "CloudEvent 'data' is required."
+        });
     }
     if (validator.isObject(ce.data)) {
         out['textData'] = JSON.stringify(ce.data);
@@ -102,14 +106,20 @@ function toCloudEventProtoFormat(ce) {
         }
     }
     else {
-        throw new FirebaseEventarcError('invalid-argument', `CloudEvent 'data' must be string or an object (which are converted to JSON), got '${typeof ce.data}'.`);
+        throw new error_1.FirebaseEventarcError({
+            code: 'invalid-argument',
+            message: `CloudEvent 'data' must be string or an object (which are converted to JSON), got '${typeof ce.data}'.`
+        });
     }
     for (const attr in ce) {
         if (TOP_LEVEL_CE_ATTRS.includes(attr)) {
             continue;
         }
         if (!validator.isNonEmptyString(ce[attr])) {
-            throw new FirebaseEventarcError('invalid-argument', `CloudEvent extension attributes ('${attr}') must be string.`);
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: `CloudEvent extension attributes ('${attr}') must be string.`
+            });
         }
         setAttribute(out, attr, {
             'ceString': ce[attr]

package/lib/eventarc/eventarc.d.ts

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

package/lib/eventarc/eventarc.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -19,7 +19,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Channel = exports.Eventarc = void 0;
 const validator = require("../utils/validator");
-const eventarc_utils_1 = require("./eventarc-utils");
+const error_1 = require("./error");
 const eventarc_client_internal_1 = require("./eventarc-client-internal");
 /**
  * Eventarc service bound to the provided app.
@@ -30,7 +30,10 @@ class Eventarc {
      */
     constructor(app) {
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new eventarc_utils_1.FirebaseEventarcError('invalid-argument', 'First argument passed to Eventarc() must be a valid Firebase app instance.');
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: 'First argument passed to Eventarc() must be a valid Firebase app instance.'
+            });
         }
         this.appInternal = app;
     }
@@ -69,7 +72,10 @@ class Eventarc {
             allowedEventTypes = opts?.allowedEventTypes;
         }
         else if (typeof opts?.allowedEventTypes !== 'undefined') {
-            throw new eventarc_utils_1.FirebaseEventarcError('invalid-argument', 'AllowedEventTypes must be either an array of strings or a comma separated string.');
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: 'AllowedEventTypes must be either an array of strings or a comma separated string.'
+            });
         }
         return new Channel(this, channel, allowedEventTypes);
     }
@@ -84,10 +90,16 @@ class Channel {
      */
     constructor(eventarc, name, allowedEventTypes) {
         if (!validator.isNonNullObject(eventarc)) {
-            throw new eventarc_utils_1.FirebaseEventarcError('invalid-argument', 'First argument passed to Channel() must be a valid Eventarc service instance.');
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: 'First argument passed to Channel() must be a valid Eventarc service instance.'
+            });
         }
         if (!validator.isNonEmptyString(name)) {
-            throw new eventarc_utils_1.FirebaseEventarcError('invalid-argument', 'name is required.');
+            throw new error_1.FirebaseEventarcError({
+                code: 'invalid-argument',
+                message: 'name is required.'
+            });
         }
         this.nameInternal = name;
         this.eventarcInternal = eventarc;

package/lib/eventarc/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2022 Google LLC
@@ -51,3 +51,4 @@ export { Eventarc, Channel, ChannelOptions } from './eventarc';
  *   app.
  */
 export declare function getEventarc(app?: App): Eventarc;
+export { FirebaseEventarcError, EventarcErrorCode } from './error';

package/lib/eventarc/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.Channel = exports.Eventarc = void 0;
+exports.EventarcErrorCode = exports.FirebaseEventarcError = exports.Channel = exports.Eventarc = void 0;
 exports.getEventarc = getEventarc;
 /**
  * Firebase Eventarc.
@@ -62,3 +62,6 @@ function getEventarc(app) {
     const firebaseApp = app;
     return firebaseApp.getOrInitService('eventarc', (app) => new eventarc_1.Eventarc(app));
 }
+var error_1 = require("./error");
+Object.defineProperty(exports, "FirebaseEventarcError", { enumerable: true, get: function () { return error_1.FirebaseEventarcError; } });
+Object.defineProperty(exports, "EventarcErrorCode", { enumerable: true, get: function () { return error_1.EventarcErrorCode; } });

package/lib/extensions/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 Extensions client error codes.
+ */
+export declare const ExtensionsErrorCode: {
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly NOT_FOUND: "not-found";
+    readonly FORBIDDEN: "forbidden";
+    readonly INTERNAL_ERROR: "internal-error";
+    readonly UNKNOWN_ERROR: "unknown-error";
+};
+/**
+ * The type definition for valid Extensions client error codes.
+ */
+export type ExtensionsErrorCode = typeof ExtensionsErrorCode[keyof typeof ExtensionsErrorCode];
+/**
+ * Firebase Extensions error code structure. This extends `FirebaseError`.
+ */
+export declare class FirebaseExtensionsError 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/extensions/error.js

@@ -0,0 +1,50 @@
+/*! 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.FirebaseExtensionsError = exports.ExtensionsErrorCode = void 0;
+const error_1 = require("../utils/error");
+/**
+ * The constant mapping for valid Extensions client error codes.
+ */
+exports.ExtensionsErrorCode = {
+    INVALID_ARGUMENT: 'invalid-argument',
+    NOT_FOUND: 'not-found',
+    FORBIDDEN: 'forbidden',
+    INTERNAL_ERROR: 'internal-error',
+    UNKNOWN_ERROR: 'unknown-error',
+};
+/**
+ * Firebase Extensions error code structure. This extends `FirebaseError`.
+ */
+class FirebaseExtensionsError 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: `Extensions/${info.code}`,
+            message: message || info.message,
+            httpResponse: info.httpResponse,
+            cause: info.cause,
+        });
+        /** @internal */
+        this.codePrefix = 'Extensions';
+    }
+}
+exports.FirebaseExtensionsError = FirebaseExtensionsError;

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

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2022 Google LLC
@@ -15,16 +15,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { PrefixedFirebaseError } from '../utils/error';
-type ExtensionsErrorCode = 'invalid-argument' | 'not-found' | 'forbidden' | 'internal-error' | 'unknown-error';
-/**
- * Firebase Extensions error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-export declare class FirebaseExtensionsError extends PrefixedFirebaseError {
-    constructor(code: ExtensionsErrorCode, message: string);
-}
 export {};

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

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,9 +17,11 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirebaseExtensionsError = exports.ExtensionsApiClient = void 0;
+exports.ExtensionsApiClient = void 0;
 const api_request_1 = require("../utils/api-request");
 const error_1 = require("../utils/error");
+const error_2 = require("./error");
+const error_3 = require("../app/error");
 const validator = require("../utils/validator");
 const utils = require("../utils");
 const FIREBASE_FUNCTIONS_CONFIG_HEADERS = {
@@ -37,7 +39,10 @@ class ExtensionsApiClient {
     constructor(app) {
         this.app = app;
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new error_1.FirebaseAppError('invalid-argument', 'First argument passed to getExtensions() must be a valid Firebase app instance.');
+            throw new error_3.FirebaseAppError({
+                code: 'invalid-argument',
+                message: 'First argument passed to getExtensions() must be a valid Firebase app instance.'
+            });
         }
         this.httpClient = new api_request_1.AuthorizedHttpClient(this.app);
     }
@@ -64,42 +69,49 @@ class ExtensionsApiClient {
         return `${this.getExtensionsApiUri()}/${EXTENSIONS_API_VERSION}/projects/${projectId}/instances/${instanceId}/runtimeData`;
     }
     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 FirebaseExtensionsError('unknown-error', `Unexpected response with status: ${response.status} and body: ${response.text}`);
+            return new error_2.FirebaseExtensionsError({
+                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;
-        const message = error?.message || `Unknown server error: ${response.text}`;
+        const message = error?.message || 'Unknown server error';
         switch (error.code) {
             case 403:
-                return new FirebaseExtensionsError('forbidden', message);
+                return new error_2.FirebaseExtensionsError({
+                    code: 'forbidden',
+                    message,
+                    httpResponse: (0, error_1.toHttpResponse)(response),
+                    cause: err,
+                });
             case 404:
-                return new FirebaseExtensionsError('not-found', message);
+                return new error_2.FirebaseExtensionsError({
+                    code: 'not-found',
+                    message,
+                    httpResponse: (0, error_1.toHttpResponse)(response),
+                    cause: err,
+                });
             case 500:
-                return new FirebaseExtensionsError('internal-error', message);
+                return new error_2.FirebaseExtensionsError({
+                    code: 'internal-error',
+                    message,
+                    httpResponse: (0, error_1.toHttpResponse)(response),
+                    cause: err,
+                });
         }
-        return new FirebaseExtensionsError('unknown-error', message);
+        return new error_2.FirebaseExtensionsError({
+            code: 'unknown-error',
+            message,
+            httpResponse: (0, error_1.toHttpResponse)(response),
+            cause: err,
+        });
     }
 }
 exports.ExtensionsApiClient = ExtensionsApiClient;
-/**
- * Firebase Extensions error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-class FirebaseExtensionsError extends error_1.PrefixedFirebaseError {
-    constructor(code, message) {
-        super('Extensions', 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__ = FirebaseExtensionsError.prototype;
-    }
-}
-exports.FirebaseExtensionsError = FirebaseExtensionsError;

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

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

package/lib/extensions/extensions-api.js

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

package/lib/extensions/extensions.d.ts

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

package/lib/extensions/extensions.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.Runtime = exports.Extensions = void 0;
 const extensions_api_client_internal_1 = require("./extensions-api-client-internal");
+const error_1 = require("./error");
 const validator = require("../utils/validator");
 /**
  * The Firebase `Extensions` service interface.
@@ -58,11 +59,17 @@ class Runtime {
     constructor(client) {
         this.projectId = this.getProjectId();
         if (!validator.isNonEmptyString(process.env['EXT_INSTANCE_ID'])) {
-            throw new extensions_api_client_internal_1.FirebaseExtensionsError('invalid-argument', 'Runtime is only available from within a running Extension instance.');
+            throw new error_1.FirebaseExtensionsError({
+                code: 'invalid-argument',
+                message: 'Runtime is only available from within a running Extension instance.'
+            });
         }
         this.extensionInstanceId = process.env['EXT_INSTANCE_ID'];
         if (!validator.isNonNullObject(client) || !('updateRuntimeData' in client)) {
-            throw new extensions_api_client_internal_1.FirebaseExtensionsError('invalid-argument', 'Must provide a valid ExtensionsApiClient instance to create a new Runtime.');
+            throw new error_1.FirebaseExtensionsError({
+                code: 'invalid-argument',
+                message: 'Must provide a valid ExtensionsApiClient instance to create a new Runtime.'
+            });
         }
         this.client = client;
     }
@@ -103,7 +110,10 @@ class Runtime {
      */
     async setFatalError(errorMessage) {
         if (!validator.isNonEmptyString(errorMessage)) {
-            throw new extensions_api_client_internal_1.FirebaseExtensionsError('invalid-argument', 'errorMessage must not be empty');
+            throw new error_1.FirebaseExtensionsError({
+                code: 'invalid-argument',
+                message: 'errorMessage must not be empty'
+            });
         }
         await this.client.updateRuntimeData(this.projectId, this.extensionInstanceId, {
             fatalError: {
@@ -114,7 +124,10 @@ class Runtime {
     getProjectId() {
         const projectId = process.env['PROJECT_ID'];
         if (!validator.isNonEmptyString(projectId)) {
-            throw new extensions_api_client_internal_1.FirebaseExtensionsError('invalid-argument', 'PROJECT_ID must not be undefined in Extensions runtime environment');
+            throw new error_1.FirebaseExtensionsError({
+                code: 'invalid-argument',
+                message: 'PROJECT_ID must not be undefined in Extensions runtime environment'
+            });
         }
         return projectId;
     }

package/lib/extensions/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 { SettableProcessingState } from './extensions-api';
   *   service associated with the provided app.
   */
 export declare function getExtensions(app?: App): Extensions;
+export { FirebaseExtensionsError, ExtensionsErrorCode } from './error';

package/lib/extensions/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.Runtime = exports.Extensions = void 0;
+exports.ExtensionsErrorCode = exports.FirebaseExtensionsError = exports.Runtime = exports.Extensions = void 0;
 exports.getExtensions = getExtensions;
 /**
  * Firebase Extensions service.
@@ -62,3 +62,6 @@ function getExtensions(app) {
     const firebaseApp = app;
     return firebaseApp.getOrInitService('extensions', (app) => new extensions_1.Extensions(app));
 }
+var error_1 = require("./error");
+Object.defineProperty(exports, "FirebaseExtensionsError", { enumerable: true, get: function () { return error_1.FirebaseExtensionsError; } });
+Object.defineProperty(exports, "ExtensionsErrorCode", { enumerable: true, get: function () { return error_1.ExtensionsErrorCode; } });