@firebase/ai 1.4.0 → 1.4.1-canary.2b5731292

package/dist/esm/index.esm2017.js

@@ -5,7 +5,7 @@ import { Logger } from '@firebase/logger';
 import { __asyncGenerator, __await } from 'tslib';
 
 var name = "@firebase/ai";
-var version = "1.4.0";
+var version = "1.4.1-canary.2b5731292";
 
 /**
  * @license
@@ -56,230 +56,221 @@ const POSSIBLE_ROLES = ['user', 'model', 'function', 'system'];
  * Harm categories that would cause prompts or candidates to be blocked.
  * @public
  */
-var HarmCategory;
-(function (HarmCategory) {
-    HarmCategory["HARM_CATEGORY_HATE_SPEECH"] = "HARM_CATEGORY_HATE_SPEECH";
-    HarmCategory["HARM_CATEGORY_SEXUALLY_EXPLICIT"] = "HARM_CATEGORY_SEXUALLY_EXPLICIT";
-    HarmCategory["HARM_CATEGORY_HARASSMENT"] = "HARM_CATEGORY_HARASSMENT";
-    HarmCategory["HARM_CATEGORY_DANGEROUS_CONTENT"] = "HARM_CATEGORY_DANGEROUS_CONTENT";
-})(HarmCategory || (HarmCategory = {}));
+const HarmCategory = {
+    HARM_CATEGORY_HATE_SPEECH: 'HARM_CATEGORY_HATE_SPEECH',
+    HARM_CATEGORY_SEXUALLY_EXPLICIT: 'HARM_CATEGORY_SEXUALLY_EXPLICIT',
+    HARM_CATEGORY_HARASSMENT: 'HARM_CATEGORY_HARASSMENT',
+    HARM_CATEGORY_DANGEROUS_CONTENT: 'HARM_CATEGORY_DANGEROUS_CONTENT'
+};
 /**
  * Threshold above which a prompt or candidate will be blocked.
  * @public
  */
-var HarmBlockThreshold;
-(function (HarmBlockThreshold) {
+const HarmBlockThreshold = {
     /**
      * Content with `NEGLIGIBLE` will be allowed.
      */
-    HarmBlockThreshold["BLOCK_LOW_AND_ABOVE"] = "BLOCK_LOW_AND_ABOVE";
+    BLOCK_LOW_AND_ABOVE: 'BLOCK_LOW_AND_ABOVE',
     /**
      * Content with `NEGLIGIBLE` and `LOW` will be allowed.
      */
-    HarmBlockThreshold["BLOCK_MEDIUM_AND_ABOVE"] = "BLOCK_MEDIUM_AND_ABOVE";
+    BLOCK_MEDIUM_AND_ABOVE: 'BLOCK_MEDIUM_AND_ABOVE',
     /**
      * Content with `NEGLIGIBLE`, `LOW`, and `MEDIUM` will be allowed.
      */
-    HarmBlockThreshold["BLOCK_ONLY_HIGH"] = "BLOCK_ONLY_HIGH";
+    BLOCK_ONLY_HIGH: 'BLOCK_ONLY_HIGH',
     /**
      * All content will be allowed.
      */
-    HarmBlockThreshold["BLOCK_NONE"] = "BLOCK_NONE";
+    BLOCK_NONE: 'BLOCK_NONE',
     /**
      * All content will be allowed. This is the same as `BLOCK_NONE`, but the metadata corresponding
      * to the {@link HarmCategory} will not be present in the response.
      */
-    HarmBlockThreshold["OFF"] = "OFF";
-})(HarmBlockThreshold || (HarmBlockThreshold = {}));
+    OFF: 'OFF'
+};
 /**
  * This property is not supported in the Gemini Developer API ({@link GoogleAIBackend}).
  *
  * @public
  */
-var HarmBlockMethod;
-(function (HarmBlockMethod) {
+const HarmBlockMethod = {
     /**
      * The harm block method uses both probability and severity scores.
      */
-    HarmBlockMethod["SEVERITY"] = "SEVERITY";
+    SEVERITY: 'SEVERITY',
     /**
      * The harm block method uses the probability score.
      */
-    HarmBlockMethod["PROBABILITY"] = "PROBABILITY";
-})(HarmBlockMethod || (HarmBlockMethod = {}));
+    PROBABILITY: 'PROBABILITY'
+};
 /**
  * Probability that a prompt or candidate matches a harm category.
  * @public
  */
-var HarmProbability;
-(function (HarmProbability) {
+const HarmProbability = {
     /**
      * Content has a negligible chance of being unsafe.
      */
-    HarmProbability["NEGLIGIBLE"] = "NEGLIGIBLE";
+    NEGLIGIBLE: 'NEGLIGIBLE',
     /**
      * Content has a low chance of being unsafe.
      */
-    HarmProbability["LOW"] = "LOW";
+    LOW: 'LOW',
     /**
      * Content has a medium chance of being unsafe.
      */
-    HarmProbability["MEDIUM"] = "MEDIUM";
+    MEDIUM: 'MEDIUM',
     /**
      * Content has a high chance of being unsafe.
      */
-    HarmProbability["HIGH"] = "HIGH";
-})(HarmProbability || (HarmProbability = {}));
+    HIGH: 'HIGH'
+};
 /**
  * Harm severity levels.
  * @public
  */
-var HarmSeverity;
-(function (HarmSeverity) {
+const HarmSeverity = {
     /**
      * Negligible level of harm severity.
      */
-    HarmSeverity["HARM_SEVERITY_NEGLIGIBLE"] = "HARM_SEVERITY_NEGLIGIBLE";
+    HARM_SEVERITY_NEGLIGIBLE: 'HARM_SEVERITY_NEGLIGIBLE',
     /**
      * Low level of harm severity.
      */
-    HarmSeverity["HARM_SEVERITY_LOW"] = "HARM_SEVERITY_LOW";
+    HARM_SEVERITY_LOW: 'HARM_SEVERITY_LOW',
     /**
      * Medium level of harm severity.
      */
-    HarmSeverity["HARM_SEVERITY_MEDIUM"] = "HARM_SEVERITY_MEDIUM";
+    HARM_SEVERITY_MEDIUM: 'HARM_SEVERITY_MEDIUM',
     /**
      * High level of harm severity.
      */
-    HarmSeverity["HARM_SEVERITY_HIGH"] = "HARM_SEVERITY_HIGH";
+    HARM_SEVERITY_HIGH: 'HARM_SEVERITY_HIGH',
     /**
      * Harm severity is not supported.
      *
      * @remarks
      * The GoogleAI backend does not support `HarmSeverity`, so this value is used as a fallback.
      */
-    HarmSeverity["HARM_SEVERITY_UNSUPPORTED"] = "HARM_SEVERITY_UNSUPPORTED";
-})(HarmSeverity || (HarmSeverity = {}));
+    HARM_SEVERITY_UNSUPPORTED: 'HARM_SEVERITY_UNSUPPORTED'
+};
 /**
  * Reason that a prompt was blocked.
  * @public
  */
-var BlockReason;
-(function (BlockReason) {
+const BlockReason = {
     /**
      * Content was blocked by safety settings.
      */
-    BlockReason["SAFETY"] = "SAFETY";
+    SAFETY: 'SAFETY',
     /**
      * Content was blocked, but the reason is uncategorized.
      */
-    BlockReason["OTHER"] = "OTHER";
+    OTHER: 'OTHER',
     /**
      * Content was blocked because it contained terms from the terminology blocklist.
      */
-    BlockReason["BLOCKLIST"] = "BLOCKLIST";
+    BLOCKLIST: 'BLOCKLIST',
     /**
      * Content was blocked due to prohibited content.
      */
-    BlockReason["PROHIBITED_CONTENT"] = "PROHIBITED_CONTENT";
-})(BlockReason || (BlockReason = {}));
+    PROHIBITED_CONTENT: 'PROHIBITED_CONTENT'
+};
 /**
  * Reason that a candidate finished.
  * @public
  */
-var FinishReason;
-(function (FinishReason) {
+const FinishReason = {
     /**
      * Natural stop point of the model or provided stop sequence.
      */
-    FinishReason["STOP"] = "STOP";
+    STOP: 'STOP',
     /**
      * The maximum number of tokens as specified in the request was reached.
      */
-    FinishReason["MAX_TOKENS"] = "MAX_TOKENS";
+    MAX_TOKENS: 'MAX_TOKENS',
     /**
      * The candidate content was flagged for safety reasons.
      */
-    FinishReason["SAFETY"] = "SAFETY";
+    SAFETY: 'SAFETY',
     /**
      * The candidate content was flagged for recitation reasons.
      */
-    FinishReason["RECITATION"] = "RECITATION";
+    RECITATION: 'RECITATION',
     /**
      * Unknown reason.
      */
-    FinishReason["OTHER"] = "OTHER";
+    OTHER: 'OTHER',
     /**
      * The candidate content contained forbidden terms.
      */
-    FinishReason["BLOCKLIST"] = "BLOCKLIST";
+    BLOCKLIST: 'BLOCKLIST',
     /**
      * The candidate content potentially contained prohibited content.
      */
-    FinishReason["PROHIBITED_CONTENT"] = "PROHIBITED_CONTENT";
+    PROHIBITED_CONTENT: 'PROHIBITED_CONTENT',
     /**
      * The candidate content potentially contained Sensitive Personally Identifiable Information (SPII).
      */
-    FinishReason["SPII"] = "SPII";
+    SPII: 'SPII',
     /**
      * The function call generated by the model was invalid.
      */
-    FinishReason["MALFORMED_FUNCTION_CALL"] = "MALFORMED_FUNCTION_CALL";
-})(FinishReason || (FinishReason = {}));
+    MALFORMED_FUNCTION_CALL: 'MALFORMED_FUNCTION_CALL'
+};
 /**
  * @public
  */
-var FunctionCallingMode;
-(function (FunctionCallingMode) {
+const FunctionCallingMode = {
     /**
      * Default model behavior; model decides to predict either a function call
      * or a natural language response.
      */
-    FunctionCallingMode["AUTO"] = "AUTO";
+    AUTO: 'AUTO',
     /**
      * Model is constrained to always predicting a function call only.
      * If `allowed_function_names` is set, the predicted function call will be
      * limited to any one of `allowed_function_names`, else the predicted
      * function call will be any one of the provided `function_declarations`.
      */
-    FunctionCallingMode["ANY"] = "ANY";
+    ANY: 'ANY',
     /**
      * Model will not predict any function call. Model behavior is same as when
      * not passing any function declarations.
      */
-    FunctionCallingMode["NONE"] = "NONE";
-})(FunctionCallingMode || (FunctionCallingMode = {}));
+    NONE: 'NONE'
+};
 /**
  * Content part modality.
  * @public
  */
-var Modality;
-(function (Modality) {
+const Modality = {
     /**
      * Unspecified modality.
      */
-    Modality["MODALITY_UNSPECIFIED"] = "MODALITY_UNSPECIFIED";
+    MODALITY_UNSPECIFIED: 'MODALITY_UNSPECIFIED',
     /**
      * Plain text.
      */
-    Modality["TEXT"] = "TEXT";
+    TEXT: 'TEXT',
     /**
      * Image.
      */
-    Modality["IMAGE"] = "IMAGE";
+    IMAGE: 'IMAGE',
     /**
      * Video.
      */
-    Modality["VIDEO"] = "VIDEO";
+    VIDEO: 'VIDEO',
     /**
      * Audio.
      */
-    Modality["AUDIO"] = "AUDIO";
+    AUDIO: 'AUDIO',
     /**
      * Document (for example, PDF).
      */
-    Modality["DOCUMENT"] = "DOCUMENT";
-})(Modality || (Modality = {}));
+    DOCUMENT: 'DOCUMENT'
+};
 /**
  * Generation modalities to be returned in generation responses.
  *
@@ -298,6 +289,56 @@ const ResponseModality = {
     IMAGE: 'IMAGE'
 };
 
+/**
+ * @license
+ * Copyright 2024 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.
+ */
+/**
+ * Standardized error codes that {@link AIError} can have.
+ *
+ * @public
+ */
+const AIErrorCode = {
+    /** A generic error occurred. */
+    ERROR: 'error',
+    /** An error occurred in a request. */
+    REQUEST_ERROR: 'request-error',
+    /** An error occurred in a response. */
+    RESPONSE_ERROR: 'response-error',
+    /** An error occurred while performing a fetch. */
+    FETCH_ERROR: 'fetch-error',
+    /** An error associated with a Content object.  */
+    INVALID_CONTENT: 'invalid-content',
+    /** An error due to the Firebase API not being enabled in the Console. */
+    API_NOT_ENABLED: 'api-not-enabled',
+    /** An error due to invalid Schema input.  */
+    INVALID_SCHEMA: 'invalid-schema',
+    /** An error occurred due to a missing Firebase API key. */
+    NO_API_KEY: 'no-api-key',
+    /** An error occurred due to a missing Firebase app ID. */
+    NO_APP_ID: 'no-app-id',
+    /** An error occurred due to a model name not being specified during initialization. */
+    NO_MODEL: 'no-model',
+    /** An error occurred due to a missing project ID. */
+    NO_PROJECT_ID: 'no-project-id',
+    /** An error occurred while parsing. */
+    PARSE_FAILED: 'parse-failed',
+    /** An error occurred due an attempt to use an unsupported feature. */
+    UNSUPPORTED: 'unsupported'
+};
+
 /**
  * @license
  * Copyright 2024 Google LLC
@@ -320,21 +361,20 @@ const ResponseModality = {
  * {@link https://swagger.io/docs/specification/data-models/data-types/ | OpenAPI specification}
  * @public
  */
-var SchemaType;
-(function (SchemaType) {
+const SchemaType = {
     /** String type. */
-    SchemaType["STRING"] = "string";
+    STRING: 'string',
     /** Number type. */
-    SchemaType["NUMBER"] = "number";
+    NUMBER: 'number',
     /** Integer type. */
-    SchemaType["INTEGER"] = "integer";
+    INTEGER: 'integer',
     /** Boolean type. */
-    SchemaType["BOOLEAN"] = "boolean";
+    BOOLEAN: 'boolean',
     /** Array type. */
-    SchemaType["ARRAY"] = "array";
+    ARRAY: 'array',
     /** Object type. */
-    SchemaType["OBJECT"] = "object";
-})(SchemaType || (SchemaType = {}));
+    OBJECT: 'object'
+};
 
 /**
  * @license
@@ -364,28 +404,27 @@ var SchemaType;
  *
  * @beta
  */
-var ImagenSafetyFilterLevel;
-(function (ImagenSafetyFilterLevel) {
+const ImagenSafetyFilterLevel = {
     /**
      * The most aggressive filtering level; most strict blocking.
      */
-    ImagenSafetyFilterLevel["BLOCK_LOW_AND_ABOVE"] = "block_low_and_above";
+    BLOCK_LOW_AND_ABOVE: 'block_low_and_above',
     /**
      * Blocks some sensitive prompts and responses.
      */
-    ImagenSafetyFilterLevel["BLOCK_MEDIUM_AND_ABOVE"] = "block_medium_and_above";
+    BLOCK_MEDIUM_AND_ABOVE: 'block_medium_and_above',
     /**
      * Blocks few sensitive prompts and responses.
      */
-    ImagenSafetyFilterLevel["BLOCK_ONLY_HIGH"] = "block_only_high";
+    BLOCK_ONLY_HIGH: 'block_only_high',
     /**
      * The least aggressive filtering level; blocks very few sensitive prompts and responses.
      *
      * Access to this feature is restricted and may require your case to be reviewed and approved by
      * Cloud support.
      */
-    ImagenSafetyFilterLevel["BLOCK_NONE"] = "block_none";
-})(ImagenSafetyFilterLevel || (ImagenSafetyFilterLevel = {}));
+    BLOCK_NONE: 'block_none'
+};
 /**
  * A filter level controlling whether generation of images containing people or faces is allowed.
  *
@@ -394,12 +433,11 @@ var ImagenSafetyFilterLevel;
  *
  * @beta
  */
-var ImagenPersonFilterLevel;
-(function (ImagenPersonFilterLevel) {
+const ImagenPersonFilterLevel = {
     /**
      * Disallow generation of images containing people or faces; images of people are filtered out.
      */
-    ImagenPersonFilterLevel["BLOCK_ALL"] = "dont_allow";
+    BLOCK_ALL: 'dont_allow',
     /**
      * Allow generation of images containing adults only; images of children are filtered out.
      *
@@ -407,7 +445,7 @@ var ImagenPersonFilterLevel;
      * reviewed and approved by Cloud support; see the {@link https://cloud.google.com/vertex-ai/generative-ai/docs/image/responsible-ai-imagen#person-face-gen | Responsible AI and usage guidelines}
      * for more details.
      */
-    ImagenPersonFilterLevel["ALLOW_ADULT"] = "allow_adult";
+    ALLOW_ADULT: 'allow_adult',
     /**
      * Allow generation of images containing adults only; images of children are filtered out.
      *
@@ -415,8 +453,8 @@ var ImagenPersonFilterLevel;
      * reviewed and approved by Cloud support; see the {@link https://cloud.google.com/vertex-ai/generative-ai/docs/image/responsible-ai-imagen#person-face-gen | Responsible AI and usage guidelines}
      * for more details.
      */
-    ImagenPersonFilterLevel["ALLOW_ALL"] = "allow_all";
-})(ImagenPersonFilterLevel || (ImagenPersonFilterLevel = {}));
+    ALLOW_ALL: 'allow_all'
+};
 /**
  * Aspect ratios for Imagen images.
  *
@@ -428,29 +466,28 @@ var ImagenPersonFilterLevel;
  *
  * @beta
  */
-var ImagenAspectRatio;
-(function (ImagenAspectRatio) {
+const ImagenAspectRatio = {
     /**
      * Square (1:1) aspect ratio.
      */
-    ImagenAspectRatio["SQUARE"] = "1:1";
+    'SQUARE': '1:1',
     /**
      * Landscape (3:4) aspect ratio.
      */
-    ImagenAspectRatio["LANDSCAPE_3x4"] = "3:4";
+    'LANDSCAPE_3x4': '3:4',
     /**
      * Portrait (4:3) aspect ratio.
      */
-    ImagenAspectRatio["PORTRAIT_4x3"] = "4:3";
+    'PORTRAIT_4x3': '4:3',
     /**
      * Landscape (16:9) aspect ratio.
      */
-    ImagenAspectRatio["LANDSCAPE_16x9"] = "16:9";
+    'LANDSCAPE_16x9': '16:9',
     /**
      * Portrait (9:16) aspect ratio.
      */
-    ImagenAspectRatio["PORTRAIT_9x16"] = "9:16";
-})(ImagenAspectRatio || (ImagenAspectRatio = {}));
+    'PORTRAIT_9x16': '9:16'
+};
 
 /**
  * @license
@@ -630,7 +667,7 @@ class AIError extends FirebaseError {
     /**
      * Constructs a new instance of the `AIError` class.
      *
-     * @param code - The error code from {@link AIErrorCode}.
+     * @param code - The error code from {@link (AIErrorCode:type)}.
      * @param message - A human-readable message describing the error.
      * @param customErrorData - Optional error data.
      */
@@ -691,7 +728,7 @@ function encodeInstanceIdentifier(backend) {
         return `${AI_TYPE}/vertexai/${backend.location}`;
     }
     else {
-        throw new AIError("error" /* AIErrorCode.ERROR */, `Invalid backend: ${JSON.stringify(backend.backendType)}`);
+        throw new AIError(AIErrorCode.ERROR, `Invalid backend: ${JSON.stringify(backend.backendType)}`);
     }
 }
 /**
@@ -702,20 +739,20 @@ function encodeInstanceIdentifier(backend) {
 function decodeInstanceIdentifier(instanceIdentifier) {
     const identifierParts = instanceIdentifier.split('/');
     if (identifierParts[0] !== AI_TYPE) {
-        throw new AIError("error" /* AIErrorCode.ERROR */, `Invalid instance identifier, unknown prefix '${identifierParts[0]}'`);
+        throw new AIError(AIErrorCode.ERROR, `Invalid instance identifier, unknown prefix '${identifierParts[0]}'`);
     }
     const backendType = identifierParts[1];
     switch (backendType) {
         case 'vertexai':
             const location = identifierParts[2];
             if (!location) {
-                throw new AIError("error" /* AIErrorCode.ERROR */, `Invalid instance identifier, unknown location '${instanceIdentifier}'`);
+                throw new AIError(AIErrorCode.ERROR, `Invalid instance identifier, unknown location '${instanceIdentifier}'`);
             }
             return new VertexAIBackend(location);
         case 'googleai':
             return new GoogleAIBackend();
         default:
-            throw new AIError("error" /* AIErrorCode.ERROR */, `Invalid instance identifier string: '${instanceIdentifier}'`);
+            throw new AIError(AIErrorCode.ERROR, `Invalid instance identifier string: '${instanceIdentifier}'`);
     }
 }
 
@@ -764,13 +801,13 @@ class AIModel {
     constructor(ai, modelName) {
         var _a, _b, _c, _d, _e, _f;
         if (!((_b = (_a = ai.app) === null || _a === void 0 ? void 0 : _a.options) === null || _b === void 0 ? void 0 : _b.apiKey)) {
-            throw new AIError("no-api-key" /* AIErrorCode.NO_API_KEY */, `The "apiKey" field is empty in the local Firebase config. Firebase AI requires this field to contain a valid API key.`);
+            throw new AIError(AIErrorCode.NO_API_KEY, `The "apiKey" field is empty in the local Firebase config. Firebase AI requires this field to contain a valid API key.`);
         }
         else if (!((_d = (_c = ai.app) === null || _c === void 0 ? void 0 : _c.options) === null || _d === void 0 ? void 0 : _d.projectId)) {
-            throw new AIError("no-project-id" /* AIErrorCode.NO_PROJECT_ID */, `The "projectId" field is empty in the local Firebase config. Firebase AI requires this field to contain a valid project ID.`);
+            throw new AIError(AIErrorCode.NO_PROJECT_ID, `The "projectId" field is empty in the local Firebase config. Firebase AI requires this field to contain a valid project ID.`);
         }
         else if (!((_f = (_e = ai.app) === null || _e === void 0 ? void 0 : _e.options) === null || _f === void 0 ? void 0 : _f.appId)) {
-            throw new AIError("no-app-id" /* AIErrorCode.NO_APP_ID */, `The "appId" field is empty in the local Firebase config. Firebase AI requires this field to contain a valid app ID.`);
+            throw new AIError(AIErrorCode.NO_APP_ID, `The "appId" field is empty in the local Firebase config. Firebase AI requires this field to contain a valid app ID.`);
         }
         else {
             this._apiSettings = {
@@ -911,7 +948,7 @@ class RequestUrl {
             return `projects/${this.apiSettings.project}/locations/${this.apiSettings.backend.location}/${this.model}`;
         }
         else {
-            throw new AIError("error" /* AIErrorCode.ERROR */, `Invalid backend: ${JSON.stringify(this.apiSettings.backend)}`);
+            throw new AIError(AIErrorCode.ERROR, `Invalid backend: ${JSON.stringify(this.apiSettings.backend)}`);
         }
     }
     get queryParams() {
@@ -996,12 +1033,13 @@ async function makeRequest(model, task, apiSettings, stream, body, requestOption
                 // ignored
             }
             if (response.status === 403 &&
+                errorDetails &&
                 errorDetails.some((detail) => detail.reason === 'SERVICE_DISABLED') &&
                 errorDetails.some((detail) => {
                     var _a, _b;
                     return (_b = (_a = detail.links) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.description.includes('Google developers console API activation');
                 })) {
-                throw new AIError("api-not-enabled" /* AIErrorCode.API_NOT_ENABLED */, `The Firebase AI SDK requires the Firebase AI ` +
+                throw new AIError(AIErrorCode.API_NOT_ENABLED, `The Firebase AI SDK requires the Firebase AI ` +
                     `API ('firebasevertexai.googleapis.com') to be enabled in your ` +
                     `Firebase project. Enable this API by visiting the Firebase Console ` +
                     `at https://console.firebase.google.com/project/${url.apiSettings.project}/genai/ ` +
@@ -1013,7 +1051,7 @@ async function makeRequest(model, task, apiSettings, stream, body, requestOption
                     errorDetails
                 });
             }
-            throw new AIError("fetch-error" /* AIErrorCode.FETCH_ERROR */, `Error fetching from ${url}: [${response.status} ${response.statusText}] ${message}`, {
+            throw new AIError(AIErrorCode.FETCH_ERROR, `Error fetching from ${url}: [${response.status} ${response.statusText}] ${message}`, {
                 status: response.status,
                 statusText: response.statusText,
                 errorDetails
@@ -1022,10 +1060,10 @@ async function makeRequest(model, task, apiSettings, stream, body, requestOption
     }
     catch (e) {
         let err = e;
-        if (e.code !== "fetch-error" /* AIErrorCode.FETCH_ERROR */ &&
-            e.code !== "api-not-enabled" /* AIErrorCode.API_NOT_ENABLED */ &&
+        if (e.code !== AIErrorCode.FETCH_ERROR &&
+            e.code !== AIErrorCode.API_NOT_ENABLED &&
             e instanceof Error) {
-            err = new AIError("error" /* AIErrorCode.ERROR */, `Error fetching from ${url.toString()}: ${e.message}`);
+            err = new AIError(AIErrorCode.ERROR, `Error fetching from ${url.toString()}: ${e.message}`);
             err.stack = e.stack;
         }
         throw err;
@@ -1084,14 +1122,14 @@ function addHelpers(response) {
                     `Access response.candidates directly to use the other candidates.`);
             }
             if (hadBadFinishReason(response.candidates[0])) {
-                throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, `Response error: ${formatBlockErrorMessage(response)}. Response body stored in error.response`, {
+                throw new AIError(AIErrorCode.RESPONSE_ERROR, `Response error: ${formatBlockErrorMessage(response)}. Response body stored in error.response`, {
                     response
                 });
             }
             return getText(response);
         }
         else if (response.promptFeedback) {
-            throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, `Text not available. ${formatBlockErrorMessage(response)}`, {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Text not available. ${formatBlockErrorMessage(response)}`, {
                 response
             });
         }
@@ -1105,14 +1143,14 @@ function addHelpers(response) {
                     `Access response.candidates directly to use the other candidates.`);
             }
             if (hadBadFinishReason(response.candidates[0])) {
-                throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, `Response error: ${formatBlockErrorMessage(response)}. Response body stored in error.response`, {
+                throw new AIError(AIErrorCode.RESPONSE_ERROR, `Response error: ${formatBlockErrorMessage(response)}. Response body stored in error.response`, {
                     response
                 });
             }
             return getInlineDataParts(response);
         }
         else if (response.promptFeedback) {
-            throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, `Data not available. ${formatBlockErrorMessage(response)}`, {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Data not available. ${formatBlockErrorMessage(response)}`, {
                 response
             });
         }
@@ -1126,14 +1164,14 @@ function addHelpers(response) {
                     `Access response.candidates directly to use the other candidates.`);
             }
             if (hadBadFinishReason(response.candidates[0])) {
-                throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, `Response error: ${formatBlockErrorMessage(response)}. Response body stored in error.response`, {
+                throw new AIError(AIErrorCode.RESPONSE_ERROR, `Response error: ${formatBlockErrorMessage(response)}. Response body stored in error.response`, {
                     response
                 });
             }
             return getFunctionCalls(response);
         }
         else if (response.promptFeedback) {
-            throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, `Function call not available. ${formatBlockErrorMessage(response)}`, {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Function call not available. ${formatBlockErrorMessage(response)}`, {
                 response
             });
         }
@@ -1206,7 +1244,7 @@ function getInlineDataParts(response) {
 const badFinishReasons = [FinishReason.RECITATION, FinishReason.SAFETY];
 function hadBadFinishReason(candidate) {
     return (!!candidate.finishReason &&
-        badFinishReasons.includes(candidate.finishReason));
+        badFinishReasons.some(reason => reason === candidate.finishReason));
 }
 function formatBlockErrorMessage(response) {
     var _a, _b, _c;
@@ -1246,7 +1284,7 @@ async function handlePredictResponse(response) {
     let filteredReason = undefined;
     // The backend should always send a non-empty array of predictions if the response was successful.
     if (!responseJson.predictions || ((_a = responseJson.predictions) === null || _a === void 0 ? void 0 : _a.length) === 0) {
-        throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, 'No predictions or filtered reason received from Vertex AI. Please report this issue with the full error details at https://github.com/firebase/firebase-js-sdk/issues.');
+        throw new AIError(AIErrorCode.RESPONSE_ERROR, 'No predictions or filtered reason received from Vertex AI. Please report this issue with the full error details at https://github.com/firebase/firebase-js-sdk/issues.');
     }
     for (const prediction of responseJson.predictions) {
         if (prediction.raiFilteredReason) {
@@ -1265,7 +1303,7 @@ async function handlePredictResponse(response) {
             });
         }
         else {
-            throw new AIError("response-error" /* AIErrorCode.RESPONSE_ERROR */, `Predictions array in response has missing properties. Response: ${JSON.stringify(responseJson)}`);
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Predictions array in response has missing properties. Response: ${JSON.stringify(responseJson)}`);
         }
     }
     return { images, filteredReason };
@@ -1312,7 +1350,7 @@ function mapGenerateContentRequest(generateContentRequest) {
     var _a, _b;
     (_a = generateContentRequest.safetySettings) === null || _a === void 0 ? void 0 : _a.forEach(safetySetting => {
         if (safetySetting.method) {
-            throw new AIError("unsupported" /* AIErrorCode.UNSUPPORTED */, 'SafetySetting.method is not supported in the the Gemini Developer API. Please remove this property.');
+            throw new AIError(AIErrorCode.UNSUPPORTED, 'SafetySetting.method is not supported in the the Gemini Developer API. Please remove this property.');
         }
     });
     if ((_b = generateContentRequest.generationConfig) === null || _b === void 0 ? void 0 : _b.topK) {
@@ -1395,7 +1433,7 @@ function mapGenerateContentCandidates(candidates) {
             // Throw early since developers may send a long video as input and only expect to pay
             // for inference on a small portion of the video.
             if ((_a = candidate.content) === null || _a === void 0 ? void 0 : _a.parts.some(part => part === null || part === void 0 ? void 0 : part.videoMetadata)) {
-                throw new AIError("unsupported" /* AIErrorCode.UNSUPPORTED */, 'Part.videoMetadata is not supported in the Gemini Developer API. Please remove this property.');
+                throw new AIError(AIErrorCode.UNSUPPORTED, 'Part.videoMetadata is not supported in the Gemini Developer API. Please remove this property.');
             }
             const mappedCandidate = {
                 index: candidate.index,
@@ -1516,7 +1554,7 @@ function getResponseStream(inputStream) {
                 return reader.read().then(({ value, done }) => {
                     if (done) {
                         if (currentText.trim()) {
-                            controller.error(new AIError("parse-failed" /* AIErrorCode.PARSE_FAILED */, 'Failed to parse stream'));
+                            controller.error(new AIError(AIErrorCode.PARSE_FAILED, 'Failed to parse stream'));
                             return;
                         }
                         controller.close();
@@ -1530,7 +1568,7 @@ function getResponseStream(inputStream) {
                             parsedResponse = JSON.parse(match[1]);
                         }
                         catch (e) {
-                            controller.error(new AIError("parse-failed" /* AIErrorCode.PARSE_FAILED */, `Error parsing JSON response: "${match[1]}`));
+                            controller.error(new AIError(AIErrorCode.PARSE_FAILED, `Error parsing JSON response: "${match[1]}`));
                             return;
                         }
                         controller.enqueue(parsedResponse);
@@ -1575,6 +1613,8 @@ function aggregateResponses(responses) {
                     candidate.finishMessage;
                 aggregatedResponse.candidates[i].safetyRatings =
                     candidate.safetyRatings;
+                aggregatedResponse.candidates[i].groundingMetadata =
+                    candidate.groundingMetadata;
                 /**
                  * Candidates should always have content and parts, but this handles
                  * possible malformed responses.
@@ -1601,7 +1641,7 @@ function aggregateResponses(responses) {
                             newPart.functionCall = part.functionCall;
                         }
                         if (Object.keys(newPart).length === 0) {
-                            throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, 'Part should have at least one property, but there are none. This is likely caused ' +
+                            throw new AIError(AIErrorCode.INVALID_CONTENT, 'Part should have at least one property, but there are none. This is likely caused ' +
                                 'by a malformed response from the backend.');
                         }
                         aggregatedResponse.candidates[i].content.parts.push(newPart);
@@ -1736,10 +1776,10 @@ function assignRoleToPartsAndValidateSendMessageRequest(parts) {
         }
     }
     if (hasUserContent && hasFunctionContent) {
-        throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, 'Within a single message, FunctionResponse cannot be mixed with other type of Part in the request for sending chat message.');
+        throw new AIError(AIErrorCode.INVALID_CONTENT, 'Within a single message, FunctionResponse cannot be mixed with other type of Part in the request for sending chat message.');
     }
     if (!hasUserContent && !hasFunctionContent) {
-        throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, 'No Content is provided for sending chat message.');
+        throw new AIError(AIErrorCode.INVALID_CONTENT, 'No Content is provided for sending chat message.');
     }
     if (hasUserContent) {
         return userContent;
@@ -1832,16 +1872,16 @@ function validateChatHistory(history) {
     for (const currContent of history) {
         const { role, parts } = currContent;
         if (!prevContent && role !== 'user') {
-            throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, `First Content should be with role 'user', got ${role}`);
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `First Content should be with role 'user', got ${role}`);
         }
         if (!POSSIBLE_ROLES.includes(role)) {
-            throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, `Each item should include role field. Got ${role} but valid roles are: ${JSON.stringify(POSSIBLE_ROLES)}`);
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `Each item should include role field. Got ${role} but valid roles are: ${JSON.stringify(POSSIBLE_ROLES)}`);
         }
         if (!Array.isArray(parts)) {
-            throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, `Content should have 'parts' but property with an array of Parts`);
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `Content should have 'parts' but property with an array of Parts`);
         }
         if (parts.length === 0) {
-            throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, `Each Content should have at least one part`);
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `Each Content should have at least one part`);
         }
         const countFields = {
             text: 0,
@@ -1859,13 +1899,13 @@ function validateChatHistory(history) {
         const validParts = VALID_PARTS_PER_ROLE[role];
         for (const key of VALID_PART_FIELDS) {
             if (!validParts.includes(key) && countFields[key] > 0) {
-                throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, `Content with role '${role}' can't contain '${key}' part`);
+                throw new AIError(AIErrorCode.INVALID_CONTENT, `Content with role '${role}' can't contain '${key}' part`);
             }
         }
         if (prevContent) {
             const validPreviousContentRoles = VALID_PREVIOUS_CONTENT_ROLES[role];
             if (!validPreviousContentRoles.includes(prevContent.role)) {
-                throw new AIError("invalid-content" /* AIErrorCode.INVALID_CONTENT */, `Content with role '${role}' can't follow '${prevContent.role}'. Valid previous roles: ${JSON.stringify(VALID_PREVIOUS_CONTENT_ROLES)}`);
+                throw new AIError(AIErrorCode.INVALID_CONTENT, `Content with role '${role}' can't follow '${prevContent.role}'. Valid previous roles: ${JSON.stringify(VALID_PREVIOUS_CONTENT_ROLES)}`);
             }
         }
         prevContent = currContent;
@@ -2388,7 +2428,7 @@ class ObjectSchema extends Schema {
         if (this.optionalProperties) {
             for (const propertyKey of this.optionalProperties) {
                 if (!this.properties.hasOwnProperty(propertyKey)) {
-                    throw new AIError("invalid-schema" /* AIErrorCode.INVALID_SCHEMA */, `Property "${propertyKey}" specified in "optionalProperties" does not exist.`);
+                    throw new AIError(AIErrorCode.INVALID_SCHEMA, `Property "${propertyKey}" specified in "optionalProperties" does not exist.`);
                 }
             }
         }
@@ -2488,50 +2528,6 @@ class ImagenImageFormat {
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/**
- * @deprecated Use the new {@link AIModel} instead. The Vertex AI in Firebase SDK has been
- * replaced with the Firebase AI SDK to accommodate the evolving set of supported features and
- * services. For migration details, see the {@link https://firebase.google.com/docs/vertex-ai/migrate-to-latest-sdk | migration guide}.
- *
- * Base class for Firebase AI model APIs.
- *
- * @public
- */
-const VertexAIModel = AIModel;
-/**
- * @deprecated Use the new {@link AIError} instead. The Vertex AI in Firebase SDK has been
- * replaced with the Firebase AI SDK to accommodate the evolving set of supported features and
- * services. For migration details, see the {@link https://firebase.google.com/docs/vertex-ai/migrate-to-latest-sdk | migration guide}.
- *
- * Error class for the Firebase AI SDK.
- *
- * @public
- */
-const VertexAIError = AIError;
-/**
- * @deprecated Use the new {@link getAI | getAI()} instead. The Vertex AI in Firebase SDK has been
- * replaced with the Firebase AI SDK to accommodate the evolving set of supported features and
- * services. For migration details, see the {@link https://firebase.google.com/docs/vertex-ai/migrate-to-latest-sdk | migration guide}.
- *
- * Returns a {@link VertexAI} instance for the given app, configured to use the
- * Vertex AI Gemini API. This instance will be
- * configured to use the Vertex AI Gemini API.
- *
- * @param app - The {@link @firebase/app#FirebaseApp} to use.
- * @param options - Options to configure the Vertex AI instance, including the location.
- *
- * @public
- */
-function getVertexAI(app = getApp(), options) {
-    app = getModularInstance(app);
-    // Dependencies
-    const AIProvider = _getProvider(app, AI_TYPE);
-    const backend = new VertexAIBackend(options === null || options === void 0 ? void 0 : options.location);
-    const identifier = encodeInstanceIdentifier(backend);
-    return AIProvider.getImmediate({
-        identifier
-    });
-}
 /**
  * Returns the default {@link AI} instance that is associated with the provided
  * {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new instance with the
@@ -2577,7 +2573,7 @@ function getAI(app = getApp(), options = { backend: new GoogleAIBackend() }) {
  */
 function getGenerativeModel(ai, modelParams, requestOptions) {
     if (!modelParams.model) {
-        throw new AIError("no-model" /* AIErrorCode.NO_MODEL */, `Must provide a model name. Example: getGenerativeModel({ model: 'my-model-name' })`);
+        throw new AIError(AIErrorCode.NO_MODEL, `Must provide a model name. Example: getGenerativeModel({ model: 'my-model-name' })`);
     }
     return new GenerativeModel(ai, modelParams, requestOptions);
 }
@@ -2597,7 +2593,7 @@ function getGenerativeModel(ai, modelParams, requestOptions) {
  */
 function getImagenModel(ai, modelParams, requestOptions) {
     if (!modelParams.model) {
-        throw new AIError("no-model" /* AIErrorCode.NO_MODEL */, `Must provide a model name. Example: getImagenModel({ model: 'my-model-name' })`);
+        throw new AIError(AIErrorCode.NO_MODEL, `Must provide a model name. Example: getImagenModel({ model: 'my-model-name' })`);
     }
     return new ImagenModel(ai, modelParams, requestOptions);
 }
@@ -2610,7 +2606,7 @@ function getImagenModel(ai, modelParams, requestOptions) {
 function registerAI() {
     _registerComponent(new Component(AI_TYPE, (container, { instanceIdentifier }) => {
         if (!instanceIdentifier) {
-            throw new AIError("error" /* AIErrorCode.ERROR */, 'AIService instance identifier is undefined.');
+            throw new AIError(AIErrorCode.ERROR, 'AIService instance identifier is undefined.');
         }
         const backend = decodeInstanceIdentifier(instanceIdentifier);
         // getImmediate for FirebaseApp will always succeed
@@ -2625,5 +2621,5 @@ function registerAI() {
 }
 registerAI();
 
-export { AIError, AIModel, ArraySchema, Backend, BackendType, BlockReason, BooleanSchema, ChatSession, FinishReason, FunctionCallingMode, GenerativeModel, GoogleAIBackend, HarmBlockMethod, HarmBlockThreshold, HarmCategory, HarmProbability, HarmSeverity, ImagenAspectRatio, ImagenImageFormat, ImagenModel, ImagenPersonFilterLevel, ImagenSafetyFilterLevel, IntegerSchema, Modality, NumberSchema, ObjectSchema, POSSIBLE_ROLES, ResponseModality, Schema, SchemaType, StringSchema, VertexAIBackend, VertexAIError, VertexAIModel, getAI, getGenerativeModel, getImagenModel, getVertexAI };
+export { AIError, AIErrorCode, AIModel, ArraySchema, Backend, BackendType, BlockReason, BooleanSchema, ChatSession, FinishReason, FunctionCallingMode, GenerativeModel, GoogleAIBackend, HarmBlockMethod, HarmBlockThreshold, HarmCategory, HarmProbability, HarmSeverity, ImagenAspectRatio, ImagenImageFormat, ImagenModel, ImagenPersonFilterLevel, ImagenSafetyFilterLevel, IntegerSchema, Modality, NumberSchema, ObjectSchema, POSSIBLE_ROLES, ResponseModality, Schema, SchemaType, StringSchema, VertexAIBackend, getAI, getGenerativeModel, getImagenModel };
 //# sourceMappingURL=index.esm2017.js.map