Eventos
postMessage y callbacks
Eventos outbound del iframe hacia el parent — derivados del catálogo canónico.
| Evento | Callback | Propósito | Payload seguro |
|---|---|---|---|
| inkspectra:ready | onReady | El iframe está listo; incluye sessionId y versión del bundle. | sessionId, bundleVersion, protocolVersion |
| inkspectra:analysis_started | onAnalysisStarted | El análisis ha comenzado. | sessionId, analysisId |
| inkspectra:analysis_completed | onAnalysisCompleted | El análisis terminó con puntuación y nivel de riesgo. | sessionId, analysisId, riskScore, riskLevel |
| inkspectra:risk_score_ready | onRiskScoreReady | Puntuación de riesgo disponible. | sessionId, riskScore, riskLevel |
| inkspectra:resize | onResize | Altura recomendada del iframe (autoResize). | sessionId, height |
| inkspectra:session_expired | onSessionExpired | La sesión expiró; recrea desde tu backend. | sessionId |
| inkspectra:retry_requested | onRetryRequested | El usuario o el embed solicitaron reintento. | sessionId, reason |
| inkspectra:user_continue | onUserContinue | El usuario eligió continuar pese al riesgo. | sessionId, analysisId |
| inkspectra:user_cancel | onUserCancel | El usuario canceló la revisión. | sessionId |
| inkspectra:user_accept | onUserAccept | El usuario aceptó el contrato. | sessionId, analysisId |
| inkspectra:user_reject | onUserReject | El usuario rechazó el contrato. | sessionId, analysisId |
| inkspectra:user_open_full_analysis | onUserOpenFullAnalysis | El usuario pidió abrir el análisis completo. | sessionId, analysisId |
| inkspectra:contract_section_viewed | onContractSectionViewed | El usuario vio una sección del contrato. | sessionId, sectionId |
| inkspectra:risk_opened | onRiskOpened | El usuario abrió un hallazgo de riesgo. | sessionId, riskId |
| inkspectra:error | onError | Error seguro con código y requestId opcional. | sessionId, code, errorCode, message, requestId |
| inkspectra:user_download_pdfdeprecado | onUserDownloadPdf | Deprecado — no se emite en v1. | sessionId, analysisId |
| inkspectra:user_ask_aideprecado | onUserAskAI | Deprecado — no se emite en v1. | sessionId, analysisId |