rivet-dev/rivetkit-client-javascript

¿Qué hace rivetkit-client-javascript?

Guía del cliente JavaScript de RivetKit. Úsalo para clientes de navegador, Node.js o Bun que se conectan a Actores de Rivet con rivetkit/client, crean clientes, llaman acciones o gestionan conexiones.

Instalación

Instala el paquete rivetkit/client en tu proyecto:

npm install rivetkit/client

Crear un Cliente

Para conectarte a un Actor de Rivet, primero debes crear un cliente. Necesitas el endpoint del actor (por ejemplo, https://mi-actor.rivet.run).

import { Client } from "rivetkit/client";

const cliente = new Client("https://mi-actor.rivet.run");

Llamar a una Acción

Una vez que tienes el cliente, puedes llamar a acciones del actor usando el método call.

const resultado = await cliente.call("saludar", { nombre: "Mundo" });
console.log(resultado);

El método call toma el nombre de la acción como primer argumento y un objeto con los parámetros como segundo argumento.

Gestionar la Conexión

El cliente maneja la conexión automáticamente, pero puedes cerrarla explícitamente cuando hayas terminado:

cliente.desconectar();

También es posible escuchar eventos de conexión para reaccionar a cambios de estado:

cliente.on("conectado", () => {
  console.log("Cliente conectado al actor");
});

cliente.on("desconectado", (error) => {
  console.error("Cliente desconectado:", error);
});

Ejemplo Completo

Aquí tienes un ejemplo completo que muestra cómo crear un cliente, llamar a una acción y manejar la desconexión:

import { Client } from "rivetkit/client";

async function main() {
  const cliente = new Client("https://mi-actor.rivet.run");

  try {
    const respuesta = await cliente.call("saludar", { nombre: "Usuario" });
    console.log("Respuesta del actor:", respuesta);
  } catch (error) {
    console.error("Error al llamar a la acción:", error);
  } finally {
    cliente.desconectar();
  }
}

main();

Soporte de Entornos

Este cliente funciona en los siguientes entornos:

• Navegador: Sitios web y aplicaciones frontend.
• Node.js: Aplicaciones backend y scripts.
• Bun: Entorno de ejecución moderno.

Notas Adicionales

• Asegúrate de que el endpoint del actor sea accesible desde tu entorno de ejecución.
• El cliente maneja reconexiones automáticas en caso de pérdida de conexión temporal.
• Para más detalles, consulta la documentación oficial de RivetKit.