@umituz/react-native-ai-gemini-provider 2.0.13 → 2.0.15

package/src/infrastructure/response/README.md

@@ -1,187 +0,0 @@
-# Response Module
-
-Response formatting and transformation utilities for Gemini API responses. Provides consistent response structures.
-
-## 📍 Import Path
-
-```
-import {
-  ResponseFormatter
-} from '@umituz/react-native-ai-gemini-provider';
-```
-
-## 🎯 Purpose
-
-Use response module to format and transform Gemini API responses consistently. Extracts text and image data from responses.
-
-**When to use:**
-- Format API responses consistently
-- Extract text from responses
-- Extract image data from multimodal responses
-- Normalize response structures
-- Handle response types safely
-
-## 📌 Strategy
-
-Response formatting ensures consistency. This module:
-- Extracts text content automatically
-- Handles image data in responses
-- Provides typed response structures
-- Preserves original response
-- Simplifies response handling
-
-**Key Decision**: Always format responses before using. Provides consistent interface for different response types.
-
-## ⚠️ Rules
-
-### Formatting Rules
-- **MUST** format all API responses
-- **SHOULD** specify expected response type
-- **MUST** check for optional fields
-- **SHOULD** preserve original response
-- **MUST NOT** assume response structure
-
-### Type Safety Rules
-- **SHOULD** use generic type parameter
-- **MUST** check for optional fields
-- **SHOULD** use type guards
-- **MUST** handle undefined values
-- **SHOULD NOT** use non-null assertion
-
-### Data Extraction Rules
-- **MUST** handle missing text gracefully
-- **SHOULD** validate image data
-- **MUST** check for image presence
-- **SHOULD** extract MIME type correctly
-- **MUST NOT** fail on partial data
-
-### Error Handling Rules
-- **SHOULD** wrap formatting in try-catch
-- **MUST** handle malformed responses
-- **SHOULD** log formatting errors
-- **MUST** provide fallback values
-- **SHOULD NOT** throw formatting errors
-
-## 🤖 AI Agent Guidelines
-
-### When Formatting Responses
-1. **CREATE** ResponseFormatter instance
-2. **CALL** formatResponse() with type
-3. **CHECK** for optional fields
-4. **EXTRACT** needed data
-5. **HANDLE** missing data gracefully
-
-### When Handling Text Responses
-1. **FORMAT** response with text type
-2. **CHECK** text field exists
-3. **VALIDATE** text not empty
-4. **USE** text value
-5. **HANDLE** empty text case
-
-### When Handling Image Responses
-1. **FORMAT** response with image type
-2. **CHECK** imageUrl exists
-3. **EXTRACT** imageBase64 if needed
-4. **USE** MIME type correctly
-5. **HANDLE** missing image case
-
-### Code Style Rules
-- **USE** generic type parameter
-- **CHECK** optional fields before use
-- **PROVIDE** fallback values
-- **LOG** formatting issues
-- **PRESERVE** original response
-
-## 📦 Available Classes
-
-### ResponseFormatter
-
-**Refer to**: [`ResponseFormatter.ts`](./ResponseFormatter.ts)
-
-**Methods:**
-- `formatResponse<T>(response, input)` - Format response to typed structure
-
-## 🔗 Related Modules
-
-- **Text Generation**: [`../services/TEXT_GENERATION_SERVICE.md`](../services/TEXT_GENERATION_SERVICE.md)
-- **Image Generation**: [`../services/IMAGE_GENERATION_SERVICE.md`](../services/IMAGE_GENERATION_SERVICE.md)
-- **Data Transformer**: [`../utils/DATA_TRANSFORMER_UTILS.md`](../utils/DATA_TRANSFORMER_UTILS.md)
-
-## 📋 Response Types
-
-### Text Response
-```typescript
-{
-  text: string;              // Extracted text content
-  response: unknown;         // Original API response
-}
-```
-
-### Multimodal Response
-```typescript
-{
-  text: string;              // Extracted text content
-  imageUrl: string;          // Data URL (data:image/png;base64,...)
-  imageBase64: string;       // Base64 image data
-  mimeType: string;          // Image MIME type
-  response: unknown;         // Original API response
-}
-```
-
-## 🎓 Usage Patterns
-
-### Basic Formatting
-1. Create ResponseFormatter instance
-2. Call formatResponse() with type
-3. Extract needed fields
-4. Check for optional data
-5. Handle response appropriately
-
-### Text Response Handling
-1. Format response as text type
-2. Check text field exists
-3. Validate text content
-4. Use text in application
-5. Handle empty text case
-
-### Image Response Handling
-1. Format response with image type
-2. Check imageUrl exists
-3. Extract imageBase64 if needed
-4. Use imageUrl for display
-5. Handle missing image case
-
-### Multimodal Handling
-1. Format response
-2. Check for both text and image
-3. Handle different response types
-4. Display appropriate content
-5. Fallback to available data
-
-### Type-Safe Formatting
-1. Define response interface
-2. Format with generic type
-3. Use type guards
-4. Narrow response type
-5. Use typed data safely
-
-## 🚨 Common Pitfalls
-
-### Don't
-- Assume text field always exists
-- Use imageUrl without checking
-- Discard original response
-- Use non-null assertions
-- Skip type checking
-
-### Do
-- Always check optional fields
-- Validate data before use
-- Preserve original response
-- Use type guards
-- Handle missing data gracefully
-
----
-
-**Last Updated**: 2025-01-08
-**See Also**: [AI_GUIDELINES.md](../../../../AI_GUIDELINES.md)

package/src/infrastructure/response/RESPONSE_FORMATTER.md

@@ -1,185 +0,0 @@
-# Response Formatter
-
-Utility for formatting Gemini API responses into consistent output structures. Handles text and image data extraction from API responses.
-
-## 📍 Import Path
-
-```
-import { ResponseFormatter } from '@umituz/react-native-ai-gemini-provider';
-```
-
-## 🎯 Purpose
-
-Use ResponseFormatter to convert raw Gemini API responses into consistent, typed structures. Extracts text and image data automatically.
-
-**When to use:**
-- Format API responses consistently
-- Extract text from responses
-- Extract image data from multimodal responses
-- Normalize response structures
-- Handle response types safely
-
-## 📌 Strategy
-
-Response formatting ensures consistency. This utility:
-- Extracts text content automatically
-- Handles image data in responses
-- Provides typed response structures
-- Preserves original response
-- Simplifies response handling
-
-**Key Decision**: Always format responses before using. Provides consistent interface for different response types.
-
-## ⚠️ Rules
-
-### Formatting Rules
-- **MUST** format all API responses
-- **SHOULD** specify expected response type
-- **MUST** check for optional fields
-- **SHOULD** preserve original response
-- **MUST NOT** assume response structure
-
-### Type Safety Rules
-- **SHOULD** use generic type parameter
-- **MUST** check for optional fields
-- **SHOULD** use type guards
-- **MUST** handle undefined values
-- **SHOULD NOT** use non-null assertion
-
-### Data Extraction Rules
-- **MUST** handle missing text gracefully
-- **SHOULD** validate image data
-- **MUST** check for image presence
-- **SHOULD** extract MIME type correctly
-- **MUST NOT** fail on partial data
-
-### Error Handling Rules
-- **SHOULD** wrap formatting in try-catch
-- **MUST** handle malformed responses
-- **SHOULD** log formatting errors
-- **MUST** provide fallback values
-- **SHOULD NOT** throw formatting errors
-
-## 🤖 AI Agent Guidelines
-
-### When Formatting Responses
-1. **CREATE** ResponseFormatter instance
-2. **CALL** formatResponse() with type
-3. **CHECK** for optional fields
-4. **EXTRACT** needed data
-5. **HANDLE** missing data gracefully
-
-### When Handling Text Responses
-1. **FORMAT** response with text type
-2. **CHECK** text field exists
-3. **VALIDATE** text not empty
-4. **USE** text value
-5. **HANDLE** empty text case
-
-### When Handling Image Responses
-1. **FORMAT** response with image type
-2. **CHECK** imageUrl exists
-3. **EXTRACT** imageBase64 data
-4. **USE** MIME type correctly
-5. **HANDLE** missing image case
-
-### Code Style Rules
-- **USE** generic type parameter
-- **CHECK** optional fields before use
-- **PROVIDE** fallback values
-- **LOG** formatting issues
-- **PRESERVE** original response
-
-## 📦 Available Class
-
-### ResponseFormatter
-
-**Refer to**: [`ResponseFormatter.ts`](./ResponseFormatter.ts)
-
-**Methods:**
-- `formatResponse<T>(response, input)` - Format response to typed structure
-
-## 🔗 Related Modules
-
-- **Text Generation Service**: [`../services/TEXT_GENERATION_SERVICE.md`](../services/TEXT_GENERATION_SERVICE.md)
-- **Image Generation Service**: [`../services/IMAGE_GENERATION_SERVICE.md`](../services/IMAGE_GENERATION_SERVICE.md)
-- **Generation Executor**: [`../services/GENERATION_EXECUTOR_SERVICE.md`](../services/GENERATION_EXECUTOR_SERVICE.md)
-
-## 📋 Response Types
-
-### Text Response
-```typescript
-{
-  text: string;              // Extracted text content
-  response: unknown;         // Original API response
-}
-```
-
-### Multimodal Response
-```typescript
-{
-  text: string;              // Extracted text content
-  imageUrl: string;          // Data URL (data:image/png;base64,...)
-  imageBase64: string;       // Base64 image data
-  mimeType: string;          // Image MIME type
-  response: unknown;         // Original API response
-}
-```
-
-## 🎓 Usage Patterns
-
-### Basic Formatting
-1. Create ResponseFormatter instance
-2. Call formatResponse() with type
-3. Extract needed fields
-4. Check for optional data
-5. Handle response appropriately
-
-### Text Response Handling
-1. Format response as text type
-2. Check text field exists
-3. Validate text content
-4. Use text in application
-5. Handle empty text case
-
-### Image Response Handling
-1. Format response with image type
-2. Check imageUrl exists
-3. Extract imageBase64 if needed
-4. Use imageUrl for display
-5. Handle missing image case
-
-### Multimodal Handling
-1. Format response
-2. Check for both text and image
-3. Handle different response types
-4. Display appropriate content
-5. Fallback to available data
-
-### Type-Safe Formatting
-1. Define response interface
-2. Format with generic type
-3. Use type guards
-4. Narrow response type
-5. Use typed data safely
-
-## 🚨 Common Pitfalls
-
-### Don't
-- Assume text field always exists
-- Use imageUrl without checking
-- Discard original response
-- Use non-null assertions
-- Skip type checking
-
-### Do
-- Always check optional fields
-- Validate data before use
-- Preserve original response
-- Use type guards
-- Handle missing data gracefully
-
----
-
-**Last Updated**: 2025-01-08
-**See Also**: [AI_GUIDELINES.md](../../../../AI_GUIDELINES.md)

package/src/infrastructure/response/ResponseFormatter.ts

@@ -1,58 +0,0 @@
-/**
- * Response Formatter
- * Formats Gemini API responses into consistent output structure
- */
-
-declare const __DEV__: boolean;
-
-export class ResponseFormatter {
-  formatResponse<T>(
-    response: unknown,
-    input: Record<string, unknown>,
-  ): T {
-    const resp = response as {
-      candidates?: Array<{
-        content: {
-          parts: Array<{
-            text?: string;
-            inlineData?: { mimeType: string; data: string };
-          }>;
-        };
-      }>;
-    };
-
-    const candidate = resp.candidates?.[0];
-    const parts = candidate?.content.parts || [];
-
-    // Extract text
-    const text = parts.find((p) => p.text)?.text;
-
-    // Extract image if present
-    const imagePart = parts.find((p) => p.inlineData);
-    const imageData = imagePart?.inlineData;
-
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-      // eslint-disable-next-line no-console
-      console.log("[ResponseFormatter] Formatting response:", {
-        hasText: !!text,
-        textLength: text?.length ?? 0,
-        hasImage: !!imageData,
-        outputFormat: input.outputFormat,
-      });
-    }
-
-    // Build result object - always return { text } for consistency
-    const result: Record<string, unknown> = {
-      text,
-      response,
-    };
-
-    if (imageData) {
-      result.imageUrl = `data:${imageData.mimeType};base64,${imageData.data}`;
-      result.imageBase64 = imageData.data;
-      result.mimeType = imageData.mimeType;
-    }
-
-    return result as T;
-  }
-}

package/src/infrastructure/services/generation-executor.ts

@@ -1,71 +0,0 @@
-/**
- * Generation Executor
- * Handles execution of text generation
- */
-
-import { geminiTextGenerationService } from "./gemini-text-generation.service";
-import { geminiStructuredTextService } from "./gemini-structured-text.service";
-
-
-export interface ExecutionOptions {
-  onProgress?: (progress: number) => void;
-}
-
-export interface GenerationInput {
-  prompt?: string;
-  generationConfig?: unknown;
-}
-
-export type GenerationResult = string;
-
-export class GenerationExecutor {
-  /**
-   * Execute text generation
-   */
-  async executeTextGeneration(prompt: string, model: string): Promise<string> {
-
-    const response = await geminiTextGenerationService.generateContent(
-      model,
-      [{ parts: [{ text: prompt }], role: "user" }],
-    );
-
-    return this.extractTextFromResponse(response);
-  }
-
-  /**
-   * Execute structured text generation (JSON output)
-   */
-  async executeStructuredGeneration<T>(
-    prompt: string,
-    schema: Record<string, unknown>,
-    model: string,
-  ): Promise<T> {
-
-    return geminiStructuredTextService.generateStructuredText<T>(
-      model,
-      prompt,
-      schema,
-    );
-  }
-
-
-  /**
-   * Extract text from Gemini response
-   */
-  private extractTextFromResponse(response: unknown): string {
-    const resp = response as {
-      candidates?: Array<{
-        content: {
-          parts: Array<{ text?: string }>;
-        };
-      }>;
-    };
-
-    return resp.candidates?.[0]?.content.parts
-      .filter((p): p is { text: string } => "text" in p && typeof p.text === "string")
-      .map((p) => p.text)
-      .join("") || "";
-  }
-}
-
-export const generationExecutor = new GenerationExecutor();

package/src/infrastructure/services/job-processor.ts

@@ -1,58 +0,0 @@
-/**
- * Job Processor
- * Handles async job processing for text generation
- */
-
-import { JobManager } from "../job/JobManager";
-import type { JobSubmission, JobStatus } from "../job/JobManager";
-import { generationExecutor } from "./generation-executor";
-
-
-export class JobProcessor {
-  private jobManager = new JobManager();
-
-  submitJob(model: string, input: Record<string, unknown>): Promise<JobSubmission> {
-    const submission = this.jobManager.submitJob(model, input);
-
-    this.processJobAsync(submission.requestId).catch(() => {
-    });
-
-    return Promise.resolve(submission);
-  }
-
-  getJobStatus(_model: string, requestId: string): Promise<JobStatus> {
-    const status = this.jobManager.getJobStatus(requestId);
-    return Promise.resolve(status);
-  }
-
-  getJobResult<T = unknown>(_model: string, requestId: string): Promise<T> {
-    try {
-      const result = this.jobManager.getJobResult<T>(requestId);
-      return Promise.resolve(result);
-    } catch (error) {
-      return Promise.reject(error);
-    }
-  }
-
-  clear(): void {
-    this.jobManager.clear();
-  }
-
-  private async processJobAsync(requestId: string): Promise<void> {
-    const job = this.jobManager.getJob(requestId);
-    if (!job) return;
-
-    this.jobManager.updateJobStatus(requestId, "IN_PROGRESS");
-
-    try {
-      const prompt = String(job.input.prompt ?? "");
-      const result = await generationExecutor.executeTextGeneration(prompt, job.model);
-      this.jobManager.setJobResult(requestId, result);
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      this.jobManager.setJobError(requestId, errorMessage);
-    }
-  }
-}
-
-export const jobProcessor = new JobProcessor();

package/src/infrastructure/services/provider-initializer.ts

@@ -1,31 +0,0 @@
-/**
- * Provider Initializer
- * Handles initialization logic for Gemini Provider
- */
-
-import type { GeminiConfig } from "../../domain/entities";
-import { geminiClientCoreService } from "./gemini-client-core.service";
-
-
-export type GeminiProviderConfig = GeminiConfig;
-
-export class ProviderInitializer {
-  initialize(config: GeminiProviderConfig): void {
-    if (geminiClientCoreService.isInitialized()) {
-      return;
-    }
-
-
-    geminiClientCoreService.initialize(config);
-  }
-
-  isInitialized(): boolean {
-    return geminiClientCoreService.isInitialized();
-  }
-
-  reset(): void {
-    geminiClientCoreService.reset();
-  }
-}
-
-export const providerInitializer = new ProviderInitializer();