Tipos & enums

enum PaymentStatus {
  CREATED   = "created",
  PENDING   = "pending",
  CANCELLED = "cancelled",
  CONFIRMED = "confirmed",
}

enum PaymentMethod {
  FPMCXEXPRSS = "FPMCXEXPRSS", // Multicaixa Express
  FPSOLPG     = "FPSOLPG",     // FaciPay (directo) — sempre disponível
  FPSOLPGEXT  = "FPSOLPGEXT",  // Referência EMIS
}

enum PaymentType { DIR = "dir", MCX = "mcx", REF = "ref" }

enum Theme       { LIGHT = "light", DARK = "dark" }
enum ButtonShape { RECT = "rect", PILL = "pill" }
enum Language    { PT = "pt", EN = "en" }

type ApiKeyStatus = 'idle' | 'loading' | 'valid' | 'invalid' | 'empty';

interface PaymentApprovalData {
  transactionId: string;
  externalTransactionId: string;
  status: PaymentStatus.CONFIRMED;
  amount: number;
  currency: string;          // "AOA"
  paymentMethod: PaymentMethod;
  timestamp: string;
}

interface PaymentPendingData {
  transactionId: string;
  externalTransactionId: string;
  status: PaymentStatus.PENDING;
  amount: number;
  currency: string;
  paymentMethod: PaymentMethod;
  timestamp: string;
}

interface PaymentCancelData {
  transactionId?: string;
  externalTransactionId?: string;
  status: PaymentStatus.CANCELLED;
  reason?: string;
  timestamp: string;
}

interface PaymentError {
  code: string;
  message: string;
  details?: Record<string, unknown>;
  timestamp: string;
}

interface ButtonOptions {
  style?: { width?: string | number; shape?: ButtonShape };
  config?: { lang?: Language; showAmount?: boolean };
  paymentConfig?: PaymentConfig;
}

interface PaymentConfig {
  theme?: Theme;
  defaultPaymentMethod?: PaymentMethod;
  allowedPaymentMethods?: PaymentMethod[];
  showUIOfProcessingInfo?: boolean;
  referencePaymentLifeSpan?: number;     // minutos
  customerInfo?: { name?: string; phone?: string; email?: string };
}

interface GenerateButtonParams {
  createOrder?: () => Promise<string | null>;
  onApprove?: (data: PaymentApprovalData, actions) => Promise<void>;
  onCancel?: (data: PaymentCancelData) => Promise<void>;
  onError?: (error: PaymentError) => Promise<void>;
  onPending?: (data: PaymentPendingData, actions) => Promise<void>;
  onInit?: (actions) => Promise<void>;
  onClick?: (data) => Promise<void>;
  options?: ButtonOptions;
}