ahs-cti 0.0.2-beta.1

package/LICENSE

@@ -0,0 +1,53 @@
+PROPRIETARY SOFTWARE LICENSE AGREEMENT
+
+Copyright (c) 2025 CTI SDK Team. All rights reserved.
+
+IMPORTANT: READ CAREFULLY BEFORE USING THIS SOFTWARE
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. The Software is licensed, not sold, to you by Call Control SDK
+("Licensor") under the terms of this license agreement.
+
+1. GRANT OF LICENSE
+   Subject to the terms and conditions of this agreement, Licensor hereby grants
+   you a limited, non-exclusive, non-transferable license to use the Software
+   solely for your internal business purposes.
+
+2. RESTRICTIONS
+   You may NOT:
+   - Copy, modify, adapt, or create derivative works of the Software
+   - Reverse engineer, decompile, disassemble, or attempt to derive source code
+   - Distribute, sublicense, rent, lease, or transfer the Software
+   - Remove or alter any proprietary notices or labels on the Software
+   - Use the Software for any purpose other than as expressly permitted
+
+3. OWNERSHIP
+   The Software and all intellectual property rights therein remain the exclusive
+   property of Licensor. This license does not grant you any ownership rights.
+
+4. CONFIDENTIALITY
+   The Software contains confidential and proprietary information. You agree to:
+   - Maintain strict confidentiality
+   - Not disclose the Software to any third parties
+   - Use reasonable care to protect the Software from unauthorized access
+
+5. TERMINATION
+   This license is effective until terminated. Licensor may terminate this
+   license immediately if you breach any terms. Upon termination, you must
+   destroy all copies of the Software.
+
+6. NO WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+7. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY DAMAGES WHATSOEVER ARISING
+   OUT OF THE USE OR INABILITY TO USE THE SOFTWARE.
+
+8. GOVERNING LAW
+   This agreement shall be governed by and construed in accordance with the
+   laws of [Your Jurisdiction].
+
+By using this Software, you acknowledge that you have read this agreement,
+understand it, and agree to be bound by its terms and conditions.

package/LICENSE-ACHALA

@@ -0,0 +1,80 @@
+SOFTWARE LICENSE AGREEMENT
+
+Copyright (c) 2025 CTI SDK Team. All rights reserved.
+
+IMPORTANT: READ CAREFULLY BEFORE USING THIS SOFTWARE
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. The Software is licensed, not sold, to you by CTI SDK Team
+("Licensor") under the terms of this license agreement.
+
+1. GRANT OF LICENSE
+   Subject to the terms and conditions of this agreement, Licensor hereby grants
+   you a limited, non-exclusive, non-transferable license to use the Software
+   solely through authorized API keys and tenant IDs across different platforms
+   as specified in your subscription agreement.
+
+2. AUTHORIZED ACCESS REQUIREMENTS
+   You may use the Software ONLY when:
+   - You possess a valid, authorized API key issued by Licensor
+   - You have a valid tenant ID registered with Licensor
+   - Your subscription is active and in good standing
+   - You are using the Software on authorized platforms only
+
+3. PROHIBITED ACTIVITIES
+   You may NOT:
+   - Use the Software without valid API key and tenant ID
+   - Share, transfer, or distribute your API key or tenant ID
+   - Reverse engineer, decompile, or disassemble the Software
+   - Create derivative works or modifications
+   - Use the Software on unauthorized platforms
+   - Exceed the usage limits defined in your subscription
+   - Attempt to circumvent API rate limits or security measures
+
+4. API KEY AND TENANT ID MANAGEMENT
+   - API keys and tenant IDs are confidential and must be protected
+   - You are responsible for maintaining the security of your credentials
+   - Report any suspected compromise immediately to Licensor
+   - Licensor reserves the right to revoke access at any time
+   - Unauthorized use of credentials may result in immediate termination
+
+5. USAGE MONITORING AND COMPLIANCE
+   - Licensor may monitor usage patterns and API calls
+   - You must comply with all usage limits and restrictions
+   - Excessive or suspicious usage may trigger security reviews
+   - Non-compliance may result in immediate license termination
+
+6. PLATFORM-SPECIFIC TERMS
+   - Each platform may have additional terms and conditions
+   - Platform-specific features may require separate authorization
+   - Cross-platform data sharing must comply with privacy regulations
+   - Third-party integrations require prior written approval
+
+7. OWNERSHIP AND INTELLECTUAL PROPERTY
+   The Software and all intellectual property rights remain the exclusive
+   property of Licensor. This license does not grant you any ownership rights.
+
+8. CONFIDENTIALITY
+   The Software contains confidential and proprietary information. You agree to:
+   - Maintain strict confidentiality of all Software components
+   - Not disclose API keys, tenant IDs, or Software details to third parties
+   - Use reasonable care to protect against unauthorized access
+   - Report any security breaches immediately
+
+9. TERMINATION
+    This license is effective until terminated. Licensor may terminate this
+    license immediately if you breach any terms. Upon termination, you must:
+    - Cease all use of the Software immediately
+    - Destroy all copies of the Software
+    - Return or destroy all API keys and credentials
+    - Provide certification of compliance upon request
+
+10. NO WARRANTY
+    THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+By using this Software, you acknowledge that you have read this agreement,
+understand it, and agree to be bound by its terms and conditions.
+
+ACHALA LICENSE VERSION 1.0 - Effective Date: October 1, 2025

package/README.md

@@ -0,0 +1,508 @@
+<div align="center">
+
+## Call Control SDK
+
+[![npm version](https://img.shields.io/npm/v/call-control-sdk.svg?color=blue&style=for-the-badge)](https://www.npmjs.com/package/call-control-sdk)
+[![npm downloads](https://img.shields.io/npm/dm/call-control-sdk.svg?color=green&style=for-the-badge)](https://www.npmjs.com/package/call-control-sdk)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/call-control-sdk?color=orange&style=for-the-badge)](https://bundlephobia.com/package/call-control-sdk)
+
+**A powerful, lightweight SDK for real-time call management**
+
+**🔑AUTHORIZED ACCESS REQUIRED - API Key & Tenant ID🔑**
+
+</div>
+
+### ⭐ **License Features**
+
+- **API Key Authentication** - Secure access through authorized API keys
+- **Tenant ID Management** - Multi-tenant support with isolated access
+- **Cross-Platform Support** - Use across web, mobile, desktop, and server platforms
+- **Usage Monitoring** - Real-time tracking and compliance monitoring
+- **Flexible Deployment** - Deploy on authorized platforms with proper credentials
+
+### 🚫 **Prohibited Activities**
+
+- **No Unauthorized Access** - Cannot use without valid credentials
+- **No Credential Sharing** - API keys and tenant IDs are confidential
+- **No Reverse Engineering** - Cannot decompile or reverse engineer
+- **No Platform Violations** - Must use only on authorized platforms
+- **No Usage Abuse** - Cannot exceed subscription limits
+
+## 📑 Table of Contents
+
+- [✨ Key Features](#-key-features)
+- [📦 Installation](#-installation)
+- [🚀 Quick Start](#-quick-start)
+  - [1️⃣ Initialize the SDK](#1️⃣-initialize-the-sdk)
+  - [2️⃣ Add Call Control Panel](#2️⃣-add-call-control-panel)
+  - [3️⃣ Use Call Management Hooks](#3️⃣-use-call-management-hooks)
+- [🔧 Configuration Options](#-configuration-options)
+- [📚 API Reference](#-api-reference)
+  - [🔧 Core Functions](#-core-functions)
+  - [🪝 React Hooks](#-react-hooks)
+- [📦 Data Types](#-data-types)
+- [🎛 Control Features](#-control-features)
+- [🌍 Browser Support](#-browser-support)
+- [📄 License](#-license)
+
+---
+
+## ✨ Key Features
+
+### 🎯 **Complete Call Control**
+
+- Hold/Resume calls
+- Mute/Unmute functionality
+- Agent status management
+- End call with disposition
+
+### 💾 **Smart State Management**
+
+- Real-time call timer
+- Persistent state storage
+- Singleton state pattern
+- Cross-component sync
+- TypeScript support
+
+## 📦 Installation
+
+```bash
+npm install call-control-sdk
+```
+
+### 🔑 Required Dependencies
+
+Make sure you have these peer dependencies installed:
+
+```bash
+npm install react react-dom axios @mui/material @mui/icons-material @emotion/react @emotion/styled
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1️⃣ **Initialize the SDK**
+
+First, initialize the SDK at the root of your application:
+
+```tsx
+import { useEffect } from "react";
+import { initSDK } from "call-control-sdk";
+
+function App() {
+	useEffect(() => {
+		try {
+			initSDK({
+				apiKey: "your-api-key",
+				tenantId: "your-tenant-id",
+				agentId: "your-agent-id",
+			});
+			console.log("✅ SDK initialized successfully");
+		} catch (error) {
+			console.error("❌ SDK initialization failed:", error);
+		}
+	}, []);
+
+	return <YourAppContent />;
+}
+```
+
+### 2️⃣ **Add Call Control Panel**
+
+Drop in the draggable call control panel anywhere in your app:
+
+```tsx
+import { CallControlPanel } from "call-control-sdk";
+
+export default function AgentDashboard() {
+	const handleCallDataChange = (data) => {
+		console.log("📞 Call data updated:", data);
+		// Handle call data changes (mobileNumber, callReferenceId, agentLoginId)
+	};
+
+	return (
+		<div>
+			<h1>Agent Dashboard</h1>
+			<CallControlPanel onDataChange={handleCallDataChange} />
+		</div>
+	);
+}
+```
+
+#### 📞 **Get Caller Data (Alternative to onDataChange)**
+
+The `useGetCallerData` hook is an **independent alternative** to the `CallControlPanel`'s `onDataChange` prop. It provides the same call data but can be used anywhere in your application without depending on the `CallControlPanel` component.
+
+**Key Differences:**
+
+- 🔄 **onDataChange**: Requires `CallControlPanel` component, callback-based
+- 🎯 **useGetCallerData**: Independent hook, reactive, can be used anywhere
+
+**When to use each:**
+
+- Use `onDataChange` when you need the call control UI and want to handle data changes
+- Use `useGetCallerData` when you only need call data without the control panel UI
+
+The `useGetCallerData` hook provides reactive access to current call data. It automatically updates when call status changes, new calls arrive, or call information is modified.
+
+```tsx
+import { useGetCallerData } from "call-control-sdk";
+
+export default function AgentDashboard() {
+	const callerData = useGetCallerData();
+
+	// Sample data structure returned:
+	// {
+	//   "phone_number": "1234567890",
+	//   "status": "ONCALL",
+	//   "callReferenceId": "convox_call_id_123",
+	//   "agent_id": "agent001",
+	//   "process_id": "proc001",
+	//   "process_name": "Sales Process"
+	// }
+
+	return (
+		<div>
+			<h1>Current Call Information</h1>
+			<p>Phone Number: {callerData.phone_number}</p>
+			<p>Call Status: {callerData.status}</p>
+			<p>Call Reference ID: {callerData.callReferenceId}</p>
+			<p>Agent ID: {callerData.agent_id}</p>
+			<p>Process: {callerData.process_name}</p>
+		</div>
+	);
+}
+```
+
+**Example: Using useGetCallerData independently (without CallControlPanel)**
+
+```tsx
+import { useGetCallerData } from "call-control-sdk";
+
+// This component can be used anywhere, even without CallControlPanel
+export default function CallStatusWidget() {
+	const callerData = useGetCallerData();
+
+	return (
+		<div className="call-status-widget">
+			<h3>Current Call Status</h3>
+			{callerData.status === "ONCALL" ?
+				<div>
+					<p>📞 Active Call: {callerData.phone_number}</p>
+					<p>Agent: {callerData.agent_id}</p>
+					<p>Process: {callerData.process_name}</p>
+				</div>
+			:	<p>No active call</p>}
+		</div>
+	);
+}
+
+// You can use this widget anywhere in your app
+export default function MainApp() {
+	return (
+		<div>
+			<h1>My Application</h1>
+			<CallStatusWidget /> {/* Independent component */}
+			{/* No CallControlPanel needed here */}
+		</div>
+	);
+}
+```
+
+**Key Features:**
+
+- ✅ **Reactive Updates**: Automatically re-renders when call data changes
+- ✅ **Real-time Data**: Reflects current call state from WebSocket updates
+- ✅ **Type Safety**: Fully typed with TypeScript interfaces
+- ✅ **Complete Data**: Returns all available call information
+- ✅ **Independent**: Works without `CallControlPanel` component
+
+**Returned Data Fields:**
+
+- `phone_number`: The phone number involved in the call
+- `status`: Current call status (ONCALL, RINGING, WRAPUP, etc.)
+- `callReferenceId`: Unique identifier for the call
+- `agent_id`: ID of the agent handling the call
+- `process_id`: Process identifier for the call
+- `process_name`: Name of the process handling the call
+
+### 3️⃣ **Use Call Management Hooks**
+
+#### 🔴 **Start a Call**
+
+```tsx
+import { useClickToCall } from "call-control-sdk";
+
+export default function CallButton() {
+	const { handleStartCall, isLoading, isSuccess, isError, error } = useClickToCall();
+
+	const startCall = () => {
+		handleStartCall({
+			mobileNumber: "1234567890",
+		});
+	};
+
+	return (
+		<button
+			onClick={startCall}
+			disabled={isLoading}
+		>
+			{isLoading ? "🔄 Calling..." : "📞 Start Call"}
+		</button>
+	);
+}
+```
+
+#### 🔚 **End a Call**
+
+```tsx
+import { useEndCall } from "call-control-sdk";
+
+export default function EndCallButton() {
+	const { handleEndCall, isLoading, isSuccess, isError, error } = useEndCall();
+
+	const endCall = () => {
+		handleEndCall({
+			disposition: "RES", // Call disposition
+		});
+	};
+
+	return (
+		<button
+			onClick={endCall}
+			disabled={isLoading}
+		>
+			{isLoading ? "🔄 Ending..." : "🔚 End Call"}
+		</button>
+	);
+}
+```
+
+#### 🚪 **Agent Logout**
+
+```tsx
+import { useLogout } from "call-control-sdk";
+
+export default function LogoutButton() {
+	const { logout, isLoading, isSuccess, isError, error } = useLogout();
+
+	return (
+		<button
+			onClick={logout}
+			disabled={isLoading}
+		>
+			{isLoading ? "🔄 Logging out..." : "🚪 Logout"}
+		</button>
+	);
+}
+```
+
+### 🔐 Authorization Token
+
+get Authorization token for external API call
+
+```tsx
+import { useGetAuthorizationToken } from "call-control-sdk";
+
+export default function axios() {
+	const token = useGetAuthorizationToken();
+
+	console.log(token);
+}
+```
+
+---
+
+## 🔧 Configuration Options
+
+Customize the SDK behavior to fit your needs:
+
+```tsx
+initSDK({
+	// Required configuration
+	apiKey: "your-api-key",
+	tenantId: "your-tenant-id",
+	agentId: "your-agent-id",
+
+	// Optional customization
+	disableEndCallButton: false, // Hide end call button
+	disabledDialButton: false, // Hide dial button
+	disableCallTransferButton: false, // Hide transfer button
+	disableConferenceButton: false, // Hide conference button
+	disableSoftPhone: false, // Hide soft phone iframe
+	isDraggable: true, // Enable/disable dragging
+
+	// Custom styling (Material-UI SxProps)
+	disabled: { opacity: 0.5 }, // Disabled button styles
+	enabled: { color: "primary" }, // Enabled button styles
+	outlined: { border: "1px solid" }, // Outlined button styles
+});
+```
+
+### 🎨 **Styling Options**
+
+| Option                      | Type      | Default | Description                       |
+| --------------------------- | --------- | ------- | --------------------------------- |
+| `disableEndCallButton`      | `boolean` | `false` | Hide the "End Call" button        |
+| `disabledDialButton`        | `boolean` | `false` | Hide the "Dial" button            |
+| `disableCallTransferButton` | `boolean` | `false` | Hide the "Call Transfer" button   |
+| `disableConferenceButton`   | `boolean` | `false` | Hide the "Conference" button      |
+| `disableSoftPhone`          | `boolean` | `false` | Hide the embedded soft phone      |
+| `isDraggable`               | `boolean` | `true`  | Enable/disable panel dragging     |
+| `disabled`                  | `SxProps` | -       | Custom styles for disabled states |
+| `enabled`                   | `SxProps` | -       | Custom styles for enabled states  |
+| `outlined`                  | `SxProps` | -       | Custom styles for outlined states |
+
+---
+
+## 📚 API Reference
+
+### 🔧 **Core Functions**
+
+#### `initSDK(config)`
+
+Initialize the SDK with your configuration. **Must be called before using any components or hooks.**
+
+```tsx
+initSDK({
+	apiKey: string, // ✅ Required - API key for authentication
+	tenantId: string, // ✅ Required - Tenant ID for events/authentication
+	agentId: string, // ✅ Required - Agent ID for call controls
+	// ... plus optional configuration options
+});
+```
+
+#### `CallControlPanel`
+
+Draggable control panel component for call management.
+
+```tsx
+<CallControlPanel
+	onDataChange={(data) => {
+		console.log("Call data updated:", data);
+	}}
+/>
+```
+
+### 🪝 **React Hooks**
+
+#### `useLogout()`
+
+Hook for agent logout functionality.
+
+```tsx
+const { logout, isLoading, isSuccess, isError, error } = useLogout();
+
+// Usage:
+logout();
+
+// Returns:
+// - logout: () => void - Function to trigger logout
+// - isLoading: boolean - Loading state
+// - isSuccess: boolean - Success state
+// - isError: boolean - Error state
+// - error: any - Error object if failed
+```
+
+#### `useClickToCall()`
+
+Hook for initiating calls to mobile numbers.
+
+```tsx
+const { handleStartCall, isLoading, isSuccess, isError, error, data } = useClickToCall();
+
+// Usage:
+handleStartCall({ mobileNumber: "1234567890" });
+
+// Returns:
+// - handleStartCall: (payload: StartCallPayload) => void
+// - isLoading: boolean - Loading state
+// - isSuccess: boolean - Success state
+// - isError: boolean - Error state
+// - error: any - Error object if failed
+// - data: any - API response on success
+```
+
+#### `useEndCall()`
+
+Hook for ending active calls.
+
+```tsx
+const { handleEndCall, isLoading, isSuccess, isError, error, data } = useEndCall();
+
+// Usage:
+handleEndCall({ disposition: "RES" });
+
+// Returns:
+// - handleEndCall: (payload: EndCallPayload) => void
+// - isLoading: boolean - Loading state
+// - isSuccess: boolean - Success state
+// - isError: boolean - Error state
+// - error: any - Error object if failed
+// - data: any - API response on success
+```
+
+---
+
+## 📦 **Data Types**
+
+### `StartCallPayload`
+
+```tsx
+interface StartCallPayload {
+	mobileNumber?: string; // Mobile number to call
+}
+```
+
+### `EndCallPayload`
+
+```tsx
+interface EndCallPayload {
+	disposition?: string; // Call disposition (default: "RES")
+}
+```
+
+---
+
+## 🎛 **Control Features**
+
+### 📞 **Call Management**
+
+- **Hold/Resume** - Pause and resume active calls
+- **Mute/Unmute** - Control audio during calls
+- **End Call** - Terminate calls with disposition tracking
+- **Agent Status** - Switch between Idle/Break states
+
+### 💾 **State Persistence**
+
+- **Call Timer** - Real-time duration tracking
+- **Panel Position** - Remembers draggable panel location
+- **Agent Status** - Maintains current status across sessions
+- **Call State** - Preserves hold/mute states
+
+---
+
+## 🌍 **Browser Support**
+
+<div align="left">
+
+| Browser                                                                       | Version | Status       |
+| ----------------------------------------------------------------------------- | ------- | ------------ |
+| ![Chrome](https://img.shields.io/badge/Chrome-60%2B-green?logo=google-chrome) | 60+     | ✅ Supported |
+| ![Firefox](https://img.shields.io/badge/Firefox-60%2B-green?logo=firefox)     | 60+     | ✅ Supported |
+| ![Safari](https://img.shields.io/badge/Safari-12%2B-green?logo=safari)        | 12+     | ✅ Supported |
+| ![Edge](https://img.shields.io/badge/Edge-79%2B-green?logo=microsoft-edge)    | 79+     | ✅ Supported |
+
+</div>
+
+---
+
+## 📄 **License**
+
+<div align="center">
+
+![license](https://img.shields.io/badge/License-Achala-blue?style=for-the-badge)
+![license](https://img.shields.io/badge/License-Proprietary-red?style=for-the-badge)
+
+</div>