echo-client-js v1.2.6

Echo Server Client

Cliente websockets para aplicaciones bajo JavaScript o cualquier Framework bajo JS, este cliente funciona usando el servidor Echo Server

INSTALACIÓN BAJO NODEJS

Puedes instalarlo fácilmente en tus proyectos ejecutando el siguiente comando

npm i echo-client-js

TIPOS DE CANALES

Existen 3 categorías de canales, estos son accedidos a través de una instancia de echo-client, el parámetro canal es el nombre del canal por donde se emitirá el evento

• channel(canal) : canal publico
• private(canal) : canal privado

PARÁMETROS ACEPTADOS

• host : uri donde se ejecuta el servidor principal websocket.
• port: puerto en donde se ejecuta el servidor websockets.
• transport : acepta los dos estandares ws mayormente para testing y wss, si no se agrega la propiedad se usará wss por defecto.

• token: token de autorizacion requerido para canales privados

• configuracion

  ```
      import EchoClient from "echo-client-js";
  
      const options = {
          host: sockets.dominio.org,
          port: 443,
          transport: wss,
          token: tu API Token,
      };
  
      export const $echo = new EchoClient(options);
  ```

  El servidor websockets Echo Server, por defecto para la autenticación de canales privados usarán las cookies de cada cliente para la autenticación. si el host de autorización maneja la sesión por cookies asegúrate de que estas sean compartidas por todos los subdominios para que el cliente tenga acceso a esas cookies y se envien por medio del server websocket en caso contrario puede agregar el token de autorizacion directamente en la configuración global de EchoClient agregando la siguiente llave.

Nota: debes tener en cuenta que el servidor websocket Echo Server no se encarga de la autorización directamente, simplemente envía las credenciales aun host por medio de un endpoint que este le proporciona.

EMITIR EVENTOS

Para emitir eventos simplemente se debe llamar a la instancia de echo global, esta acción puede ir dentro de una función para que sea fácil de controlar, recibe tres parámetros, siendo los 2 últimos parámetros opciones, el primer parámetro es el nombre del evento a emitir, el segundo es un mensaje en el evento, y el último es un id por defecto tomará el id único por sesión generada cuando no se ingresa un valor

nuevoEvento() {
this.$echo.channel("chat").event(EventName: String, msg: String, id: string);
},

ESCUCHAR EVENTOS

Para escuchar eventos se deben acceder desde la instancia global de echo de la sigueinete manera

//canales publicos
this.$echo.channel(canal).listen(event, (res) => {
//logica aqui
})

//canales privados
this.$echo.private(canal).listen(event, (res) => {
//logica aqui
})
 

LISTENER U OYENTES ANIDADOS

También puedes escuchar múltiples eventos de un solo canal de la siguiente forma, esto para todos los tipos de canales

this.$echo.channel(canal)
.listen(event1, (res) => {
//logica aqui
})
.listen(event2, (res) => {
//logica aqui
})
.listen(event3, (res) => {
//logica aqui
})
.listen(event4, (res) => {
//logica aqui
})

LISTENER U OYENTES POR DEFECTO

Hay dos tipos de listener por defecto que son emitidos justo cuando alguien se conecta o se desconecta, puedes usarlo por las diferentes categorías de canales y no solo aplica para públicos dependiendo del usuario estos se emitirán por el respectivo canal que fue autorizado, el ejemplo debajo hace uso de canales públicos

this.$echo.channel(ChannelName).listen("connected", (msg) => {
//logica aqui
});

this.$echo.channel(ChannelName).listen("disconnected", (msg) => {
//logica aqui
});

Se integro dos oyentes que te permiten capturar excepciones cuando se pierda la conexion con el server o cuando suceda algun error

this.$echo.closed((close) => {
//logica aqui
});

this.$echo.error((error) => {
//logica aqui
});

CONFIGURACION PROXY

Puedes revisar la documentacion del servidor websockets Echo Server

DESARROLLADOR

• Telegram