@lmapp/react-native-cloudpayments/lib/module/hooks/payment/usePaymentForm.js

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

"use strict";

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

import { useCallback } from 'react';
import { PaymentService } from "../../services/index.js";
// ============================================================================
// HOOK IMPLEMENTATION
// ============================================================================

/**
 * Хук для работы с платежной формой CloudPayments
 *
 * @description Предоставляет функцию для запуска стандартной платежной формы CloudPayments.
 * Этот хук инкапсулирует логику работы с платежной формой и может быть переиспользован
 * в различных сценариях оплаты.
 *
 * @param publicId - Публичный идентификатор мерчанта CloudPayments
 * @param options - Опции конфигурации хука (пока не используются, зарезервированы для будущего)
 * @returns Функция для запуска платежной формы
 *
 * @example Базовое использование
 * ```typescript
 * const presentPaymentForm = usePaymentForm('pk_test_1234567890abcdef');
 *
 * const handlePayment = async () => {
 *   try {
 *     const result = await presentPaymentForm({
 *       amount: '1000.00',
 *       currency: 'RUB',
 *       description: 'Покупка товара',
 *       email: 'user@example.com'
 *     });
 *
 *     if (result.success) {
 *       console.log('Платеж успешен:', result.transactionId);
 *     } else {
 *       console.log('Платеж отклонен:', result.message);
 *     }
 *   } catch (error) {
 *     console.error('Ошибка платежа:', error);
 *   }
 * };
 * ```
 *
 * @example Использование с дополнительными параметрами
 * ```typescript
 * const presentPaymentForm = usePaymentForm('pk_test_1234567890abcdef');
 *
 * const result = await presentPaymentForm({
 *   amount: '2500.00',
 *   currency: 'RUB',
 *   description: 'Подписка Premium',
 *   email: 'user@example.com',
 *   requireEmail: true,
 *   applePayMerchantId: 'merchant.com.myapp.payments',
 *   showResultScreen: true
 * });
 * ```
 *
 * @since 1.0.0
 */
export const usePaymentForm = publicId => {
  /**
   * Функция запуска платежной формы
   */
  const presentPaymentForm = useCallback(async paymentData => {
    try {
      // Запускаем платежную форму с объединенными данными
      const result = await PaymentService.presentPaymentForm({
        ...paymentData,
        publicId
      });
      return result;
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : 'Неизвестная ошибка';

      // Возвращаем результат с ошибкой
      return {
        success: false,
        message: errorMessage,
        transactionId: undefined
      };
    }
  }, [publicId]);
  return presentPaymentForm;
};
//# sourceMappingURL=usePaymentForm.js.map