Quick Start

import { Hoshimi } from 'hoshimi';

const gatewaySend = async (_guildId: string, _payload: unknown): Promise<void> => {};

const manager = new Hoshimi({
  nodes: [{ host: 'localhost', port: 2333, password: 'youshallnotpass' }],
  sendPayload(guildId, payload) {
    return gatewaySend(guildId, payload);
  },
});

import type { Hoshimi } from 'hoshimi';

declare const manager: Hoshimi;

declare const botUser: {
  id: string;
  username: string;
  avatar: string | null;
};

manager.init(botUser);

import type {
  Hoshimi,
  VoicePacket,
  VoiceServer,
  VoiceState,
  ChannelDeletePacket,
} from 'hoshimi';

type AnyPacket = VoicePacket | VoiceServer | VoiceState | ChannelDeletePacket;

declare const manager: Hoshimi;
declare const packet: AnyPacket;

await manager.updateVoiceState(packet);

import { LoadType } from 'hoshimi';
import type { Hoshimi } from 'hoshimi';

declare const manager: Hoshimi;

declare const guildId: string;
declare const voiceId: string;
declare const textId: string;

const player = manager.createPlayer({
  guildId,
  voiceId,
  textId,
  volume: 100,
  selfDeaf: true,
});

const result = await player.search({
  query: 'Nujabes - Feather',
  requester: { id: '123', username: 'demo' },
});

if (result.loadType === LoadType.Track || result.loadType === LoadType.Search) {
  await player.queue.add(result.tracks[0]);

  if (!player.connected) await player.connect();
  if (!player.isPlaying()) await player.play();
}