@umituz/react-native-ai-gemini-provider 3.0.22 → 3.0.24

package/dist/index.d.ts

@@ -5,7 +5,7 @@
 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, type ChatSendResult } from "./infrastructure/services/ChatSession";
+export { createChatSession, sendChatMessage, buildChatHistory, trimChatHistory, resolveAudioMimeType, resolveImageMimeType, type ChatSendResult, type ChatHistoryMessage, type SendChatMessageOptions, } 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

@@ -1,15 +1,67 @@
-import type { GeminiChatConfig, GeminiMessagePart } from "../../domain/entities";
+import type { GeminiChatConfig, GeminiGenerationConfig, GeminiContent, GeminiInlineDataPart, GeminiMessagePart, GeminiSafetySetting } from "../../domain/entities";
 export interface ChatSendResult {
     text: string;
     finishReason?: string;
 }
+/** A simple chat message (user/assistant/system) */
+export interface ChatHistoryMessage {
+    readonly role: "user" | "assistant" | "system";
+    readonly content: string;
+}
+/** Options for the high-level sendChatMessage() */
+export interface SendChatMessageOptions {
+    /** Conversation history */
+    history: ChatHistoryMessage[];
+    /** Current user message text */
+    message: string;
+    /** System instruction for the model */
+    systemPrompt?: string;
+    /** Model name (defaults to gemini-2.5-flash) */
+    model?: string;
+    /** Generation config (temperature, maxOutputTokens, etc.) */
+    generationConfig?: GeminiGenerationConfig;
+    /** Safety settings (defaults to BLOCK_NONE for all) */
+    safetySettings?: GeminiSafetySetting[];
+    /** Pre-built attachments (base64 inline data parts for images/audio) */
+    attachments?: GeminiInlineDataPart[];
+    /** Max character budget for history trimming (default 12000) */
+    historyMaxChars?: number;
+    /** Min messages to always keep regardless of budget (default 4) */
+    historyMinMessages?: number;
+}
+/** Resolve MIME type for an audio file extension */
+export declare function resolveAudioMimeType(extension: string): string;
+/** Resolve MIME type for an image file extension */
+export declare function resolveImageMimeType(extension: string): string;
+/**
+ * Converts chat messages (user/assistant/system) to Gemini SDK content format.
+ * Skips system messages, merges consecutive same-role messages.
+ */
+export declare function buildChatHistory(history: readonly ChatHistoryMessage[]): GeminiContent[];
+/**
+ * Trims conversation history to fit within a character budget.
+ * Keeps at least `minMessages` entries regardless of budget.
+ */
+export declare function trimChatHistory(history: ChatHistoryMessage[], maxChars?: number, minMessages?: number): ChatHistoryMessage[];
 /**
  * Creates a Gemini chat session with full support for system instructions,
  * safety settings, generation config, and multi-turn conversation history.
  */
 export declare function createChatSession(config?: GeminiChatConfig): {
-    /**
-     * Send a message and return the response text + finish reason.
-     */
     send(parts: GeminiMessagePart[]): Promise<ChatSendResult>;
 };
+/**
+ * All-in-one: trims history, builds session, sends message, handles safety.
+ * Returns the AI response text.
+ *
+ * ```ts
+ * const text = await sendChatMessage({
+ *   history: messages,
+ *   message: "hello",
+ *   systemPrompt: "You are Aria...",
+ *   model: GEMINI_MODELS.TEXT.FLASH,
+ *   generationConfig: { temperature: 0.7, maxOutputTokens: 512 },
+ * });
+ * ```
+ */
+export declare function sendChatMessage(opts: SendChatMessageOptions): Promise<string>;

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

@@ -3,4 +3,4 @@ export { textGeneration } from "./TextGeneration";
 export { structuredText } from "./StructuredText";
 export { streaming } from "./Streaming";
 export { geminiProvider, GeminiProvider } from "./GeminiProvider";
-export { createChatSession, type ChatSendResult } from "./ChatSession";
+export { createChatSession, sendChatMessage, buildChatHistory, trimChatHistory, resolveAudioMimeType, resolveImageMimeType, type ChatSendResult, type ChatHistoryMessage, type SendChatMessageOptions, } from "./ChatSession";

package/package.json

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

package/src/global.d.ts

@@ -0,0 +1 @@
+declare const __DEV__: boolean;

package/src/index.ts

@@ -34,7 +34,17 @@ export {
 
 // Services
 export { geminiClient } from "./infrastructure/services/GeminiClient";
-export { createChatSession, type ChatSendResult } from "./infrastructure/services/ChatSession";
+export {
+  createChatSession,
+  sendChatMessage,
+  buildChatHistory,
+  trimChatHistory,
+  resolveAudioMimeType,
+  resolveImageMimeType,
+  type ChatSendResult,
+  type ChatHistoryMessage,
+  type SendChatMessageOptions,
+} from "./infrastructure/services/ChatSession";
 export { textGeneration } from "./infrastructure/services/TextGeneration";
 export { structuredText } from "./infrastructure/services/StructuredText";
 export { streaming } from "./infrastructure/services/Streaming";

package/src/infrastructure/services/ChatSession.ts

@@ -3,14 +3,130 @@ import { geminiClient } from "./GeminiClient";
 import { DEFAULT_MODELS } from "../../domain/entities";
 import type {
   GeminiChatConfig,
+  GeminiGenerationConfig,
+  GeminiContent,
+  GeminiInlineDataPart,
   GeminiMessagePart,
+  GeminiSafetySetting,
 } from "../../domain/entities";
 
+// ─── Types ───────────────────────────────────────────────────────────────────
+
 export interface ChatSendResult {
   text: string;
   finishReason?: string;
 }
 
+/** A simple chat message (user/assistant/system) */
+export interface ChatHistoryMessage {
+  readonly role: "user" | "assistant" | "system";
+  readonly content: string;
+}
+
+/** Options for the high-level sendChatMessage() */
+export interface SendChatMessageOptions {
+  /** Conversation history */
+  history: ChatHistoryMessage[];
+  /** Current user message text */
+  message: string;
+  /** System instruction for the model */
+  systemPrompt?: string;
+  /** Model name (defaults to gemini-2.5-flash) */
+  model?: string;
+  /** Generation config (temperature, maxOutputTokens, etc.) */
+  generationConfig?: GeminiGenerationConfig;
+  /** Safety settings (defaults to BLOCK_NONE for all) */
+  safetySettings?: GeminiSafetySetting[];
+  /** Pre-built attachments (base64 inline data parts for images/audio) */
+  attachments?: GeminiInlineDataPart[];
+  /** Max character budget for history trimming (default 12000) */
+  historyMaxChars?: number;
+  /** Min messages to always keep regardless of budget (default 4) */
+  historyMinMessages?: number;
+}
+
+// ─── MIME Utilities ──────────────────────────────────────────────────────────
+
+const AUDIO_MIME: Record<string, string> = {
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  flac: "audio/flac",
+  aac: "audio/aac",
+  mp4: "audio/mp4",
+  m4a: "audio/mp4",
+  caf: "audio/mp4",
+  "3gp": "audio/3gpp",
+};
+
+/** Resolve MIME type for an audio file extension */
+export function resolveAudioMimeType(extension: string): string {
+  return AUDIO_MIME[extension.toLowerCase()] ?? "audio/mp4";
+}
+
+/** Resolve MIME type for an image file extension */
+export function resolveImageMimeType(extension: string): string {
+  return extension.toLowerCase() === "png" ? "image/png" : "image/jpeg";
+}
+
+// ─── History Utilities ───────────────────────────────────────────────────────
+
+/**
+ * Converts chat messages (user/assistant/system) to Gemini SDK content format.
+ * Skips system messages, merges consecutive same-role messages.
+ */
+export function buildChatHistory(
+  history: readonly ChatHistoryMessage[],
+): GeminiContent[] {
+  const result: GeminiContent[] = [];
+  let seenUser = false;
+
+  for (const m of history) {
+    if (m.role === "system") continue;
+    if (!seenUser && m.role !== "user") continue;
+    seenUser = true;
+
+    const role = m.role === "assistant" ? "model" : "user";
+    const last = result[result.length - 1];
+
+    if (last && last.role === role) {
+      const existingText =
+        "text" in last.parts[0] ? (last.parts[0].text ?? "") : "";
+      last.parts[0] = { text: existingText + "\n" + m.content };
+    } else {
+      result.push({ role, parts: [{ text: m.content }] });
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Trims conversation history to fit within a character budget.
+ * Keeps at least `minMessages` entries regardless of budget.
+ */
+export function trimChatHistory(
+  history: ChatHistoryMessage[],
+  maxChars = 12000,
+  minMessages = 4,
+): ChatHistoryMessage[] {
+  if (history.length <= minMessages) return history;
+
+  let totalChars = 0;
+  const trimmed: ChatHistoryMessage[] = [];
+
+  for (let i = history.length - 1; i >= 0; i--) {
+    const chars = history[i].content.length;
+    if (trimmed.length >= minMessages && totalChars + chars > maxChars) break;
+    trimmed.unshift(history[i]);
+    totalChars += chars;
+  }
+
+  return trimmed;
+}
+
+// ─── Low-level: createChatSession ────────────────────────────────────────────
+
 /**
  * Creates a Gemini chat session with full support for system instructions,
  * safety settings, generation config, and multi-turn conversation history.
@@ -33,17 +149,119 @@ export function createChatSession(config: GeminiChatConfig = {}) {
   });
 
   return {
-    /**
-     * Send a message and return the response text + finish reason.
-     */
     async send(parts: GeminiMessagePart[]): Promise<ChatSendResult> {
+      if (__DEV__) {
+        console.log("[ChatSession.send] >>> SENDING TO GEMINI SDK");
+        console.log("[ChatSession.send] parts count:", parts.length);
+        parts.forEach((p, i) => {
+          if ("text" in p) console.log(`[ChatSession.send] part[${i}] text:`, (p.text ?? "").substring(0, 200));
+          if ("inlineData" in p) console.log(`[ChatSession.send] part[${i}] inlineData: mime=${(p as GeminiInlineDataPart).inlineData.mimeType}, size=${(p as GeminiInlineDataPart).inlineData.data.length}`);
+        });
+      }
+
       const result = await chat.sendMessage(parts as Part[]);
       if (!result.response) throw new Error("No response from Gemini SDK");
       const candidate = result.response.candidates?.[0];
+      const text = result.response.text();
+
+      if (__DEV__) {
+        console.log("[ChatSession.send] <<< GEMINI SDK RESPONSE");
+        console.log("[ChatSession.send] finishReason:", candidate?.finishReason ?? "N/A");
+        console.log("[ChatSession.send] safetyRatings:", JSON.stringify(candidate?.safetyRatings ?? []));
+        console.log("[ChatSession.send] response text length:", text.length);
+        console.log("[ChatSession.send] response text:", text.substring(0, 500));
+        console.log("[ChatSession.send] response FULL text:", text);
+      }
+
       return {
-        text: result.response.text(),
+        text,
         finishReason: candidate?.finishReason ?? undefined,
       };
     },
   };
 }
+
+// ─── High-level: sendChatMessage ─────────────────────────────────────────────
+
+/**
+ * All-in-one: trims history, builds session, sends message, handles safety.
+ * Returns the AI response text.
+ *
+ * ```ts
+ * const text = await sendChatMessage({
+ *   history: messages,
+ *   message: "hello",
+ *   systemPrompt: "You are Aria...",
+ *   model: GEMINI_MODELS.TEXT.FLASH,
+ *   generationConfig: { temperature: 0.7, maxOutputTokens: 512 },
+ * });
+ * ```
+ */
+export async function sendChatMessage(
+  opts: SendChatMessageOptions,
+): Promise<string> {
+  if (__DEV__) {
+    console.log("═══════════════════════════════════════════════════");
+    console.log("[sendChatMessage] >>> START");
+    console.log("[sendChatMessage] model:", opts.model ?? DEFAULT_MODELS.CHAT);
+    console.log("[sendChatMessage] message:", opts.message.substring(0, 200));
+    console.log("[sendChatMessage] history count:", opts.history.length);
+    console.log("[sendChatMessage] systemPrompt length:", opts.systemPrompt?.length ?? 0);
+    console.log("[sendChatMessage] systemPrompt (first 500):", opts.systemPrompt?.substring(0, 500));
+    console.log("[sendChatMessage] generationConfig:", JSON.stringify(opts.generationConfig));
+    console.log("[sendChatMessage] safetySettings:", opts.safetySettings ? JSON.stringify(opts.safetySettings) : "USING DEFAULT (BLOCK_NONE)");
+    console.log("[sendChatMessage] attachments:", opts.attachments?.length ?? 0);
+  }
+
+  const trimmed = trimChatHistory(
+    opts.history,
+    opts.historyMaxChars,
+    opts.historyMinMessages,
+  );
+
+  if (__DEV__) {
+    console.log("[sendChatMessage] history after trim:", trimmed.length, "messages");
+    trimmed.forEach((m, i) => console.log(`[sendChatMessage] history[${i}]: role=${m.role}, content=${m.content.substring(0, 100)}`));
+  }
+
+  const geminiHistory = buildChatHistory(trimmed);
+
+  if (__DEV__) {
+    console.log("[sendChatMessage] geminiHistory (SDK format):", geminiHistory.length, "turns");
+    geminiHistory.forEach((h, i) => {
+      const text = "text" in h.parts[0] ? (h.parts[0] as { text: string }).text : "[non-text]";
+      console.log(`[sendChatMessage] geminiHistory[${i}]: role=${h.role}, text=${text.substring(0, 100)}`);
+    });
+  }
+
+  const session = createChatSession({
+    model: opts.model ?? DEFAULT_MODELS.CHAT,
+    systemInstruction: opts.systemPrompt,
+    safetySettings: opts.safetySettings,
+    generationConfig: opts.generationConfig,
+    history: geminiHistory,
+  });
+
+  const parts: GeminiMessagePart[] = [{ text: opts.message }];
+  if (opts.attachments) {
+    parts.push(...opts.attachments);
+  }
+
+  const result = await session.send(parts);
+
+  if (__DEV__) {
+    console.log("[sendChatMessage] finishReason:", result.finishReason);
+    console.log("[sendChatMessage] response text length:", result.text.length);
+    console.log("[sendChatMessage] response FULL:", result.text);
+    console.log("[sendChatMessage] <<< END");
+    console.log("═══════════════════════════════════════════════════");
+  }
+
+  if (result.finishReason === "SAFETY") {
+    if (__DEV__) console.warn("[sendChatMessage] ⚠️ SAFETY FILTER TRIGGERED but has text, returning partial");
+    if (result.text.trim()) return result.text;
+    throw new Error("Response blocked by safety filter.");
+  }
+
+  return result.text;
+}

package/src/infrastructure/services/GeminiClient.ts

@@ -78,6 +78,12 @@ class GeminiClient {
         }))
       : PERMISSIVE_SAFETY;
 
+    if (__DEV__) {
+      console.log("[GeminiClient.getModel] model:", effectiveModel);
+      console.log("[GeminiClient.getModel] systemInstruction length:", opts.systemInstruction?.length ?? 0);
+      console.log("[GeminiClient.getModel] safetySettings:", JSON.stringify(sdkSafety.map(s => ({ category: s.category, threshold: s.threshold }))));
+    }
+
     return this.client.getGenerativeModel({
       model: effectiveModel,
       ...(opts.systemInstruction && { systemInstruction: opts.systemInstruction }),

package/src/infrastructure/services/index.ts

@@ -3,4 +3,14 @@ export { textGeneration } from "./TextGeneration";
 export { structuredText } from "./StructuredText";
 export { streaming } from "./Streaming";
 export { geminiProvider, GeminiProvider } from "./GeminiProvider";
-export { createChatSession, type ChatSendResult } from "./ChatSession";
+export {
+  createChatSession,
+  sendChatMessage,
+  buildChatHistory,
+  trimChatHistory,
+  resolveAudioMimeType,
+  resolveImageMimeType,
+  type ChatSendResult,
+  type ChatHistoryMessage,
+  type SendChatMessageOptions,
+} from "./ChatSession";