@solveo-ai/react-native 0.1.0 → 0.1.1

package/README.md

@@ -47,6 +47,26 @@ function ChatScreen() {
 }
 ```
 
+## Development
+
+From the repo root (monorepo), install and build:
+
+```bash
+# From platform root
+npm install
+npm run build --workspace=@solveo-ai/react-native
+```
+
+Or from this package:
+
+```bash
+cd sdks/react-native
+npm install
+npm run build
+```
+
+This produces `dist/index.js`, `dist/index.mjs`, and `dist/index.d.ts`. Type declarations are included; `prepublishOnly` runs the build before publishing so published packages include `dist` and types.
+
 ## Documentation
 
 See [full documentation](https://docs.solveoai.io/sdk/react-native).

package/dist/index.d.mts

@@ -0,0 +1,182 @@
+import React, { ReactNode } from 'react';
+import { SolveoClientConfig, SolveoSDK, Socket, CustomerSocketManager, AgentSocketManager, StreamingSocket, Conversation, Message, HumanAgent, Widget, WidgetConfig, Device, MessageAttachment, Agent, AgentCreateRequest, AgentUpdateRequest, ConversationMetrics, SentimentDistribution, FeedbackStats, TokenUsageMetrics } from '@solveo-ai/sdk-core';
+export { Agent, Conversation, ConversationStatus, FeedbackType, Message, MessageAttachment, SentimentType, Widget } from '@solveo-ai/sdk-core';
+
+interface SolveoContextValue {
+    sdk: SolveoSDK;
+    config: SolveoProviderConfig;
+    customerSocket: Socket | null;
+    customerSocketManager: CustomerSocketManager | null;
+    agentSocket: Socket | null;
+    agentSocketManager: AgentSocketManager | null;
+    streamingSocket: StreamingSocket | null;
+    connectCustomerSocket: (conversationId: string) => void;
+    disconnectCustomerSocket: () => void;
+    connectAgentSocket: (token: string) => void;
+    disconnectAgentSocket: () => void;
+    connectStreamingSocket: (conversationId: string) => void;
+    disconnectStreamingSocket: () => void;
+}
+interface SolveoProviderConfig extends Omit<SolveoClientConfig, 'platform'> {
+    user?: {
+        email?: string;
+        name?: string;
+        id?: string;
+    };
+    autoConnectCustomer?: boolean;
+    autoConnectAgent?: boolean;
+    conversationId?: string;
+    onError?: (error: Error) => void;
+}
+interface SolveoProviderProps {
+    children: ReactNode;
+    config: SolveoProviderConfig;
+}
+declare function SolveoProvider({ children, config }: SolveoProviderProps): React.JSX.Element;
+declare function useSolveo(): SolveoContextValue;
+
+interface UseChatOptions {
+    widgetId?: string;
+    agentId?: string;
+    persistConversation?: boolean;
+}
+declare function useChat(options?: UseChatOptions): {
+    conversation: Conversation | null;
+    messages: Message[];
+    isLoading: boolean;
+    isStreaming: boolean;
+    streamingContent: string;
+    error: Error | null;
+    createConversation: () => Promise<Conversation>;
+    sendMessage: (content: string) => Promise<void>;
+    loadMessages: (conversationId: string) => Promise<void>;
+    submitFeedback: (messageId: string, rating: "THUMBS_UP" | "THUMBS_DOWN") => Promise<void>;
+};
+
+declare function useRealtime(): {
+    isConnected: boolean;
+    agentTyping: boolean;
+    queuePosition: number | null;
+    estimatedWait: number | null;
+};
+
+declare function useEscalation(): {
+    escalationId: string | null;
+    assignedAgent: HumanAgent | null;
+    status: "idle" | "requesting" | "queued" | "active" | "resolved";
+    requestHuman: (conversationId: string) => void;
+    endChat: () => void;
+    submitCSAT: (rating: number) => void;
+};
+
+declare function useWidgetConfig(widgetId?: string): {
+    widget: Widget | null;
+    widgetConfig: WidgetConfig | null;
+    isLoading: boolean;
+    error: Error | null;
+    reload: () => Promise<void>;
+};
+
+/**
+ * Push notification event handlers
+ */
+interface PushNotificationHandlers {
+    onNotificationReceived?: (notification: any) => void;
+    onNotificationTapped?: (notification: any) => void;
+}
+/**
+ * Hook options
+ */
+interface UsePushNotificationsOptions {
+    mode?: 'widget' | 'agent';
+    conversationId?: string;
+    autoRegister?: boolean;
+    handlers?: PushNotificationHandlers;
+}
+/**
+ * Enhanced Push Notifications Hook for React Native
+ *
+ * Supports both customer (widget) and agent (dashboard) modes.
+ * Handles permissions, registration, and notification events.
+ *
+ * SETUP INSTRUCTIONS:
+ * 1. Install peer dependencies:
+ *    npm install @react-native-firebase/app @react-native-firebase/messaging
+ *    (or expo-notifications for Expo projects)
+ *
+ * 2. Configure Firebase/APNs:
+ *    - Android: Add google-services.json to android/app/
+ *    - iOS: Add GoogleService-Info.plist to ios/ and configure APNs
+ *
+ * 3. Add permissions to manifests:
+ *    - Android: INTERNET, VIBRATE, RECEIVE_BOOT_COMPLETED
+ *    - iOS: User Notifications capability
+ */
+declare function usePushNotifications(options?: UsePushNotificationsOptions): {
+    requestPermission: () => Promise<boolean>;
+    registerDevice: (convId?: string, pushToken?: string, bundleId?: string) => Promise<Device | null>;
+    registerAgentDevice: (pushToken?: string, deviceName?: string) => Promise<any>;
+    unregisterDevice: () => Promise<void>;
+    device: Device | null;
+    isRegistered: boolean;
+    isInitialized: boolean;
+    permissionStatus: "granted" | "denied" | "undetermined";
+};
+
+declare function useAttachments(conversationId?: string): {
+    uploading: boolean;
+    uploadProgress: number;
+    uploadAttachment: (file: {
+        uri: string;
+        type?: string;
+        name?: string;
+    }, attachmentType: "IMAGE" | "AUDIO" | "VIDEO" | "DOCUMENT" | "VOICE_NOTE") => Promise<MessageAttachment>;
+};
+
+declare function useAgents(accountId?: string): {
+    agents: Agent[];
+    isLoading: boolean;
+    error: Error | null;
+    createAgent: (data: AgentCreateRequest) => Promise<Agent>;
+    updateAgent: (id: string, data: AgentUpdateRequest) => Promise<Agent>;
+    deleteAgent: (id: string) => Promise<void>;
+    reload: () => Promise<void>;
+};
+
+declare function useConversations(accountId?: string): {
+    conversations: Conversation[];
+    isLoading: boolean;
+    error: Error | null;
+    resolveConversation: (id: string) => Promise<void>;
+    reload: () => Promise<void>;
+};
+
+declare function useAnalytics(accountId?: string, days?: number): {
+    metrics: ConversationMetrics | null;
+    sentiment: SentimentDistribution | null;
+    feedback: FeedbackStats | null;
+    tokenUsage: TokenUsageMetrics | null;
+    isLoading: boolean;
+    error: Error | null;
+    reload: () => Promise<void>;
+};
+
+declare const storage: {
+    getConversationId(): Promise<string | null>;
+    setConversationId(id: string): Promise<void>;
+    clearConversationId(): Promise<void>;
+    getMessages(conversationId: string): Promise<any[]>;
+    setMessages(conversationId: string, messages: any[]): Promise<void>;
+    getUserIdentity(): Promise<{
+        email?: string;
+        name?: string;
+    } | null>;
+    setUserIdentity(identity: {
+        email?: string;
+        name?: string;
+    }): Promise<void>;
+    getWidgetConfig(widgetId: string): Promise<any | null>;
+    setWidgetConfig(widgetId: string, config: any): Promise<void>;
+};
+
+export { SolveoProvider, type SolveoProviderConfig, type SolveoProviderProps, storage, useAgents, useAnalytics, useAttachments, useChat, useConversations, useEscalation, usePushNotifications, useRealtime, useSolveo, useWidgetConfig };

package/dist/index.d.ts

@@ -0,0 +1,182 @@
+import React, { ReactNode } from 'react';
+import { SolveoClientConfig, SolveoSDK, Socket, CustomerSocketManager, AgentSocketManager, StreamingSocket, Conversation, Message, HumanAgent, Widget, WidgetConfig, Device, MessageAttachment, Agent, AgentCreateRequest, AgentUpdateRequest, ConversationMetrics, SentimentDistribution, FeedbackStats, TokenUsageMetrics } from '@solveo-ai/sdk-core';
+export { Agent, Conversation, ConversationStatus, FeedbackType, Message, MessageAttachment, SentimentType, Widget } from '@solveo-ai/sdk-core';
+
+interface SolveoContextValue {
+    sdk: SolveoSDK;
+    config: SolveoProviderConfig;
+    customerSocket: Socket | null;
+    customerSocketManager: CustomerSocketManager | null;
+    agentSocket: Socket | null;
+    agentSocketManager: AgentSocketManager | null;
+    streamingSocket: StreamingSocket | null;
+    connectCustomerSocket: (conversationId: string) => void;
+    disconnectCustomerSocket: () => void;
+    connectAgentSocket: (token: string) => void;
+    disconnectAgentSocket: () => void;
+    connectStreamingSocket: (conversationId: string) => void;
+    disconnectStreamingSocket: () => void;
+}
+interface SolveoProviderConfig extends Omit<SolveoClientConfig, 'platform'> {
+    user?: {
+        email?: string;
+        name?: string;
+        id?: string;
+    };
+    autoConnectCustomer?: boolean;
+    autoConnectAgent?: boolean;
+    conversationId?: string;
+    onError?: (error: Error) => void;
+}
+interface SolveoProviderProps {
+    children: ReactNode;
+    config: SolveoProviderConfig;
+}
+declare function SolveoProvider({ children, config }: SolveoProviderProps): React.JSX.Element;
+declare function useSolveo(): SolveoContextValue;
+
+interface UseChatOptions {
+    widgetId?: string;
+    agentId?: string;
+    persistConversation?: boolean;
+}
+declare function useChat(options?: UseChatOptions): {
+    conversation: Conversation | null;
+    messages: Message[];
+    isLoading: boolean;
+    isStreaming: boolean;
+    streamingContent: string;
+    error: Error | null;
+    createConversation: () => Promise<Conversation>;
+    sendMessage: (content: string) => Promise<void>;
+    loadMessages: (conversationId: string) => Promise<void>;
+    submitFeedback: (messageId: string, rating: "THUMBS_UP" | "THUMBS_DOWN") => Promise<void>;
+};
+
+declare function useRealtime(): {
+    isConnected: boolean;
+    agentTyping: boolean;
+    queuePosition: number | null;
+    estimatedWait: number | null;
+};
+
+declare function useEscalation(): {
+    escalationId: string | null;
+    assignedAgent: HumanAgent | null;
+    status: "idle" | "requesting" | "queued" | "active" | "resolved";
+    requestHuman: (conversationId: string) => void;
+    endChat: () => void;
+    submitCSAT: (rating: number) => void;
+};
+
+declare function useWidgetConfig(widgetId?: string): {
+    widget: Widget | null;
+    widgetConfig: WidgetConfig | null;
+    isLoading: boolean;
+    error: Error | null;
+    reload: () => Promise<void>;
+};
+
+/**
+ * Push notification event handlers
+ */
+interface PushNotificationHandlers {
+    onNotificationReceived?: (notification: any) => void;
+    onNotificationTapped?: (notification: any) => void;
+}
+/**
+ * Hook options
+ */
+interface UsePushNotificationsOptions {
+    mode?: 'widget' | 'agent';
+    conversationId?: string;
+    autoRegister?: boolean;
+    handlers?: PushNotificationHandlers;
+}
+/**
+ * Enhanced Push Notifications Hook for React Native
+ *
+ * Supports both customer (widget) and agent (dashboard) modes.
+ * Handles permissions, registration, and notification events.
+ *
+ * SETUP INSTRUCTIONS:
+ * 1. Install peer dependencies:
+ *    npm install @react-native-firebase/app @react-native-firebase/messaging
+ *    (or expo-notifications for Expo projects)
+ *
+ * 2. Configure Firebase/APNs:
+ *    - Android: Add google-services.json to android/app/
+ *    - iOS: Add GoogleService-Info.plist to ios/ and configure APNs
+ *
+ * 3. Add permissions to manifests:
+ *    - Android: INTERNET, VIBRATE, RECEIVE_BOOT_COMPLETED
+ *    - iOS: User Notifications capability
+ */
+declare function usePushNotifications(options?: UsePushNotificationsOptions): {
+    requestPermission: () => Promise<boolean>;
+    registerDevice: (convId?: string, pushToken?: string, bundleId?: string) => Promise<Device | null>;
+    registerAgentDevice: (pushToken?: string, deviceName?: string) => Promise<any>;
+    unregisterDevice: () => Promise<void>;
+    device: Device | null;
+    isRegistered: boolean;
+    isInitialized: boolean;
+    permissionStatus: "granted" | "denied" | "undetermined";
+};
+
+declare function useAttachments(conversationId?: string): {
+    uploading: boolean;
+    uploadProgress: number;
+    uploadAttachment: (file: {
+        uri: string;
+        type?: string;
+        name?: string;
+    }, attachmentType: "IMAGE" | "AUDIO" | "VIDEO" | "DOCUMENT" | "VOICE_NOTE") => Promise<MessageAttachment>;
+};
+
+declare function useAgents(accountId?: string): {
+    agents: Agent[];
+    isLoading: boolean;
+    error: Error | null;
+    createAgent: (data: AgentCreateRequest) => Promise<Agent>;
+    updateAgent: (id: string, data: AgentUpdateRequest) => Promise<Agent>;
+    deleteAgent: (id: string) => Promise<void>;
+    reload: () => Promise<void>;
+};
+
+declare function useConversations(accountId?: string): {
+    conversations: Conversation[];
+    isLoading: boolean;
+    error: Error | null;
+    resolveConversation: (id: string) => Promise<void>;
+    reload: () => Promise<void>;
+};
+
+declare function useAnalytics(accountId?: string, days?: number): {
+    metrics: ConversationMetrics | null;
+    sentiment: SentimentDistribution | null;
+    feedback: FeedbackStats | null;
+    tokenUsage: TokenUsageMetrics | null;
+    isLoading: boolean;
+    error: Error | null;
+    reload: () => Promise<void>;
+};
+
+declare const storage: {
+    getConversationId(): Promise<string | null>;
+    setConversationId(id: string): Promise<void>;
+    clearConversationId(): Promise<void>;
+    getMessages(conversationId: string): Promise<any[]>;
+    setMessages(conversationId: string, messages: any[]): Promise<void>;
+    getUserIdentity(): Promise<{
+        email?: string;
+        name?: string;
+    } | null>;
+    setUserIdentity(identity: {
+        email?: string;
+        name?: string;
+    }): Promise<void>;
+    getWidgetConfig(widgetId: string): Promise<any | null>;
+    setWidgetConfig(widgetId: string, config: any): Promise<void>;
+};
+
+export { SolveoProvider, type SolveoProviderConfig, type SolveoProviderProps, storage, useAgents, useAnalytics, useAttachments, useChat, useConversations, useEscalation, usePushNotifications, useRealtime, useSolveo, useWidgetConfig };