feat(firebase-ai): create ai package, vertexai wraps around it

eslint.config.mjs

@@ -37,8 +37,9 @@ export default [
       '**/app.playground.js',
       '**/type-test.ts',
       'packages/**/modular/dist/**/*',
-      'packages/vertexai/__tests__/test-utils',
+      'packages/ai/__tests__/test-utils',
       'packages/vertexai/dist',
+      'packages/ai/dist',
     ],
   },
   ...compat

package.json

@@ -18,7 +18,7 @@
     "lint:spellcheck": "spellchecker --quiet --files=\"docs/**/*.md\" --dictionaries=\"./.spellcheck.dict.txt\" --reports=\"spelling.json\" --plugins spell indefinite-article repeated-words syntax-mentions syntax-urls frontmatter",
     "tsc:compile": "tsc --project .",
     "lint:all": "yarn lint && yarn lint:markdown && yarn lint:spellcheck && yarn tsc:compile",
-    "tests:vertex:mocks": "yarn ts-node ./scripts/fetch_ai_mock_responses.ts && yarn ts-node ./packages/vertexai/__tests__/test-utils/convert-mocks.ts",
+    "tests:ai:mocks": "yarn ts-node ./scripts/fetch_ai_mock_responses.ts && yarn ts-node ./packages/ai/__tests__/test-utils/convert-mocks.ts",
     "tests:jest": "jest",
     "tests:jest-watch": "jest --watch",
     "tests:jest-coverage": "jest --coverage",

packages/ai/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## Feature
+
+Initial release of the Firebase AI Logic SDK (`FirebaseAI`). This SDK *replaces* the previous Vertex AI in Firebase SDK (`FirebaseVertexAI`) to accommodate the evolving set of supported features and services.
+The new Firebase AI Logic SDK provides **preview** support for the Gemini Developer API, including its free tier offering.
+Using the Firebase AI Logic SDK with the Vertex AI Gemini API is still generally available (GA).
+
+To start using the new SDK, import the `@react-native-firebase/ai` package and use the modular method `getAI()` to initialize. See details in the [migration guide](https://firebase.google.com/docs/vertex-ai/migrate-to-latest-sdk).
+
+Please update the following to move from VertexAI to FirebaseAI:
+
+```js
+// BEFORE - using firebase/vertexai
+import { initializeApp } from "firebase/app";
+~~import { getVertexAI, getGenerativeModel } from "firebase/vertexai";~~
+
+
+// AFTER - using firebase/ai
+import { initializeApp } from "firebase/app";
+import { getAI, getGenerativeModel } from "firebase/ai";
+```

packages/ai/LICENSE

@@ -0,0 +1,32 @@
+Apache-2.0 License
+------------------
+
+Copyright (c) 2016-present Invertase Limited <oss@invertase.io> & Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this library except in compliance with the License.
+
+You may obtain a copy of the Apache-2.0 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.
+
+
+Creative Commons Attribution 3.0 License
+----------------------------------------
+
+Copyright (c) 2016-present Invertase Limited <oss@invertase.io> & Contributors
+
+Documentation and other instructional materials provided for this project
+(including on a separate documentation repository or it's documentation website) are
+licensed under the Creative Commons Attribution 3.0 License. Code samples/blocks
+contained therein are licensed under the Apache License, Version 2.0 (the "License"), as above.
+
+You may obtain a copy of the Creative Commons Attribution 3.0 License at
+
+    https://creativecommons.org/licenses/by/3.0/

packages/ai/README.md

@@ -0,0 +1,55 @@
+<p align="center">
+  <a href="https://rnfirebase.io">
+    <img width="160px" src="https://i.imgur.com/JIyBtKW.png"><br/>
+  </a>
+  <h2 align="center">React Native Firebase - AI Logic</h2>
+</p>
+
+<p align="center">
+  <a href="https://api.rnfirebase.io/coverage/ai/detail"><img src="https://api.rnfirebase.io/coverage/ai/badge?style=flat-square" alt="Coverage"></a>
+  <a href="https://www.npmjs.com/package/@react-native-firebase/ai"><img src="https://img.shields.io/npm/dm/@react-native-firebase/ai.svg?style=flat-square" alt="NPM downloads"></a>
+  <a href="https://www.npmjs.com/package/@react-native-firebase/ai"><img src="https://img.shields.io/npm/v/@react-native-firebase/ai.svg?style=flat-square" alt="NPM version"></a>
+  <a href="/LICENSE"><img src="https://img.shields.io/npm/l/react-native-firebase.svg?style=flat-square" alt="License"></a>
+  <a href="https://lerna.js.org/"><img src="https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg?style=flat-square" alt="Maintained with Lerna"></a>
+</p>
+
+<p align="center">
+  <a href="https://invertase.link/discord"><img src="https://img.shields.io/discord/295953187817521152.svg?style=flat-square&colorA=7289da&label=Chat%20on%20Discord" alt="Chat on Discord"></a>
+  <a href="https://twitter.com/rnfirebase"><img src="https://img.shields.io/twitter/follow/rnfirebase.svg?style=flat-square&colorA=1da1f2&colorB=&label=Follow%20on%20Twitter" alt="Follow on Twitter"></a>
+  <a href="https://www.facebook.com/groups/rnfirebase"><img src="https://img.shields.io/badge/Follow%20on%20Facebook-4172B8?logo=facebook&style=flat-square&logoColor=fff" alt="Follow on Facebook"></a>
+</p>
+
+---
+
+Firebase AI Logic gives you access to the latest generative AI models from Google.
+
+If you need to call the Gemini API directly from your mobile or web app — rather than server-side — you can use the Firebase AI Logic client SDKs. These client SDKs are built specifically for use with mobile and web apps, offering security options against unauthorized clients as well as integrations with other Firebase services.
+
+[> Learn More](https://firebase.google.com/docs/ai-logic/)
+
+## Installation
+
+Requires `@react-native-firebase/app` to be installed.
+
+```bash
+yarn add @react-native-firebase/ai
+```
+
+## Documentation
+
+- [Quick Start](https://rnfirebase.io/ai/usage)
+
+## License
+
+- See [LICENSE](/LICENSE)
+
+---
+
+<p>
+  <img align="left" width="75px" src="https://static.invertase.io/assets/invertase-logo-small.png">
+  <p align="left">
+    Built and maintained with 💛 by <a href="https://invertase.io">Invertase</a>.
+  </p>
+</p>
+
+---

packages/ai/__tests__/api.test.ts

@@ -0,0 +1,199 @@
+/**
+ * @license
+ * Copyright 2025 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 { describe, expect, it } from '@jest/globals';
+import { type ReactNativeFirebase } from '../../app/lib';
+
+import { ModelParams, AIErrorCode } from '../lib/types';
+import { AIError } from '../lib/errors';
+import { getGenerativeModel } from '../lib/index';
+
+import { AI } from '../lib/public-types';
+import { GenerativeModel } from '../lib/models/generative-model';
+
+import { AI_TYPE } from '../lib/constants';
+import { GoogleAIBackend, VertexAIBackend } from '../lib/backend';
+
+const fakeAI: AI = {
+  app: {
+    name: 'DEFAULT',
+    options: {
+      apiKey: 'key',
+      appId: 'appId',
+      projectId: 'my-project',
+    },
+  } as ReactNativeFirebase.FirebaseApp,
+  backend: new VertexAIBackend('us-central1'),
+  location: 'us-central1',
+};
+
+const fakeGoogleAI: AI = {
+  app: {
+    name: 'DEFAULT',
+    automaticDataCollectionEnabled: true,
+    options: {
+      apiKey: 'key',
+      projectId: 'my-project',
+      appId: 'my-appid',
+    },
+  } as ReactNativeFirebase.FirebaseApp,
+  backend: new GoogleAIBackend(),
+  location: 'us-central1',
+};
+
+describe('API tests', () => {
+  describe('getGenerativeModel() with VertexAIBackend', () => {
+    it('should throw an error if no model is provided', () => {
+      try {
+        getGenerativeModel(fakeAI, {} as ModelParams);
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_MODEL);
+        expect((e as AIError).message).toContain(
+          `AI: Must provide a model name. Example: ` +
+            `getGenerativeModel({ model: 'my-model-name' }) (${AI_TYPE}/${AIErrorCode.NO_MODEL})`,
+        );
+      }
+    });
+
+    it('getGenerativeModel throws if no apiKey is provided', () => {
+      const fakeVertexNoApiKey = {
+        ...fakeAI,
+        app: { options: { projectId: 'my-project', appId: 'my-appid' } },
+      } as AI;
+      try {
+        getGenerativeModel(fakeVertexNoApiKey, { model: 'my-model' });
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_API_KEY);
+        expect((e as AIError).message).toBe(
+          `AI: The "apiKey" field is empty in the local ` +
+            `Firebase config. Firebase AI requires this field to` +
+            ` contain a valid API key. (${AI_TYPE}/${AIErrorCode.NO_API_KEY})`,
+        );
+      }
+    });
+
+    it('should throw an error if no projectId is provided', () => {
+      const fakeVertexNoProject = {
+        ...fakeAI,
+        app: { options: { apiKey: 'my-key' } },
+      } as AI;
+      try {
+        getGenerativeModel(fakeVertexNoProject, { model: 'my-model' });
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_PROJECT_ID);
+        expect((e as AIError).message).toBe(
+          `AI: The "projectId" field is empty in the local` +
+            ` Firebase config. Firebase AI requires this field ` +
+            `to contain a valid project ID. (${AI_TYPE}/${AIErrorCode.NO_PROJECT_ID})`,
+        );
+      }
+    });
+
+    it('should throw an error if no appId is provided', () => {
+      const fakeVertexNoAppId = {
+        ...fakeAI,
+        app: { options: { apiKey: 'my-key', projectId: 'my-projectid' } },
+      } as AI;
+      try {
+        getGenerativeModel(fakeVertexNoAppId, { model: 'my-model' });
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_APP_ID);
+        expect((e as AIError).message).toBe(
+          `AI: The "appId" field is empty in the local` +
+            ` Firebase config. Firebase AI requires this field ` +
+            `to contain a valid app ID. (${AI_TYPE}/${AIErrorCode.NO_APP_ID})`,
+        );
+      }
+    });
+
+    it('should return an instance of GenerativeModel', () => {
+      const genModel = getGenerativeModel(fakeAI, { model: 'my-model' });
+      expect(genModel).toBeInstanceOf(GenerativeModel);
+      expect(genModel.model).toBe('publishers/google/models/my-model');
+    });
+  });
+
+  describe('getGenerativeModel() with GoogleAIBackend', () => {
+    it('should throw an error if no model is provided', () => {
+      try {
+        getGenerativeModel(fakeGoogleAI, {} as ModelParams);
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_MODEL);
+        expect((e as AIError).message).toContain(
+          `AI: Must provide a model name. Example: ` +
+            `getGenerativeModel({ model: 'my-model-name' }) (${AI_TYPE}/${AIErrorCode.NO_MODEL})`,
+        );
+      }
+    });
+
+    it('getGenerativeModel throws if no apiKey is provided', () => {
+      const fakeGoogleNoApiKey = {
+        ...fakeGoogleAI,
+        app: { options: { projectId: 'my-project', appId: 'my-appid' } },
+      } as AI;
+      try {
+        getGenerativeModel(fakeGoogleNoApiKey, { model: 'my-model' });
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_API_KEY);
+        expect((e as AIError).message).toBe(
+          `AI: The "apiKey" field is empty in the local ` +
+            `Firebase config. Firebase AI requires this field to` +
+            ` contain a valid API key. (${AI_TYPE}/${AIErrorCode.NO_API_KEY})`,
+        );
+      }
+    });
+
+    it('should throw an error if no projectId is provided', () => {
+      const fakeGoogleNoProject = {
+        ...fakeGoogleAI,
+        app: { options: { apiKey: 'my-key' } },
+      } as AI;
+      try {
+        getGenerativeModel(fakeGoogleNoProject, { model: 'my-model' });
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_PROJECT_ID);
+        expect((e as AIError).message).toBe(
+          `AI: The "projectId" field is empty in the local` +
+            ` Firebase config. Firebase AI requires this field ` +
+            `to contain a valid project ID. (${AI_TYPE}/${AIErrorCode.NO_PROJECT_ID})`,
+        );
+      }
+    });
+
+    it('should throw an error if no appId is provided', () => {
+      const fakeGoogleNoAppId = {
+        ...fakeGoogleAI,
+        app: { options: { apiKey: 'my-key', projectId: 'my-projectid' } },
+      } as AI;
+      try {
+        getGenerativeModel(fakeGoogleNoAppId, { model: 'my-model' });
+      } catch (e) {
+        expect((e as AIError).code).toContain(AIErrorCode.NO_APP_ID);
+        expect((e as AIError).message).toBe(
+          `AI: The "appId" field is empty in the local` +
+            ` Firebase config. Firebase AI requires this field ` +
+            `to contain a valid app ID. (${AI_TYPE}/${AIErrorCode.NO_APP_ID})`,
+        );
+      }
+    });
+
+    it('should return an instance of GenerativeModel', () => {
+      const genModel = getGenerativeModel(fakeGoogleAI, { model: 'my-model' });
+      expect(genModel).toBeInstanceOf(GenerativeModel);
+      expect(genModel.model).toBe('models/my-model');
+    });
+  });
+});

packages/ai/__tests__/backend.test.ts

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 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 { describe, it, expect } from '@jest/globals';
+import { GoogleAIBackend, VertexAIBackend } from '../lib/backend';
+import { BackendType } from '../lib/public-types';
+import { DEFAULT_LOCATION } from '../lib/constants';
+
+describe('Backend', () => {
+  describe('GoogleAIBackend', () => {
+    it('should set backendType to GOOGLE_AI', () => {
+      const backend = new GoogleAIBackend();
+      expect(backend.backendType).toBe(BackendType.GOOGLE_AI);
+    });
+  });
+
+  describe('VertexAIBackend', () => {
+    it('should set backendType to VERTEX_AI', () => {
+      const backend = new VertexAIBackend();
+      expect(backend.backendType).toBe(BackendType.VERTEX_AI);
+      expect(backend.location).toBe(DEFAULT_LOCATION);
+    });
+
+    it('should set a custom location', () => {
+      const backend = new VertexAIBackend('test-location');
+      expect(backend.backendType).toBe(BackendType.VERTEX_AI);
+      expect(backend.location).toBe('test-location');
+    });
+
+    it('should use a default location if location is empty string', () => {
+      const backend = new VertexAIBackend('');
+      expect(backend.backendType).toBe(BackendType.VERTEX_AI);
+      expect(backend.location).toBe(DEFAULT_LOCATION);
+    });
+
+    it('uses default location if location is null', () => {
+      const backend = new VertexAIBackend(null as any);
+      expect(backend.backendType).toBe(BackendType.VERTEX_AI);
+      expect(backend.location).toBe(DEFAULT_LOCATION);
+    });
+  });
+});