@firebase/ai 1.4.1-canary.2d720995d → 1.4.1-canary.a9be6757f

package/dist/esm/src/requests/schema-builder.d.ts

@@ -24,10 +24,11 @@ import { SchemaInterface, SchemaType, SchemaParams, SchemaRequest } from '../typ
  */
 export declare abstract class Schema implements SchemaInterface {
     /**
-     * Optional. The type of the property. {@link
-     * (SchemaType:type)}.
+     * Optional. The type of the property.
+     * This can only be undefined when using `anyOf` schemas, which do not have an
+     * explicit type in the {@link https://swagger.io/docs/specification/v3_0/data-models/data-types/#any-type | OpenAPI specification}.
      */
-    type: SchemaType;
+    type?: SchemaType;
     /** Optional. The format of the property.
      * Supported formats:<br/>
      * <ul>
@@ -77,12 +78,15 @@ export declare abstract class Schema implements SchemaInterface {
     static integer(integerParams?: SchemaParams): IntegerSchema;
     static number(numberParams?: SchemaParams): NumberSchema;
     static boolean(booleanParams?: SchemaParams): BooleanSchema;
+    static anyOf(anyOfParams: SchemaParams & {
+        anyOf: TypedSchema[];
+    }): AnyOfSchema;
 }
 /**
  * A type that includes all specific Schema types.
  * @public
  */
-export type TypedSchema = IntegerSchema | NumberSchema | StringSchema | BooleanSchema | ObjectSchema | ArraySchema;
+export type TypedSchema = IntegerSchema | NumberSchema | StringSchema | BooleanSchema | ObjectSchema | ArraySchema | AnyOfSchema;
 /**
  * Schema class for "integer" types.
  * @public
@@ -149,3 +153,18 @@ export declare class ObjectSchema extends Schema {
      */
     toJSON(): SchemaRequest;
 }
+/**
+ * Schema class representing a value that can conform to any of the provided sub-schemas. This is
+ * useful when a field can accept multiple distinct types or structures.
+ * @public
+ */
+export declare class AnyOfSchema extends Schema {
+    anyOf: TypedSchema[];
+    constructor(schemaParams: SchemaParams & {
+        anyOf: TypedSchema[];
+    });
+    /**
+     * @internal
+     */
+    toJSON(): SchemaRequest;
+}

package/dist/esm/src/types/requests.d.ts

@@ -87,7 +87,7 @@ export interface GenerationConfig {
      * value can be a class generated with a {@link Schema} static method
      * like `Schema.string()` or `Schema.object()` or it can be a plain
      * JS object matching the {@link SchemaRequest} interface.
-     * <br/>Note: This only applies when the specified `responseMIMEType` supports a schema; currently
+     * <br/>Note: This only applies when the specified `responseMimeType` supports a schema; currently
      * this is limited to `application/json` and `text/x.enum`.
      */
     responseSchema?: TypedSchema | SchemaRequest;

package/dist/esm/src/types/responses.d.ts

@@ -192,10 +192,6 @@ export interface GroundingMetadata {
      * @deprecated Use {@link GroundingSupport} instead.
      */
     retrievalQueries?: string[];
-    /**
-     * @deprecated Use {@link GroundingChunk} instead.
-     */
-    groundingAttributions: GroundingAttribution[];
 }
 /**
  * Google search entry point.
@@ -308,16 +304,6 @@ export interface Segment {
      */
     text: string;
 }
-/**
- * @deprecated
- * @public
- */
-export interface GroundingAttribution {
-    segment: Segment;
-    confidenceScore?: number;
-    web?: WebAttribution;
-    retrievedContext?: RetrievedContextAttribution;
-}
 /**
  * @public
  */

package/dist/esm/src/types/schema.d.ts

@@ -47,6 +47,12 @@ export type SchemaType = (typeof SchemaType)[keyof typeof SchemaType];
  * @public
  */
 export interface SchemaShared<T> {
+    /**
+     * An array of {@link Schema}. The generated data must be valid against any of the schemas
+     * listed in this array. This allows specifying multiple possible structures or types for a
+     * single field.
+     */
+    anyOf?: T[];
     /** Optional. The format of the property.
      * When using the Gemini Developer API ({@link GoogleAIBackend}), this must be either `'enum'` or
      * `'date-time'`, otherwise requests will fail.
@@ -97,10 +103,10 @@ export interface SchemaParams extends SchemaShared<SchemaInterface> {
  */
 export interface SchemaRequest extends SchemaShared<SchemaRequest> {
     /**
-     * The type of the property. {@link
-     * (SchemaType:type)}.
+     * The type of the property. this can only be undefined when using `anyOf` schemas,
+     * which do not have an explicit type in the {@link https://swagger.io/docs/specification/v3_0/data-models/data-types/#any-type | OpenAPI specification }.
      */
-    type: SchemaType;
+    type?: SchemaType;
     /** Optional. Array of required property. */
     required?: string[];
 }
@@ -110,10 +116,10 @@ export interface SchemaRequest extends SchemaShared<SchemaRequest> {
  */
 export interface SchemaInterface extends SchemaShared<SchemaInterface> {
     /**
-     * The type of the property. {@link
-     * (SchemaType:type)}.
+     * The type of the property. this can only be undefined when using `anyof` schemas,
+     * which do not have an explicit type in the {@link https://swagger.io/docs/specification/v3_0/data-models/data-types/#any-type | OpenAPI Specification}.
      */
-    type: SchemaType;
+    type?: SchemaType;
 }
 /**
  * Interface for JSON parameters in a schema of {@link SchemaType}

package/dist/index.cjs.js

@@ -8,7 +8,7 @@ var util = require('@firebase/util');
 var logger$1 = require('@firebase/logger');
 
 var name = "@firebase/ai";
-var version = "1.4.1-canary.2d720995d";
+var version = "1.4.1-canary.a9be6757f";
 
 /**
  * @license
@@ -2311,12 +2311,19 @@ class ImagenModel extends AIModel {
  */
 class Schema {
     constructor(schemaParams) {
+        // TODO(dlarocque): Enforce this with union types
+        if (!schemaParams.type && !schemaParams.anyOf) {
+            throw new AIError(AIErrorCode.INVALID_SCHEMA, "A schema must have either a 'type' or an 'anyOf' array of sub-schemas.");
+        }
         // eslint-disable-next-line guard-for-in
         for (const paramKey in schemaParams) {
             this[paramKey] = schemaParams[paramKey];
         }
         // Ensure these are explicitly set to avoid TS errors.
         this.type = schemaParams.type;
+        this.format = schemaParams.hasOwnProperty('format')
+            ? schemaParams.format
+            : undefined;
         this.nullable = schemaParams.hasOwnProperty('nullable')
             ? !!schemaParams.nullable
             : false;
@@ -2363,6 +2370,9 @@ class Schema {
     static boolean(booleanParams) {
         return new BooleanSchema(booleanParams);
     }
+    static anyOf(anyOfParams) {
+        return new AnyOfSchema(anyOfParams);
+    }
 }
 /**
  * Schema class for "integer" types.
@@ -2490,6 +2500,34 @@ class ObjectSchema extends Schema {
         return obj;
     }
 }
+/**
+ * Schema class representing a value that can conform to any of the provided sub-schemas. This is
+ * useful when a field can accept multiple distinct types or structures.
+ * @public
+ */
+class AnyOfSchema extends Schema {
+    constructor(schemaParams) {
+        if (schemaParams.anyOf.length === 0) {
+            throw new AIError(AIErrorCode.INVALID_SCHEMA, "The 'anyOf' array must not be empty.");
+        }
+        super({
+            ...schemaParams,
+            type: undefined // anyOf schemas do not have an explicit type
+        });
+        this.anyOf = schemaParams.anyOf;
+    }
+    /**
+     * @internal
+     */
+    toJSON() {
+        const obj = super.toJSON();
+        // Ensure the 'anyOf' property contains serialized SchemaRequest objects.
+        if (this.anyOf && Array.isArray(this.anyOf)) {
+            obj.anyOf = this.anyOf.map(s => s.toJSON());
+        }
+        return obj;
+    }
+}
 
 /**
  * @license
@@ -2667,6 +2705,7 @@ registerAI();
 exports.AIError = AIError;
 exports.AIErrorCode = AIErrorCode;
 exports.AIModel = AIModel;
+exports.AnyOfSchema = AnyOfSchema;
 exports.ArraySchema = ArraySchema;
 exports.Backend = Backend;
 exports.BackendType = BackendType;