Web-Sign

Web-Sign es una librería JavaScript para la captura de firmas digitales de forma sencilla y personalizable. Permite integrarse fácilmente en cualquier entorno web y ofrece compatibilidad con dispositivos como Wacom STU o DTU.

✨ Características

• Modo Core: incluye lo esencial para capturar firmas y captura por DTU.
• Modo Full: incluye funcionalidades extra como firma manual (no DTU por el momento).
• Detección automática de dispositivos compatibles (STU, DTU o modo display).
• Configuración flexible y override opcional por parte del usuario.
• Callback centralizado para controlar eventos como éxito, error, cancelación, etc.

🚀 Uso Básico

Para comenzar a utilizar Web-Sign, sigue estos pasos:

1. Inserta el contenedor en tu HTML

Crea un <div> con el ID web-sign, que es donde se renderizará el componente de firma:

<div id="web-sign"></div>

2. Importa y utiliza la librería

let webSign = new WebSign(file, config, callback);

Parámetros:

file: El documento PDF a firmar. Puede ser un archivo File, un Blob o una cadena en Base64.

config (opcional): Objeto con configuración adicional para personalizar el comportamiento. Si no se pasa, se usará la configuración por defecto incluida en el archivo de configuración del proyecto.

callback: Función que se ejecutará con los eventos que genere la librería.

Ejemplo de uso:

let webSign = new WebSign(file, {}, (event) => {
  console.log(event);
  switch (event.type) {
    case "cancel":
      // El usuario canceló el proceso
      break;
    case "signed":
      // Firma completada con éxito
      break;
    case "error":
      console.error(event.error);
      document.getElementById("fieldset-container").style.display = "none";
      break;
    case "no-device":
      console.log("No hay dispositivo conectado. Intenta relanzar WebSign con otra configuración.");
      break;
    case "signature-timeout":
      console.log("La firma ha expirado por tiempo.");
      break;
  }
});