Eventos y Callbacks

┌──────────────┐    onSuccess()          ┌──────────────┐
│  JS SDK      │ ──────────────────────→ │  Tu frontend │  → Actualiza UI
│  (iFrame)    │    onEvent()            │              │  → Analytics
└──────────────┘                         └──────────────┘
       │
       │  (AllSign server-side)
       ▼
┌──────────────┐    webhook POST        ┌──────────────┐
│  AllSign API │ ──────────────────────→ │  Tu backend  │  → Acciones críticas
│              │                         │              │
└──────────────┘                         └──────────────┘

const session = AllSign.init({
  clientSecret: 'as_sess_xxx_secret_yyy',
  onReady: () => { /* widget cargado */ },
  onSuccess: (result) => { /* firmado */ },
  onExit: (metadata) => { /* sesión terminó */ },
  onEvent: (event) => { /* paso a paso */ },
});

session.modal();

onReady: () => {
  // Oculta tu skeleton/loader
  document.getElementById('loader').style.display = 'none';
}

onSuccess: (result) => {
  console.log(result.signatureId);  // UUID de la firma
  console.log(result.documentId);   // UUID del documento
  console.log(result.signerEmail);  // Email del firmante
  console.log(result.signedAt);     // Timestamp ISO-8601
}

onExit: (metadata) => {
  switch (metadata.reason) {
    case 'completed':
      showSuccessScreen();
      break;
    case 'cancelled':
      showCancelledMessage();
      break;
    case 'expired':
      refreshAndRetry();
      break;
    case 'error':
      console.error(metadata.error?.code, metadata.error?.message);
      break;
  }

  // metadata.lastStep te dice dónde estaba el firmante cuando salió
  analytics.track('signing_exit', {
    reason: metadata.reason,
    lastStep: metadata.lastStep, // 'otp', 'id_scan', 'signature', etc.
  });
}

onEvidence: (evidence) => {
  // URL presignada de descarga (corta vida). null si no se pudo generar.
  if (evidence.downloadUrl) {
    window.open(evidence.downloadUrl, '_blank');
  }
}

onEvent: (event) => {
  // Muestra progreso en tu UI
  updateProgressBar(event.name);

  // Envía a tu analytics
  analytics.track(`allsign_${event.name}`, event.metadata);
}

const steps = {
  'SESSION_STARTED': { label: 'Cargando...', progress: 10 },
  'OTP_VERIFIED': { label: 'Identidad verificada', progress: 25 },
  'ID_SCAN_COMPLETED': { label: 'INE escaneada', progress: 50 },
  'BIOMETRIC_VERIFIED': { label: 'Biométricos verificados', progress: 65 },
  'DOCUMENT_VIEWED': { label: 'Revisando documento', progress: 80 },
  'SIGNATURE_SUBMITTED': { label: 'Firmando...', progress: 95 },
  'SESSION_COMPLETED': { label: 'Completado', progress: 100 },
};

const session = AllSign.init({
  clientSecret,
  onEvent: (event) => {
    const step = steps[event.name];
    if (step) {
      progressBar.style.width = `${step.progress}%`;
      statusText.textContent = step.label;
    }
  },
});

session.inline('#container');

onSuccess: (result) => {
  // result.success_url viene si la configuraste en POST /v2/signing-sessions
  showThankYouMessage();

  if (result.success_url) {
    // Tú decides cuándo redirigir
    setTimeout(() => {
      window.location.href = result.success_url;
    }, 2000);
  }
}

onExit: (metadata) => {
  if (metadata.reason === 'cancelled' && metadata.cancel_url) {
    window.location.href = metadata.cancel_url;
  }
}

const session = await fetch('https://api.allsign.io/v2/signing-sessions', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer allsign_live_sk_...', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    document_id: '550e8400-...',
    signer_email: 'juan@empresa.com',
    success_url: 'https://tuapp.com/firmado',   // opcional
    cancel_url: 'https://tuapp.com/cancelado',  // opcional
  })
});

// 1. Obtén un token SSE desde tu backend
const { token } = await fetch('/api/sse-token', {
  method: 'POST',
  body: JSON.stringify({ documentId })
}).then(r => r.json());

// 2. Conéctate al stream
const eventSource = new EventSource(
  `https://api.allsign.io/v2/sse/stream?token=${token}`
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('SSE:', data.type);
  // 'signer_signed', 'document_completed', 'status_changed'
};

// Frontend: feedback instantáneo
const session = AllSign.init({
  clientSecret,
  onSuccess: () => {
    showConfirmation();  // Instantáneo — el usuario ve que firmó
  },
  onEvent: (e) => {
    trackAnalytics(e);   // Cada paso del flujo
  },
});

session.modal();

// Backend: fuente de verdad
//
// Ojo: los dos eventos usan envelopes distintos.
//   document.completed → { event, document:{...}, pdf:{...} }     (sin clave `data`)
//   signer.signed      → { event, data:{ document, signer, progress } }
app.post('/webhooks/allsign', (req, res) => {
  // El cierre del documento: PDF final + acción de negocio.
  if (req.body.event === 'document.completed') {
    downloadPdf(req.body.pdf.s3_presigned_url);  // PDF final
    activateService(req.body.document.id);         // Acción de negocio
    // ⚠️ document.completed NO trae `data.signer`. Para notificar a un
    // firmante específico usa el evento signer.signed (ver abajo).
  }

  // Notificación por cada firmante: aquí sí existe data.signer.
  if (req.body.event === 'signer.signed') {
    sendConfirmationEmail(req.body.data.signer);   // Notificación
  }

  res.status(200).json({ received: true });
});