@veruspay/react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+
+declare interface CreateDynamicQrCodeParams {
+    accountId: string;
+    pixKey: string;
+    amount: number;
+    description: string;
+    expirationSeconds?: number;
+}
+
+declare interface CreateStaticQrCodeParams {
+    accountId: string;
+    pixKey: string;
+    amount: number;
+    description: string;
+    name: string;
+    city?: string;
+    postalCode?: string;
+}
+
+/**
+ * Componente drop-in de checkout PIX.
+ *
+ * **Em modo sandbox:**
+ * - QR Code é exibido com um watermark "SANDBOX"
+ * - Bloco de aviso "Ambiente de testes" aparece abaixo
+ * - Botão "Simular pagamento" confirma o pagamento via API
+ *
+ * **Em produção:**
+ * - QR Code limpo, sem indicadores de sandbox
+ * - Polling automático detecta o pagamento e dispara `onSuccess`
+ *
+ * @example
+ * ```tsx
+ * <PixCheckout
+ *   clientId="cli_xxx"
+ *   clientSecret="sec_xxx"
+ *   accountId="uuid-da-conta"
+ *   pixKey="uuid-evp"
+ *   amount={4990}
+ *   description="Produto X"
+ *   sandbox
+ *   onSuccess={(txId) => console.log('Pago!', txId)}
+ * />
+ * ```
+ */
+export declare function PixCheckout({ title, className, style, ...paymentOptions }: PixCheckoutProps): JSX_2.Element;
+
+export declare interface PixCheckoutProps extends UsePixPaymentOptions {
+    /** Título exibido no topo do checkout (default: "Pagar com PIX") */
+    title?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+
+export declare type PixPaymentStatus = 'idle' | 'loading' | 'active' | 'completed' | 'error';
+
+/**
+ * Renderiza um QR Code PIX a partir do payload EMV.
+ * Use este componente quando quiser apenas o QR Code, sem o checkout completo.
+ */
+export declare function PixQrCode({ emv, size, className, style }: PixQrCodeProps): JSX_2.Element;
+
+export declare interface PixQrCodeProps {
+    /** Payload EMV do QR Code PIX */
+    emv: string;
+    /** Tamanho do QR Code em pixels (default: 256) */
+    size?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}
+
+export declare interface QrCodeResult {
+    txId: string;
+    qrCodeEmv: string;
+    amount: number;
+    status: string;
+    expiresAt?: string;
+}
+
+export declare interface QrCodeStatus {
+    txId: string;
+    status: 'active' | 'completed' | 'expired' | 'cancelled';
+    amount: number;
+    completedAt?: string;
+    endToEndId?: string;
+}
+
+export declare function usePixPayment(options: UsePixPaymentOptions): UsePixPaymentResult;
+
+export declare interface UsePixPaymentOptions {
+    /** clientId das credenciais VerusPay (padrão, sem canSendPix) */
+    clientId: string;
+    /** clientSecret das credenciais VerusPay */
+    clientSecret: string;
+    /** ID da conta VerusPay */
+    accountId: string;
+    /** Chave PIX EVP (UUID) cadastrada na conta */
+    pixKey: string;
+    /** Valor em centavos (ex: 4990 = R$ 49,90) */
+    amount: number;
+    /** Descrição do pagamento */
+    description: string;
+    /** Tipo do QR Code — static ou dynamic (default: static) */
+    type?: 'static' | 'dynamic';
+    /** Nome do recebedor (obrigatório para QR Code estático) */
+    name?: string;
+    /** Cidade do recebedor (para QR Code estático; default: 'Brasil') */
+    city?: string;
+    /** CEP do recebedor (para QR Code estático; default: '00000000') */
+    postalCode?: string;
+    /** Tempo de expiração em segundos (para QR Code dinâmico; default: 3600) */
+    expirationSeconds?: number;
+    /** URL base da API VerusPay. Se omitido, usa produção. */
+    apiUrl?: string;
+    /** true = ambiente de testes (exibe botão "Simular Pagamento") */
+    sandbox?: boolean;
+    /** Callback chamado quando o pagamento é confirmado */
+    onSuccess?: (txId: string) => void;
+    /** Callback chamado em caso de erro */
+    onError?: (error: Error) => void;
+}
+
+export declare interface UsePixPaymentResult {
+    /** Payload EMV do QR Code (renderizar com <PixQrCode emv={qrCodeEmv} />) */
+    qrCodeEmv: string | null;
+    /** TxId retornado pela API */
+    txId: string | null;
+    /** Status atual do pagamento */
+    status: PixPaymentStatus;
+    /** Mensagem de erro (quando status === 'error') */
+    error: string | null;
+    /** Copia o código PIX para a área de transferência */
+    copyCode: () => void;
+    /** true por 2s após copyCode() ser chamado */
+    copied: boolean;
+    /** Simula um pagamento (apenas disponível quando sandbox=true) */
+    simulatePayment: () => Promise<void>;
+}
+
+export declare class VerusPayClient {
+    private readonly apiUrl;
+    constructor(apiUrl?: string);
+    getToken(clientId: string, clientSecret: string): Promise<string>;
+    createStaticQrCode(token: string, params: CreateStaticQrCodeParams): Promise<QrCodeResult>;
+    createDynamicQrCode(token: string, params: CreateDynamicQrCodeParams): Promise<QrCodeResult>;
+    getQrCodeStatus(token: string, accountId: string, txId: string): Promise<QrCodeStatus>;
+    simulatePayment(token: string, accountId: string, txId: string, amount: number, type: 'static' | 'cob' | 'cobv'): Promise<void>;
+}
+
+export { }