react-native-pos-pagseguro 1.0.0 → 1.1.0

package/package.json

@@ -1,179 +1,179 @@
-{
-  "name": "react-native-pos-pagseguro",
-  "version": "1.0.0",
-  "description": "Integration of plugpag for React Native",
-  "main": "./lib/module/index.js",
-  "types": "./lib/typescript/src/index.d.ts",
-  "exports": {
-    ".": {
-      "source": "./src/index.tsx",
-      "types": "./lib/typescript/src/index.d.ts",
-      "default": "./lib/module/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "src",
-    "lib",
-    "android",
-    "ios",
-    "cpp",
-    "nitrogen",
-    "nitro.json",
-    "*.podspec",
-    "react-native.config.js",
-    "!ios/build",
-    "!android/build",
-    "!android/gradle",
-    "!android/gradlew",
-    "!android/gradlew.bat",
-    "!android/local.properties",
-    "!**/__tests__",
-    "!**/__fixtures__",
-    "!**/__mocks__",
-    "!**/.*"
-  ],
-  "scripts": {
-    "example": "yarn workspace react-native-pos-pagseguro-example",
-    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
-    "prepublishOnly": "bob build",
-    "nitrogen": "nitrogen",
-    "typecheck": "tsc",
-    "lint": "eslint \"**/*.{js,ts,tsx}\"",
-    "test": "jest",
-    "release": "release-it --only-version"
-  },
-  "keywords": [
-    "react-native",
-    "pagseguro",
-    "pos",
-    "payment",
-    "plugpag",
-    "moderninha",
-    "terminal",
-    "android",
-    "nitro-modules",
-    "pix",
-    "credit-card",
-    "debit",
-    "voucher",
-    "point-of-sale",
-    "mpos",
-    "react-native-pos",
-    "pagamento",
-    "maquininha",
-    "pagseguro-pos"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/CECSMH/react-native-pos-pagseguro.git"
-  },
-  "author": "CECSMH (https://github.com/CECSMH)",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/CECSMH/react-native-pos-pagseguro/issues"
-  },
-  "homepage": "https://github.com/CECSMH/react-native-pos-pagseguro#readme",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "devDependencies": {
-    "@commitlint/config-conventional": "^19.8.1",
-    "@react-native/babel-preset": "0.83.0",
-    "@react-native/eslint-config": "0.83.0",
-    "@release-it/conventional-changelog": "^10.0.1",
-    "del-cli": "^6.0.0",
-    "nitrogen": "^0.32.0",
-    "prettier": "^2.8.8",
-    "react": "19.2.0",
-    "react-native": "0.83.0",
-    "react-native-builder-bob": "^0.40.13",
-    "react-native-nitro-modules": "^0.32.0",
-    "release-it": "^19.0.4",
-    "turbo": "^2.5.6",
-    "typescript": "^5.9.2"
-  },
-  "peerDependencies": {
-    "react": "*",
-    "react-native": "*",
-    "react-native-nitro-modules": "^0.32.0"
-  },
-  "workspaces": [
-    "example"
-  ],
-  "packageManager": "yarn@4.11.0",
-  "react-native-builder-bob": {
-    "source": "src",
-    "output": "lib",
-    "targets": [
-      [
-        "custom",
-        {
-          "script": "nitrogen",
-          "clean": "nitrogen/"
-        }
-      ],
-      [
-        "module",
-        {
-          "esm": true
-        }
-      ],
-      [
-        "typescript",
-        {
-          "project": "tsconfig.build.json"
-        }
-      ]
-    ]
-  },
-  "prettier": {
-    "quoteProps": "consistent",
-    "singleQuote": true,
-    "tabWidth": 2,
-    "trailingComma": "es5",
-    "useTabs": false
-  },
-  "jest": {
-    "preset": "react-native",
-    "modulePathIgnorePatterns": [
-      "<rootDir>/example/node_modules",
-      "<rootDir>/lib/"
-    ]
-  },
-  "commitlint": {
-    "extends": [
-      "@commitlint/config-conventional"
-    ]
-  },
-  "release-it": {
-    "git": {
-      "commitMessage": "chore: release ${version}",
-      "tagName": "v${version}"
-    },
-    "npm": {
-      "publish": true
-    },
-    "github": {
-      "release": true
-    },
-    "plugins": {
-      "@release-it/conventional-changelog": {
-        "preset": {
-          "name": "angular"
-        }
-      }
-    }
-  },
-  "create-react-native-library": {
-    "type": "nitro-module",
-    "languages": "kotlin-swift",
-    "tools": [
-      "eslint",
-      "jest",
-      "lefthook",
-      "release-it"
-    ],
-    "version": "0.56.0"
-  }
-}
+{
+  "name": "react-native-pos-pagseguro",
+  "version": "1.1.0",
+  "description": "Integration of plugpag for React Native",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-pos-pagseguro-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepublishOnly": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "pagseguro",
+    "pos",
+    "payment",
+    "plugpag",
+    "moderninha",
+    "terminal",
+    "android",
+    "nitro-modules",
+    "pix",
+    "credit-card",
+    "debit",
+    "voucher",
+    "point-of-sale",
+    "mpos",
+    "react-native-pos",
+    "pagamento",
+    "maquininha",
+    "pagseguro-pos"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CECSMH/react-native-pos-pagseguro.git"
+  },
+  "author": "CECSMH (https://github.com/CECSMH)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/CECSMH/react-native-pos-pagseguro/issues"
+  },
+  "homepage": "https://github.com/CECSMH/react-native-pos-pagseguro#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "del-cli": "^6.0.0",
+    "nitrogen": "^0.32.0",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.13",
+    "react-native-nitro-modules": "^0.32.0",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin-swift",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.56.0"
+  }
+}

package/src/PosPagseguro.nitro.ts

@@ -1,10 +1,11 @@
 import type { HybridObject } from 'react-native-nitro-modules';
 
 import type { CustomError } from './types/exceptions';
-import type { PaymentData, TransactionResult, VoidPayData } from './types/payments';
+import type { PaymentData, PaymentEvent, TransactionResult, VoidPayData } from './types/payments';
 import type { Capabilities, SubAcquirer, UserData } from './types/device';
+import type { CustomPrinterLayout, StyleData } from './types/styles';
 
-export interface PosPagseguro extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+export interface PosPagseguro extends HybridObject<{ android: 'kotlin' }> {
   getModel(): string;
   getSerialNumber(): string;
   getSubAcquirerData(): SubAcquirer | undefined;
@@ -25,8 +26,11 @@ export interface PosPagseguro extends HybridObject<{ ios: 'swift'; android: 'kot
   hasCapability(capability: Capabilities): boolean;
   initialize(activation_code: string): void;
 
-  doPayment(payment_data: PaymentData, process_callback: (event: string) => void): Promise<TransactionResult | CustomError>;
-  voidPayment(void_data: VoidPayData, process_callback: (event: string) => void): Promise<TransactionResult | CustomError>;
+  doPayment(payment_data: PaymentData, process_callback: (event: string, code: PaymentEvent) => void): Promise<TransactionResult | CustomError>;
+  voidPayment(void_data: VoidPayData, process_callback: (event: string, code: PaymentEvent) => void): Promise<TransactionResult | CustomError>;
 
   getLastApprovedTransaction(): TransactionResult | CustomError;
+
+  setStyleData(data: StyleData): boolean;
+  setPrinterLayout(data: CustomPrinterLayout): void;
 }

package/src/index.ts

@@ -1,19 +1,24 @@
 import PagSeguro from './pag_seguro';
 import { PaymentError, PrintError } from './types/exceptions';
-import { InstallmentTypes, PaymentTypes, VoidType } from './types/payments';
+import type { CustomPrinterLayout, StyleData } from './types/styles';
 import type { PaymentData, TransactionResult, VoidPayData } from './types/payments';
+import { InstallmentTypes, PaymentTypes, VoidType, PaymentEvent } from './types/payments';
 
 
 export type {
+  StyleData,
   PaymentData,
   VoidPayData,
-  TransactionResult
+  TransactionResult,
+  CustomPrinterLayout
 }
+
 export {
   PagSeguro as default,
   VoidType,
   PrintError,
   PaymentError,
   PaymentTypes,
+  PaymentEvent,
   InstallmentTypes,
 }

package/src/pag_seguro.ts

@@ -1,18 +1,18 @@
 import { NitroModules } from "react-native-nitro-modules";
 
 import type { PosPagseguro } from "./PosPagseguro.nitro";
-import { InstallmentTypes, PaymentTypes, VoidType, type PaymentData, type TransactionResult, type VoidPayData } from "./types/payments";
+import { InstallmentTypes, PaymentEvent, PaymentTypes, VoidType, type PaymentData, type TransactionResult, type VoidPayData } from "./types/payments";
 
 import { AbordError, PaymentError, PrintError } from "./types/exceptions";
 import { Capabilities, type SubAcquirer, type UserData } from "./types/device";
+import type { CustomPrinterLayout, StyleData } from "./types/styles";
 
 const PosPagseguroHybridObject = NitroModules.createHybridObject<PosPagseguro>('PosPagseguro');
 
 /**
  * PagSeguro POS SDK para React Native
  *
- * Biblioteca de alto desempenho para integração com terminais PagSeguro (Moderninha, Smart, Pro, etc.)
- * utilizando react-native-nitro-modules para comunicação nativa direta em Swift (iOS) e Kotlin (Android).
+ * Biblioteca de alto desempenho para integração com terminais PagSeguro (Moderninha, Moderninha2, etc.)
  *
  * ### Funcionalidades principais
  * - Inicialização e ativação do terminal
@@ -92,7 +92,7 @@ export default class PagSeguro {
      *   print_receipt: true
      * });
      */
-    static async do_payment(data: PaymentData, process_callback: (message: string) => void = () => { }): Promise<TransactionResult> {
+    static async do_payment(data: PaymentData, process_callback: (message: string, code: PaymentEvent) => void = () => { }): Promise<TransactionResult> {
         validate_payment_data(data);
         const r = await PosPagseguroHybridObject.doPayment(data, process_callback);
         if ("message" in r && "code" in r) throw new PaymentError(r.code, r.message);
@@ -110,7 +110,7 @@ export default class PagSeguro {
      * @returns Resultado da operação de cancelamento
      * @throws PaymentError Em caso de erro de validação ou rejeição
      */
-    static async void_payment(data: VoidPayData, process_callback: (message: string) => void = () => { }): Promise<TransactionResult> {
+    static async void_payment(data: VoidPayData, process_callback: (message: string, code: PaymentEvent) => void = () => { }): Promise<TransactionResult> {
         validate_void_pay_data(data);
         const r = await PosPagseguroHybridObject.voidPayment(data, process_callback);
         if ("message" in r && "code" in r) throw new PaymentError(r.code, r.message);
@@ -134,12 +134,32 @@ export default class PagSeguro {
      * @returns Dados completos da transação (valor, NSU, bandeira, etc.)
      * @throws PaymentError Se não houver transação aprovada ou em caso de erro
      */
-    static get_last_approved_transaction(): TransactionResult{
+    static get_last_approved_transaction(): TransactionResult {
         const r = PosPagseguroHybridObject.getLastApprovedTransaction();
         if ("message" in r && "code" in r) throw new PaymentError(r.code, r.message);
         return r;
     };
 
+    /**
+     * Define o estilo visual (cores, botões, textos) das janelas modais
+     * exibidas pelo terminal durante operações de pagamento.
+     *
+     * @param styles Objeto StyleData contendo as cores e estilos desejados
+     */
+    static set_modal_styles(styles: StyleData): boolean {
+        return PosPagseguroHybridObject.setStyleData(styles);
+    };
+
+    /**
+     * Define o layout e estilo visual da janela de impressão customizada
+     * utilizada pelo terminal
+     *
+     * @param styles Objeto CustomPrinterLayout com título, cores e tempo máximo de exibição
+     */
+    static set_printer_modal_styles(styles: CustomPrinterLayout): void {
+        PosPagseguroHybridObject.setPrinterLayout(styles);
+    };
+
     /**
      * Reimprime a via do cliente da última transação aprovada.
      *
@@ -286,7 +306,7 @@ function validate_payment_data(data: PaymentData): void {
     if (data.user_reference !== undefined) {
         const ref = String(data.user_reference);
         const regex = /^[a-zA-Z0-9]+$/;
-        if (!regex.test(ref)) throw new PaymentError("INVALID_ARG", "A referência do usuário deve conter apenas letras ou números.");
+        if (!regex.test(ref)) throw new PaymentError("INVALID_ARG", "A referência do usuário deve conter apenas letras e/ou números.");
     };
 };
 

package/src/types/payments.ts

@@ -82,7 +82,7 @@ export type PaymentData = {
    * Referência opcional do usuário ou da transação.
    * Pode ser usada para vincular o pagamento a um pedido ou cliente específico.
    */
-  user_reference?: number,
+  user_reference?: string | number,
 }
 
 /**
@@ -208,6 +208,132 @@ export type TransactionResult = {
   pix_tx_id_code?: string;
 }
 
+/**
+ * Eventos de pagamento
+ */
+export enum PaymentEvent {
+  /**
+   * Aguardando inserção do cartão.
+   */
+  WAITING_CARD = 0,
+  /**
+   * Cartão foi inserido no terminal.
+   */
+  INSERTED_CARD = 1,
+  /**
+   * Fim da transação (independente do resultado).
+   */
+  SALE_END = 4,
+  /**
+   * Aguardando autorização da senha.
+   */
+  AUTHORIZING = 5,
+  /**
+   * Aguardando remoção do cartão.
+   */
+  WAITING_REMOVE_CARD = 7,
+  /**
+   * Cartão foi removido do terminal.
+   */
+  REMOVED_CARD = 8,
+  /**
+   * Solicitação de digitação do PIN (senha).
+   */
+  PIN_REQUESTED = 2,
+  /**
+   * PIN (senha) digitado corretamente.
+   */
+  PIN_OK = 3,
+  /**
+   * Solicitação de CVV.
+   */
+  CVV_REQUESTED = 9,
+  /**
+   * CVV digitado corretamente.
+   */
+  CVV_OK = 10,
+  /**
+   * Solicitação de BIN do cartão.
+   */
+  CAR_BIN_REQUESTED = 11,
+  /**
+   * BIN do cartão digitado corretamente.
+   */
+  CAR_BIN_OK = 12,
+  /**
+   * Solicitação do nome do portador do cartão.
+   */
+  CAR_HOLDER_REQUESTED = 13,
+  /**
+   * Nome do portador do cartão digitado corretamente.
+   */
+  CAR_HOLDER_OK = 14,
+  /**
+   * Ativação realizada com sucesso.
+   */
+  ACTIVATION_SUCCESS = 15,
+  /**
+   * Dígito da senha foi digitado.
+   */
+  DIGIT_PASSWORD = 16,
+  /**
+   * Dígito da senha foi apagado.
+   */
+  NO_PASSWORD = 17,
+  /**
+   * Aprovada (cartão ou Pix).
+   */
+  APPROVED = 18,
+  /**
+   * Não aprovada (cartão ou Pix).
+   */
+  NOT_APPROVED = 19,
+  /**
+   * Erro de leitura em transação NFC.
+   */
+  CONTACTLESS_ERROR = 23,
+  /**
+   * Instruções exibidas no smartphone durante NFC.
+   */
+  CONTACTLESS_ON_DEVICE = 24,
+  /**
+   * Necessário usar tarja magnética.
+   */
+  USE_TARJA = 25,
+  /**
+   * Necessário usar chip.
+   */
+  USE_CHIP = 26,
+  /**
+   * Download de tabelas em andamento.
+   */
+  DOWNLOADING_TABLES = 27,
+  /**
+   * Gravação de tabelas em andamento.
+   */
+  RECORDING_TABLES = 28,
+  /**
+   * Transação concluída com sucesso.
+   */
+  SUCCESS = 29,
+  /**
+   * Resolvendo pendências de transações.
+   */
+  SOLVE_PENDINGS = 30,
+  /**
+   * Mensagem customizada enviada pelo terminal.
+   */
+  CUSTOM_MESSAGE = -1,
+  /**
+   * Evento padrão (fallback).
+   */
+  DEFAULT = -2,
+  /**
+   * Erro durante execução do evento.
+   */
+  ON_EVENT_ERROR = -3
+}
+
 export {
   VoidType,
   PaymentTypes,