@stoatx/client 0.7.0 → 0.9.0

package/dist/index.cjs

@@ -33,6 +33,8 @@ __export(index_exports, {
   API: () => API,
   Attachment: () => Attachment,
   AttachmentBuilder: () => AttachmentBuilder,
+  AudioPlayer: () => AudioPlayer,
+  AudioResource: () => AudioResource,
   Base: () => Base,
   BaseChannel: () => BaseChannel,
   BitField: () => BitField,
@@ -67,7 +69,10 @@ __export(index_exports, {
   TextChannel: () => TextChannel,
   UnknownChannel: () => UnknownChannel,
   User: () => User,
-  UserManager: () => UserManager
+  UserManager: () => UserManager,
+  VoiceConnection: () => VoiceConnection,
+  VoiceManager: () => VoiceManager,
+  decodeTime: () => import_ulid8.decodeTime
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -522,7 +527,7 @@ var MessageMentions = class _MessageMentions {
   static parseChannelIds(content) {
     return [...content.matchAll(/<#([A-Z0-9]+)>/g)].flatMap((m) => m[1] ? [m[1]] : []);
   }
-  [import_node_util.default.inspect.custom](depth, options, inspect12) {
+  [import_node_util.default.inspect.custom](depth, options, inspect13) {
     const { client, message, ...props } = this;
     const data = {
       ...props,
@@ -531,7 +536,7 @@ var MessageMentions = class _MessageMentions {
       users: this.users,
       roles: this.roles
     };
-    return `${this.constructor.name} ${inspect12(data, { ...options, depth: depth ?? options.depth })}`;
+    return `${this.constructor.name} ${inspect13(data, { ...options, depth: depth ?? options.depth })}`;
   }
 };
 
@@ -543,7 +548,8 @@ var Message = class extends Base {
   embeds = [];
   attachments = [];
   editedAt = null;
-  createdAt = null;
+  createdAt;
+  createdTimestamp;
   flags = 0;
   interactions = null;
   masquerade = null;
@@ -555,10 +561,9 @@ var Message = class extends Base {
     super(client, data);
     this.authorId = data.author;
     this.channelId = data.channel;
-    const timestamp = (0, import_ulid.decodeTime)(this.id);
-    if (timestamp) {
-      this.createdAt = new Date(timestamp);
-    }
+    const timestamp = (0, import_ulid.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     if (data.attachments) {
       this.attachments = data.attachments.map((fileData) => new Attachment(this.client, fileData));
     }
@@ -739,7 +744,7 @@ var Message = class extends Base {
     }
   }
   // This tells Node.js exactly how to print this object in console.log()
-  [util3.inspect.custom](depth, options, inspect12) {
+  [util3.inspect.custom](depth, options, inspect13) {
     const { client, authorId, channelId, ...props } = this;
     const data = {
       ...props,
@@ -748,11 +753,12 @@ var Message = class extends Base {
       server: this.server,
       member: this.member
     };
-    return `${this.constructor.name} ${inspect12(data, { ...options, depth: depth ?? options.depth })}`;
+    return `${this.constructor.name} ${inspect13(data, { ...options, depth: depth ?? options.depth })}`;
   }
 };
 
 // src/structures/User.ts
+var import_ulid2 = require("ulid");
 var User = class extends Base {
   discriminator;
   online;
@@ -765,11 +771,17 @@ var User = class extends Base {
   flags;
   privileged;
   status;
+  createdAt;
+  createdTimestamp;
+  pronouns = null;
   constructor(client, data) {
     super(client, data);
     this.bot = false;
     this.privileged = false;
     this.flags = 0;
+    const timestamp = (0, import_ulid2.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   _patch(data, clear) {
@@ -777,6 +789,7 @@ var User = class extends Base {
     if (data.discriminator !== void 0) this.discriminator = data.discriminator;
     if (data.online !== void 0) this.online = data.online;
     if (data.relationship !== void 0) this.relationship = data.relationship;
+    if (data.pronouns !== void 0) this.pronouns = data.pronouns;
     if (data.display_name !== void 0) this.displayName = data.display_name;
     if (data.badges !== void 0) this.badges = data.badges;
     if (data.flags !== void 0) this.flags = data.flags;
@@ -790,9 +803,23 @@ var User = class extends Base {
     }
     if (clear && Array.isArray(clear)) {
       for (const field of clear) {
-        if (field === "Avatar") this.avatar = null;
-        if (field === "StatusText" && this.status) this.status.text = null;
-        if (field === "DisplayName") this.displayName = null;
+        switch (field) {
+          case "Avatar":
+            this.avatar = null;
+            break;
+          case "DisplayName":
+            this.displayName = null;
+            break;
+          case "Pronouns":
+            this.pronouns = null;
+            break;
+          case "StatusText":
+            this.status.text = null;
+            break;
+          case "StatusPresence":
+            this.status.presence = null;
+            break;
+        }
       }
     }
   }
@@ -908,11 +935,10 @@ var GatewayManager = class {
         }
         if (payload.emojis) {
           for (const rawEmoji of payload.emojis) {
-            const emoji = this.client.emojis._add(rawEmoji);
             if (rawEmoji.parent && rawEmoji.parent.type === "Server") {
               const server = this.client.servers.cache.get(rawEmoji.parent.id);
               if (server) {
-                server.emojis._add(emoji);
+                server.emojis._add(rawEmoji);
               }
             }
           }
@@ -1090,7 +1116,7 @@ var GatewayManager = class {
       case "ServerMemberJoin": {
         const server = this.client.servers.cache.get(payload.id);
         if (server) {
-          const member = server.members._add({ user: payload.user });
+          const member = server.members._add(payload.member);
           this.client.emit("serverMemberJoin", member);
         }
         break;
@@ -1108,7 +1134,7 @@ var GatewayManager = class {
         if (payload.reason === "Ban") {
           if (server) {
             const dummyBanPayload = {
-              id: payload.user,
+              _id: payload.user,
               reason: null
             };
             server.bans._add(dummyBanPayload);
@@ -1122,11 +1148,10 @@ var GatewayManager = class {
         break;
       }
       case "EmojiCreate": {
-        const emoji = this.client.emojis._add(payload);
         if (payload.parent?.type === "Server") {
           const server = this.client.servers.cache.get(payload.parent.id);
           if (server) {
-            server.emojis._add(emoji);
+            server.emojis._add(payload);
           }
         }
         break;
@@ -1428,13 +1453,14 @@ var RESTManager = class {
       this.client.emit("debug", `Bucket [${method}:${endpoint}] exhausted. Waiting ${waitTime}ms proactively...`);
       await sleep(waitTime);
     }
+    const isBodyMethod = ["post", "patch", "put"].includes(method.toLowerCase());
     const response = await fetch(url, {
       method: method.toUpperCase(),
       headers: {
         "X-Bot-Token": this.token,
         "Content-Type": "application/json"
       },
-      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+      ...isBodyMethod ? { body: JSON.stringify(body ?? {}) } : {}
     });
     const remainingHeader = response.headers.get("x-ratelimit-remaining");
     const resetAfterHeader = response.headers.get("x-ratelimit-reset-after");
@@ -1525,7 +1551,7 @@ var BaseManager = class {
   _add(data) {
     const id = this.extractId(data);
     const existing = this.cache.get(id);
-    if (existing && typeof existing._patch === "function") {
+    if (existing && this.isPatchable(existing)) {
       existing._patch(data);
       return existing;
     }
@@ -1533,6 +1559,9 @@ var BaseManager = class {
     this.cache.set(id, structure);
     return structure;
   }
+  isPatchable(value) {
+    return typeof value._patch === "function";
+  }
 };
 
 // src/builders/AttachmentBuilder.ts
@@ -1970,9 +1999,13 @@ var BaseChannel = class extends Base {
   isGroup() {
     return this.type === "Group";
   }
+  isVoice() {
+    return this.isText() && this.voice !== null;
+  }
 };
 
 // src/structures/TextChannel.ts
+var import_ulid3 = require("ulid");
 var TextChannel = class extends BaseChannel {
   name;
   serverId;
@@ -1983,9 +2016,14 @@ var TextChannel = class extends BaseChannel {
   nsfw;
   slowmode;
   voice;
+  createdAt;
+  createdTimestamp;
   constructor(client, data) {
     super(client, data);
     this.serverId = data.server;
+    const timestamp = (0, import_ulid3.decodeTime)(data._id);
+    this.createdTimestamp = timestamp;
+    this.createdAt = new Date(timestamp);
     this.defaultPermissions = data.default_permissions;
     this.description = data.description;
     if (data.icon !== void 0) {
@@ -2010,10 +2048,10 @@ var TextChannel = class extends BaseChannel {
             this.icon = null;
             break;
           case "DefaultPermissions":
-            this.defaultPermissions = data.default_permissions;
+            this.defaultPermissions = null;
             break;
           case "Voice":
-            this.voice = data.voice;
+            this.voice = null;
             break;
         }
       }
@@ -2208,6 +2246,7 @@ var DMChannel = class extends BaseChannel {
 
 // src/structures/GroupChannel.ts
 var util5 = __toESM(require("util"), 1);
+var import_ulid4 = require("ulid");
 var GroupChannel = class extends BaseChannel {
   name;
   ownerId;
@@ -2216,8 +2255,13 @@ var GroupChannel = class extends BaseChannel {
   icon = null;
   lastMessageId = null;
   nsfw = false;
+  createdAt;
+  createdTimestamp;
   constructor(client, data) {
     super(client, data);
+    const timestamp = (0, import_ulid4.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   _patch(data, clear) {
@@ -2233,9 +2277,6 @@ var GroupChannel = class extends BaseChannel {
     if (clear && Array.isArray(clear)) {
       for (const field of clear) {
         switch (field) {
-          case "Name":
-            this.name = "";
-            break;
           case "Description":
             this.description = null;
             break;
@@ -2267,9 +2308,9 @@ var GroupChannel = class extends BaseChannel {
   async setDefaultPermissions(permissions) {
     return await this.client.channels.setDefaultPermissions(this.id, permissions);
   }
-  [util5.inspect.custom](_depth, options, inspect12) {
+  [util5.inspect.custom](_depth, options, inspect13) {
     const { client, ...props } = this;
-    return `${this.constructor.name} ${inspect12(
+    return `${this.constructor.name} ${inspect13(
       {
         ...props,
         owner: this.owner,
@@ -2280,10 +2321,21 @@ var GroupChannel = class extends BaseChannel {
   }
 };
 
+// src/structures/VoiceChannel.ts
+var VoiceChannel = class extends TextChannel {
+  async join() {
+    return this.client.voice.join(this.id, this.serverId);
+  }
+  async leave() {
+    return this.client.voice.leave(this.id);
+  }
+};
+
 // src/utils/ChannelFactory.ts
 function createChannel(client, data) {
   switch (data.channel_type) {
     case "TextChannel":
+      if (data.voice) return new VoiceChannel(client, data);
       return new TextChannel(client, data);
     case "DirectMessage":
       return new DMChannel(client, data);
@@ -2905,6 +2957,8 @@ var Member = class extends Base {
   _roles = [];
   // The date the member joined the server
   joinedAt;
+  // The timestamp the member joined the server
+  joinedTimestamp;
   // The date the member's timeout expires, or null if not timed out
   timeout = null;
   // Whatever the user can talk in Voice Chat
@@ -2913,20 +2967,53 @@ var Member = class extends Base {
   canRecieve = false;
   // Member roles manager
   roles;
+  // Member pronouns
+  pronouns = null;
   constructor(client, data, serverId) {
     super(client, { _id: data._id?.user });
     this.serverId = data._id?.server ?? serverId;
-    this.joinedAt = new Date(data.joined_at);
+    const timestamp = new Date(data.joined_at);
+    this.joinedAt = timestamp;
+    this.joinedTimestamp = timestamp.getTime();
     this.roles = new MemberRoleManager(this);
     this._patch(data);
   }
-  _patch(data) {
+  _patch(data, clear) {
     if (data.nickname !== void 0) this.nickname = data.nickname;
     if (data.avatar !== void 0) this.avatar = data.avatar ? new Attachment(this.client, data.avatar) : null;
     if (data.roles !== void 0) this._roles = data.roles;
     if (data.timeout !== void 0) this.timeout = data.timeout ? new Date(data.timeout) : null;
     if (data.can_publish !== void 0) this.canPublish = data.can_publish;
     if (data.can_receive !== void 0) this.canRecieve = data.can_receive;
+    if (data.pronouns !== void 0) this.pronouns = data.pronouns;
+    if (clear && Array.isArray(clear)) {
+      for (const field of clear) {
+        switch (field) {
+          case "Avatar":
+            this.avatar = null;
+            break;
+          case "Nickname":
+            this.nickname = null;
+            break;
+          case "Pronouns":
+            this.pronouns = null;
+            break;
+          case "CanPublish":
+            this.canPublish = false;
+            break;
+          case "Timeout":
+            this.timeout = null;
+            break;
+          case "Roles":
+            this._roles = [];
+            this.roles = new MemberRoleManager(this);
+            break;
+          case "CanReceive":
+            this.canRecieve = false;
+            break;
+        }
+      }
+    }
   }
   /**
    * Get member role IDs
@@ -3046,9 +3133,9 @@ var Member = class extends Base {
     await server.members.kick(this.id);
   }
   /** @internal */
-  [util6.inspect.custom](depth, options, inspect12) {
+  [util6.inspect.custom](depth, options, inspect13) {
     const { client, serverId, ...props } = this;
-    return `${this.constructor.name} ${inspect12(
+    return `${this.constructor.name} ${inspect13(
       {
         ...props,
         user: this.user,
@@ -3279,6 +3366,7 @@ var ServerChannelManager = class {
 
 // src/structures/Role.ts
 var util9 = __toESM(require("util"), 1);
+var import_ulid5 = require("ulid");
 var Role = class extends Base {
   serverId;
   name;
@@ -3287,16 +3375,21 @@ var Role = class extends Base {
   rank = 0;
   icon = null;
   _permissions = 0n;
+  createdAt;
+  createdTimestamp;
   constructor(client, data, serverId) {
     super(client, data);
     this.serverId = serverId;
+    const timestamp = (0, import_ulid5.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   /**
    * Updates the role instance with new data without losing the object reference.
    * @internal
    */
-  _patch(data) {
+  _patch(data, clear) {
     if (data.name !== void 0) this.name = data.name;
     if (data.colour !== void 0) this.color = data.colour;
     if (data.hoist !== void 0) this.hoist = data.hoist;
@@ -3314,6 +3407,18 @@ var Role = class extends Base {
         this._permissions = 0n;
       }
     }
+    if (clear && Array.isArray(clear)) {
+      for (const field of clear) {
+        switch (field) {
+          case "Colour":
+            this.color = null;
+            break;
+          case "Icon":
+            this.icon = null;
+            break;
+        }
+      }
+    }
   }
   /**
    * The server this role belongs to.
@@ -3809,7 +3914,7 @@ var ServerBanManager = class extends BaseManager {
     this.server = server;
   }
   extractId(data) {
-    return data._id?.user ?? data.id;
+    return data._id?.user;
   }
   construct(data) {
     return new ServerBan(data);
@@ -3821,11 +3926,6 @@ var ServerBanManager = class extends BaseManager {
    */
   async fetch() {
     const data = await this.client.rest.get(`/servers/${this.server.id}/bans`);
-    if (data.users && Array.isArray(data.users)) {
-      for (const userData of data.users) {
-        this.client.users._add(userData);
-      }
-    }
     const rawBans = data.bans || (Array.isArray(data) ? data : []);
     const fetched = new Collection();
     for (const rawBan of rawBans) {
@@ -3846,14 +3946,20 @@ var ServerBanManager = class extends BaseManager {
 };
 
 // src/structures/Emoji.ts
+var import_ulid6 = require("ulid");
 var Emoji = class extends Base {
   creatorId;
   name;
   parent;
+  createdAt;
+  createdTimestamp;
   animated = false;
   nsfw = false;
   constructor(client, data) {
     super(client, data);
+    const timestamp = (0, import_ulid6.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   _patch(data) {
@@ -4031,6 +4137,114 @@ var EmojiManager = class extends BaseManager {
   }
 };
 
+// src/structures/Server.ts
+var import_ulid7 = require("ulid");
+
+// src/structures/AuditLogEntry.ts
+var util12 = __toESM(require("util"), 1);
+function resolveTargetId(data) {
+  if (data.target) return data.target;
+  const action = data.action;
+  switch (action.type) {
+    case "ChannelCreate":
+    case "ChannelEdit":
+    case "ChannelDelete":
+    case "ChannelRolePermissionsEdit":
+      return action.channel;
+    case "RoleCreate":
+    case "RoleEdit":
+    case "RoleDelete":
+      return action.role;
+    case "InviteCreate":
+    case "InviteDelete":
+      return action.invite;
+    case "WebhookCreate":
+    case "WebhookDelete":
+      return action.webhook;
+    case "EmojiCreate":
+    case "EmojiUpdate":
+    case "EmojiDelete":
+      return action.emoji;
+    case "MessageDelete":
+      return action.channel;
+    case "MessagePin":
+    case "MessageUnpin":
+      return action.message;
+    case "MessageBulkDelete":
+      return action.channel;
+    default:
+      return null;
+  }
+}
+var AuditLogEntry = class extends Base {
+  serverId;
+  userId;
+  targetId;
+  reason;
+  action;
+  constructor(client, data) {
+    super(client, data);
+    this.serverId = data.server;
+    this.userId = data.user;
+    this.targetId = resolveTargetId(data);
+    this.reason = data.reason ?? null;
+    this.action = data.action;
+  }
+  /** The action tag, e.g. "ChannelEdit" — narrow `entry.action` on this. */
+  get type() {
+    return this.action.type;
+  }
+  get server() {
+    return this.client.servers.cache.get(this.serverId);
+  }
+  /** The user who performed this action, if cached. */
+  get executor() {
+    return this.client.users.cache.get(this.userId);
+  }
+  /**
+   * Best-effort resolve of `targetId` into the actual entity, picked by
+   * `action.type` since a bare id alone doesn't say whether it's a member,
+   * a role, a channel, etc.
+   */
+  get target() {
+    if (!this.targetId) return void 0;
+    const server = this.server;
+    switch (this.action.type) {
+      case "MemberEdit":
+      case "MemberKick":
+        return server?.members.cache.get(this.targetId);
+      case "BanCreate":
+      case "BanDelete":
+        return this.client.users.cache.get(this.targetId);
+      case "ChannelCreate":
+      case "ChannelEdit":
+      case "ChannelDelete":
+      case "ChannelRolePermissionsEdit":
+        return server?.channels.cache.get(this.targetId);
+      case "RoleCreate":
+      case "RoleEdit":
+      case "RoleDelete":
+        return server?.roles.cache.get(this.targetId);
+      default:
+        return this.targetId;
+    }
+  }
+  /**
+   * Customizer for Node.js `console.log` and `util.inspect`.
+   * Hides the cyclic client reference for a cleaner output.
+   * @internal
+   */
+  [util12.inspect.custom]() {
+    const { client, ...props } = this;
+    return `${this.constructor.name} ${util12.inspect({
+      ...props,
+      type: this.type,
+      executor: this.executor,
+      target: this.target
+    })}`;
+  }
+};
+
 // src/structures/Server.ts
 var Server = class extends Base {
   channelIds = [];
@@ -4051,6 +4265,8 @@ var Server = class extends Base {
   bans;
   invites;
   emojis;
+  createdAt;
+  createdTimestamp;
   constructor(client, data) {
     super(client, data);
     this.channels = new ServerChannelManager(client, this);
@@ -4059,6 +4275,9 @@ var Server = class extends Base {
     this.bans = new ServerBanManager(this.client, this);
     this.invites = new ServerInviteManager(this.client, this);
     this.emojis = new EmojiManager(this.client, this);
+    const timestamp = (0, import_ulid7.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   /**
@@ -4101,6 +4320,12 @@ var Server = class extends Base {
           case "Icon":
             this.icon = null;
             break;
+          case "Banner":
+            this.banner = null;
+            break;
+          case "Categories":
+            this.categories = null;
+            break;
         }
       }
     }
@@ -4119,6 +4344,27 @@ var Server = class extends Base {
   async leave() {
     return this.client.rest.delete(`/servers/${this.id}/leave`);
   }
+  /**
+   * Fetch audit logs for this server
+   * @param options Query params
+   */
+  async fetchAuditLogs(options) {
+    const query = {};
+    if (options?.user) query.user = options.user;
+    if (options?.target) query.target = options.target;
+    if (options?.type) query.type = options.type;
+    if (options?.before) query.before = options.before;
+    if (options?.after) query.after = options.after;
+    if (options?.limit) query.limit = options.limit;
+    const data = await this.client.rest.get(`/servers/${this.id}/audit_logs`, query);
+    for (const user of data.users) this.client.users._add(user);
+    for (const member of data.members) this.members._add(member);
+    const entries = new Collection();
+    for (const raw of data.audit_logs) {
+      entries.set(raw._id, new AuditLogEntry(this.client, raw));
+    }
+    return entries;
+  }
   /**
    * Fetches multiple members from this server.
    * @param options Filter options for the fetch request.
@@ -4130,7 +4376,7 @@ var Server = class extends Base {
 };
 
 // src/managers/ServerManager.ts
-var util12 = __toESM(require("util"), 1);
+var util13 = __toESM(require("util"), 1);
 var ServerManager = class extends BaseManager {
   constructor(client, limit = Infinity) {
     super(client, limit);
@@ -4201,7 +4447,7 @@ var ServerManager = class extends BaseManager {
     const data = await this.client.rest.patch(`/servers/${serverId}`, payload);
     return this._add(data);
   }
-  [util12.inspect.custom]() {
+  [util13.inspect.custom]() {
     return this.cache;
   }
 };
@@ -4429,6 +4675,237 @@ var SweeperManager = class {
   }
 };
 
+// src/voice/VoiceConnection.ts
+var import_rtc_node = require("@livekit/rtc-node");
+var import_node_events = require("events");
+var SAMPLE_RATE = 48e3;
+var CHANNELS = 2;
+var SAMPLES_PER_FRAME = 960;
+var BYTES_PER_FRAME = SAMPLES_PER_FRAME * CHANNELS * 2;
+var VoiceConnection = class extends import_node_events.EventEmitter {
+  channelId;
+  guildId;
+  room;
+  _status = "connecting";
+  _player = null;
+  _audioSource = null;
+  _audioTrack = null;
+  constructor(channelId, guildId) {
+    super();
+    this.channelId = channelId;
+    this.guildId = guildId;
+    this.room = new import_rtc_node.Room();
+    this.room.on(import_rtc_node.RoomEvent.Disconnected, () => {
+      this._status = "disconnected";
+      this._player?.removeSubscriber(this);
+      this.emit("disconnect");
+    });
+  }
+  get status() {
+    return this._status;
+  }
+  get player() {
+    return this._player;
+  }
+  /** @internal */
+  async connect(url, token) {
+    await this.room.connect(url, token);
+    this._status = "ready";
+    this.emit("ready");
+  }
+  subscribe(player) {
+    if (this._player) this._player.removeSubscriber(this);
+    this._player = player;
+    player.addSubscriber(this);
+  }
+  unsubscribe() {
+    this._player?.removeSubscriber(this);
+    this._player = null;
+  }
+  async _feedStream(stream) {
+    if (!this._audioSource) {
+      this._audioSource = new import_rtc_node.AudioSource(SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME);
+      this._audioTrack = import_rtc_node.LocalAudioTrack.createAudioTrack("audio", this._audioSource);
+      const options = new import_rtc_node.TrackPublishOptions();
+      options.source = import_rtc_node.TrackSource.SOURCE_MICROPHONE;
+      if (!this.room.localParticipant) {
+        throw new Error("Not connected to a room");
+      }
+      await this.room.localParticipant.publishTrack(this._audioTrack, options);
+    }
+    let leftover = Buffer.alloc(0);
+    for await (const chunk of stream) {
+      const buf = Buffer.concat([leftover, chunk]);
+      let offset = 0;
+      while (offset + BYTES_PER_FRAME <= buf.length) {
+        const slice = buf.subarray(offset, offset + BYTES_PER_FRAME);
+        const tmp = slice.buffer.slice(slice.byteOffset, slice.byteOffset + slice.byteLength);
+        const pcm = new Int16Array(tmp);
+        await this._audioSource.captureFrame(new import_rtc_node.AudioFrame(pcm, SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME));
+        offset += BYTES_PER_FRAME;
+      }
+      leftover = buf.subarray(offset);
+    }
+  }
+  async disconnect() {
+    this._status = "disconnecting";
+    this.unsubscribe();
+    if (this._audioTrack) {
+      await this._audioTrack.close();
+      this._audioTrack = null;
+      this._audioSource = null;
+    }
+    await this.room.disconnect();
+  }
+};
+
+// src/voice/VoiceManager.ts
+var VoiceManager = class {
+  connections = /* @__PURE__ */ new Map();
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async join(channelId, guildId) {
+    const existing = this.connections.get(channelId);
+    if (existing?.status === "ready") return existing;
+    const { token, url } = await this.client.rest.post(`/channels/${channelId}/join_call`);
+    const connection = new VoiceConnection(channelId, guildId);
+    this.connections.set(channelId, connection);
+    connection.once("disconnect", () => this.connections.delete(channelId));
+    await connection.connect(url, token);
+    return connection;
+  }
+  get(channelId) {
+    return this.connections.get(channelId);
+  }
+  async leave(channelId) {
+    await this.connections.get(channelId)?.disconnect();
+  }
+  async leaveAll() {
+    await Promise.all([...this.connections.keys()].map((id) => this.leave(id)));
+  }
+};
+
+// src/voice/AudioPlayer.ts
+var import_node_events2 = require("events");
+var AudioPlayer = class extends import_node_events2.EventEmitter {
+  _status = "idle";
+  _resource = null;
+  /** Registered VoiceConnections subscribed to this player */
+  subscribers = /* @__PURE__ */ new Set();
+  get status() {
+    return this._status;
+  }
+  get resource() {
+    return this._resource;
+  }
+  play(resource) {
+    this.transition("buffering");
+    this._resource = resource;
+    resource.stream.once("readable", () => {
+      this.transition("playing");
+      this.feed();
+    });
+    resource.stream.once("end", () => {
+      this._resource = null;
+      this.transition("idle");
+      this.emit("idle");
+    });
+    resource.stream.once("error", (err) => {
+      this._resource = null;
+      this.transition("idle");
+      this.emit("error", err);
+    });
+  }
+  pause() {
+    if (this._status !== "playing") return;
+    this._resource?.stream.pause();
+    this.transition("paused");
+  }
+  resume() {
+    if (this._status !== "paused") return;
+    this._resource?.stream.resume();
+    this.transition("playing");
+  }
+  stop() {
+    this._resource?.stream.destroy();
+    this._resource = null;
+    this.transition("stopped");
+    this.transition("idle");
+    this.emit("idle");
+  }
+  /** @internal */
+  addSubscriber(conn) {
+    this.subscribers.add(conn);
+  }
+  /** @internal */
+  removeSubscriber(conn) {
+    this.subscribers.delete(conn);
+  }
+  feed() {
+    if (!this._resource) return;
+    for (const conn of this.subscribers) {
+      conn._feedStream(this._resource.stream);
+    }
+  }
+  transition(next) {
+    const prev = this._status;
+    this._status = next;
+    this.emit("stateChange", prev, next);
+  }
+};
+
+// src/voice/AudioResource.ts
+var import_node_stream = require("stream");
+var import_node_child_process = require("child_process");
+var import_node_stream2 = require("stream");
+var import_node_fs = require("fs");
+var AudioResource = class _AudioResource {
+  stream;
+  constructor(stream) {
+    this.stream = stream;
+  }
+  static from(source, options = {}) {
+    if (typeof source === "string" && !source.startsWith("http") && !(0, import_node_fs.existsSync)(source)) {
+      throw new Error(`Audio file not found: ${source}`);
+    }
+    const { volume = 1, inputType } = options;
+    const args = [
+      ...inputType ? ["-f", inputType] : [],
+      "-i",
+      typeof source === "string" ? source : "pipe:0",
+      "-af",
+      `volume=${volume}`,
+      "-ar",
+      "48000",
+      "-ac",
+      "2",
+      "-f",
+      "s16le",
+      "-acodec",
+      "pcm_s16le",
+      "pipe:1"
+    ];
+    const ffmpeg = (0, import_node_child_process.spawn)("ffmpeg", args, { stdio: ["pipe", "pipe", "ignore"] });
+    if (source instanceof import_node_stream.Readable) {
+      source.pipe(ffmpeg.stdin);
+      source.once("error", () => ffmpeg.kill());
+    }
+    ffmpeg.stdin?.on("error", () => {
+    });
+    const pass = new import_node_stream2.PassThrough();
+    ffmpeg.stdout.pipe(pass);
+    ffmpeg.once("error", (err) => pass.destroy(err));
+    ffmpeg.once("close", (code) => {
+      if (code !== 0 && code !== null) {
+        pass.destroy(new Error(`ffmpeg exited with code ${code}`));
+      }
+    });
+    return new _AudioResource(pass);
+  }
+};
+
 // src/client/Client.ts
 var Client = class extends import_events2.EventEmitter {
   rest;
@@ -4440,6 +4917,7 @@ var Client = class extends import_events2.EventEmitter {
   emojis;
   user = null;
   options;
+  voice;
   constructor(options = {}) {
     super({ captureRejections: true });
     this.options = options;
@@ -4449,6 +4927,7 @@ var Client = class extends import_events2.EventEmitter {
     this.servers = new ServerManager(this, options.cacheLimits?.servers);
     this.users = new UserManager(this, options.cacheLimits?.users);
     this.emojis = new EmojiManager(this, void 0, options.cacheLimits?.emojis);
+    this.voice = new VoiceManager(this);
     this.sweepers = new SweeperManager(this, options.sweepers ?? {});
   }
   /**
@@ -4538,12 +5017,15 @@ var EmbedBuilder = class {
 };
 
 // src/index.ts
+var import_ulid8 = require("ulid");
 var API = __toESM(require("stoat-api"), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   API,
   Attachment,
   AttachmentBuilder,
+  AudioPlayer,
+  AudioResource,
   Base,
   BaseChannel,
   BitField,
@@ -4578,6 +5060,9 @@ var API = __toESM(require("stoat-api"), 1);
   TextChannel,
   UnknownChannel,
   User,
-  UserManager
+  UserManager,
+  VoiceConnection,
+  VoiceManager,
+  decodeTime
 });
 //# sourceMappingURL=index.cjs.map