SDK Guides

npm install @onebudd/sdk
# or
yarn add @onebudd/sdk
# or
pnpm add @onebudd/sdk

import { OneBuddClient } from '@onebudd/sdk';

const client = new OneBuddClient({
  baseUrl: 'wss://api.onebudd.com',
  autoReconnect: true
});

// Event handlers
client.on('audio', (audioData) => {
  // Binary audio data for playback
  playAudio(audioData);
});

client.on('transcript', ({ text, isFinal }) => {
  console.log(isFinal ? 'Final:' : 'Interim:', text);
});

client.on('state_change', (state) => {
  console.log('State:', state); // 'listening' | 'processing' | 'speaking'
});

client.on('error', ({ code, message, fatal }) => {
  console.error(`Error [${code}]: ${message}`);
  if (fatal) {
    // Reconnect required
  }
});

// Start session and send audio
await client.startSession({ auth_token: 'sk_live_xxx' });
client.sendAudio(audioBuffer);
client.sendMessage('Hello, how are you?');
client.cancel(); // Interrupt current response
await client.endSession();

// Browser microphone capture
const stream = await navigator.mediaDevices.getUserMedia({ 
  audio: { sampleRate: 16000, channelCount: 1 } 
});

const audioContext = new AudioContext({ sampleRate: 16000 });
const source = audioContext.createMediaStreamSource(stream);
const processor = audioContext.createScriptProcessor(3200, 1, 1);

processor.onaudioprocess = (e) => {
  const pcmData = e.inputBuffer.getChannelData(0);
  const int16Data = new Int16Array(pcmData.length);
  for (let i = 0; i < pcmData.length; i++) {
    int16Data[i] = Math.max(-32768, Math.min(32767, pcmData[i] * 32768));
  }
  client.sendAudio(int16Data.buffer);
};

source.connect(processor);
processor.connect(audioContext.destination);