vorqard-ai-sdk 1.0.0 → 1.0.1

package/README.md

@@ -1,209 +1,228 @@
-# 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"
-}
-```
-
-
+# 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 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
+npm install axios react-native-linear-gradient react-native-image-crop-picker react-native-vision-camera react-native-vector-icons react-native-safe-area-context
+```
+
+### Step 3: Install the SDK
+In your main application folder (`groupin-app/`), install the SDK package from npm by running:
+```bash
+npm install vorqard-ai-sdk
+```
+
+### 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
+        onTokenRefresh={async () => {
+          // Triggered automatically if the token expires (401 error)
+          const newToken = await fetchNewTokenFromYourBackend();
+          setVorqardToken(newToken);
+          return newToken; // The SDK will retry the failed request using this
+        }}
+      />
+    </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 Do:**
+- `backendUrl` — VORQARD API base URL (e.g., `https://app.vorqard.com/api`)
+- `userToken` — Patient JWT token
+
+> **Getting a Token for Testing & Production:**
+> To retrieve a valid `userToken`, call the `/partner/groupin/sync-user` endpoint from your backend — it now returns an `access_token` directly in the response. Pass this token straight to the SDK `userToken` prop. No separate OTP login step is needed.
+
+**Endpoints used internally by SDK (no manual calls needed):**
+
+| Endpoint | Method | Purpose |
+|---|---|---|
+| `/partner/groupin/sync-user` | POST | Register/sync user **→ returns `access_token` directly** |
+| `/patients/ai/chat` | POST | Full AI booking + health chat |
+| `/patients/ai/analyze-report` | POST | Medical report OCR analysis |
+
+### Props Reference
+
+| Prop | Type | Required | Description |
+|---|---|---|---|
+| `backendUrl` | string | Yes | VORQARD API base URL |
+| `userToken` | string | Yes | JWT token from `sync-user` |
+| `patientName` | string | No | First name for greeting (Default: `"there"`) |
+| `onClose` | function | No | Called when user presses the back button |
+| `aiLogo` | image | No | Custom AI avatar icon |
+| `onAnalyzeReportPress` | function | No | Custom handler to override the default report analyzer screen |
+| `onTokenRefresh` | function | No | Callback triggered on 401 errors. Return a promise that resolves to a new JWT token to automatically retry failed requests. |
+
+---
+
+### 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

@@ -1,6 +1,6 @@
 {
   "name": "vorqard-ai-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Standalone React Native SDK for VORQARD AI Health Assistant and Report Analyzer",
   "main": "src/index.js",
   "repository": {
@@ -12,14 +12,14 @@
     "url": "https://github.com/AbhivornGroupIn/VORQARD_SDK_AI/issues"
   },
   "peerDependencies": {
+    "axios": "^1.0.0",
     "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-linear-gradient": "*",
+    "react-native-safe-area-context": "*",
     "react-native-vector-icons": "*",
-    "react-native-safe-area-context": "*"
+    "react-native-vision-camera": "*"
   },
   "keywords": [
     "vorqard",
@@ -29,6 +29,10 @@
     "healthcare"
   ],
   "author": "VORQARD Developer",
-  "license": "Abhivorn Technologies"
+  "license": "Abhivorn Technologies",
+  "dependencies": {
+    "expo-av": "^16.0.8",
+    "expo-file-system": "~18.0.0",
+    "react-native-live-audio-stream": "^1.1.1"
+  }
 }
-

package/src/api/sdkClient.js

@@ -2,7 +2,7 @@ import axios from 'axios';
 
 let client = null;
 
-export const initSDKClient = (backendUrl, token) => {
+export const initSDKClient = (backendUrl, token, onTokenRefresh = null) => {
   client = axios.create({
     baseURL: backendUrl,
     headers: {
@@ -10,6 +10,41 @@ export const initSDKClient = (backendUrl, token) => {
       ...(token ? { Authorization: `Bearer ${token}` } : {})
     }
   });
+
+  if (onTokenRefresh) {
+    client.interceptors.response.use(
+      (response) => response,
+      async (error) => {
+        const originalRequest = error.config;
+        
+        // If it's a 401 error and we haven't already retried this exact request
+        if (error.response?.status === 401 && !originalRequest._retry) {
+          originalRequest._retry = true;
+          
+          try {
+            // Ask the host app for a new token
+            const newToken = await onTokenRefresh();
+            
+            if (newToken) {
+              // Update the default headers for future requests
+              client.defaults.headers.common['Authorization'] = `Bearer ${newToken}`;
+              
+              // Update the headers of the failed request
+              originalRequest.headers['Authorization'] = `Bearer ${newToken}`;
+              
+              // Retry the original request with the new token
+              return client(originalRequest);
+            }
+          } catch (refreshError) {
+            console.error('VORQARD AI SDK: Token refresh failed:', refreshError);
+            return Promise.reject(refreshError);
+          }
+        }
+        
+        return Promise.reject(error);
+      }
+    );
+  }
 };
 
 export const getSDKClient = () => {

package/src/components/ChatCards.js

@@ -1,4 +1,6 @@
 export { DoctorTypeSelectionCard } from './cards/DoctorTypeSelectionCard';
+export { SpecialtySelectionCard } from './cards/SpecialtySelectionCard';
+export { RadiusSelectionCard } from './cards/RadiusSelectionCard';
 export { HospitalSelectionList, HospitalProfileCard } from './cards/HospitalCards';
 export { DoctorSelectionList, DoctorProfileCard } from './cards/DoctorCards';
 export { SlotSelectionCard } from './cards/SlotSelectionCard';