Firmas Holográficas React SDK

Componente de React para integrar fácilmente el flujo de firmas holográficas mediante un iframe embebido con comunicación segura vía postMessage.

Instalación

Instala el paquete en tu proyecto de React:

npm install @nightmarefox12/firmas-holograficas-react
# o usando yarn / pnpm
yarn add @nightmarefox12/firmas-holograficas-react
pnpm add @nightmarefox12/firmas-holograficas-react

Uso Básico

import { EmbeddedSign } from "firmas-holograficas-react";

export function App() {
  const handleSuccess = (data) => {
    console.log("¡Firma exitosa!", data);
    // Redirige o muestra una notificación de éxito
  };

  return (
    <div className="w-full max-w-4xl mx-auto">
      <EmbeddedSign
        sessionId="tu-session-id-aqui"
        onSignSuccess={handleSuccess}
        className="rounded-xl shadow-lg"
      />
    </div>
  );
}

Props

| Prop | Tipo | Requerido | Descripción | | :-------------- | :----------------------------------- | :-------: | :------------------------------------------------------------------------------------------------- | | sessionId | string | Sí | El identificador único de la sesión de firma generado en tu backend. | | onSignSuccess | (data: { status: string }) => void | No | Callback que se ejecuta automáticamente cuando el proceso de firma se completa con éxito. | | className | string | No | Clases de CSS adicionales (ideal si usas Tailwind CSS) para personalizar el contenedor del iframe. |

Eventos que emite el embed:

SUCCESS | LOADED | SIGN_FAILED | RESEND_OTP_FAILED | LOAD_FAILED

Licencia

MIT