rivet-dev/rivetkit-client-javascript

O que rivetkit-client-javascript faz?

Orientação para clientes JavaScript do RivetKit. Use para clientes de navegador, Node.js ou Bun que se conectam a Atores Rivet com rivetkit/client, criar clientes, chamar ações ou gerenciar conexões.

Instalação

npm install rivetkit/client

Uso Básico

import { Client } from 'rivetkit/client';

const client = new Client({
  url: 'ws://localhost:3000',
  actor: 'meu-ator'
});

await client.connect();

const resultado = await client.call('minhaAcao', { param1: 'valor' });

await client.disconnect();

Ambientes Suportados

• Navegador: Funciona com WebSocket nativo.
• Node.js: Requer pacote ws para suporte a WebSocket.
• Bun: Suporte nativo a WebSocket.

Gestão de Conexões

O cliente gerencia automaticamente reconexões e estados:

• connect(): Estabelece conexão com o ator.
• disconnect(): Encerra a conexão.
• call(method, params): Invoca uma ação no ator remoto e retorna a resposta.
• Eventos: 'connected', 'disconnected', 'error'.

Exemplo com Tratamento de Erros

try {
  await client.connect();
  const data = await client.call('obterDados', { id: 123 });
  console.log(data);
} catch (error) {
  console.error('Erro na comunicação:', error);
} finally {
  await client.disconnect();
}

Links Úteis

• Documentação Rivet
• Repositório do Pacote