@quo-digital/nominex-authorization-tokens-client

Descripción

Cliente TCP para validar tokens de autorización en Nominex. Este paquete proporciona un módulo NestJS que se conecta a un microservicio de tokens mediante TCP para validar tokens de autorización.

📦 Instalación

Para instalar el paquete, usa npm:

npm install @quo-digital/nominex-authorization-tokens-client

🚀 Uso

Configuración básica

Primero, asegúrate de configurar las variables de entorno necesarias:

MS_TOKENS_HOST=localhost
MS_TOKENS_PORT=3001

Importar el módulo en tu aplicación NestJS

import { Module } from '@nestjs/common';
import { TcpClientModule } from '@quo-digital/nominex-authorization-tokens-client';

@Module({
  imports: [TcpClientModule],
  // ... otros módulos
})
export class AppModule {}

Usar el servicio de tokens

import { Injectable } from '@nestjs/common';
import { TokensService, ValidarTokenRequestDto } from '@quo-digital/nominex-authorization-tokens-client';

@Injectable()
export class MiServicio {
  constructor(private readonly tokensService: TokensService) {}

  async validarToken(token: string, solicitanteId: string) {
    const request: ValidarTokenRequestDto = {
      token,
      solicitanteId,
      payload: {
        // datos adicionales si es necesario
      },
    };

    const resultado = await this.tokensService.validarToken(request);
    
    if (resultado.valido) {
      console.log('Token válido');
    } else {
      console.error('Token inválido:', resultado.error);
    }
    
    return resultado;
  }
}

📋 Exports

El paquete exporta los siguientes elementos:

• TcpClientModule: Módulo NestJS que configura el cliente TCP
• TokensService: Servicio para validar tokens
• ValidarTokenRequestDto: DTO para la solicitud de validación
• ValidarTokenResponseDto: DTO para la respuesta de validación
• VALIDAR_TOKEN_PATTERN: Patrón de mensaje TCP usado para la comunicación

🔧 Variables de entorno requeridas

• MS_TOKENS_HOST: Host del microservicio de tokens (ej: localhost o tokens-service)
• MS_TOKENS_PORT: Puerto del microservicio de tokens (ej: 3001)

⚠️ Manejo de errores

El servicio maneja automáticamente los errores de conexión TCP y retorna un objeto con valido: false y un mensaje de error descriptivo cuando no puede conectarse al microservicio.

📝 Dependencias

• @nestjs/common: ^11.0.9
• @nestjs/microservices: ^11.1.13
• class-validator: ^0.14.1
• rxjs: ^7.8.1

📄 Licencia

MIT

👤 Autor

Huetzin Sotelo