Merge branch 'main' into data-connect-readme-doc

Author: armando-navarro

.github/workflows/test.yml

@@ -168,7 +168,7 @@ jobs:
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
+          registry-url: 'https://wombat-dressing-room.appspot.com/'
           check-latest: false
       - name: 'Download Artifacts'
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1

README.md

@@ -183,9 +183,9 @@ import { } from '@angular/fire/app-check';
 </td>
     <td>
 
-#### [Vertex AI](docs/vertexai.md#vertex-ai)
+#### [AI Logic](docs/ai.md#ai-logic)
 ```ts
-import { } from '@angular/fire/vertexai';
+import { } from '@angular/fire/ai';
 ```
 </td>
   </tr>

docs/ai.md

@@ -0,0 +1,53 @@
+<small>
+<a href="https://github.com/angular/angularfire">AngularFire</a> &#10097; <a href="../README.md#developer-guide">Developer Guide</a> &#10097; AI Logic
+</small>
+
+# AI Logic
+
+Firebase AI Logic gives you access to the latest generative AI models from Google: the Gemini models and Imagen models.
+
+[Learn more](https://firebase.google.com/docs/ai-logic)
+
+## Dependency Injection
+
+As a prerequisite, ensure that `AngularFire` has been added to your project via
+```bash
+ng add @angular/fire
+```
+
+Provide an AI instance in the application's `app.config.ts`:
+
+```ts
+import { provideFirebaseApp, initializeApp } from '@angular/fire/app';
+import { provideAI, getAI } from '@angular/fire/ai';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideFirebaseApp(() => initializeApp({ ... })),
+    provideAI(() => getAI()),
+    ...
+  ],
+  ...,
+}
+```
+
+Next inject `AI` into your component:
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { AI } from '@angular/fire/ai';
+
+@Component({ ... })
+export class MyComponent {
+    private ai = inject(AI);
+    ...
+}
+```
+
+## Firebase API
+
+AngularFire wraps the Firebase JS SDK to ensure proper functionality in Angular, while providing the same API.
+
+Update the imports from `import { ... } from 'firebase/ai'` to `import { ... } from '@angular/fire/ai'` and follow the official documentation.
+
+[Getting Started](https://firebase.google.com/docs/ai-logic/get-started?platform=web) | [API Reference](https://firebase.google.com/docs/reference/js/ai)

docs/vertexai.md

@@ -2,6 +2,10 @@
   "name": "@angular/fire",
   "version": "21.0.0-rc.0",
   "description": "Angular + Firebase = ❤️",
+  "publishConfig": {
+    "registry": "https://wombat-dressing-room.appspot.com",
+    "access": "public"
+  },
   "private": true,
   "scripts": {
     "test": "npm run build:jasmine && npm run test:node-esm && npm run test:chrome-headless",

package.json

@@ -3,6 +3,10 @@
   "name": "@angular/fire",
   "version": "ANGULARFIRE2_VERSION",
   "description": "Angular + Firebase = ❤️",
+  "publishConfig": {
+    "registry": "https://wombat-dressing-room.appspot.com",
+    "access": "public"
+  },
   "schematics": "./schematics/collection.json",
   "builders": "./schematics/builders.json",
   "keywords": [

src/package.json

@@ -12,7 +12,7 @@ export const enum FEATURES {
   Firestore,
   Storage,
   RemoteConfig,
-  VertexAI,
+  AI,
 }
 
 export const featureOptions = [
@@ -27,7 +27,7 @@ export const featureOptions = [
   { name: 'Performance Monitoring', value: FEATURES.Performance },
   { name: 'Cloud Storage', value: FEATURES.Storage },
   { name: 'Remote Config', value: FEATURES.RemoteConfig },
-  { name: 'Vertex AI', value: FEATURES.VertexAI },
+  { name: 'AI Logic', value: FEATURES.AI },
 ];
 
 export const enum PROJECT_TYPE { Static, CloudFunctions, CloudRun, WebFrameworks }

src/schematics/interfaces.ts

@@ -293,13 +293,13 @@ export function featureToRules(
               "@angular/fire/remote-config"
             )}(() => getRemoteConfig())`;
           });
-        case FEATURES.VertexAI:
+        case FEATURES.AI:
           return addRootProvider(projectName, ({ code, external }) => {
-            external("getVertexAI", "@angular/fire/vertexai");
+            external("getAI", "@angular/fire/ai");
             return code`${external(
-              "provideVertexAI",
-              "@angular/fire/vertexai"
-            )}(() => getVertexAI())`;
+              "provideAI",
+              "@angular/fire/ai"
+            )}(() => getAI())`;
           });
         default:
           return undefined;

src/schematics/utils.ts

@@ -17,5 +17,5 @@ fi;
 npm --no-git-tag-version --allow-same-version -f version $OVERRIDE_VERSION
 
 npm run build &&
-    echo "npm publish . --tag $NPM_TAG" > ./dist/packages-dist/publish.sh &&
+    echo "npm publish . --access public --registry https://wombat-dressing-room.appspot.com --tag $NPM_TAG" > ./dist/packages-dist/publish.sh &&
     chmod +x ./dist/packages-dist/publish.sh