medos-sdk 1.0.1 → 1.0.3

package/README.md

@@ -19,11 +19,10 @@ The SDK supports two authentication methods:
 Use this method for backend services and server-side rendering.
 
 ```javascript
-import { MedosClient } from 'medos-sdk';
+import { MedosClient } from "medos-sdk";
 
 await MedosClient.init({
-  apiKey: 'your-api-key',
-  baseURL: 'https://api-dev.medapi.in/v1'
+  apiKey: "your-api-key",
 });
 ```
 
@@ -32,11 +31,10 @@ await MedosClient.init({
 Use this method for frontend applications. Obtain the session token from your backend.
 
 ```javascript
-import { MedosClient } from 'medos-sdk';
+import { MedosClient } from "medos-sdk";
 
 await MedosClient.initWithSession({
-  sessionToken: 'user-session-token',
-  baseURL: 'https://api-dev.medapi.in/v1'
+  sessionToken: "user-session-token",
 });
 ```
 
@@ -85,10 +83,10 @@ Get available appointment time slots for a specific doctor.
 
 ```javascript
 const slots = await MedosClient.fetchAppointments(
-  'workspace-123',  // workspaceId
-  'addr-1',        // addressId
-  'doc-1',         // doctorId
-  '2025-11-16'     // appointmentDate (YYYY-MM-DD)
+  "workspace-123", // workspaceId
+  "addr-1", // addressId
+  "doc-1", // doctorId
+  "2025-11-16" // appointmentDate (YYYY-MM-DD)
 );
 ```
 
@@ -99,14 +97,14 @@ const slots = await MedosClient.fetchAppointments(
   {
     start: "2025-11-16T10:00:00",
     end: "2025-11-16T10:30:00",
-    id: "slot-1"
+    id: "slot-1",
   },
   {
     start: "2025-11-16T11:00:00",
     end: "2025-11-16T11:30:00",
-    id: "slot-2"
-  }
-]
+    id: "slot-2",
+  },
+];
 ```
 
 ### Book an Appointment
@@ -114,46 +112,46 @@ const slots = await MedosClient.fetchAppointments(
 Create a new appointment booking.
 
 ```javascript
-import { AppointmentService } from 'medos-sdk';
+import { AppointmentService } from "medos-sdk";
 
 const appointment = await AppointmentService.createAppointment({
-  workspaceAddressId: 'addr-1',
-  doctorId: 'doc-1',
-  mode: 'OFFLINE',
-  appointmentDate: '2025-11-16',
-  fromDateTimeTs: '10:00',
-  toDateTimeTs: '10:30',
-  consultationCharge: '100',
-  type: 'CONSULTATION',
-  source: 'SDK_POWERED_WEBSITE',
+  workspaceAddressId: "addr-1",
+  doctorId: "doc-1",
+  mode: "OFFLINE",
+  appointmentDate: "2025-11-16",
+  fromDateTimeTs: "10:00",
+  toDateTimeTs: "10:30",
+  consultationCharge: "100",
+  type: "CONSULTATION",
+  source: "SDK_POWERED_WEBSITE",
   patientPayload: {
-    firstName: 'Jane',
-    lastName: 'Doe',
-    email: 'jane.doe@example.com',
-    countryCode: '+1',
-    phoneNumber: '5551234567',
+    firstName: "Jane",
+    lastName: "Doe",
+    email: "jane.doe@example.com",
+    countryCode: "+1",
+    phoneNumber: "5551234567",
     age: 30,
-    gender: 'FEMALE'
+    gender: "FEMALE",
   },
   patientAddress: {
-    addressLine1: '456 Patient Street',
-    city: 'New York',
-    state: 'NY',
-    country: 'USA',
-    zipcode: '10001',
-    landmark: 'Near Central Park'
-  }
+    addressLine1: "456 Patient Street",
+    city: "New York",
+    state: "NY",
+    country: "USA",
+    zipcode: "10001",
+    landmark: "Near Central Park",
+  },
 });
 ```
 
 **Optional Fields:**
 
-| Field | Default Value | Description |
-|-------|---------------|-------------|
-| `mode` | `"OFFLINE"` | Consultation mode: `"OFFLINE"` or `"ONLINE"` |
-| `consultationCharge` | `"0"` | Consultation fee as string |
-| `type` | `"CONSULTATION"` | Appointment type |
-| `source` | `"SDK_POWERED_WEBSITE"` | Source identifier |
+| Field                | Default Value           | Description                                  |
+| -------------------- | ----------------------- | -------------------------------------------- |
+| `mode`               | `"OFFLINE"`             | Consultation mode: `"OFFLINE"` or `"ONLINE"` |
+| `consultationCharge` | `"0"`                   | Consultation fee as string                   |
+| `type`               | `"CONSULTATION"`        | Appointment type                             |
+| `source`             | `"SDK_POWERED_WEBSITE"` | Source identifier                            |
 
 ### Phone Verification
 
@@ -163,8 +161,8 @@ Implement OTP-based phone number verification for patients.
 
 ```javascript
 await MedosClient.sendPhoneVerificationOtp({
-  countryCode: '+1',
-  phoneNumber: '5551234567'
+  countryCode: "+1",
+  phoneNumber: "5551234567",
 });
 ```
 
@@ -172,9 +170,9 @@ await MedosClient.sendPhoneVerificationOtp({
 
 ```javascript
 const result = await MedosClient.verifyPhoneVerificationOtp({
-  countryCode: '+1',
-  phoneNumber: '5551234567',
-  otp: '123456'
+  countryCode: "+1",
+  phoneNumber: "5551234567",
+  otp: "123456",
 });
 ```
 
@@ -189,28 +187,28 @@ import {
   BookAppointmentPayload,
   AddressesResponse,
   PatientPayload,
-  PatientAddressPayload
-} from 'medos-sdk';
+  PatientAddressPayload,
+} from "medos-sdk";
 
 const payload: BookAppointmentPayload = {
-  workspaceAddressId: 'addr-1',
-  doctorId: 'doc-1',
-  appointmentDate: '2025-11-16',
-  fromDateTimeTs: '10:00',
-  toDateTimeTs: '10:30',
+  workspaceAddressId: "addr-1",
+  doctorId: "doc-1",
+  appointmentDate: "2025-11-16",
+  fromDateTimeTs: "10:00",
+  toDateTimeTs: "10:30",
   patientPayload: {
-    firstName: 'John',
-    lastName: 'Doe',
-    countryCode: '+1',
-    phoneNumber: '5551234567'
+    firstName: "John",
+    lastName: "Doe",
+    countryCode: "+1",
+    phoneNumber: "5551234567",
   },
   patientAddress: {
-    addressLine1: '123 Main Street',
-    city: 'New York',
-    state: 'NY',
-    country: 'USA',
-    zipcode: '10001'
-  }
+    addressLine1: "123 Main Street",
+    city: "New York",
+    state: "NY",
+    country: "USA",
+    zipcode: "10001",
+  },
 };
 
 const appointment = await AppointmentService.createAppointment(payload);
@@ -268,7 +266,7 @@ const appointment = await AppointmentService.createAppointment(payload);
 Pre-built appointment calendar component for React applications.
 
 ```jsx
-import { AppointmentCalender } from 'medos-sdk';
+import { AppointmentCalender } from "medos-sdk";
 
 function BookingPage() {
   return <AppointmentCalender />;
@@ -277,6 +275,135 @@ function BookingPage() {
 
 The component automatically uses the initialized `MedosClient` instance.
 
+### Using React-specific exports
+
+For better tree-shaking and to avoid React dependency conflicts:
+
+```jsx
+import { AppointmentCalender } from "medos-sdk/react";
+```
+
+## Vanilla JavaScript / HTML Integration
+
+For websites using plain HTML, CSS, and JavaScript (no React), use the vanilla widget.
+
+### Installation
+
+The widget is available as a bundled UMD module. After building the package, you'll find:
+
+- `dist/vanilla/widget.js` - JavaScript bundle
+- `dist/vanilla/widget.css` - Stylesheet
+
+### Basic Usage
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <link rel="stylesheet" href="path/to/widget.css" />
+  </head>
+  <body>
+    <div id="appointment-calendar"></div>
+
+    <script src="path/to/widget.js"></script>
+    <script>
+      window.MedosAppointmentCalendar.init({
+        containerId: "appointment-calendar",
+        apiKey: "your-api-key",
+        onError: (err) => {
+          console.error("Error:", err);
+          alert("An error occurred. Please try again.");
+        },
+        onSuccess: () => {
+          console.log("Appointment booked successfully!");
+        },
+      });
+    </script>
+  </body>
+</html>
+```
+
+### Using Session Token (Recommended for Production)
+
+For better security, obtain the session token server-side:
+
+```html
+<script>
+  window.MedosAppointmentCalendar.init({
+    containerId: "appointment-calendar",
+    sessionToken: "your-session-token", // Obtained from your server
+    baseURL: "https://api-dev.medapi.in/v1",
+    onError: (err) => console.error(err),
+  });
+</script>
+```
+
+### PHP Integration Example
+
+```php
+<?php
+// Get session token from your backend
+$sessionToken = getSessionTokenFromBackend();
+?>
+<!DOCTYPE html>
+<html>
+<head>
+    <link rel="stylesheet" href="path/to/widget.css">
+</head>
+<body>
+    <div id="appointment-calendar"></div>
+    <script src="path/to/widget.js"></script>
+    <script>
+        window.MedosAppointmentCalendar.init({
+            containerId: 'appointment-calendar',
+            sessionToken: '<?php echo htmlspecialchars($sessionToken); ?>',
+            onError: (err) => {
+                console.error('Error:', err);
+                alert('An error occurred. Please try again.');
+            }
+        });
+    </script>
+</body>
+</html>
+```
+
+### Configuration Options
+
+- `containerId` (string, required) - ID of the HTML element where the widget will be rendered
+- `apiKey` (string, optional) - Your Medos API key (if not using sessionToken)
+- `sessionToken` (string, optional) - Session token obtained from your server (if not using apiKey)
+- `baseURL` (string, optional) - API base URL (defaults to `https://api-dev.medapi.in/v1`)
+- `onError` (function, optional) - Callback function for error handling
+- `onSuccess` (function, optional) - Callback function called when appointment is successfully booked
+
+### Styling
+
+The widget comes with default styles. You can customize them by overriding CSS classes:
+
+```css
+.medos-appointment-btn-primary {
+  background: #your-color;
+}
+
+.medos-appointment-card {
+  border-radius: 8px;
+}
+```
+
+See `dist/vanilla/widget.css` for all available classes.
+
+### Package Exports
+
+The SDK provides multiple entry points:
+
+- `medos-sdk` - Default export (includes React components)
+- `medos-sdk/react` - React-specific exports
+- `medos-sdk/vanilla` - Vanilla JS exports (ES modules)
+- `medos-sdk/core` - Core services only (no framework dependencies)
+- `medos-sdk/widget` - Widget bundle with CSS
+
+For more details, see [Vanilla Widget Documentation](./docs/VANILLA_WIDGET.md).
+
 ## API Reference
 
 ### MedosClient
@@ -286,6 +413,7 @@ The component automatically uses the initialized `MedosClient` instance.
 Initialize the SDK with an API key (server-side).
 
 **Parameters:**
+
 - `config.apiKey` (string, required) - Your Medos API key
 - `config.baseURL` (string, optional) - API base URL. Defaults to dev environment
 
@@ -298,6 +426,7 @@ Initialize the SDK with an API key (server-side).
 Initialize the SDK with a session token (client-side).
 
 **Parameters:**
+
 - `config.sessionToken` (string, required) - Session token
 - `config.baseURL` (string, optional) - API base URL. Defaults to dev environment
 
@@ -312,6 +441,7 @@ Fetch all clinic addresses and their associated doctors.
 **Returns:** `Promise<AddressesResponse>`
 
 **Response Type:**
+
 ```typescript
 {
   totalAddresses?: number;
@@ -342,6 +472,7 @@ Fetch all clinic addresses and their associated doctors.
 Fetch available appointment slots for a specific doctor.
 
 **Parameters:**
+
 - `workspaceId` (string | number) - Workspace identifier
 - `addressId` (string | number) - Address identifier
 - `doctorId` (string | number) - Doctor identifier
@@ -350,12 +481,13 @@ Fetch available appointment slots for a specific doctor.
 **Returns:** `Promise<Slot[]>`
 
 **Response Type:**
+
 ```typescript
 Array<{
-  start: string;  // ISO datetime format
-  end: string;    // ISO datetime format
+  start: string; // ISO datetime format
+  end: string; // ISO datetime format
   id?: string;
-}>
+}>;
 ```
 
 ---
@@ -365,6 +497,7 @@ Array<{
 Send OTP to a phone number for verification.
 
 **Parameters:**
+
 - `payload.countryCode` (string) - Country code with + prefix (e.g., "+1")
 - `payload.phoneNumber` (string) - Phone number without country code
 
@@ -377,6 +510,7 @@ Send OTP to a phone number for verification.
 Verify OTP for a phone number.
 
 **Parameters:**
+
 - `payload.countryCode` (string) - Country code with + prefix
 - `payload.phoneNumber` (string) - Phone number without country code
 - `payload.otp` (string) - OTP code received
@@ -392,6 +526,7 @@ Verify OTP for a phone number.
 Create a new appointment booking.
 
 **Parameters:**
+
 - `payload` (BookAppointmentPayload) - Appointment details
 
 **Returns:** `Promise<any>`
@@ -402,10 +537,10 @@ All SDK methods return Promises and should be wrapped in try-catch blocks.
 
 ```javascript
 try {
-  await MedosClient.init({ apiKey: 'your-api-key' });
+  await MedosClient.init({ apiKey: "your-api-key" });
   const addresses = await MedosClient.fetchAllAddressesAndDoctors();
 } catch (error) {
-  console.error('Failed to fetch addresses:', error.message);
+  console.error("Failed to fetch addresses:", error.message);
 }
 ```
 
@@ -413,7 +548,7 @@ try {
 
 - **Node.js:** v14 or higher
 - **Browsers:** Modern browsers with ES6+ support
-- **React:** v19 or higher (for React components)
+- **React:** v19 or higher (only required for React components, not for vanilla widget)
 - **TypeScript:** v5 or higher (optional)
 
 ## License
@@ -430,4 +565,4 @@ Pooranjoy Bhattacharya
 
 ---
 
-*Built for healthcare providers worldwide.*
+_Built for healthcare providers worldwide._

package/dist/client/MedosClient.d.ts

@@ -20,7 +20,7 @@ declare class MedosClient {
     static initWithSession({ sessionToken, baseURL, }: MedosClientSessionConfig): Promise<void>;
     private static initializeAxiosInstance;
     static fetchAllAddressesAndDoctors(): Promise<AddressesResponse>;
-    static fetchAppointments(workspaceId: string | number, addressId: string | number, doctorId: string | number, appointmentDate: string): Promise<any[]>;
+    static fetchAppointments(workspaceId: number, addressId: number, doctorId: number, appointmentDate: string): Promise<any[]>;
     static sendPhoneVerificationOtp(payload: SendPhoneVerificationOtpPayload): Promise<any>;
     static verifyPhoneVerificationOtp(payload: VerifyPhoneVerificationOtpPayload): Promise<any>;
     static get client(): AxiosInstance;

package/dist/client/MedosClient.js

@@ -3,7 +3,7 @@ import { AuthService } from "../services/AuthService";
 import { AppointmentService, } from "../services/AppointmentService";
 import { PatientService, } from "../services/PatientService";
 class MedosClient {
-    static async init({ apiKey, baseURL = "https://api-dev.medapi.in/v1", }) {
+    static async init({ apiKey, baseURL = "https://api.medos.one", }) {
         if (!apiKey) {
             throw new Error("MedosClient.init() requires 'apiKey'");
         }

package/dist/components/AppointmentCalender.d.ts

@@ -1,6 +1,3 @@
 import React from "react";
-type AppointmentCalenderProps = {
-    onError?: (err: Error) => void;
-};
+import { AppointmentCalenderProps } from "./types";
 export declare const AppointmentCalender: React.FC<AppointmentCalenderProps>;
-export {};