@umituz/react-native-ai-gemini-provider 3.0.19 → 3.0.20

package/dist/domain/entities/gemini.types.d.ts

@@ -88,3 +88,46 @@ export interface GeminiUsageMetadata {
     /** Total number of tokens used */
     totalTokenCount?: number;
 }
+/**
+ * Safety setting for a single harm category
+ */
+export interface GeminiSafetySetting {
+    category: GeminiHarmCategory;
+    threshold: GeminiHarmBlockThreshold;
+}
+/**
+ * Inline data part for binary content (images, audio)
+ */
+export interface GeminiInlineDataPart {
+    inlineData: {
+        mimeType: string;
+        data: string;
+    };
+}
+/**
+ * A message part that can be text or inline data
+ */
+export type GeminiMessagePart = GeminiPart | GeminiInlineDataPart;
+/**
+ * Options for creating a generative model instance
+ */
+export interface GeminiModelOptions {
+    model?: string;
+    systemInstruction?: string;
+    safetySettings?: GeminiSafetySetting[];
+}
+/**
+ * Configuration for a chat session
+ */
+export interface GeminiChatConfig {
+    /** Model name override */
+    model?: string;
+    /** System instruction for the model */
+    systemInstruction?: string;
+    /** Safety settings (defaults to BLOCK_NONE for all categories) */
+    safetySettings?: GeminiSafetySetting[];
+    /** Generation config (temperature, maxOutputTokens, etc.) */
+    generationConfig?: GeminiGenerationConfig;
+    /** Initial conversation history */
+    history?: GeminiContent[];
+}

package/dist/domain/entities/models.d.ts

@@ -6,6 +6,10 @@ export declare const GEMINI_MODELS: {
     readonly TEXT: {
         /** Lightweight flash model for fast text generation */
         readonly FLASH_LITE: "gemini-2.5-flash-lite";
+        /** Balanced flash model for general use */
+        readonly FLASH: "gemini-2.5-flash";
+        /** Premium model for complex tasks */
+        readonly PRO: "gemini-2.5-pro";
     };
 };
 /**
@@ -14,4 +18,6 @@ export declare const GEMINI_MODELS: {
 export declare const DEFAULT_MODELS: {
     /** Default model for text generation */
     readonly TEXT: "gemini-2.5-flash-lite";
+    /** Default model for chat sessions */
+    readonly CHAT: "gemini-2.5-flash";
 };

package/dist/index.d.ts

@@ -2,9 +2,10 @@
  * @umituz/react-native-ai-gemini-provider
  * Google Gemini AI provider for React Native applications
  */
-export type { GeminiConfig, GeminiGenerationConfig, GeminiHarmCategory, GeminiHarmBlockThreshold, GeminiContent, GeminiPart, GeminiResponse, GeminiCandidate, GeminiFinishReason, GeminiSafetyRating, GeminiUsageMetadata, GeminiErrorInfo, GeminiApiError, } from "./domain/entities";
+export type { GeminiConfig, GeminiGenerationConfig, GeminiHarmCategory, GeminiHarmBlockThreshold, GeminiContent, GeminiPart, GeminiInlineDataPart, GeminiMessagePart, GeminiSafetySetting, GeminiModelOptions, GeminiChatConfig, GeminiResponse, GeminiCandidate, GeminiFinishReason, GeminiSafetyRating, GeminiUsageMetadata, GeminiErrorInfo, GeminiApiError, } from "./domain/entities";
 export { GeminiErrorType, GeminiError, GEMINI_MODELS, DEFAULT_MODELS } from "./domain/entities";
 export { geminiClient } from "./infrastructure/services/GeminiClient";
+export { createChatSession } from "./infrastructure/services/ChatSession";
 export { textGeneration } from "./infrastructure/services/TextGeneration";
 export { structuredText } from "./infrastructure/services/StructuredText";
 export { streaming } from "./infrastructure/services/Streaming";

package/dist/infrastructure/services/ChatSession.d.ts

@@ -0,0 +1,24 @@
+import type { GeminiChatConfig, GeminiMessagePart } from "../../domain/entities";
+/**
+ * Creates a Gemini chat session with full support for system instructions,
+ * safety settings, generation config, and multi-turn conversation history.
+ *
+ * Usage:
+ * ```ts
+ * const session = createChatSession({
+ *   model: "gemini-2.5-flash",
+ *   systemInstruction: "You are a helpful assistant.",
+ *   generationConfig: { temperature: 0.7, maxOutputTokens: 512 },
+ *   history: geminiHistory,
+ * });
+ *
+ * const text = await session.send([{ text: "Hello" }]);
+ * ```
+ */
+export declare function createChatSession(config?: GeminiChatConfig): {
+    /**
+     * Send a message and return the full response text.
+     * Accepts text parts and/or inline data parts (images, audio).
+     */
+    send(parts: GeminiMessagePart[]): Promise<string>;
+};

package/dist/infrastructure/services/GeminiClient.d.ts

@@ -1,5 +1,5 @@
 import { GoogleGenerativeAI, type GenerativeModel } from "@google/generative-ai";
-import type { GeminiConfig } from "../../domain/entities";
+import type { GeminiConfig, GeminiModelOptions } from "../../domain/entities";
 declare class GeminiClient {
     private client;
     private config;
@@ -8,7 +8,11 @@ declare class GeminiClient {
     isInitialized(): boolean;
     getConfig(): GeminiConfig | null;
     getClient(): GoogleGenerativeAI | null;
-    getModel(modelName?: string): GenerativeModel;
+    /**
+     * Returns a GenerativeModel configured with optional safety settings and system instruction.
+     * When no safety settings are provided, defaults to BLOCK_NONE for all categories.
+     */
+    getModel(modelNameOrOptions?: string | GeminiModelOptions): GenerativeModel;
     reset(): void;
 }
 export declare const geminiClient: GeminiClient;

package/dist/infrastructure/services/index.d.ts

@@ -3,3 +3,4 @@ export { textGeneration } from "./TextGeneration";
 export { structuredText } from "./StructuredText";
 export { streaming } from "./Streaming";
 export { geminiProvider, GeminiProvider } from "./GeminiProvider";
+export { createChatSession } from "./ChatSession";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-gemini-provider",
-  "version": "3.0.19",
+  "version": "3.0.20",
   "description": "Google Gemini AI text generation provider for React Native applications",
   "main": "./src/index.ts",
   "types": "./dist/index.d.ts",