@volkansuner/aichat-react-native 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Volkan Suner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,528 @@
+# AIChatSDK for React Native
+
+AI-powered conversational interface for React Native applications with intelligent navigation and hybrid AI processing.
+
+## 📦 Installation
+
+```bash
+npm install @volkansuner/aichat-react-native
+# or
+yarn add @volkansuner/aichat-react-native
+# or
+pnpm add @volkansuner/aichat-react-native
+```
+
+### Peer Dependencies
+
+```bash
+# Sadece AsyncStorage gerekli (axios kaldırıldı, native fetch kullanılıyor)
+npm install react-native @react-navigation/native @react-native-async-storage/async-storage
+```
+
+## 🚀 Quick Start
+
+### 1. Initialize SDK
+
+```typescript
+import { AIChatSDK } from '@volkansuner/aichat-react-native';
+import { NavigationContainer } from '@react-navigation/native';
+import { useNavigationContainerRef } from '@react-navigation/native';
+
+function App() {
+  const navigationRef = useNavigationContainerRef();
+  
+  useEffect(() => {
+    const initSDK = async () => {
+      const sdk = AIChatSDK.getInstance();
+      
+      await sdk.initialize({
+        apiKey: 'your-api-key-here',
+        navigationRef,
+        enableLocalAI: true,
+        onStatusChange: (status) => {
+          console.log('SDK Status:', status);
+        },
+        onNavigationSuggest: (suggestion) => {
+          console.log('Navigate to:', suggestion.screenName);
+        },
+      });
+    };
+    
+    initSDK();
+  }, []);
+  
+  return (
+    <NavigationContainer ref={navigationRef}>
+      {/* Your navigation */}
+    </NavigationContainer>
+  );
+}
+```
+
+### 2. Send Messages
+
+```typescript
+import { getSDK } from '@volkansuner/aichat-react-native';
+
+async function handleUserMessage(message: string) {
+  const sdk = getSDK();
+  
+  try {
+    const response = await sdk.sendMessage(message);
+    
+    console.log('AI Response:', response.message);
+    console.log('Handled by:', response.handledBy); // 'local' or 'backend'
+    console.log('Confidence:', response.confidence);
+    
+    if (response.navigationSuggestion) {
+      // AI suggested navigation
+      console.log('Suggested screen:', response.navigationSuggestion.screenName);
+    }
+  } catch (error) {
+    console.error('Error:', error);
+  }
+}
+```
+
+### 3. Access Conversation History
+
+```typescript
+const sdk = getSDK();
+const history = await sdk.getConversationHistory();
+
+console.log('Messages:', history);
+```
+
+## 🎯 Features
+
+### Hybrid AI Processing
+
+The SDK uses a **two-tier AI system**:
+
+1. **Local AI** (DistilBERT via ONNX Runtime)
+   - Handles simple intents locally (<150ms)
+   - Confidence threshold: 0.85
+   - Intents: Navigate, Search, Action, General
+   - **Works offline**
+
+2. **Backend AI** (GPT-4 Turbo via API)
+   - Complex conversations
+   - Context-aware responses
+   - Navigation schema integration
+   - Fallback for low-confidence local results
+
+```typescript
+// Example: High-confidence local handling
+User: "Go to settings"
+→ Local AI (confidence: 0.92) → Navigate to Settings
+
+// Example: Low-confidence → backend fallback
+User: "Show me products under $50 in electronics category"
+→ Local AI (confidence: 0.65) → Backend API → Complex response
+```
+
+### Navigation Intelligence
+
+```typescript
+// User asks: "Show me my profile"
+const response = await sdk.sendMessage("Show me my profile");
+
+if (response.navigationSuggestion) {
+  // Automatically navigate
+  sdk.navigate(response.navigationSuggestion.screenName);
+}
+```
+
+### Conversation Management
+
+```typescript
+const sdk = getSDK();
+
+// Get history
+const history = await sdk.getConversationHistory();
+
+// Clear conversation
+await sdk.clearConversation();
+
+// Get status
+const status = sdk.getStatus(); // 'uninitialized' | 'initializing' | 'ready' | 'error'
+```
+
+## 📚 API Reference
+
+### `AIChatSDK.initialize(config)`
+
+Initialize the SDK with configuration.
+
+```typescript
+interface SDKConfig {
+  apiKey: string;                              // Required: Your API key
+  apiUrl?: string;                             // Optional: Custom API URL
+  enableLocalAI?: boolean;                     // Optional: Enable local AI (default: true)
+  navigationRef?: NavigationContainerRef;      // Optional: React Navigation ref
+  localAI?: {
+    confidenceThreshold?: number;             // Default: 0.85
+  };
+  onStatusChange?: (status) => void;          // Optional: Status callback
+  onNavigationSuggest?: (suggestion) => void; // Optional: Navigation callback
+  onError?: (error) => void;                  // Optional: Error callback
+}
+```
+
+### `sdk.sendMessage(message: string)`
+
+Send a chat message and get AI response.
+
+```typescript
+const response = await sdk.sendMessage("Hello");
+
+interface ChatResponse {
+  id: string;
+  message: string;
+  timestamp: Date;
+  handledBy: 'local' | 'backend';
+  confidence?: number;
+  tokensUsed?: number;
+  navigationSuggestion?: {
+    screenName: string;
+    confidence: number;
+    message: string;
+  };
+}
+```
+
+### `sdk.getConversationHistory()`
+
+Get conversation history.
+
+```typescript
+const history = await sdk.getConversationHistory();
+// Returns: ChatMessage[]
+```
+
+### `sdk.clearConversation()`
+
+Clear conversation history and start new session.
+
+```typescript
+await sdk.clearConversation();
+```
+
+### `sdk.navigate(screenName: string, params?: any)`
+
+Programmatically navigate to a screen.
+
+```typescript
+sdk.navigate('Profile', { userId: '123' });
+```
+
+### `sdk.getStatus()`
+
+Get current SDK status.
+
+```typescript
+const status = sdk.getStatus();
+// Returns: 'uninitialized' | 'initializing' | 'ready' | 'error'
+```
+
+## 🔧 Configuration Examples
+
+### Basic Setup
+
+```typescript
+await sdk.initialize({
+  apiKey: 'aichat_test_pk_...',
+});
+```
+
+### With Navigation
+
+```typescript
+const navigationRef = useNavigationContainerRef();
+
+await sdk.initialize({
+  apiKey: 'aichat_test_pk_...',
+  navigationRef,
+  onNavigationSuggest: (suggestion) => {
+    Alert.alert(
+      'Navigate?',
+      `Do you want to go to ${suggestion.screenName}?`,
+      [
+        { text: 'Cancel', style: 'cancel' },
+        { text: 'Go', onPress: () => sdk.navigate(suggestion.screenName) },
+      ]
+    );
+  },
+});
+```
+
+### Backend-Only Mode
+
+```typescript
+await sdk.initialize({
+  apiKey: 'aichat_test_pk_...',
+  enableLocalAI: false, // Disable local AI, always use backend
+});
+```
+
+### Custom API URL
+
+```typescript
+await sdk.initialize({
+  apiKey: 'aichat_test_pk_...',
+  apiUrl: 'https://your-custom-api.com/v1',
+});
+```
+
+## 💬 Usage Examples
+
+### Simple Chat
+
+```typescript
+import React, { useState } from 'react';
+import { View, TextInput, Button, Text } from 'react-native';
+import { getSDK } from '@volkansuner/aichat-react-native';
+
+function ChatScreen() {
+  const [message, setMessage] = useState('');
+  const [response, setResponse] = useState('');
+
+  const sendMessage = async () => {
+    const sdk = getSDK();
+    const result = await sdk.sendMessage(message);
+    setResponse(result.message);
+    setMessage('');
+  };
+
+  return (
+    <View>
+      <TextInput
+        value={message}
+        onChangeText={setMessage}
+        placeholder="Type a message..."
+      />
+      <Button title="Send" onPress={sendMessage} />
+      <Text>{response}</Text>
+    </View>
+  );
+}
+```
+
+### With History
+
+```typescript
+import React, { useState, useEffect } from 'react';
+import { FlatList, Text } from 'react-native';
+import { getSDK } from '@volkansuner/aichat-react-native';
+
+function ChatHistory() {
+  const [messages, setMessages] = useState([]);
+
+  useEffect(() => {
+    loadHistory();
+  }, []);
+
+  const loadHistory = async () => {
+    const sdk = getSDK();
+    const history = await sdk.getConversationHistory();
+    setMessages(history);
+  };
+
+  return (
+    <FlatList
+      data={messages}
+      keyExtractor={(item) => item.id}
+      renderItem={({ item }) => (
+        <Text>{item.role}: {item.text}</Text>
+      )}
+    />
+  );
+}
+```
+
+### Navigation Integration
+
+```typescript
+const sdk = getSDK();
+
+// User asks: "Take me to my orders"
+const response = await sdk.sendMessage("Take me to my orders");
+
+if (response.navigationSuggestion) {
+  // Option 1: Auto-navigate
+  sdk.navigate(response.navigationSuggestion.screenName);
+  
+  // Option 2: Ask user first
+  Alert.alert(
+    'Navigation',
+    response.navigationSuggestion.message,
+    [
+      { text: 'Cancel' },
+      { 
+        text: 'Go', 
+        onPress: () => sdk.navigate(response.navigationSuggestion.screenName) 
+      },
+    ]
+  );
+}
+```
+
+## 🎨 Best Practices
+
+### 1. Initialize Early
+
+Initialize SDK in your root component:
+
+```typescript
+function App() {
+  useEffect(() => {
+    const init = async () => {
+      const sdk = AIChatSDK.getInstance();
+      await sdk.initialize({ apiKey: process.env.AICHAT_API_KEY });
+    };
+    init();
+  }, []);
+}
+```
+
+### 2. Handle Errors
+
+```typescript
+try {
+  const response = await sdk.sendMessage(message);
+} catch (error) {
+  if (error.message.includes('Invalid API key')) {
+    // Handle auth error
+  } else if (error.message.includes('Rate limit')) {
+    // Handle rate limit
+  } else {
+    // Handle other errors
+  }
+}
+```
+
+### 3. Provide Feedback
+
+```typescript
+const [loading, setLoading] = useState(false);
+
+const send = async () => {
+  setLoading(true);
+  try {
+    const response = await sdk.sendMessage(message);
+    // Handle response
+  } finally {
+    setLoading(false);
+  }
+};
+```
+
+### 4. Navigation Confirmation
+
+Always ask user before navigating:
+
+```typescript
+if (response.navigationSuggestion) {
+  // ✅ Good: Ask first
+  const confirmed = await showConfirmDialog(
+    `Go to ${response.navigationSuggestion.screenName}?`
+  );
+  if (confirmed) {
+    sdk.navigate(response.navigationSuggestion.screenName);
+  }
+  
+  // ❌ Bad: Auto-navigate without confirmation
+  // sdk.navigate(response.navigationSuggestion.screenName);
+}
+```
+
+## 🔄 Hybrid AI Flow
+
+```
+User Message
+     ↓
+Local AI Classifier (DistilBERT)
+     ↓
+Confidence ≥ 0.85?
+     ↓
+   YES → Handle Locally (fast, offline)
+     ↓
+   NO  → Send to Backend (GPT-4, context-aware)
+     ↓
+Navigation Suggestion?
+     ↓
+   YES → Suggest screen navigation
+     ↓
+Return Response
+```
+
+## 📊 Performance
+
+- **Local AI**: < 150ms response time
+- **Backend API**: < 2s response time
+- **Model Size**: 20MB (DistilBERT quantized)
+- **Memory Usage**: ~50MB additional
+
+## 🛠️ Troubleshooting
+
+### SDK not initializing
+
+```typescript
+// Check status
+const status = sdk.getStatus();
+console.log('Status:', status);
+
+// Reinitialize if error
+if (status === 'error') {
+  await sdk.destroy();
+  await sdk.initialize(config);
+}
+```
+
+### Navigation not working
+
+```typescript
+// Make sure navigationRef is passed
+const navigationRef = useNavigationContainerRef();
+
+await sdk.initialize({
+  apiKey: '...',
+  navigationRef, // ← Important!
+});
+```
+
+### Local AI not loading
+
+```typescript
+// Check if local AI is enabled
+await sdk.initialize({
+  apiKey: '...',
+  enableLocalAI: true, // Make sure this is true
+  localAI: {
+    confidenceThreshold: 0.85,
+  },
+});
+```
+
+## 📝 TypeScript Support
+
+Fully typed with TypeScript:
+
+```typescript
+import type {
+  SDKConfig,
+  ChatMessage,
+  ChatResponse,
+  NavigationSuggestion,
+} from '@volkansuner/aichat-react-native';
+```
+
+## 🔗 Related
+
+- [Backend API](../../apps/api/README.md)
+- [CLI Tool](../cli/README.md)
+- [Project Documentation](../../README.md)
+
+## 📄 License
+
+MIT

package/dist/AIChatSDK.d.ts

@@ -0,0 +1,75 @@
+import { SDKConfig, SDKStatusType, ChatMessage, ChatResponse } from './types';
+/**
+ * AIChatSDK - Main SDK class
+ * Provides AI-powered conversational interface for React Native apps
+ */
+export declare class AIChatSDK {
+    private static instance;
+    private config;
+    private status;
+    private localAI;
+    private backendService;
+    private conversationManager;
+    private navigationHandler;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): AIChatSDK;
+    /**
+     * Initialize SDK
+     */
+    initialize(config: SDKConfig): Promise<void>;
+    /**
+     * Send a chat message
+     */
+    sendMessage(message: string, context?: Record<string, any>, contextDescription?: string): Promise<ChatResponse>;
+    /**
+     * 🆕 Send message with streaming response
+     */
+    sendMessageStream(message: string, onChunk: (chunk: string) => void, onComplete?: (response: ChatResponse) => void, onError?: (error: Error) => void, context?: Record<string, any>, contextDescription?: string, onToolSuggestions?: (tools: any[]) => void): Promise<void>;
+    /**
+     * Handle local AI response
+     */
+    private handleLocalResponse;
+    /**
+     * Get conversation history
+     */
+    getConversationHistory(): Promise<ChatMessage[]>;
+    /**
+     * Clear conversation history
+     */
+    clearConversation(): Promise<void>;
+    /**
+     * 🆕 Add tool response to conversation
+     * Use this after executing a tool to display the results
+     */
+    addToolResponse(toolKey: string, data: any, tool: any): ChatMessage;
+    /**
+     * Get SDK status
+     */
+    getStatus(): SDKStatusType;
+    /**
+     * Get SDK configuration
+     */
+    getConfig(): SDKConfig | null;
+    /**
+     * Navigate to screen
+     */
+    navigate(screenName: string, params?: any): void;
+    /**
+     * Generate unique ID
+     */
+    private generateId;
+    /**
+     * Resolve API key from config
+     * Priority: config.apiKey > config.keys[platform] > config.keys.default
+     */
+    private resolveApiKey;
+    /**
+     * Destroy SDK instance
+     */
+    destroy(): Promise<void>;
+}
+export declare const getSDK: () => AIChatSDK;
+//# sourceMappingURL=AIChatSDK.d.ts.map

package/dist/AIChatSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatSDK.d.ts","sourceRoot":"","sources":["../src/AIChatSDK.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAC;AAM7F;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,iBAAiB,CAAkC;IAE3D,OAAO;IAEP;;OAEG;WACW,WAAW,IAAI,SAAS;IAOtC;;OAEG;IACU,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDzD;;OAEG;IACU,WAAW,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,YAAY,CAAC;IAgFxB;;OAEG;IACU,iBAAiB,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAChC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,EAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,kBAAkB,CAAC,EAAE,MAAM,EAC3B,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,GACzC,OAAO,CAAC,IAAI,CAAC;IAoEhB;;OAEG;YACW,mBAAmB;IA8CjC;;OAEG;IACU,sBAAsB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAO7D;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/C;;;OAGG;IACI,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,WAAW;IAsB1E;;OAEG;IACI,SAAS,IAAI,aAAa;IAIjC;;OAEG;IACI,SAAS,IAAI,SAAS,GAAG,IAAI;IAIpC;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI;IAOvD;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAStC;AAGD,eAAO,MAAM,MAAM,iBAAgC,CAAC"}