​

Guía de Migración

​

Migración de v2 a v3

​

Resumen de Cambios

​

Paso 1: Actualizar Dependencias

# Desinstalar versión anterior
npm uninstall camarauth-lib

# Instalar nueva versión
npm install camarauth-sdk@^3.0.0

​

Paso 2: Actualizar Imports

const { CamarauthClient } = require('camarauth-lib');

​

Paso 3: Migrar Configuración del Backend

const backend = new CamarauthBackend({
  dbConnection: pool, // Conexión directa
  jwtSecret: process.env.JWT_SECRET
});

​

Paso 4: Migrar Hooks de React

const { pin, status } = useCamarauth({
  apiUrl: 'http://localhost:3001'
});

​

Paso 5: Manejo de Errores

try {
  await backend.registerPin(pin);
} catch (error) {
  console.error(error.message);
}

​

Paso 6: Modelo de Usuario

const user = {
  id: 123,
  first_name: 'Juan',
  phone: '+34600123456'
};

​

Paso 7: Webhooks

app.post('/webhook', webhookHandler);

​

Cambios Breaking

​

Checklist de Migración

• Actualizar package.json
• Migrar imports
• Actualizar configuración backend
• Migrar hooks React
• Actualizar manejo de errores
• Migrar modelo de usuario
• Actualizar webhooks
• Agregar tests
• Probar en desarrollo
• Desplegar a staging
• Desplegar a producción

​

Obtener Ayuda

• 📖 Documentación completa
• 💬 Discusiones en GitHub
• 🐛 Reportar issues

​

Ejemplos de Migración

• Quickstart Backend
• Quickstart React
• Guía de Testing