Node.js SDK

npm install @corvidhq/server

import { Raven } from '@corvidhq/server';
 
const raven = new Raven({ apiKey: process.env.RAVEN_API_KEY });

// Projects
await raven.projects.get(); // the one project this key belongs to
 
// RTC tokens — the core of this SDK
const token = await raven.tokens.create({
  room: roomId,
  identity: 'user-42',
  permissions: { join: true, publish: true, subscribe: true },
  expiresIn: 3600,
});
 
// Rooms
await raven.rooms.create({ name: 'demo-room' });
await raven.rooms.list();
await raven.rooms.get(roomId);
await raven.rooms.participants.list(roomId); // null means the SFU couldn't be reached — distinct from a genuinely empty room ([])
 
// Observability
await raven.connections.list();
await raven.errors.list();
await raven.metrics.get('1h'); // '15m' | '1h' | '24h' | '7d'
await raven.diagnostics.get();
 
// Chat — see Chat Overview and the Python SDK page for the full surface
await raven.chat.createConversation({ name: 'support-room-42' });
await raven.chat.createToken({ userId: 'alice', conversations: [conv.publicId] });
 
// Live Streaming — see below
await raven.liveStreams.create({ title: 'Friday Q&A', hostIdentity: 'user-123' });

const stream = await raven.liveStreams.create({
  title: 'Friday Q&A',
  hostIdentity: 'user-123', // registered as this stream's HOST
});
 
await raven.liveStreams.start(stream.id);
 
// Registering a co-host mints full-publish RTC + moderator chat credentials
// in one call. Hand the result to the client SDK unchanged.
const hostCredential = await raven.liveStreams.addHost(stream.id, { identity: 'user-456' });
 
// A viewer token is always subscribe-only — there is no field here that
// can request publish access.
const viewerCredential = await raven.liveStreams.createViewerToken(stream.id, 'user-789');
 
await raven.liveStreams.removeHost(stream.id, 'user-456');
await raven.liveStreams.end(stream.id); // LIVE → ENDED, terminal

import { RavenError } from '@corvidhq/server';
 
try {
  await raven.rooms.get('missing-room');
} catch (error) {
  if (error instanceof RavenError) {
    console.log(error.code, error.statusCode, error.requestId);
  }
}