@ion299/sdk-react-native 0.1.0-beta.1

package/src/types.ts

@@ -0,0 +1,199 @@
+// Конфигурация при инициализации SDK.
+// token может быть либо plain-строкой (тогда baseUrl обязателен),
+// либо base64-закодированным JSON вида {"token":"...","baseUrl":"..."}.
+export interface ChatSDKConfig {
+  token: string
+  baseUrl?: string
+  locale?: 'ru' | 'en'
+}
+
+// Данные пользователя при логине
+export interface ChatSDKUser {
+  userId: string
+  name?: string
+  surname?: string
+  email?: string
+  phone?: string
+}
+
+// Данные устройства (опционально)
+export interface ChatSDKDevice {
+  platform?: 'ios' | 'android' | 'other'
+  appVersion?: string
+  bundleId?: string
+}
+
+// Тема виджета из ЧП
+export interface ChatSDKTheme {
+  widgetTitle: string
+  colorType: 'single' | 'gradient'
+  themeColor: string
+  colorStart: string | null
+  colorEnd: string | null
+  imageLogo: string | null
+}
+
+// Параметры Reverb из ответа /session
+export interface ReverbConfig {
+  key: string
+  host: string
+  port: number
+  scheme: 'http' | 'https'
+}
+
+// Полный конфиг из /session или /config
+export interface MobileConfig extends ChatSDKTheme {
+  apiBaseUrl: string
+  reverb: ReverbConfig
+  broadcastAuthEndpoint: string
+}
+
+// Ответ POST /session
+export interface SessionResponse {
+  sessionToken: string
+  expiresAt: string
+  contactId: string
+  config: MobileConfig
+}
+
+// Одно сообщение в чате
+export interface ChatMessage {
+  id: string
+  type: 'contact' | 'user' | 'system' | 'event'
+  text: string | null
+  time: string
+  createdAt: number
+  sender?: { name: string } | null
+  attachments?: ChatAttachment[]
+  buttons?: ChatButton[] | null
+  serverMessageId?: number | null
+}
+
+// Вложение
+export interface ChatAttachment {
+  id: number
+  url: string
+  filename: string
+  mime: string
+  size: number
+  type: 'image' | 'video' | 'audio' | 'document'
+}
+
+// Файл для отправки из SDK (используется хост-приложением)
+export interface AttachmentInput {
+  uri: string
+  name: string
+  type: string
+  size?: number
+}
+
+// Вложение с контекстом сообщения (для галереи)
+export interface GalleryAttachment extends ChatAttachment {
+  messageTime: string
+}
+
+// Кнопка бота
+export interface ChatButton {
+  text: string
+  callback_data: string
+}
+
+// Ответ GET /messages
+export interface MessagesResponse {
+  operator: { id: number; name: string } | null
+  messages: ChatMessage[]
+}
+
+export interface ChatOperator {
+  id: number
+  name: string
+}
+
+// Payload для handleNotification (из push)
+export interface NotificationPayload {
+  token: string
+  contactId: string
+  conversationId?: string
+  messageId?: string
+}
+
+export interface OperatorChangedEventPayload {
+  token: string
+  contactId: string
+  previousOperator: ChatOperator | null
+  operator: ChatOperator | null
+  occurredAt: string
+}
+
+export interface NewMessageEventPayload {
+  token: string
+  contactId: string
+  message: ChatMessage
+  operator: ChatOperator | null
+  occurredAt: string
+}
+
+export interface MessagesUpdatedEventPayload {
+  messages: ChatMessage[]
+  operator: ChatOperator | null
+}
+
+export type ChatSDKEventName =
+  | 'stateChange'
+  | 'error'
+  | 'operatorChanged'
+  | 'newMessage'
+  | 'messagesUpdated'
+  | 'connectedChange'
+
+// Конфиг CSI-опроса с сервера
+export interface SurveyConfig {
+  visible: true
+  title: string
+  description: string
+  range: [number, number]
+  badRange: [number, number]
+  badMessage: string
+  goodMessage: string
+  afterCommentMessage: string
+  commentEnabled: boolean
+  badRangeEnabled: boolean
+  commentRequired: boolean
+}
+
+export type SurveyConfigResponse = SurveyConfig | { visible: false }
+
+// Внутреннее состояние SDK
+export type SDKState =
+  | 'idle'
+  | 'initializing'
+  | 'ready'
+  | 'authenticated'
+  | 'error'
+
+/**
+ * Кастомные тексты для <ChatScreen />.
+ * Все поля опциональны — непереданные значения берутся из встроенного дефолта.
+ */
+export interface ChatStrings {
+  /** Заголовок хедера. По умолчанию: widgetTitle из конфига → 'Чат' */
+  headerTitle?: string
+  /** Текст пустого экрана чата */
+  emptyStateText?: string
+  /** Placeholder в поле ввода */
+  inputPlaceholder?: string
+  /** Текст кнопки/индикатора отправки */
+  sendingText?: string
+  /** Текст кнопки повтора при ошибке */
+  errorRetry?: string
+  /** Заголовок оверлея CSI-опроса (если не задан сервером) */
+  surveyTitle?: string
+  /** Текст кнопки отправки оценки в опросе */
+  surveySubmit?: string
+  /** Текст кнопки пропуска опроса */
+  surveySkip?: string
+  /** Текст кнопки закрытия результата опроса */
+  surveyClose?: string
+  /** Текст кнопки скачивания в галерее */
+  galleryDownload?: string
+}

package/src/useChat.ts

@@ -0,0 +1,190 @@
+import { useCallback, useEffect, useRef, useState } from 'react'
+import { ChatSDK } from './ChatSDK'
+import { isSurveyEventSeen, markSurveyEventSeen, deleteSurveyEvent } from './surveyCache'
+import type {
+  AttachmentInput,
+  ChatAttachment,
+  ChatMessage,
+  SurveyConfig,
+} from './types'
+
+export interface UseChatReturn {
+  messages: ChatMessage[]
+  isLoading: boolean
+  isSending: boolean
+  connected: boolean
+  error: string | null
+  survey: SurveyConfig | null
+  sendMessage: (text: string, files?: AttachmentInput[]) => Promise<void>
+  sendCallback: (messageId: number, callbackData: string) => Promise<void>
+  submitSurvey: (rating: number, comment?: string) => Promise<void>
+  dismissSurvey: () => void
+  retry: () => void
+}
+
+function filterVisible(all: ChatMessage[]): ChatMessage[] {
+  return all.filter((m) => !(m.type === 'event' && m.text === 'status_changed'))
+}
+
+export function useChat(): UseChatReturn {
+  const [messages, setMessages]   = useState<ChatMessage[]>(() => filterVisible(ChatSDK.getMessages()))
+  const [isLoading, setIsLoading] = useState(ChatSDK.getMessages().length === 0)
+  const [isSending, setIsSending] = useState(false)
+  const [connected, setConnected] = useState(ChatSDK.isRealtimeConnected())
+  const [error, setError]         = useState<string | null>(null)
+  const [survey, setSurvey]       = useState<SurveyConfig | null>(null)
+
+  const api = ChatSDK.getApi()
+  const lastCloseEventRef = useRef<string | null>(null)
+
+  const checkSurvey = useCallback(
+    async (eventMessageId: string, closeEventCreatedAt?: number) => {
+      const contactId = api.getContactId()
+      if (!contactId) return
+      if (isSurveyEventSeen(contactId, eventMessageId)) return
+
+      markSurveyEventSeen(contactId, eventMessageId)
+
+      try {
+        const cfg = await api.getSurveyConfig(closeEventCreatedAt)
+        if (cfg.visible) {
+          setSurvey(cfg as SurveyConfig)
+        }
+      } catch {
+        deleteSurveyEvent(contactId, eventMessageId)
+      }
+    },
+    [api],
+  )
+
+  useEffect(() => {
+    const unsubMessages = ChatSDK.on('messagesUpdated', ({ messages: all }) => {
+      setMessages(filterVisible(all))
+      setIsLoading(false)
+      setError(null)
+
+      const closeEvent = all.findLast(
+        (m) => m.type === 'event' && m.text === 'status_changed',
+      )
+      if (closeEvent && closeEvent.id !== lastCloseEventRef.current) {
+        lastCloseEventRef.current = closeEvent.id
+        void checkSurvey(closeEvent.id, closeEvent.createdAt)
+      }
+    })
+
+    const unsubConnected = ChatSDK.on('connectedChange', (value) => setConnected(value))
+
+    return () => {
+      unsubMessages()
+      unsubConnected()
+    }
+  }, [checkSurvey])
+
+  useEffect(() => {
+    void (async () => {
+      try {
+        const user = ChatSDK.getUser()
+        await api.startDialog({
+          name:    user?.name,
+          surname: user?.surname,
+          email:   user?.email,
+          phone:   user?.phone,
+        })
+      } catch (e) {
+        console.warn('ChatSDK: startDialog failed (non-fatal):', e)
+      }
+      try {
+        await ChatSDK.refreshMessages()
+      } catch (e) {
+        setError(e instanceof Error ? e.message : 'Ошибка загрузки')
+        setIsLoading(false)
+      }
+    })()
+  }, [api])
+
+  const sendMessage = useCallback(
+    async (text: string, files?: AttachmentInput[]) => {
+      if (!text.trim() && (!files || files.length === 0)) return
+      setIsSending(true)
+      setError(null)
+
+      const tempId = `temp-${Date.now()}`
+      const tempAttachments: ChatAttachment[] = (files ?? []).map((f, i) => ({
+        id:       -(i + 1),
+        url:      f.uri,
+        filename: f.name,
+        mime:     f.type,
+        size:     f.size ?? 0,
+        type:     f.type.startsWith('image/') ? 'image'
+                : f.type.startsWith('video/') ? 'video'
+                : f.type.startsWith('audio/') ? 'audio'
+                : 'document',
+      }))
+
+      const tempMsg: ChatMessage = {
+        id:          tempId,
+        type:        'contact',
+        text:        text.trim() || null,
+        time:        new Date().toLocaleTimeString('ru', { hour: '2-digit', minute: '2-digit' }),
+        createdAt:   Date.now(),
+        attachments: tempAttachments,
+      }
+      setMessages((prev) => [...prev, tempMsg])
+
+      try {
+        await api.sendMessage(text, files)
+        await ChatSDK.refreshMessages()
+      } catch (e) {
+        setError(e instanceof Error ? e.message : 'Ошибка отправки')
+        setMessages((prev) => prev.filter((m) => m.id !== tempId))
+      } finally {
+        setIsSending(false)
+      }
+    },
+    [api],
+  )
+
+  const sendCallback = useCallback(
+    async (messageId: number, callbackData: string) => {
+      try {
+        await api.sendCallback(messageId, callbackData)
+        await ChatSDK.refreshMessages()
+      } catch (e) {
+        setError(e instanceof Error ? e.message : 'Ошибка отправки')
+      }
+    },
+    [api],
+  )
+
+  const submitSurvey = useCallback(
+    async (rating: number, comment?: string) => {
+      await api.submitCsi(rating, comment)
+    },
+    [api],
+  )
+
+  const dismissSurvey = useCallback(() => setSurvey(null), [])
+
+  const retry = useCallback(() => {
+    setIsLoading(true)
+    setError(null)
+    void ChatSDK.refreshMessages().catch((e) => {
+      setError(e instanceof Error ? e.message : 'Ошибка загрузки')
+      setIsLoading(false)
+    })
+  }, [])
+
+  return {
+    messages,
+    isLoading,
+    isSending,
+    connected,
+    error,
+    survey,
+    sendMessage,
+    sendCallback,
+    submitSurvey,
+    dismissSurvey,
+    retry,
+  }
+}