CloudStorm Wrapper

Table of Contents

• Class Definition
• Constructor
• Methods

Class Definition

export class CloudstormManager extends Manager {}

note

CloudStorm is a gateway-only library — it has no built-in user or guild cache. You must manually call manager.init({ clientId: "your-bot-id" }) inside your ready event handler.

Constructor

new CloudstormManager(client: Client, options?: ManagerOptions)

Parameter	Type	Description	Optional
client	Client	The CloudStorm client instance.
options	ManagerOptions	The manager options.

note

The constructor automatically hooks into the CloudStorm client to:

• Forward VOICE_STATE_UPDATE and VOICE_SERVER_UPDATE gateway events to updateVoiceState() via the event listener.
• Throw a MagmaStreamError if the GUILD_VOICE_STATES intent (128) is not set on the client.

Example:

import { CloudstormManager } from "magmastream";

const client = new Client("token", { intents: ["GUILDS", "GUILD_VOICE_STATES"] });
const manager = new CloudstormManager(client, {
    nodes: [{ host: "localhost", port: 2333, password: "youshallnotpass" }],
    send: (packet) => { /* handle manually if needed */ },
});

client.once("ready", async () => {
    await manager.init({ clientId: "your-bot-id" });
});

Methods

resolveGuild()

override resolveGuild(guildId: string): AnyGuild

Resolves a guild using the user-provided getGuild cache callback configured in ManagerOptions.

Parameters

Parameter	Type	Description	Optional
guildId	string	The guild ID to resolve.

Returns

Type	Description
AnyGuild	The resolved guild from the cache callback.

---

resolveUser()

override async resolveUser(user: AnyUser | string): Promise<PortableUser>

Returns a minimal PortableUser object. CloudStorm has no user cache, so only the id and username (if already on the object) are returned.

Parameters

Parameter	Type	Description	Optional
user	AnyUser | string	The user object or user ID to resolve.

Returns

Type	Description
Promise<PortableUser>	A minimal user object with id and optionally username.

---

send()

note

This method is protected. It is called internally and is not intended for direct use.

protected override send(packet: GatewayVoiceStateUpdate): void

Sends a voice state update packet to Discord via the correct CloudStorm shard, calculated from the guild ID.

Parameters

Parameter	Type	Description	Optional
packet	GatewayVoiceStateUpdate	The voice state update packet to send.