@payconductor/react 1.2.6 → 1.3.0

package/dist/payconductor/hooks/use-three-ds.d.ts

@@ -1,13 +1,16 @@
-import { ThreeDSecureInit, ThreeDSecureResult } from '../three-ds/types';
+import { ThreeDSecureInit, ThreeDSecurePollingOptions, ThreeDSecureResult } from '../three-ds/types';
 
 export type UseThreeDSOptions = {
     onChallenge?: () => void;
-    onComplete?: () => void;
+    onComplete?: (result: ThreeDSecureResult) => void;
     onError?: (error: Error) => void;
     onTimeout?: () => void;
+    complete?: boolean;
+    poll?: boolean;
+    polling?: ThreeDSecurePollingOptions;
 };
 export type UseThreeDSReturn = {
-    handleChallenge: (threeDSecure: ThreeDSecureInit) => Promise<ThreeDSecureResult>;
+    authenticate: (threeDSecure: ThreeDSecureInit) => Promise<ThreeDSecureResult>;
     destroy: () => void;
 };
 export declare function useThreeDS(options?: UseThreeDSOptions): UseThreeDSReturn;

package/dist/payconductor/three-ds/api.d.ts

@@ -1,4 +1,5 @@
-import { ThreeDSecureData } from './types';
+import { PaymentResult } from '../iframe/types';
+import { ThreeDSMode, ThreeDSecureCompletionPayload, ThreeDSecureData, ThreeDSecurePollingOptions } from './types';
 
 export declare class PayConductorThreeDSApiError extends Error {
     readonly title?: unknown | undefined;
@@ -7,7 +8,18 @@ export declare class PayConductorThreeDSApiError extends Error {
 export declare class PayConductorThreeDSApi {
     private readonly publicKey;
     constructor(publicKey: string);
-    completeManualChallenge(orderId: string, providerTransactionId: string): Promise<void>;
+    completeChallenge(orderId: string, body: ThreeDSecureCompletionPayload): Promise<void>;
+    getOrderStatus(orderId: string): Promise<PaymentResult>;
+    /**
+     * Aguarda o pedido sair de `ThreeDsAwaitingChallenge`.
+     * No modo `Auto` não existe `statusDetail`; a espera é enquanto o pedido seguir `Pending`.
+     */
+    pollOrderStatus(orderId: string, { maxAttempts, intervalMs, mode }?: ThreeDSecurePollingOptions & {
+        mode?: ThreeDSMode;
+    }): Promise<{
+        order: PaymentResult | null;
+        timedOut: boolean;
+    }>;
     getThreeDSecureData(orderId: string): Promise<ThreeDSecureData>;
     private parseResponseError;
     private get headers();

package/dist/payconductor/three-ds/handler.d.ts

@@ -7,6 +7,32 @@ export declare class PayConductor3DSSDK {
     constructor(threeDSecure: ThreeDSecureInit);
     get needsChallenge(): boolean;
     get acquirer(): string | undefined;
+    /** Indica se o pedido precisa de autenticação 3DS. */
+    static requiresChallenge(order: {
+        statusDetail?: string | null;
+        threeDSecure?: {
+            status?: string;
+        } | null;
+        creditCard?: {
+            threeDSecure?: {
+                status?: string;
+            };
+        } | null;
+    }): boolean;
+    /**
+     * Executa o fluxo completo de 3DS: carrega os dados, resolve o provedor,
+     * conduz o desafio, envia o `complete` (só no modo `Manual`) e faz o polling
+     * do pedido. O integrador não precisa ramificar por modo.
+     */
     authenticate(options?: Omit<ThreeDSecureOptions, "threeDSecure">): Promise<ThreeDSecureResult>;
     destroy(): void;
+    /** Mensagem amigável da falha do desafio (pt-BR). */
+    private deriveFailureReason;
+    /**
+     * Payload do `complete`. `failureReason` só vai quando é falha técnica
+     * (sem `transStatus` do emissor nem cancelamento) — string vazia quebra o backend.
+     */
+    private buildCompletionPayload;
+    private finish;
+    private toError;
 }

package/dist/payconductor/three-ds/index.d.ts

@@ -1,3 +1,3 @@
 export { PayConductor3DSSDK } from './handler';
-export { ThreeDSecureResultStatus, ThreeDSTransStatus } from './types';
-export type { ThreeDSecureData, ThreeDSecureInit, ThreeDSecureResult } from './types';
+export { ThreeDSMode, ThreeDSecureResultStatus, ThreeDSTransStatus } from './types';
+export type { ThreeDSecureData, ThreeDSecureInit, ThreeDSecureResult, ThreeDSecureChallengeOutcome, ThreeDSecureCompletionPayload, ThreeDSecurePollingOptions, ThreeDSecureOptions } from './types';

package/dist/payconductor/three-ds/types.d.ts

@@ -1,10 +1,12 @@
-import { IntegrationProvider, OrganizationEnvironment } from '../iframe/types';
+import { IntegrationProvider, OrganizationEnvironment, PaymentResult } from '../iframe/types';
 
 export type ThreeDSecureData = {
     orderId: string;
     publicKey: string;
     status?: string;
     statusDetail?: string;
+    /** Modo do 3DS resolvido pelo backend. Uso interno do SDK. */
+    mode?: ThreeDSMode;
     acquirer?: IntegrationProvider | "PayConductor" | string;
     environment?: OrganizationEnvironment;
     authToken?: string;
@@ -15,9 +17,11 @@ export type ThreeDSecureData = {
     version?: string;
     card?: {
         number: string;
-        expMonth: string;
-        expYear: string;
         holderName: string;
+        expiration: {
+            month: number;
+            year: number;
+        };
     };
     customer?: {
         name: string;
@@ -51,14 +55,12 @@ export type ThreeDSecureData = {
  * pela API através do `orderId` ao chamar `authenticate`.
  */
 export type ThreeDSecureInit = Pick<ThreeDSecureData, "orderId" | "publicKey" | "card">;
-export type ThreeDSecureOptions = {
-    threeDSecure: ThreeDSecureData;
-    onChallenge?: () => void;
-    onComplete?: () => void;
-    onError?: (error: Error) => void;
-    onTimeout?: () => void;
-    timeoutMs?: number;
-};
+/** Modo de condução do desafio 3DS, resolvido pelo backend. */
+export declare enum ThreeDSMode {
+    Auto = "Auto",
+    Manual = "Manual",
+    Agnostic = "Agnostic"
+}
 export declare enum ThreeDSecureResultStatus {
     Success = "Success",
     Failed = "Failed",
@@ -73,14 +75,53 @@ export declare enum ThreeDSTransStatus {
     Rejected = "R",
     InformationOnly = "I"
 }
-export type ThreeDSecureResult = {
+/** Corpo de `POST /api/v1/sdk/three-ds/complete/:orderId`. */
+export type ThreeDSecureCompletionPayload = {
+    providerTransactionId?: string;
+    transStatus?: ThreeDSTransStatus;
+    challengeCanceled?: boolean;
+    failureReason?: string;
+};
+/** Resultado normalizado do desafio, independente do provedor. */
+export type ThreeDSecureChallengeOutcome = {
     status: ThreeDSecureResultStatus;
     error?: Error;
-    authToken?: string;
-    dsTransactionId?: string;
-    providerTransactionId?: string;
+    /** Mensagem amigável (pt-BR) da falha do desafio. Ausente em sucesso. */
+    failureReason?: string;
+    /** `transStatus` bruto do emissor (EMVCo), quando o provedor devolver. */
     transStatus?: ThreeDSTransStatus;
+    /** Identificador da transação no provedor/adquirente (fallback de `dsTransactionId`). */
+    providerTransactionId?: string;
+    /** O portador fechou/cancelou o desafio. */
     challengeCanceled?: boolean;
+    /** Mantido para o fallback de `providerTransactionId` e uso interno dos provedores. */
+    dsTransactionId?: string;
+    authToken?: string;
+};
+export type ThreeDSecurePollingOptions = {
+    /** Default: 30 */
+    maxAttempts?: number;
+    /** Default: 2000 */
+    intervalMs?: number;
+};
+export type ThreeDSecureResult = ThreeDSecureChallengeOutcome & {
+    /** Último status conhecido do pedido. Presente quando `poll` (ou `complete`) rodou. */
+    order?: PaymentResult;
+    /** `true` quando o polling esgotou as tentativas sem sair de `ThreeDsAwaitingChallenge`. */
+    timedOut?: boolean;
+};
+export type ThreeDSecureOptions = {
+    threeDSecure: ThreeDSecureData;
+    onChallenge?: () => void;
+    onComplete?: (result: ThreeDSecureResult) => void;
+    onError?: (error: Error) => void;
+    onTimeout?: () => void;
+    timeoutMs?: number;
+    /** Envia o resultado ao backend (`POST /three-ds/complete/:orderId`). Default: `true`. */
+    complete?: boolean;
+    /** Faz polling de `GET /orders/:id/status`. Default: `true`. */
+    poll?: boolean;
+    polling?: ThreeDSecurePollingOptions;
 };
 export declare abstract class AbstractThreeDSProvider {
     protected readonly data: ThreeDSecureData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payconductor/react",
-  "version": "1.2.6",
+  "version": "1.3.0",
   "description": "React SDK for PayConductor",
   "type": "module",
   "main": "dist/index.cjs.js",