vorqard-ai-sdk 1.0.0

package/README.md

@@ -0,0 +1,209 @@
+# VORQARD AI Health Assistant SDK
+
+[![GitHub](https://img.shields.io/badge/GitHub-AbhivornGroupIn%2FVORQARD__SDK__AI-blue?logo=github)](https://github.com/AbhivornGroupIn/VORQARD_SDK_AI)
+
+The VORQARD AI SDK is a standalone React Native / Expo module that provides a conversational AI clinical health assistant and a structured medical report analyzer.
+
+---
+
+## 🚀 Step-by-Step Integration Guide
+
+Follow these steps to integrate the AI SDK into your React Native / Expo application (such as the Groupin App):
+
+### Step 1: Copy the SDK Folder
+Copy the `VORQARD_AI_SDK` directory into your project structure. A common setup is to place it side-by-side with your host application:
+```text
+/my-workspace
+  ├── groupin-app/      (Your main mobile application directory)
+  └── VORQARD_AI_SDK/   (This SDK directory)
+```
+
+### Step 2: Install Peer Dependencies
+The SDK relies on standard Expo and React Native libraries for image picking, safe area views, icons, and network requests.
+
+Run the following command in your main application folder (`groupin-app/`):
+```bash
+npx expo install axios expo-linear-gradient expo-image-picker expo-camera @expo/vector-icons react-native-safe-area-context
+```
+
+### Step 3: Link the SDK to Your App
+In your main application folder (`groupin-app/`), install the SDK package as a local file dependency by running:
+```bash
+npm install ../VORQARD_AI_SDK
+```
+*(This automatically adds `"vorqard-ai-sdk": "file:../VORQARD_AI_SDK"` to your dependencies in `package.json` and configures node module resolution)*.
+
+### Step 4: Render the AI Assistant Screen
+Import `VorqardAIAssistant` and add it to any screen, layout, or modal in your navigation stack. 
+
+Here is a basic template:
+
+```javascript
+import React from 'react';
+import { SafeAreaView, StyleSheet } from 'react-native';
+import { VorqardAIAssistant } from 'vorqard-ai-sdk';
+
+export default function AIExpertScreen({ navigation }) {
+  // Retrieve the patient's authenticated token and first name from your app's auth state
+  const userToken = "eyJhbGciOi..."; // Active patient JWT session token
+  const patientName = "Jagadish";     // Used for personalized greeting
+
+  return (
+    <SafeAreaView style={styles.container}>
+      <VorqardAIAssistant
+        backendUrl="https://app.vorqard.com/api"     // VORQARD production API endpoint
+        userToken={userToken}                    // Authentication JWT
+        patientName={patientName}                // Custom patient name
+        onClose={() => navigation.goBack()}      // Callback when close/back button is pressed
+        aiLogo={require('./assets/AI_Icon.png')} // Optional: custom icon for AI replies
+      />
+    </SafeAreaView>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+  },
+});
+```
+
+---
+
+## 🛠 Advanced / Decoupled Usage
+
+If you want to render your own custom user interface and only use the state management and API integration layer of the SDK, you can import the initialization client and custom hooks directly:
+
+```javascript
+import { initSDKClient, getSDKClient, useHealthChat } from 'vorqard-ai-sdk';
+
+// 1. Initialize the HTTP client configuration
+initSDKClient('https://app.vorqard.com/api', 'JWT_TOKEN_HERE');
+
+// 2. Consume the custom health chat state hook in your own component
+const MyCustomChat = () => {
+  const { messages, sendMessage, loading } = useHealthChat('chat', 'Jagadish');
+  // messages contains: [{ id, role, content, ui_action, timestamp }]
+  // sendMessage is a function to send the next prompt
+};
+```
+
+---
+
+## 🌐 Backend API Endpoints Reference
+
+The SDK automatically communicates with the following backend routes. Ensure your API gateway/server allows the client's JWT token authorization on these endpoints:
+
+### 1. Patient Dashboard Context
+*   **Path:** `GET /patients/dashboard/me`
+*   **Headers:** `Authorization: Bearer <userToken>`
+*   **Description:** Fetches core summary details of the logged-in patient (e.g. name, date of last visit) to personalize the greeting.
+
+### 2. Patient Medical Records
+*   **Path:** `GET /patients/records/me`
+*   **Headers:** `Authorization: Bearer <userToken>`
+*   **Description:** Fetches past clinical records and consult history to provide relevant diagnostic context to the AI model.
+
+### 3. AI Health Chat Engine
+*   **Path:** `POST /patients/ai/chat`
+*   **Headers:** `Authorization: Bearer <userToken>`
+*   **Request Body:**
+    ```json
+    {
+      "message": "book appointment",
+      "history": [
+        { "role": "user", "content": "hello" },
+        { "role": "assistant", "content": "Hi there! How can I help you today?" }
+      ]
+    }
+    ```
+*   **Response Body:**
+    ```json
+    {
+      "response": "Here is a list of hospital-associated doctors...",
+      "ui_action": {
+        "type": "selection",
+        "title": "Select Doctor",
+        "options": [
+          { "id": "129", "label": "Dr. Veeha Reddy", "name": "Dr. Veeha Reddy" }
+        ]
+      }
+    }
+    ```
+*   **Description:** The chat router interface. It passes user utterances and conversational history to return clinical AI responses and rich-action metadata.
+
+### 4. AI Report Analyzer (Optional)
+*   **Path:** `POST /patients/ai/analyze-report`
+*   **Headers:** `Authorization: Bearer <userToken>`
+*   **Request Body:** `Multipart Form-Data` (keys: `file`)
+*   **Description:** Submits physical medical report images for OCR scanning and structured health scoring.
+
+---
+
+## 🤝 Integration Path Options
+
+Groupin can choose one of two integration approaches based on their requirements:
+
+---
+
+### Option A: SDK Integration (Recommended — AI-powered)
+Use the SDK component described in this README. The AI chat handles hospital search, doctor discovery, slot picking, and appointment booking — all through a single conversational interface.
+
+**What Groupin needs to provide:**
+- `backendUrl` — VORQARD API base URL
+- `userToken` — Patient JWT token (from OTP login)
+
+**Endpoints used internally by SDK (no manual calls needed):**
+
+| Endpoint | Method | Purpose |
+|---|---|---|
+| `/auth/send-otp-mobile` | POST | Send OTP to patient phone |
+| `/auth/verify-otp-mobile` | POST | Verify OTP → get JWT token |
+| `/patients/ai/chat` | POST | Full AI booking + health chat |
+| `/patients/ai/analyze-report` | POST | Medical report OCR analysis |
+
+---
+
+### Option B: Direct Partner API (Custom UI — no SDK required)
+If Groupin prefers to build their own UI and call VORQARD APIs directly from their backend server.
+
+**Authentication:** All requests must include the partner API key in the header:
+```
+X-Api-Key: <provided_by_vorqard>
+```
+
+**Backend URL:** `https://app.vorqard.com/api`
+
+**Available Partner Endpoints:**
+
+| Endpoint | Method | Purpose |
+|---|---|---|
+| `/partner/groupin/sync-user` | POST | Register/sync a Groupin user as a VORQARD patient |
+| `/partner/groupin/hospitals` | GET | Fetch all available hospitals |
+| `/partner/groupin/doctors` | GET | Fetch doctors (filter by specialty or hospital) |
+| `/partner/groupin/book-appointment` | POST | Book an appointment directly |
+
+**Example — Sync User Request Body:**
+```json
+{
+  "phone_number": "9876543210",
+  "user_name": "Ravi Kumar",
+  "email": "ravi@example.com",
+  "gender": "Male",
+  "date_of_birth": "1990-05-15",
+  "blood_group": "O+",
+  "location": "Hyderabad"
+}
+```
+
+**Example — Book Appointment Request Body:**
+```json
+{
+  "vorqard_patient_id": 42,
+  "vorqard_doctor_id": 7,
+  "date": "2026-06-20",
+  "time_slot": "10:00"
+}
+```
+
+

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "vorqard-ai-sdk",
+  "version": "1.0.0",
+  "description": "Standalone React Native SDK for VORQARD AI Health Assistant and Report Analyzer",
+  "main": "src/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AbhivornGroupIn/VORQARD_SDK_AI.git"
+  },
+  "homepage": "https://github.com/AbhivornGroupIn/VORQARD_SDK_AI#readme",
+  "bugs": {
+    "url": "https://github.com/AbhivornGroupIn/VORQARD_SDK_AI/issues"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.70.0",
+    "axios": "^1.0.0",
+    "react-native-linear-gradient": "*",
+    "react-native-image-crop-picker": "*",
+    "react-native-vision-camera": "*",
+    "react-native-vector-icons": "*",
+    "react-native-safe-area-context": "*"
+  },
+  "keywords": [
+    "vorqard",
+    "ai",
+    "sdk",
+    "react-native",
+    "healthcare"
+  ],
+  "author": "VORQARD Developer",
+  "license": "Abhivorn Technologies"
+}
+

package/src/api/sdkClient.js

@@ -0,0 +1,22 @@
+import axios from 'axios';
+
+let client = null;
+
+export const initSDKClient = (backendUrl, token) => {
+  client = axios.create({
+    baseURL: backendUrl,
+    headers: {
+      'Content-Type': 'application/json',
+      ...(token ? { Authorization: `Bearer ${token}` } : {})
+    }
+  });
+};
+
+export const getSDKClient = () => {
+  if (!client) {
+    console.warn('VORQARD AI SDK: Client was not initialized. Call initSDKClient(backendUrl, token) first.');
+    // Fallback to basic client
+    client = axios.create();
+  }
+  return client;
+};

package/src/components/ChatCards.js

@@ -0,0 +1,5 @@
+export { DoctorTypeSelectionCard } from './cards/DoctorTypeSelectionCard';
+export { HospitalSelectionList, HospitalProfileCard } from './cards/HospitalCards';
+export { DoctorSelectionList, DoctorProfileCard } from './cards/DoctorCards';
+export { SlotSelectionCard } from './cards/SlotSelectionCard';
+export { BookingConfirmationCard } from './cards/BookingConfirmationCard';

package/src/components/ChatComponents.js

@@ -0,0 +1,208 @@
+import React from 'react';
+import {
+  View,
+  Text,
+  TextInput,
+  TouchableOpacity,
+  Image,
+  StyleSheet,
+  Dimensions,
+  ActivityIndicator,
+  Linking,
+  Platform,
+} from 'react-native';
+import Ionicons from 'react-native-vector-icons/Ionicons';
+import LinearGradient from 'react-native-linear-gradient';
+import { styles } from './ChatStyles';
+import {
+  DoctorTypeSelectionCard,
+  HospitalSelectionList,
+  HospitalProfileCard,
+  DoctorSelectionList,
+  DoctorProfileCard,
+  SlotSelectionCard,
+  BookingConfirmationCard
+} from './ChatCards';
+
+const { width: SCREEN_WIDTH } = Dimensions.get('window');
+
+// ─── Message Bubble ───────────────────────────────────────────────────────────
+export const MessageBubble = ({ item, aiLogo, onOptionPress }) => {
+  const isUser = item.role === 'user';
+
+  const renderAssistantText = (content) => {
+    const parts = content.split(/(VORQARD AI|Vorqard AI)/gi);
+    return (
+      <Text style={styles.assistantText}>
+        {parts.map((part, i) =>
+          /VORQARD AI/i.test(part) ? (
+            <Text key={i} style={styles.highlightText}>{part}</Text>
+          ) : (
+            <Text key={i}>{part}</Text>
+          )
+        )}
+      </Text>
+    );
+  };
+
+  // 7. Route UI Action to the correct Rich Component
+  const renderUIAction = () => {
+    if (!item.ui_action) return null;
+    const { type, title, options, doctor, hospital, selected_date } = item.ui_action;
+
+    if (type === 'selection') {
+      if (title === 'Select Doctor Type') {
+        return <DoctorTypeSelectionCard options={options} onOptionPress={onOptionPress} />;
+      }
+      if (title === 'Select Hospital') {
+        return <HospitalSelectionList options={options} onOptionPress={onOptionPress} />;
+      }
+      if (title === 'Select Doctor') {
+        return <DoctorSelectionList options={options} onOptionPress={onOptionPress} />;
+      }
+      // Fallback selection list
+      return (
+        <View style={styles.optionsContainer}>
+          {options.map((opt) => (
+            <TouchableOpacity
+              key={opt.id}
+              style={styles.optionButton}
+              onPress={() => onOptionPress?.(opt)}
+              activeOpacity={0.7}
+            >
+              <Text style={styles.optionButtonText}>{opt.label}</Text>
+            </TouchableOpacity>
+          ))}
+        </View>
+      );
+    }
+
+    if (type === 'doctor_profile') {
+      return <DoctorProfileCard doctor={doctor} options={options} onOptionPress={onOptionPress} />;
+    }
+
+    if (type === 'hospital_profile') {
+      return <HospitalProfileCard hospital={hospital} options={options} onOptionPress={onOptionPress} />;
+    }
+
+    if (type === 'slot_selection') {
+      return <SlotSelectionCard doctor={doctor} selectedDate={selected_date} options={options} onOptionPress={onOptionPress} />;
+    }
+
+    if (type === 'booking_confirmation') {
+      return <BookingConfirmationCard ui={item.ui_action} onOptionPress={onOptionPress} />;
+    }
+
+    return null;
+  };
+
+  return (
+    <View style={[styles.bubbleContainer, isUser ? styles.userAlign : styles.assistantAlign]}>
+      {!isUser && (
+        aiLogo ? (
+          <Image source={aiLogo} style={styles.avatarImage} />
+        ) : (
+          <View style={styles.avatarFallback}>
+            <Ionicons name="sparkles" size={14} color="#FFF" />
+          </View>
+        )
+      )}
+
+      {isUser ? (
+        <LinearGradient
+          colors={['#6366F1', '#3B82F6']}
+          start={{ x: 0, y: 0 }}
+          end={{ x: 1, y: 1 }}
+          style={[styles.bubble, styles.userBubble]}
+        >
+          <Text style={styles.userText}>{item.content}</Text>
+          {item.timestamp && (
+            <Text style={styles.userTime}>
+              {new Date(item.timestamp).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })}
+            </Text>
+          )}
+        </LinearGradient>
+      ) : (
+        <View style={{ flexDirection: 'column', maxWidth: SCREEN_WIDTH * 0.76 }}>
+          <View style={[styles.bubble, styles.assistantBubble]}>
+            {renderAssistantText(item.content)}
+            {item.timestamp && (
+              <Text style={styles.assistantTime}>
+                {new Date(item.timestamp).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })}
+              </Text>
+            )}
+          </View>
+          {renderUIAction()}
+        </View>
+      )}
+    </View>
+  );
+};
+
+// ─── Input Panel ──────────────────────────────────────────────────────────────
+export const InputPanel = ({ value, onChangeText, onSend, onVoicePress, loading, aiLogo }) => {
+  const hasText = value.trim().length > 0;
+
+  return (
+    <View style={styles.inputOuterContainer}>
+      <LinearGradient
+        colors={['#6366F1', '#EC4899', '#F97316']}
+        start={{ x: 0, y: 0 }}
+        end={{ x: 1, y: 0 }}
+        style={styles.inputBorderGradient}
+      >
+        <View style={styles.inputInner}>
+          {aiLogo ? (
+            <Image source={aiLogo} style={{ width: 18, height: 18, marginLeft: 2, borderRadius: 4 }} />
+          ) : (
+            <Ionicons name="sparkles" size={18} color="#6366F1" style={{ marginLeft: 2 }} />
+          )}
+
+          <TextInput
+            placeholder="Ask Vorqard AI about reports, history..."
+            placeholderTextColor="#94A3B8"
+            value={value}
+            onChangeText={onChangeText}
+            style={styles.textInput}
+            multiline
+            maxLength={500}
+          />
+
+          <View style={styles.rightIcons}>
+            {!hasText && (
+              <TouchableOpacity style={styles.iconBtn} activeOpacity={0.7}>
+                <Ionicons name="attach" size={20} color="#94A3B8" />
+              </TouchableOpacity>
+            )}
+
+            {!hasText && (
+              <TouchableOpacity style={styles.iconBtn} onPress={onVoicePress} activeOpacity={0.7}>
+                <Ionicons name="mic" size={20} color="#94A3B8" />
+              </TouchableOpacity>
+            )}
+
+            <TouchableOpacity
+              onPress={() => onSend(value)}
+              disabled={!hasText || loading}
+              activeOpacity={0.8}
+            >
+              <LinearGradient
+                colors={hasText ? ['#10B981', '#3B82F6'] : ['#E2E8F0', '#E2E8F0']}
+                start={{ x: 0, y: 0 }}
+                end={{ x: 1, y: 1 }}
+                style={styles.sendButton}
+              >
+                {loading ? (
+                  <ActivityIndicator color="#FFF" size="small" />
+                ) : (
+                  <Ionicons name="arrow-up" size={18} color={hasText ? '#FFF' : '#94A3B8'} />
+                )}
+              </LinearGradient>
+            </TouchableOpacity>
+          </View>
+        </View>
+      </LinearGradient>
+    </View>
+  );
+};
+