refactor: rename useTransactionPaymentEvent to useTransactionEvent and update related references

Author: mCodex

README.md

@@ -23,13 +23,13 @@ import {
   initializeAndActivatePinPad,
   doPayment,
   generatePixQRCode,
-  useTransactionPaymentEvent,
+  useTransactionEvent,
   PaymentType,
   ErrorCode
 } from 'react-native-plugpag-nitro';
 
 function PaymentScreen() {
-  const paymentEvent = useTransactionPaymentEvent();
+  const paymentEvent = useTransactionEvent();
 
   const handlePayment = async () => {
     // Initialize terminal
@@ -83,11 +83,11 @@ Generate PIX QR code string.
 const qrString = await generatePixQRCode(2500); // R$ 25.00
 ```
 
-#### `useTransactionPaymentEvent()`
+#### `useTransactionEvent()`
 Real-time payment event monitoring hook.
 
 ```typescript
-const paymentEvent = useTransactionPaymentEvent();
+const paymentEvent = useTransactionEvent();
 // Returns: { code: number, message: string, customMessage?: string }
 ```
 
@@ -217,11 +217,11 @@ const result = await refundPayment({
 ```
 
 ### 🎣 React Hooks
-#### `useTransactionPaymentEvent()`
+#### `useTransactionEvent()`
 Real-time payment event monitoring hook to track status updates during transactions.
 
 ```typescript
-const paymentEvent = useTransactionPaymentEvent();
+const paymentEvent = useTransactionEvent();
 
 useEffect(() => {
   if (paymentEvent.code > 0) {
@@ -231,11 +231,11 @@ useEffect(() => {
 ```
 
 ### 🎣 React Hooks
-#### `useTransactionPaymentEvent()`
+#### `useTransactionEvent()`
 Real-time payment event monitoring hook to track status updates during transactions.
 
 ```typescript
-const paymentEvent = useTransactionPaymentEvent();
+const paymentEvent = useTransactionEvent();
 
 // paymentEvent contains:
 // {
@@ -279,15 +279,15 @@ import {
   PaymentType,
   ErrorCode,
   doPayment,
-  useTransactionPaymentEvent,
+  useTransactionEvent,
   initializeAndActivatePinPad,
   generatePixQRCode
 } from 'react-native-plugpag-nitro';
 
 function PaymentScreen() {
   const [isInitialized, setIsInitialized] = useState(false);
   const [isProcessing, setIsProcessing] = useState(false);
-  const paymentEvent = useTransactionPaymentEvent();
+  const paymentEvent = useTransactionEvent();
 
   // Initialize terminal on mount
   useEffect(() => {

android/src/main/java/com/margelo/nitro/plugpagnitro/PlugpagEventEmitter.kt

@@ -5,6 +5,11 @@ import com.facebook.react.modules.core.DeviceEventManagerModule
 
 class PlugpagEventEmitter(private val reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
 
+    init {
+        // Save instance for emitting events
+        setInstance(this)
+    }
+    
     override fun getName(): String {
         return "PlugpagEventEmitter"
     }

android/src/main/java/com/margelo/nitro/plugpagnitro/PlugpagNitro.kt

@@ -105,84 +105,8 @@ class PlugpagNitro : HybridPlugpagNitroSpec() {
     }
   }
 
-  override fun doPayment(
-    amount: Double,
-    type: PaymentType,
-    installmentType: InstallmentType,
-    installments: Double,
-    printReceipt: Boolean,
-    userReference: String
-  ): Promise<PlugpagTransactionResult> {
-    return Promise.async {
-      withContext(Dispatchers.IO) {
-        try {
-          initializePlugPag()
-          
-          // Convert enum to PlugPag SDK constants
-          val paymentType = when (type) {
-            PaymentType.CREDIT -> PlugPag.TYPE_CREDITO
-            PaymentType.DEBIT -> PlugPag.TYPE_DEBITO
-            PaymentType.VOUCHER -> PlugPag.TYPE_VOUCHER
-            PaymentType.PIX -> PlugPag.TYPE_PIX
-          }
-          
-          val installmentTypeInt = when (installmentType) {
-            InstallmentType.NO_INSTALLMENT -> PlugPag.INSTALLMENT_TYPE_A_VISTA
-            InstallmentType.SELLER_INSTALLMENT -> PlugPag.INSTALLMENT_TYPE_PARC_VENDEDOR
-            InstallmentType.BUYER_INSTALLMENT -> PlugPag.INSTALLMENT_TYPE_PARC_COMPRADOR
-          }
-          
-          val plugPagPaymentData = PlugPagPaymentData(
-            paymentType,
-            amount.toInt(),
-            installmentTypeInt,
-            installments.toInt(),
-            userReference,
-            printReceipt
-          )
-          
-          val result = plugPag.doPayment(plugPagPaymentData)
-          
-          val errorCode = when (result.result) {
-            PlugPag.RET_OK -> ErrorCode.OK
-            PlugPag.OPERATION_ABORTED -> ErrorCode.OPERATION_ABORTED
-            PlugPag.AUTHENTICATION_FAILED -> ErrorCode.AUTHENTICATION_FAILED
-            PlugPag.COMMUNICATION_ERROR -> ErrorCode.COMMUNICATION_ERROR
-            PlugPag.NO_PRINTER_DEVICE -> ErrorCode.NO_PRINTER_DEVICE
-            PlugPag.NO_TRANSACTION_DATA -> ErrorCode.NO_TRANSACTION_DATA
-            else -> ErrorCode.COMMUNICATION_ERROR
-          }
-          
-          PlugpagTransactionResult(
-            result = errorCode,
-            errorCode = result.errorCode ?: "",
-            message = result.message ?: "",
-            transactionCode = result.transactionCode ?: "",
-            transactionId = result.transactionId ?: "",
-            hostNsu = result.hostNsu ?: "",
-            date = result.date ?: "",
-            time = result.time ?: "",
-            cardBrand = result.cardBrand ?: "",
-            bin = result.bin ?: "",
-            holder = result.holder ?: "",
-            userReference = result.userReference ?: "",
-            terminalSerialNumber = result.terminalSerialNumber ?: "",
-            amount = result.amount ?: "",
-            availableBalance = result.availableBalance ?: "",
-            cardApplication = result.cardApplication ?: "",
-            label = result.label ?: "",
-            holderName = result.holderName ?: "",
-            extendedHolderName = result.extendedHolderName ?: ""
-          )
-        } catch (e: Exception) {
-          Log.e(TAG, "Error processing payment", e)
-          throw Exception("PAYMENT_ERROR: ${e.message ?: "Unknown error"}")
-        }
-      }
-    }
-  }
 
-  override fun doPaymentWithEvents(
+  override fun doPayment(
     amount: Double,
     type: PaymentType,
     installmentType: InstallmentType,

example/src/App.tsx

@@ -7,15 +7,14 @@ import {
   Text,
   TouchableOpacity,
   View,
-  DeviceEventEmitter,
 } from 'react-native';
 import {
   type PlugpagTransactionResult,
   initializeAndActivatePinPad,
   doPayment,
   refundPayment,
   generatePixQRCode,
-  useTransactionPaymentEvent,
+  useTransactionEvent,
   getTerminalSerialNumber,
   PaymentType,
   ErrorCode,
@@ -24,23 +23,16 @@ import {
 
 export default function App() {
   const [isProcessing, setIsProcessing] = useState(false);
+
   const [terminalSerial, setTerminalSerial] = useState<string>('N/A');
+
   const [lastPayment, setLastPayment] =
     useState<PlugpagTransactionResult | null>(null);
+
   const [isInitialized, setIsInitialized] = useState(false);
 
   // Real-time payment events
-  const paymentEvent = useTransactionPaymentEvent();
-
-  // Test event emitter
-  const testEventEmitter = () => {
-    console.log('Testing event emission...');
-    DeviceEventEmitter.emit('paymentEvent', {
-      code: 1001,
-      message: 'Teste manual de evento',
-      customMessage: 'Evento disparado do app',
-    });
-  };
+  const paymentEvent = useTransactionEvent();
 
   // Get terminal serial on mount
   useEffect(() => {
@@ -224,18 +216,6 @@ export default function App() {
         </Text>
       </View>
 
-      {/* Real-time Event Display */}
-      <View style={styles.debugContainer}>
-        <Text style={styles.debugTitle}>Estado do Evento:</Text>
-        <Text style={styles.debugText}>Código: {paymentEvent.code}</Text>
-        <Text style={styles.debugText}>Mensagem: {paymentEvent.message}</Text>
-        {paymentEvent.customMessage && (
-          <Text style={styles.debugText}>
-            Custom: {paymentEvent.customMessage}
-          </Text>
-        )}
-      </View>
-
       {paymentEvent.code > 0 && (
         <View
           style={[
@@ -297,10 +277,6 @@ export default function App() {
         <Text style={styles.buttonText}>Gerar QR PIX - R$ 50,00</Text>
       </TouchableOpacity>
 
-      <TouchableOpacity style={styles.button} onPress={testEventEmitter}>
-        <Text style={styles.buttonText}>🧪 Testar Evento</Text>
-      </TouchableOpacity>
-
       <TouchableOpacity
         style={[styles.button, styles.refundButton]}
         onPress={handleRefund}
@@ -414,23 +390,4 @@ const styles = StyleSheet.create({
     fontWeight: 'bold',
     marginBottom: 5,
   },
-  debugContainer: {
-    backgroundColor: '#f9f9f9',
-    padding: 10,
-    borderRadius: 5,
-    marginBottom: 10,
-    borderWidth: 1,
-    borderColor: '#ddd',
-  },
-  debugTitle: {
-    fontSize: 14,
-    fontWeight: 'bold',
-    color: '#333',
-    marginBottom: 5,
-  },
-  debugText: {
-    fontSize: 12,
-    color: '#666',
-    marginBottom: 2,
-  },
 });

src/PlugpagNitro.nitro.ts

@@ -183,25 +183,6 @@ export interface PlugpagNitro extends HybridObject<{ android: 'kotlin' }> {
     userReference: string
   ): Promise<PlugpagTransactionResult>;
 
-  /**
-   * Process a payment transaction with real-time events
-   * This method emits payment events during the transaction flow
-   * @param amount Payment amount in cents
-   * @param type Payment type (PaymentType.CREDIT, PaymentType.DEBIT, etc.)
-   * @param installmentType Installment type (InstallmentType.NO_INSTALLMENT, etc.)
-   * @param installments Number of installments
-   * @param printReceipt Whether to print receipt
-   * @param userReference Optional user reference
-   */
-  doPaymentWithEvents(
-    amount: number,
-    type: PaymentType,
-    installmentType: InstallmentType,
-    installments: number,
-    printReceipt: boolean,
-    userReference: string
-  ): Promise<PlugpagTransactionResult>;
-
   /**
    * Refund a previous payment transaction
    * @param transactionCode Transaction code to refund

src/index.tsx

@@ -113,6 +113,7 @@ export async function doPayment(options: {
   };
 
   return safeModuleCall('doPayment', () =>
+    // Use native doPayment (with built-in events)
     PlugpagNitroModule.doPayment(
       paymentOptions.amount,
       paymentOptions.type,
@@ -133,7 +134,9 @@ export async function doPayment(options: {
  * - Error notifications
  * - Transaction completion status
  */
-export function useTransactionPaymentEvent(): PaymentEvent {
+export function useTransactionEvent(): PaymentEvent & {
+  resetEvent: () => void;
+} {
   const [paymentEvent, setPaymentEvent] = useState<PaymentEvent>({
     code: PaymentEventCode.WAITING_CARD,
     message: 'Aguardando cartão...',
@@ -146,7 +149,6 @@ export function useTransactionPaymentEvent(): PaymentEvent {
         setPaymentEvent(event);
       }
     );
-
     return () => {
       subscription.remove();
     };
@@ -162,7 +164,7 @@ export function useTransactionPaymentEvent(): PaymentEvent {
   return {
     ...paymentEvent,
     resetEvent,
-  } as PaymentEvent & { resetEvent: () => void };
+  };
 }
 
 /**
@@ -250,7 +252,7 @@ export default {
   reprintCustomerReceipt,
 
   // Enhanced payment event listener
-  useTransactionPaymentEvent,
+  useTransactionEvent,
 
   // Enums
   PaymentType,