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

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@ion299/sdk-react-native",
+  "version": "0.1.0-beta.1",
+  "description": "React Native SDK for Chat Platform",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/commonjs/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "ChatPlatformSdk.podspec",
+    "react-native.config.js",
+    "README.md",
+    "CHANGELOG.md",
+    "!**/__tests__",
+    "!**/*.test.ts",
+    "!**/*.test.tsx"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "clean": "del-cli lib",
+    "build": "bob build",
+    "prepare": "bob build"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      ["commonjs", { "esm": true }],
+      ["module", { "esm": true }],
+      ["typescript", { "project": "tsconfig.build.json" }]
+    ]
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-native": ">=0.72.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.72.0",
+    "react-native-builder-bob": "^0.40.0",
+    "del-cli": "^5.1.0"
+  },
+  "keywords": ["chat", "sdk", "react-native"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YOUR_GITHUB_USERNAME/chat-platform-sdk-rn-test.git"
+  },
+  "homepage": "https://github.com/YOUR_GITHUB_USERNAME/chat-platform-sdk-rn-test#readme",
+  "bugs": {
+    "url": "https://github.com/YOUR_GITHUB_USERNAME/chat-platform-sdk-rn-test/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "UNLICENSED"
+}

package/react-native.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        packageInstance: 'new com.chatplatform.sdk.ChatSdkPackage()',
+      },
+      ios: {},
+    },
+  },
+}

package/src/ChatSDK.ts

@@ -0,0 +1,237 @@
+import { MobileApiClient } from './api'
+import { ChatSDKSession } from './session'
+import type {
+  ChatMessage,
+  ChatOperator,
+  ChatSDKConfig,
+  ChatSDKDevice,
+  ChatSDKUser,
+  MessagesUpdatedEventPayload,
+  MobileConfig,
+  NewMessageEventPayload,
+  NotificationPayload,
+  OperatorChangedEventPayload,
+  SDKState,
+} from './types'
+
+type SDKEventMap = {
+  stateChange: SDKState
+  error: unknown
+  operatorChanged: OperatorChangedEventPayload
+  newMessage: NewMessageEventPayload
+  messagesUpdated: MessagesUpdatedEventPayload
+  connectedChange: boolean
+}
+
+type EventName = keyof SDKEventMap
+type EventHandler<K extends EventName = EventName> = (data: SDKEventMap[K]) => void
+
+class ChatSDKSingleton {
+  private config: ChatSDKConfig | null = null
+  private api: MobileApiClient | null = null
+  private sdkConfig: MobileConfig | null = null
+  private session: ChatSDKSession | null = null
+  private state: SDKState = 'idle'
+  private lastError: string | null = null
+  private currentUser: ChatSDKUser | null = null
+  private listeners: Map<EventName, Set<EventHandler>> = new Map()
+
+  // ─── Lifecycle ────────────────────────────────────────────────────────────
+
+  init(raw: ChatSDKConfig): void {
+    // После hot reload в Expo состояние может остаться error — разрешаем переинициализацию
+    if (this.state !== 'idle' && this.state !== 'error') {
+      console.warn('ChatSDK: already initialized')
+      return
+    }
+
+    const config = ChatSDKSingleton.resolveConfig(raw)
+    this.config = config
+    this.api = new MobileApiClient(config.baseUrl!, config.token)
+    this.lastError = null
+    this.setState('ready')
+
+    // Конфиг для темы подгружаем в фоне; полный config всё равно приходит из POST /session при login
+    void this.api
+      .getConfig()
+      .then((cfg) => {
+        this.sdkConfig = cfg
+        if (this.state === 'ready') {
+          this.emit('stateChange', 'ready')
+        }
+      })
+      .catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err)
+        console.warn('ChatSDK: getConfig failed (non-fatal):', msg)
+      })
+  }
+
+  getLastError(): string | null {
+    return this.lastError
+  }
+
+  async login(user: ChatSDKUser, device?: ChatSDKDevice): Promise<void> {
+    this.assertInitialized()
+    const api = this.api!
+
+    try {
+      const result = await api.createSession(
+        user.userId,
+        {
+          name: user.name,
+          surname: user.surname,
+          email: user.email,
+          phone: user.phone,
+        },
+        device ?? {},
+      )
+
+      api.setSession(result.sessionToken, result.contactId)
+      api.setUserProfile({
+        name:    user.name,
+        surname: user.surname,
+        email:   user.email,
+        phone:   user.phone,
+      })
+      this.sdkConfig = result.config
+      this.currentUser = user
+      this.lastError = null
+
+      this.startSession()
+      this.setState('authenticated')
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      this.lastError = msg
+      this.setState('error')
+      this.emit('error', err)
+      throw err
+    }
+  }
+
+  async logout(): Promise<void> {
+    this.currentUser = null
+    this.session?.destroy()
+    this.session = null
+    this.api?.clearSession()
+    this.setState(this.sdkConfig ? 'ready' : 'idle')
+  }
+
+  // ─── Push ─────────────────────────────────────────────────────────────────
+
+  handleNotification(_payload: NotificationPayload): void {
+    // Навигация обрабатывается в host app через onNotification callback.
+    // SDK только проверяет, что payload относится к нашему токену.
+    if (_payload.token !== this.config?.token) return
+    // В будущем: открыть ChatScreen если приложение foreground
+  }
+
+  // ─── Getters ──────────────────────────────────────────────────────────────
+
+  getApi(): MobileApiClient {
+    this.assertInitialized()
+    return this.api!
+  }
+
+  getSDKConfig(): MobileConfig | null {
+    return this.sdkConfig
+  }
+
+  getBaseUrl(): string {
+    return this.config?.baseUrl ?? ''
+  }
+
+  getState(): SDKState {
+    return this.state
+  }
+
+  isAuthenticated(): boolean {
+    return this.state === 'authenticated'
+  }
+
+  getUser(): ChatSDKUser | null {
+    return this.currentUser
+  }
+
+  /** Кэш последнего ответа /messages. Пустой массив до первой загрузки. */
+  getMessages(): ChatMessage[] {
+    return this.session?.getMessages() ?? []
+  }
+
+  getOperator(): ChatOperator | null {
+    return this.session?.getOperator() ?? null
+  }
+
+  isRealtimeConnected(): boolean {
+    return this.session?.isConnected() ?? false
+  }
+
+  /** Принудительный refresh с сервера. Не бросает при сетевых ошибках после первой загрузки. */
+  refreshMessages(): Promise<void> {
+    return this.session?.refreshMessages() ?? Promise.resolve()
+  }
+
+  // ─── Events ───────────────────────────────────────────────────────────────
+
+  on<K extends EventName>(event: K, handler: EventHandler<K>): () => void {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, new Set())
+    }
+    const handlers = this.listeners.get(event)!
+    handlers.add(handler as EventHandler)
+    return () => handlers.delete(handler as EventHandler)
+  }
+
+  // ─── Private ──────────────────────────────────────────────────────────────
+
+  private startSession(): void {
+    if (!this.sdkConfig || !this.api || !this.config) return
+    this.session?.destroy()
+    this.session = new ChatSDKSession(
+      this.api,
+      this.sdkConfig,
+      this.config.token,
+      this.config.baseUrl ?? this.sdkConfig.apiBaseUrl,
+      {
+        emitMessagesUpdated: (messages, operator) =>
+          this.emit('messagesUpdated', { messages, operator }),
+        emitConnectedChange: (connected) => this.emit('connectedChange', connected),
+        emitOperatorChanged: (payload) => this.emit('operatorChanged', payload),
+        emitNewMessage:      (payload) => this.emit('newMessage', payload),
+      },
+    )
+    this.session.start()
+  }
+
+  private setState(next: SDKState): void {
+    this.state = next
+    this.emit('stateChange', next)
+  }
+
+  private emit<K extends EventName>(event: K, data: SDKEventMap[K]): void {
+    this.listeners.get(event)?.forEach((h) => (h as EventHandler<K>)(data))
+  }
+
+  private assertInitialized(): void {
+    if (!this.api || !this.config) {
+      throw new Error('ChatSDK: call init() before login()')
+    }
+  }
+
+  /** Если token — base64-JSON с полями token+baseUrl, распаковывает его. */
+  private static resolveConfig(raw: ChatSDKConfig): ChatSDKConfig & { baseUrl: string } {
+    if (!raw.baseUrl) {
+      try {
+        const decoded = JSON.parse(atob(raw.token)) as { token?: string; baseUrl?: string }
+        if (decoded.token && decoded.baseUrl) {
+          return { ...raw, token: decoded.token, baseUrl: decoded.baseUrl }
+        }
+      } catch {
+        // не base64 — падём ниже с понятной ошибкой
+      }
+      throw new Error('ChatSDK: baseUrl is required (or pass a base64-encoded config token)')
+    }
+    return raw as ChatSDKConfig & { baseUrl: string }
+  }
+}
+
+export const ChatSDK = new ChatSDKSingleton()

package/src/api.ts

@@ -0,0 +1,228 @@
+import type {
+  SessionResponse,
+  MobileConfig,
+  MessagesResponse,
+  ChatSDKDevice,
+  SurveyConfigResponse,
+  AttachmentInput,
+} from './types'
+
+export class MobileApiClient {
+  private baseUrl: string
+  private token: string
+  private sessionToken: string | null = null
+  private contactId: string | null = null
+  private userProfile: Record<string, string | undefined> = {}
+
+  constructor(baseUrl: string, token: string) {
+    this.baseUrl = baseUrl.replace(/\/$/, '')
+    this.token = token
+  }
+
+  setSession(sessionToken: string, contactId: string): void {
+    this.sessionToken = sessionToken
+    this.contactId = contactId
+  }
+
+  setUserProfile(profile: Record<string, string | undefined>): void {
+    this.userProfile = profile
+  }
+
+  clearSession(): void {
+    this.sessionToken = null
+    this.contactId = null
+    this.userProfile = {}
+  }
+
+  getContactId(): string | null {
+    return this.contactId
+  }
+
+  async createSession(
+    userId: string,
+    profile: Record<string, string | undefined>,
+    device: ChatSDKDevice,
+  ): Promise<SessionResponse> {
+    const body = { userId, profile, device }
+    const path = `/api/mobile/${this.token}/session`
+    let lastError: Error | null = null
+
+    // До 3 попыток — tunnel/LTE иногда рвёт POST
+    for (let attempt = 0; attempt < 3; attempt++) {
+      try {
+        const res = await this.post(path, body, 60_000)
+        return res as SessionResponse
+      } catch (e) {
+        lastError = e instanceof Error ? e : new Error(String(e))
+        if (attempt < 2) {
+          await new Promise((r) => setTimeout(r, 1500 * (attempt + 1)))
+        }
+      }
+    }
+
+    throw lastError ?? new Error('Session request failed')
+  }
+
+  async getConfig(): Promise<MobileConfig> {
+    const res = await this.get(`/api/mobile/${this.token}/config`)
+    return res as MobileConfig
+  }
+
+  async getMessages(): Promise<MessagesResponse> {
+    this.assertSession()
+    const res = await this.get(
+      `/api/mobile/${this.token}/contact/${this.contactId}/messages`,
+    )
+    return res as MessagesResponse
+  }
+
+  async startDialog(userData: Record<string, string | undefined>): Promise<void> {
+    this.assertSession()
+    await this.post(
+      `/api/mobile/${this.token}/contact/${this.contactId}/start`,
+      userData,
+    )
+  }
+
+  async sendMessage(text: string, files?: AttachmentInput[]): Promise<void> {
+    this.assertSession()
+    const url = `${this.baseUrl}/api/mobile/${this.token}/contact/${this.contactId}/messages`
+
+    const form = new FormData()
+    if (text.trim()) form.append('text', text)
+
+    if (files && files.length > 0) {
+      files.forEach((f) =>
+        // React Native FormData принимает объект {uri, name, type} вместо File
+        form.append('files[]', { uri: f.uri, name: f.name, type: f.type } as unknown as Blob),
+      )
+    }
+
+    if (this.userProfile.name)    form.append('name',    this.userProfile.name)
+    if (this.userProfile.surname) form.append('surname', this.userProfile.surname)
+    if (this.userProfile.email)   form.append('email',   this.userProfile.email)
+    if (this.userProfile.phone)   form.append('phone',   this.userProfile.phone)
+
+    const res = await fetch(url, {
+      method: 'POST',
+      headers: this.authHeaders(),
+      body: form,
+    })
+
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}))
+      throw new Error(body?.message ?? `HTTP ${res.status}`)
+    }
+  }
+
+  async getSurveyConfig(closeEventCreatedAt?: number): Promise<SurveyConfigResponse> {
+    const params = new URLSearchParams()
+    if (this.contactId) {
+      params.set('contact_id', this.contactId)
+    }
+    if (closeEventCreatedAt !== undefined) {
+      params.set('close_event_at', String(closeEventCreatedAt))
+    }
+    const query = params.toString()
+    const res = await this.get(
+      `/api/mobile/${this.token}/survey-config${query ? `?${query}` : ''}`,
+    )
+    return res as SurveyConfigResponse
+  }
+
+  async submitCsi(rating: number, comment?: string): Promise<void> {
+    this.assertSession()
+    await this.post(
+      `/api/mobile/${this.token}/contact/${this.contactId}/csi`,
+      { rating, comment: comment ?? '' },
+    )
+  }
+
+  async sendCallback(messageId: number, callbackData: string): Promise<void> {
+    this.assertSession()
+    await this.post(
+      `/api/mobile/${this.token}/contact/${this.contactId}/callback`,
+      { message_id: messageId, callback_data: callbackData },
+    )
+  }
+
+  getDownloadUrl(contactId: string): string {
+    return `${this.baseUrl}/api/mobile/${this.token}/contact/${contactId}/download`
+  }
+
+  buildAttachmentDownloadUrl(fileUrl: string, filename: string): string {
+    this.assertSession()
+    const params = new URLSearchParams({
+      url: fileUrl,
+      filename: filename || 'file',
+    })
+    return `${this.getDownloadUrl(this.contactId!)}?${params.toString()}`
+  }
+
+  getBroadcastAuthEndpoint(): string {
+    return `${this.baseUrl}/api/mobile/${this.token}/broadcasting/auth`
+  }
+
+  getAuthHeaders(): Record<string, string> {
+    return this.authHeaders()
+  }
+
+  private assertSession(): void {
+    if (!this.sessionToken || !this.contactId) {
+      throw new Error('ChatSDK: not authenticated. Call login() first.')
+    }
+  }
+
+  private authHeaders(): Record<string, string> {
+    return this.sessionToken
+      ? { Authorization: `Bearer ${this.sessionToken}` }
+      : {}
+  }
+
+  private async get(path: string): Promise<unknown> {
+    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+      headers: { Accept: 'application/json', ...this.authHeaders() },
+    })
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}))
+      throw new Error(body?.message ?? `HTTP ${res.status}`)
+    }
+    return res.json()
+  }
+
+  private async post(path: string, body: unknown, timeoutMs = 30_000): Promise<unknown> {
+    const res = await this.fetchWithTimeout(
+      `${this.baseUrl}${path}`,
+      {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Accept: 'application/json',
+          ...this.authHeaders(),
+        },
+        body: JSON.stringify(body),
+      },
+      timeoutMs,
+    )
+    if (!res.ok) {
+      const json = await res.json().catch(() => ({}))
+      throw new Error(json?.message ?? `HTTP ${res.status}`)
+    }
+    return res.json()
+  }
+
+  private async fetchWithTimeout(url: string, options: RequestInit, timeoutMs = 30000): Promise<Response> {
+    const controller = new AbortController()
+    const timer = setTimeout(() => controller.abort(), timeoutMs)
+    try {
+      return await fetch(url, { ...options, signal: controller.signal })
+    } catch (e: unknown) {
+      if (e instanceof Error && e.name === 'AbortError') {
+        throw new Error(`Request timed out: ${url}`)
+      }
+      throw e
+    } finally {
+      clearTimeout(timer)
+    }
+  }
+}

package/src/attachmentUtils.ts

@@ -0,0 +1,49 @@
+import { ChatSDK } from './ChatSDK'
+import type { ChatAttachment, GalleryAttachment } from './types'
+
+export function attachmentDisplayName(attachment: ChatAttachment): string {
+  const name = attachment.filename?.trim()
+  if (name) return name
+
+  try {
+    const path = attachment.url.split('?')[0] ?? ''
+    const segment = path.split('/').pop()
+    if (segment) return decodeURIComponent(segment)
+  } catch {
+    // ignore malformed URL
+  }
+
+  return 'Файл'
+}
+
+export function sanitizeFilename(name: string): string {
+  return name.replace(/[/\\?%*:|"<>]/g, '_') || 'file'
+}
+
+export interface AttachmentDownloadRequest {
+  downloadUrl: string
+  filename: string
+  headers: Record<string, string>
+  mime: string
+}
+
+export function buildAttachmentDownloadRequest(
+  attachment: GalleryAttachment,
+): AttachmentDownloadRequest {
+  const api = ChatSDK.getApi()
+  const contactId = api.getContactId()
+  if (!contactId) {
+    throw new Error('Сессия не активна')
+  }
+
+  const filename = attachmentDisplayName(attachment)
+
+  return {
+    downloadUrl: api.buildAttachmentDownloadUrl(attachment.url, filename),
+    filename,
+    headers: api.getAuthHeaders(),
+    mime: attachment.mime || 'application/octet-stream',
+  }
+}
+
+export type AttachmentDownloadHandler = (attachment: GalleryAttachment) => Promise<void>