@lmapp/react-native-cloudpayments/lib/module/hooks/core/useCloudPaymentsEvents.js

🚀 Мощный SDK для интеграции платежей CloudPayments в React Native. Поддержка Apple Pay, Google Pay, СБП, банковских карт. Полная типизация TypeScript. iOS 12+ и Android 21+

"use strict";

/**
 * @fileoverview Хук для управления событиями CloudPayments SDK
 * @description Базовый хук для подписки на события и управления состоянием SDK
 * @author Leonid Molchanov
 * @since 1.0.0
 */

import { useCallback, useEffect, useRef, useState } from 'react';
import { eventEmitter } from "../../events/index.js";
import { EPaymentFormEventName } from "../../types/index.js";
// ============================================================================
// CONSTANTS
// ============================================================================

/**
 * События по умолчанию для подписки
 * @description Базовый набор событий, на которые подписывается хук если не указаны enabledEvents
 */
const DEFAULT_ENABLED_EVENTS = [EPaymentFormEventName.PAYMENT_FORM];

/**
 * Начальное состояние SDK
 */
const INITIAL_STATE = {
  isLoading: false,
  isError: false,
  isSuccess: false,
  status: 'idle',
  error: null,
  transactionId: null,
  progress: null
};

// ============================================================================
// HOOK IMPLEMENTATION
// ============================================================================

/**
 * Хук для управления событиями CloudPayments SDK
 *
 * @description Базовый хук для подписки на события SDK и управления состоянием.
 * Предоставляет методы для обновления состояния и автоматически подписывается
 * на события платежной формы.
 *
 * @param options - Опции конфигурации хука
 * @returns Объект с состоянием и методами управления
 *
 * @example Базовое использование
 * ```typescript
 * const { state, actions } = useCloudPaymentsEvents({
 *   onSuccess: (data) => console.log('Успех:', data.transactionId),
 *   onError: (data) => console.log('Ошибка:', data.message)
 * });
 *
 * // Использование методов управления состоянием
 * const handleStart = () => {
 *   actions.setStatus('processing');
 * };
 *
 * const handleError = (message: string) => {
 *   actions.setError(message, EPaymentFormErrorCode.PAYMENT_FAILED);
 * };
 * ```
 *
 * @example Кастомные события
 * ```typescript
 * const { state, actions } = useCloudPaymentsEvents({
 *   enabledEvents: [EPaymentFormEventName.PAYMENT_FORM],
 *   onSuccess: (data) => {
 *     actions.setStatus('success', { transactionId: data.transactionId });
 *   }
 * });
 * ```
 *
 * @since 1.0.0
 */
export const useCloudPaymentsEvents = (options = {}) => {
  // ============================================================================
  // STATE & REFS
  // ============================================================================

  const [state, setState] = useState(INITIAL_STATE);
  const subscriptionsRef = useRef([]);
  const transactionProcessedRef = useRef(false);
  const {
    enabledEvents = DEFAULT_ENABLED_EVENTS,
    onSuccess,
    onError,
    onCancel
  } = options;

  // ============================================================================
  // HELPER FUNCTIONS
  // ============================================================================

  /**
   * Обновление состояния хука
   */
  const updateState = useCallback(updates => {
    setState(prevState => ({
      ...prevState,
      ...updates
    }));
  }, []);

  /**
   * Установка статуса с автоматическим обновлением флагов
   */
  const setStatus = useCallback((status, additionalUpdates = {}) => {
    updateState({
      status,
      isLoading: status === 'initializing' || status === 'processing',
      isError: status === 'error',
      isSuccess: status === 'success',
      ...additionalUpdates
    });
  }, [updateState]);

  /**
   * Установка ошибки
   */
  const setError = useCallback((message, code, details) => {
    const error = {
      message,
      code,
      details
    };
    setStatus('error', {
      error
    });
  }, [setStatus]);

  /**
   * Установка прогресса
   */
  const setProgress = useCallback((stage, percentage) => {
    const progress = {
      stage,
      percentage
    };
    updateState({
      progress
    });
  }, [updateState]);

  /**
   * Очистка состояния
   */
  const resetState = useCallback(() => {
    setState(INITIAL_STATE);
  }, []);

  // ============================================================================
  // EVENT HANDLERS
  // ============================================================================

  /**
   * Обработчик событий платежной формы
   */
  const handlePaymentFormEvent = useCallback(event => {
    switch (event.action) {
      case 'willDisplay':
        setStatus('initializing');
        break;
      case 'didDisplay':
        setStatus('processing');
        break;
      case 'willHide':
        // Форма готовится к скрытию
        break;
      case 'didHide':
        // Форма скрыта - сбрасываем состояние если не было транзакции
        if (!transactionProcessedRef.current) {
          setStatus('cancelled');
          onCancel?.();
        }
        // Сбрасываем флаг для следующего платежа
        transactionProcessedRef.current = false;
        break;
      case 'cancelled':
        // НОВОЕ: Обработка специального события отмены платежа
        transactionProcessedRef.current = true;
        setStatus('cancelled');
        onCancel?.();
        break;
      case 'transaction':
        // Отмечаем что транзакция была обработана
        transactionProcessedRef.current = true;
        if (event.statusCode) {
          // Успешная транзакция
          const transactionId = event.transactionId || null;
          setStatus('success', {
            transactionId
          });
          if (onSuccess && transactionId) {
            onSuccess({
              transactionId,
              message: event.message
            });
          }
        } else {
          // Ошибка транзакции
          const message = event.message || 'Произошла ошибка при выполнении платежа';
          const code = event.errorCode;
          setError(message, code);
          if (onError) {
            onError({
              message,
              code
            });
          }
        }
        break;
      default:
        console.warn('Неизвестное действие платежной формы:', event.action);
    }
  }, [setStatus, setError, onSuccess, onError, onCancel]);

  // ============================================================================
  // EFFECTS
  // ============================================================================

  /**
   * Подписка на события при монтировании компонента
   */
  useEffect(() => {
    const subscriptions = [];

    // Подписываемся только на поддерживаемые события
    enabledEvents.forEach(eventName => {
      switch (eventName) {
        case EPaymentFormEventName.PAYMENT_FORM:
          subscriptions.push(eventEmitter.addListener(eventName, handlePaymentFormEvent));
          break;
        case EPaymentFormEventName.PAYMENT:
        case EPaymentFormEventName.CARD:
        case EPaymentFormEventName.THREE_DS:
          // Пока не реализованы, но готовы к добавлению
          console.log(`Событие ${eventName} будет поддержано в будущих версиях`);
          break;
        default:
          console.warn(`Неподдерживаемое событие: ${eventName}`);
      }
    });
    subscriptionsRef.current = subscriptions;

    // Очистка подписок при размонтировании
    return () => {
      subscriptions.forEach(subscription => subscription.remove());
      subscriptionsRef.current = [];
    };
  }, [enabledEvents, handlePaymentFormEvent]);

  // ============================================================================
  // RETURN
  // ============================================================================

  return {
    state,
    actions: {
      setStatus,
      setError,
      setProgress,
      updateState,
      resetState
    }
  };
};
//# sourceMappingURL=useCloudPaymentsEvents.js.map