Skip to main content

​
Node.js SDK

El SDK oficial de Node.js para implementar autenticación por WhatsApp en tus aplicaciones.

​
Instalación

npm install @camarauth/sdk

​
Características

  • 🚀 Servidor completo - HTTP + WebSocket
  • 📱 WhatsApp integration - Evolution API webhooks
  • 🔐 JWT seguros - Tokens con refresh automático
  • 🗄️ Base de datos - Soporte PostgreSQL opcional
  • ⚡ Alto rendimiento - WebSocket para tiempo real
  • 🧪 Testeado - Cobertura completa de tests

​
Uso básico

​
Backend

import { CamarauthBackend } from '@camarauth/sdk/server';

const backend = new CamarauthBackend({
  port: 3001,
  evolutionApiUrl: 'https://tu-evolution-api.com',
  evolutionApiKey: 'tu-api-key',
  evolutionInstanceName: 'mi-instancia'
});

backend.start();

​
Cliente

import { CamarauthClient } from '@camarauth/sdk';

const client = new CamarauthClient({
  apiUrl: 'http://localhost:3001'
});

const response = await client.checkLogin('ABC123');

​
Módulos disponibles

Server

import { CamarauthBackend } from '@camarauth/sdk/server'Servidor completo con Express y Socket.IO

Client

import { CamarauthClient } from '@camarauth/sdk'Cliente HTTP para comunicación con el backend

​
Ejemplo completo

import { CamarauthBackend } from '@camarauth/sdk/server';
import dotenv from 'dotenv';

dotenv.config();

const backend = new CamarauthBackend({
  port: parseInt(process.env.PORT || '3001'),
  jwtSecret: process.env.JWT_SECRET!,
  evolutionApiUrl: process.env.EVOLUTION_API_URL!,
  evolutionApiKey: process.env.EVOLUTION_API_KEY!,
  evolutionInstanceName: process.env.EVOLUTION_INSTANCE_NAME!,
  pinExpirationMinutes: 3,
  corsOrigins: ['http://localhost:5173']
});

// Eventos
backend.on('auth:verified', async (data) => {
  console.log('Usuario verificado:', data.userId);
  
  // Enviar mensaje de bienvenida
  await backend.sendWhatsAppMessage({
    phoneNumber: data.phoneNumber,
    message: '¡Bienvenido! Tu sesión ha sido verificada. 🔐'
  });
});

backend.start();

​
Documentación

​
Repositorio

github.com/camarauth/camarauth-sdk

​
Licencia

MIT © Camarauth