Merge with main

.github/ISSUE_TEMPLATE/bug_report_v2.yaml

@@ -58,6 +58,7 @@ body:
       description: Select the Firebase product(s) relevant to your issue. You can select multiple options in the dropdown.
       multiple: true
       options:
+        - AI
         - Analytics
         - AppCheck
         - Auth
@@ -72,7 +73,6 @@ body:
         - Performance
         - Remote-Config
         - Storage
-        - VertexAI
     validations:
       required: true
   - type: textarea

.github/workflows/e2e-test.yml

@@ -30,8 +30,8 @@ jobs:
 
     defaults:
       run:
-        # Run any command steps in the /e2e subdir
-        working-directory: './e2e'
+        # Run any command steps in the /e2e/smoke-tests subdir
+        working-directory: './e2e/smoke-tests'
 
     steps:
       - name: Checkout Repo
@@ -53,7 +53,9 @@ jobs:
       - name: Poll npm until version to test is available for install
         run: |
           echo "Polling npm for firebase@${{ github.event.client_payload.versionOrTag }}"
-          node ../scripts/release/poll-npm-publish.js
+          node ./scripts/release/poll-npm-publish.js
+        # run in root
+        working-directory: '.'
         env:
           VERSION: ${{ github.event.client_payload.versionOrTag }}
       - name: Yarn install

.gitignore

@@ -103,4 +103,4 @@ vertexai-sdk-test-data
 mocks-lookup.ts
 
 # temp changeset output
-changeset-temp.json
+changeset-temp.json

.vscode/launch.json

@@ -9,7 +9,7 @@
       "type": "node",
       "request": "launch",
       "program": "${workspaceFolder}/node_modules/.bin/_mocha",
-      "cwd": "${workspaceRoot}/packages/vertexai",
+      "cwd": "${workspaceRoot}/packages/ai",
       "args": [
         "--require",
         "ts-node/register",
@@ -24,6 +24,26 @@
       },
       "sourceMaps": true
     },
+    {
+      "name": "AI Integration Tests (node)",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/node_modules/.bin/_mocha",
+      "cwd": "${workspaceRoot}/packages/ai",
+      "args": [
+        "--require",
+        "ts-node/register",
+        "--require",
+        "src/index.node.ts",
+        "--timeout",
+        "5000",
+        "integration/**/*.test.ts"
+      ],
+      "env": {
+        "TS_NODE_COMPILER_OPTIONS": "{\"module\":\"commonjs\"}"
+      },
+      "sourceMaps": true
+    },
     {
       "type": "node",
       "request": "launch",

README.md

@@ -143,6 +143,8 @@ and follow the instructions to login.
 
 For more information, visit https://firebase.google.com/docs/storage/web/download-files#cors_configuration
 
+Then, make sure you have anonymous sign-in provider enabled:
+
 #### Authentication Support
 
 Visit the authentication config in your project and enable the `Anonymous`

common/api-review/ai.api.md

@@ -518,7 +518,8 @@ export enum HarmBlockThreshold {
     BLOCK_LOW_AND_ABOVE = "BLOCK_LOW_AND_ABOVE",
     BLOCK_MEDIUM_AND_ABOVE = "BLOCK_MEDIUM_AND_ABOVE",
     BLOCK_NONE = "BLOCK_NONE",
-    BLOCK_ONLY_HIGH = "BLOCK_ONLY_HIGH"
+    BLOCK_ONLY_HIGH = "BLOCK_ONLY_HIGH",
+    OFF = "OFF"
 }
 
 // @public
@@ -790,6 +791,9 @@ export abstract class Schema implements SchemaInterface {
     format?: string;
     // (undocumented)
     static integer(integerParams?: SchemaParams): IntegerSchema;
+    items?: SchemaInterface;
+    maxItems?: number;
+    minItems?: number;
     nullable: boolean;
     // (undocumented)
     static number(numberParams?: SchemaParams): NumberSchema;
@@ -831,10 +835,16 @@ export interface SchemaShared<T> {
     example?: unknown;
     format?: string;
     items?: T;
+    maximum?: number;
+    maxItems?: number;
+    minimum?: number;
+    minItems?: number;
     nullable?: boolean;
     properties?: {
         [k: string]: T;
     };
+    propertyOrdering?: string[];
+    title?: string;
 }
 
 // @public

config/karma.base.js

@@ -68,7 +68,7 @@ const config = {
   // test results reporter to use
   // possible values: 'dots', 'progress'
   // available reporters: https://npmjs.org/browse/keyword/karma-reporter
-  reporters: ['mocha', 'coverage-istanbul'],
+  reporters: ['coverage-istanbul', 'mocha'],
 
   // web server port
   port: 8089,

docs-devsite/ai.md

@@ -448,13 +448,13 @@ export declare const enum AIErrorCode
 |  INVALID\_CONTENT | <code>&quot;invalid-content&quot;</code> | An error associated with a Content object. |
 |  INVALID\_SCHEMA | <code>&quot;invalid-schema&quot;</code> | An error due to invalid Schema input. |
 |  NO\_API\_KEY | <code>&quot;no-api-key&quot;</code> | An error occurred due to a missing Firebase API key. |
-|  NO\_APP\_ID | <code>&quot;no-app-id&quot;</code> | An error occured due to a missing Firebase app ID. |
+|  NO\_APP\_ID | <code>&quot;no-app-id&quot;</code> | An error occurred due to a missing Firebase app ID. |
 |  NO\_MODEL | <code>&quot;no-model&quot;</code> | An error occurred due to a model name not being specified during initialization. |
 |  NO\_PROJECT\_ID | <code>&quot;no-project-id&quot;</code> | An error occurred due to a missing project ID. |
 |  PARSE\_FAILED | <code>&quot;parse-failed&quot;</code> | An error occurred while parsing. |
 |  REQUEST\_ERROR | <code>&quot;request-error&quot;</code> | An error occurred in a request. |
 |  RESPONSE\_ERROR | <code>&quot;response-error&quot;</code> | An error occurred in a response. |
-|  UNSUPPORTED | <code>&quot;unsupported&quot;</code> | An error occured due an attempt to use an unsupported feature. |
+|  UNSUPPORTED | <code>&quot;unsupported&quot;</code> | An error occurred due an attempt to use an unsupported feature. |
 
 ## BlockReason
 
@@ -551,6 +551,7 @@ export declare enum HarmBlockThreshold
 |  BLOCK\_MEDIUM\_AND\_ABOVE | <code>&quot;BLOCK_MEDIUM_AND_ABOVE&quot;</code> | Content with <code>NEGLIGIBLE</code> and <code>LOW</code> will be allowed. |
 |  BLOCK\_NONE | <code>&quot;BLOCK_NONE&quot;</code> | All content will be allowed. |
 |  BLOCK\_ONLY\_HIGH | <code>&quot;BLOCK_ONLY_HIGH&quot;</code> | Content with <code>NEGLIGIBLE</code>, <code>LOW</code>, and <code>MEDIUM</code> will be allowed. |
+|  OFF | <code>&quot;OFF&quot;</code> | All content will be allowed. This is the same as <code>BLOCK_NONE</code>, but the metadata corresponding to the [HarmCategory](./ai.md#harmcategory) will not be present in the response. |
 
 ## HarmCategory
 

docs-devsite/ai.schema.md

@@ -32,6 +32,9 @@ export declare abstract class Schema implements SchemaInterface
 |  [description](./ai.schema.md#schemadescription) |  | string | Optional. The description of the property. |
 |  [example](./ai.schema.md#schemaexample) |  | unknown | Optional. The example of the property. |
 |  [format](./ai.schema.md#schemaformat) |  | string | Optional. The format of the property. Supported formats:<br/> <ul> <li>for NUMBER type: "float", "double"</li> <li>for INTEGER type: "int32", "int64"</li> <li>for STRING type: "email", "byte", etc</li> </ul> |
+|  [items](./ai.schema.md#schemaitems) |  | [SchemaInterface](./ai.schemainterface.md#schemainterface_interface) | Optional. The items of the property. |
+|  [maxItems](./ai.schema.md#schemamaxitems) |  | number | The maximum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->. |
+|  [minItems](./ai.schema.md#schemaminitems) |  | number | The minimum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->. |
 |  [nullable](./ai.schema.md#schemanullable) |  | boolean | Optional. Whether the property is nullable. Defaults to false. |
 |  [type](./ai.schema.md#schematype) |  | [SchemaType](./ai.md#schematype) | Optional. The type of the property. [SchemaType](./ai.md#schematype)<!-- -->. |
 
@@ -93,6 +96,36 @@ Optional. The format of the property. Supported formats:<br/> <ul> <li>for NUMBE
 format?: string;
 ```
 
+## Schema.items
+
+Optional. The items of the property.
+
+<b>Signature:</b>
+
+```typescript
+items?: SchemaInterface;
+```
+
+## Schema.maxItems
+
+The maximum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->.
+
+<b>Signature:</b>
+
+```typescript
+maxItems?: number;
+```
+
+## Schema.minItems
+
+The minimum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->.
+
+<b>Signature:</b>
+
+```typescript
+minItems?: number;
+```
+
 ## Schema.nullable
 
 Optional. Whether the property is nullable. Defaults to false.

docs-devsite/ai.schemashared.md

@@ -27,8 +27,14 @@ export interface SchemaShared<T>
 |  [example](./ai.schemashared.md#schemasharedexample) | unknown | Optional. The example of the property. |
 |  [format](./ai.schemashared.md#schemasharedformat) | string | Optional. The format of the property. When using the Gemini Developer API ([GoogleAIBackend](./ai.googleaibackend.md#googleaibackend_class)<!-- -->), this must be either <code>'enum'</code> or <code>'date-time'</code>, otherwise requests will fail. |
 |  [items](./ai.schemashared.md#schemashareditems) | T | Optional. The items of the property. |
+|  [maximum](./ai.schemashared.md#schemasharedmaximum) | number | The maximum value of a numeric type. |
+|  [maxItems](./ai.schemashared.md#schemasharedmaxitems) | number | The maximum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->. |
+|  [minimum](./ai.schemashared.md#schemasharedminimum) | number | The minimum value of a numeric type. |
+|  [minItems](./ai.schemashared.md#schemasharedminitems) | number | The minimum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->. |
 |  [nullable](./ai.schemashared.md#schemasharednullable) | boolean | Optional. Whether the property is nullable. |
 |  [properties](./ai.schemashared.md#schemasharedproperties) | { \[k: string\]: T; } | Optional. Map of <code>Schema</code> objects. |
+|  [propertyOrdering](./ai.schemashared.md#schemasharedpropertyordering) | string\[\] | A hint suggesting the order in which the keys should appear in the generated JSON string. |
+|  [title](./ai.schemashared.md#schemasharedtitle) | string | The title of the property. This helps document the schema's purpose but does not typically constrain the generated value. It can subtly guide the model by clarifying the intent of a field. |
 
 ## SchemaShared.description
 
@@ -80,6 +86,46 @@ Optional. The items of the property.
 items?: T;
 ```
 
+## SchemaShared.maximum
+
+The maximum value of a numeric type.
+
+<b>Signature:</b>
+
+```typescript
+maximum?: number;
+```
+
+## SchemaShared.maxItems
+
+The maximum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->.
+
+<b>Signature:</b>
+
+```typescript
+maxItems?: number;
+```
+
+## SchemaShared.minimum
+
+The minimum value of a numeric type.
+
+<b>Signature:</b>
+
+```typescript
+minimum?: number;
+```
+
+## SchemaShared.minItems
+
+The minimum number of items (elements) in a schema of type [SchemaType.ARRAY](./ai.md#schematypearray_enummember)<!-- -->.
+
+<b>Signature:</b>
+
+```typescript
+minItems?: number;
+```
+
 ## SchemaShared.nullable
 
 Optional. Whether the property is nullable.
@@ -101,3 +147,23 @@ properties?: {
         [k: string]: T;
     };
 ```
+
+## SchemaShared.propertyOrdering
+
+A hint suggesting the order in which the keys should appear in the generated JSON string.
+
+<b>Signature:</b>
+
+```typescript
+propertyOrdering?: string[];
+```
+
+## SchemaShared.title
+
+The title of the property. This helps document the schema's purpose but does not typically constrain the generated value. It can subtly guide the model by clarifying the intent of a field.
+
+<b>Signature:</b>
+
+```typescript
+title?: string;
+```