​

Arquitectura del SDK

​

Visión General

​

Principios de Diseño

​

1. Separación de Responsabilidades

• Core: Lógica de negocio universal (no depende de framework)
• React: Componentes específicos de React
• Backend: Servidor Express con Socket.IO
• Server: Middleware y utilidades

​

2. Inversión de Dependencias

// El backend depende directamente de PostgreSQL
import { Pool } from 'pg';

class Backend {
  constructor(private db: Pool) {}
}

// El backend depende de una abstracción
interface DatabaseAdapter {
  query(text: string, values?: unknown[]): Promise<QueryResult>;
}

class Backend {
  constructor(private db: DatabaseAdapter) {}
}

// PostgreSQLAdapter implementa la interfaz
class PostgreSQLAdapter implements DatabaseAdapter {
  constructor(private pool: Pool) {}
  async query(text: string, values?: unknown[]) {
    return this.pool.query(text, values);
  }
}

​

3. Configuración sobre Convención

​

Flujo de Datos

​

Autenticación Completa

​

Refresh de Token

​

Módulos del SDK

​

Core (camarauth-sdk)

​

Backend (camarauth-sdk/backend)

​

React (camarauth-sdk/react)

​

Patrones de Diseño

​

Dependency Injection

const backend = new CamarauthBackend({
  db: new PostgreSQLAdapter(pool),
  logger: createProductionLogger(),
  timeProvider: new FakeTimeProvider()
});

​

Factory Method

// Detecta automáticamente el mejor storage disponible
const storage = createAuthStorage();
// Puede retornar LocalStorage, SessionStorage o MemoryStorage

​

Observer (EventEmitter)

backend.on('auth:verified', ({ userId, phoneNumber }) => {
  console.log(`Usuario ${userId} verificado`);
});

​

Repository

class PinRepository {
  create(pin: PinData): Promise<void>;
  findByPin(pin: string): Promise<PinData | null>;
  update(id: string, data: Partial<PinData>): Promise<void>;
  delete(id: string): Promise<void>;
}

​

Decisiones Arquitectónicas

​

¿Por qué WebSockets?

• Notificación inmediata cuando el PIN es verificado
• Experiencia de usuario fluida sin polling
• Menor latencia que HTTP polling

​

¿Por qué JWT?

• Stateless: No requieren sesión en servidor
• Escalables: Fácil de escalar horizontalmente
• Seguros: Firmados y con expiración
• Universales: Estándar de la industria

​

¿Por qué DatabaseAdapter?

• Cambiar de PostgreSQL a MongoDB sin modificar el dominio
• Testing con mocks fácilmente
• Soporte para múltiples bases de datos simultáneamente

​

Escalabilidad

​

Horizontal Scaling

1. Base de datos compartida: Todos los servidores deben usar la misma DB
2. Redis para sesiones: Compartir estado de PINs entre instancias
3. Load balancer: Distribuir requests entre instancias
4. Sticky sessions: Mantener conexiones WebSocket

// Ejemplo con Redis
const backend = new CamarauthBackend({
  db: new RedisAdapter(redisClient),
  // ...
});

​

Microservicios

​

Seguridad

• Rate Limiting: Protección contra fuerza bruta
• JWT: Tokens firmados con expiración
• CORS: Orígenes explícitamente permitidos
• Webhook Validation: Firma HMAC para webhooks
• Input Validation: Validación de todos los inputs
• Timing Safe Comparison: Comparación segura de hashes

​

Para Desarrolladores Avanzados

​

Extensibilidad

// Adaptador de base de datos personalizado
class DynamoDBAdapter implements DatabaseAdapter {
  constructor(private client: DynamoDBClient) {}
  
  async query<Row>(text: string, values?: unknown[]) {
    // Implementación DynamoDB
  }
}

// Usar adaptador personalizado
const backend = new CamarauthBackend({
  db: new DynamoDBAdapter(dynamoClient)
});

​

Testing

// Testing con FakeTimeProvider
const fakeTime = new FakeTimeProvider();
const backend = new CamarauthBackend({
  timeProvider: fakeTime
});

// Avanzar tiempo en tests
fakeTime.advance(5 * 60 * 1000); // 5 minutos

​

Eventos Personalizados

backend.on('auth:verified', async (data) => {
  // Enviar email de bienvenida
  await sendWelcomeEmail(data.userData.email);
  
  // Registrar en analytics
  analytics.track('User Verified', data);
  
  // Actualizar CRM
  await crm.updateUser(data.userId, { lastLogin: new Date() });
});

​

Referencias

• Backend Overview
• Core Overview
• React Overview
• Testing Guide