@buape/carbon 0.1.3 → 0.3.0

package/src/internals/UserSelectMenuInteraction.ts

@@ -1,20 +0,0 @@
-import {
-	type APIMessageComponentSelectMenuInteraction,
-	type APIMessageUserSelectInteractionData,
-	ComponentType
-} from "discord-api-types/v10"
-import { AnySelectMenuInteraction } from "../abstracts/AnySelectMenuInteraction.js"
-import type { Client } from "../classes/Client.js"
-
-export class UserSelectMenuInteraction extends AnySelectMenuInteraction {
-	constructor(client: Client, data: APIMessageComponentSelectMenuInteraction) {
-		super(client, data)
-		if (data.data.component_type !== ComponentType.UserSelect) {
-			throw new Error("Invalid component type was used to create this class")
-		}
-	}
-
-	get values(): string[] {
-		return (this.rawData.data as APIMessageUserSelectInteractionData).values
-	}
-}

package/src/structures/DmChannel.ts

@@ -1,31 +0,0 @@
-import {
-	type APIDMChannel,
-	type APIMessage,
-	ChannelType,
-	Routes
-} from "discord-api-types/v10"
-import { BaseChannel } from "../abstracts/BaseChannel.js"
-
-/**
- * Represents a DM between two users.
- */
-export class DmChannel extends BaseChannel<ChannelType.DM> {
-	/**
-	 * The name of the channel. This is always null for DM channels.
-	 */
-	name?: null = null
-	type: ChannelType.DM = ChannelType.DM
-
-	protected setSpecificData(data: APIDMChannel) {
-		this.name = data.name
-	}
-
-	/**
-	 * Send a message to the channel
-	 */
-	async send(message: APIMessage) {
-		this.client.rest.post(Routes.channelMessages(this.id), {
-			body: { ...message }
-		})
-	}
-}

package/src/structures/GroupDmChannel.ts

@@ -1,132 +0,0 @@
-import {
-	type APIGroupDMChannel,
-	ChannelType,
-	Routes
-} from "discord-api-types/v10"
-import { BaseChannel } from "../abstracts/BaseChannel.js"
-import { Message } from "./Message.js"
-import { User } from "./User.js"
-
-/**
- * Represents a group DM channel.
- */
-export class GroupDmChannel extends BaseChannel<ChannelType.GroupDM> {
-	/**
-	 * The name of the channel.
-	 */
-	name?: string | null
-	/**
-	 * The recipients of the channel.
-	 */
-	recipients?: User[]
-	type: ChannelType.GroupDM = ChannelType.GroupDM
-	/**
-	 * The ID of the application that created the channel, if it was created by a bot.
-	 */
-	applicationId?: string | null
-	/**
-	 * The icon hash of the channel.
-	 */
-	icon?: string | null
-	/**
-	 * The ID of the user who created the channel.
-	 */
-	ownerId?: string | null
-	/**
-	 * The ID of the last message sent in the channel.
-	 *
-	 * @remarks
-	 * This might not always resolve to a message. The ID still stays a part of the channel's data, even if the message is deleted.
-	 */
-	lastMessageId?: string | null
-	/**
-	 * Whether the channel is managed by an Oauth2 application.
-	 */
-	managed?: boolean | null
-
-	protected setSpecificData(data: APIGroupDMChannel) {
-		this.name = data.name
-		this.recipients = data.recipients?.map((x) => new User(this.client, x))
-		this.applicationId = data.application_id
-		this.icon = data.icon
-		this.ownerId = data.owner_id
-		this.lastMessageId = data.last_message_id
-		this.managed = data.managed
-	}
-
-	/**
-	 * Get the URL of the channel's icon.
-	 */
-	get iconUrl(): string | null {
-		return this.icon
-			? `https://cdn.discordapp.com/channel-icons/${this.id}/${this.icon}.png`
-			: null
-	}
-
-	/**
-	 * Get the owner of the channel.
-	 */
-	get owner(): User {
-		if (!this.ownerId) throw new Error("Cannot get owner without owner ID")
-		return new User(this.client, this.ownerId)
-	}
-
-	/**
-	 * The last message sent in the channel.
-	 *
-	 * @remarks
-	 * This might not always resolve to a message. The ID still stays a part of the channel's data, even if the message is deleted.
-	 * This will always return a partial message, so you can use {@link Message.fetch} to get the full message data.
-	 *
-	 */
-	get lastMessage() {
-		if (!this.lastMessageId) return null
-		return new Message(this.client, {
-			id: this.lastMessageId,
-			channel_id: this.id
-		})
-	}
-
-	/**
-	 * Set the name of the channel
-	 * @param name The new name of the channel
-	 */
-	async setName(name: string) {
-		await this.client.rest.patch(Routes.channel(this.id), {
-			body: {
-				name
-			}
-		})
-		this.name = name
-	}
-
-	async addRecipient(user: User | string) {
-		await this.client.rest.put(
-			Routes.channelRecipient(
-				this.id,
-				typeof user === "string" ? user : user.id
-			)
-		)
-		if (this.recipients)
-			this.recipients.push(
-				typeof user === "string" ? new User(this.client, user) : user
-			)
-		else
-			this.recipients = [
-				typeof user === "string" ? new User(this.client, user) : user
-			]
-	}
-
-	async removeRecipient(user: User | string) {
-		await this.client.rest.delete(
-			Routes.channelRecipient(
-				this.id,
-				typeof user === "string" ? user : user.id
-			)
-		)
-		if (this.recipients)
-			this.recipients = this.recipients.filter(
-				(x) => x.id !== (typeof user === "string" ? user : user.id)
-			)
-	}
-}

package/src/structures/Guild.ts

@@ -1,154 +0,0 @@
-import {
-	type APIChannel,
-	type APIGuild,
-	type APIGuildMember,
-	type APIRole,
-	type RESTPostAPIGuildRoleJSONBody,
-	Routes
-} from "discord-api-types/v10"
-import { Base } from "../abstracts/Base.js"
-import type { Client } from "../classes/Client.js"
-import { channelFactory } from "../factories/channelFactory.js"
-import { GuildMember } from "./GuildMember.js"
-import { Role } from "./Role.js"
-
-export class Guild extends Base {
-	/**
-	 * The ID of the guild
-	 */
-	id: string
-	/**
-	 * The name of the guild.
-	 */
-	name?: string
-	/**
-	 * The description of the guild.
-	 */
-	description?: string | null
-	/**
-	 * The icon hash of the guild.
-	 * You can use {@link Guild.iconUrl} to get the URL of the icon.
-	 */
-	icon?: string | null
-	/**
-	 * The splash hash of the guild.
-	 * You can use {@link Guild.splashUrl} to get the URL of the splash.
-	 */
-	splash?: string | null
-	/**
-	 * The ID of the owner of the guild.
-	 */
-	ownerId?: string
-
-	/**
-	 * Whether the guild is a partial guild (meaning it does not have all the data).
-	 * If this is true, you should use {@link Guild.fetch} to get the full data of the guild.
-	 */
-	partial: boolean
-
-	private rawData: APIGuild | null = null
-
-	constructor(client: Client, rawDataOrId: APIGuild | string) {
-		super(client)
-		if (typeof rawDataOrId === "string") {
-			this.id = rawDataOrId
-			this.partial = true
-		} else {
-			this.rawData = rawDataOrId
-			this.id = rawDataOrId.id
-			this.partial = false
-			this.setData(rawDataOrId)
-		}
-	}
-
-	private setData(data: typeof this.rawData) {
-		if (!data) throw new Error("Cannot set data without having data... smh")
-		this.rawData = data
-		this.name = data.name
-		this.description = data.description
-		this.icon = data.icon
-		this.splash = data.splash
-		this.ownerId = data.owner_id
-		this.partial = false
-	}
-
-	/**
-	 * Fetch updated data for this guild.
-	 * If the guild is partial, this will fetch all the data for the guild and populate the fields.
-	 * If the guild is not partial, all fields will be updated with new values from Discord.
-	 */
-	async fetch() {
-		const newData = (await this.client.rest.get(
-			Routes.guild(this.id)
-		)) as APIGuild
-		if (!newData) throw new Error(`Guild ${this.id}not found`)
-
-		this.setData(newData)
-	}
-
-	/**
-	 * Leave the guild
-	 */
-	async leave() {
-		return await this.client.rest.delete(Routes.guild(this.id))
-	}
-
-	/**
-	 * Create a role in the guild
-	 */
-	async createRole(data: RESTPostAPIGuildRoleJSONBody) {
-		const role = (await this.client.rest.post(Routes.guildRoles(this.id), {
-			body: {
-				...data
-			}
-		})) as APIRole
-		return new Role(this.client, role)
-	}
-
-	/**
-	 * Get a member in the guild by ID
-	 */
-	async fetchMember(memberId: string) {
-		const member = (await this.client.rest.get(
-			Routes.guildMember(this.id, memberId)
-		)) as APIGuildMember
-		return new GuildMember(this.client, member, this)
-	}
-
-	/**
-	 * Get the URL of the guild's icon
-	 */
-	get iconUrl(): string | null {
-		return this.icon
-			? `https://cdn.discordapp.com/icons/${this.id}/${this.icon}.png`
-			: null
-	}
-
-	/**
-	 * Get the URL of the guild's splash
-	 */
-	get splashUrl(): string | null {
-		return this.splash
-			? `https://cdn.discordapp.com/splashes/${this.id}/${this.splash}.png`
-			: null
-	}
-
-	/**
-	 * Get all roles in the guild
-	 */
-	get roles() {
-		const roles = this.rawData?.roles
-		if (!roles) throw new Error("Cannot get roles without having data... smh")
-		return roles.map((role) => new Role(this.client, role))
-	}
-
-	/**
-	 * Fetch a channel from the guild by ID
-	 */
-	async fetchChannel(channelId: string) {
-		const channel = (await this.client.rest.get(
-			Routes.channel(channelId)
-		)) as APIChannel
-		return channelFactory(this.client, channel)
-	}
-}

package/src/structures/GuildAnnouncementChannel.ts

@@ -1,20 +0,0 @@
-import { ChannelType, Routes } from "discord-api-types/v10"
-import { BaseGuildTextChannel } from "../abstracts/BaseGuildTextChannel.js"
-import type { GuildTextChannel } from "./GuildTextChannel.js"
-
-/**
- * Represents a guild announcement channel.
- */
-export class GuildAnnouncementChannel extends BaseGuildTextChannel<ChannelType.GuildAnnouncement> {
-	type: ChannelType.GuildAnnouncement = ChannelType.GuildAnnouncement
-	protected setMoreSpecificData() {}
-
-	async follow(targetChannel: GuildTextChannel | string) {
-		await this.client.rest.put(Routes.channelFollowers(this.id), {
-			body: {
-				webhook_channel_id:
-					typeof targetChannel === "string" ? targetChannel : targetChannel.id
-			}
-		})
-	}
-}

package/src/structures/GuildCategoryChannel.ts

@@ -1,16 +0,0 @@
-import type { ChannelType } from "discord-api-types/v10"
-import { BaseGuildChannel } from "../abstracts/BaseGuildChannel.js"
-
-/**
- * Represents a guild category channel.
- */
-export class GuildCategoryChannel extends BaseGuildChannel<ChannelType.GuildCategory> {
-	protected setSpecificData() {}
-
-	/**
-	 * You cannot send a message to a category channel, so this method throws an error
-	 */
-	override async send(): Promise<void> {
-		throw new Error("Category channels cannot be sent to")
-	}
-}

package/src/structures/GuildForumChannel.ts

@@ -1,20 +0,0 @@
-import type {
-	APIGuildForumChannel,
-	ChannelType,
-	ForumLayoutType
-} from "discord-api-types/v10"
-import { GuildThreadOnlyChannel } from "../abstracts/GuildThreadOnlyChannel.js"
-
-/**
- * Represents a guild forum channel.
- */
-export class GuildForumChannel extends GuildThreadOnlyChannel<ChannelType.GuildForum> {
-	/**
-	 * The default forum layout of the channel.
-	 */
-	defaultForumLayout?: ForumLayoutType
-
-	protected setMoreSpecificData(data: APIGuildForumChannel) {
-		this.defaultForumLayout = data.default_forum_layout
-	}
-}

package/src/structures/GuildMediaChannel.ts

@@ -1,13 +0,0 @@
-import type { ChannelType, ForumLayoutType } from "discord-api-types/v10"
-import { GuildThreadOnlyChannel } from "../abstracts/GuildThreadOnlyChannel.js"
-
-/**
- * Represents a guild media channel (a forum channel )
- */
-export class GuildMediaChannel extends GuildThreadOnlyChannel<ChannelType.GuildMedia> {
-	/**
-	 * The default forum layout of the channel.
-	 */
-	defaultForumLayout?: ForumLayoutType
-	protected setMoreSpecificData() {}
-}

package/src/structures/GuildMember.ts

@@ -1,231 +0,0 @@
-import type { APIGuildMember, GuildMemberFlags } from "discord-api-types/v10"
-import { Base } from "../abstracts/Base.js"
-import type { Client } from "../classes/Client.js"
-import type { Guild } from "./Guild.js"
-import { Role } from "./Role.js"
-import { User } from "./User.js"
-
-export class GuildMember extends Base {
-	/**
-	 * The guild-specific nickname of the member.
-	 */
-	nickname?: string | null
-	/**
-	 * The guild-specific avatar hash of the member.
-	 * You can use {@link GuildMember.avatarUrl} to get the URL of the avatar.
-	 */
-	avatar?: string | null
-	/**
-	 * Is this member muted in Voice Channels?
-	 */
-	mute?: boolean | null
-	/**
-	 * Is this member deafened in Voice Channels?
-	 */
-	deaf?: boolean | null
-	/**
-	 * The date since this member boosted the guild, if applicable.
-	 */
-	premiumSince?: string | null
-	/**
-	 * The flags of the member.
-	 * @see https://discord.com/developers/docs/resources/guild#guild-member-object-guild-member-flags
-	 */
-	flags?: GuildMemberFlags | null
-	/**
-	 * The roles of the member
-	 */
-	roles?: Role[] | null
-	/**
-	 * The joined date of the member
-	 */
-	joinedAt?: string | null
-	/**
-	 * The date when the member's communication privileges (timeout) will be reinstated
-	 */
-	communicationDisabledUntil?: string | null
-	/**
-	 * Is this member yet to pass the guild's Membership Screening requirements?
-	 */
-	pending?: boolean | null
-	/**
-	 * The guild object of the member
-	 */
-	guild: Guild
-	/**
-	 * The user object of the member
-	 */
-	user?: User | null
-
-	private rawData: APIGuildMember | null = null
-
-	constructor(client: Client, rawData: APIGuildMember, guild: Guild) {
-		super(client)
-		this.rawData = rawData
-		this.guild = guild
-		this.setData(rawData)
-	}
-
-	private setData(data: typeof this.rawData) {
-		if (!data) throw new Error("Cannot set data without having data... smh")
-		this.rawData = data
-		this.nickname = data.nick
-		this.avatar = data.avatar
-		this.mute = data.mute
-		this.deaf = data.deaf
-		this.premiumSince = data.premium_since
-		this.flags = data.flags
-		this.roles = data.roles?.map((roleId) => new Role(this.client, roleId))
-		this.joinedAt = data.joined_at
-		this.communicationDisabledUntil = data.communication_disabled_until
-		this.pending = data.pending
-		this.user = data.user ? new User(this.client, data.user) : null
-	}
-
-	/**
-	 * Set the nickname of the member
-	 */
-	async setNickname(nickname: string | null): Promise<void> {
-		await this.client.rest.patch(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}`,
-			{
-				body: {
-					nick: nickname
-				}
-			}
-		)
-		this.nickname = nickname
-	}
-
-	/**
-	 * Add a role to the member
-	 */
-	async addRole(roleId: string): Promise<void> {
-		await this.client.rest.put(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}/roles/${roleId}`,
-			{}
-		)
-		this.roles?.push(new Role(this.client, roleId))
-	}
-
-	/**
-	 * Remove a role from the member
-	 */
-	async removeRole(roleId: string): Promise<void> {
-		await this.client.rest.delete(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}/roles/${roleId}`
-		)
-		this.roles = this.roles?.filter((role) => role.id !== roleId)
-	}
-
-	/**
-	 * Kick the member from the guild
-	 */
-	async kick(): Promise<void> {
-		await this.client.rest.delete(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}`
-		)
-	}
-
-	/**
-	 * Ban the member from the guild
-	 */
-	async ban(
-		options: { reason?: string; deleteMessageDays?: number } = {}
-	): Promise<void> {
-		await this.client.rest.put(
-			`/guilds/${this.guild?.id}/bans/${this.user?.id}`,
-			{
-				body: {
-					reason: options.reason,
-					delete_message_days: options.deleteMessageDays
-				}
-			}
-		)
-	}
-
-	/**
-	 * Mute a member in voice channels
-	 */
-	async muteMember(): Promise<void> {
-		await this.client.rest.patch(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}`,
-			{
-				body: {
-					mute: true
-				}
-			}
-		)
-		this.mute = true
-	}
-
-	/**
-	 * Unmute a member in voice channels
-	 */
-	async unmuteMember(): Promise<void> {
-		await this.client.rest.patch(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}`,
-			{
-				body: {
-					mute: false
-				}
-			}
-		)
-		this.mute = false
-	}
-
-	/**
-	 * Deafen a member in voice channels
-	 */
-	async deafenMember(): Promise<void> {
-		await this.client.rest.patch(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}`,
-			{
-				body: {
-					deaf: true
-				}
-			}
-		)
-		this.deaf = true
-	}
-
-	/**
-	 * Undeafen a member in voice channels
-	 */
-	async undeafenMember(): Promise<void> {
-		await this.client.rest.patch(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}`,
-			{
-				body: {
-					deaf: false
-				}
-			}
-		)
-		this.deaf = false
-	}
-
-	/**
-	 * Set or remove a timeout for a member in the guild
-	 */
-	async timeoutMember(communicationDisabledUntil: string): Promise<void> {
-		await this.client.rest.patch(
-			`/guilds/${this.guild?.id}/members/${this.user?.id}`,
-			{
-				body: {
-					communication_disabled_until: communicationDisabledUntil
-				}
-			}
-		)
-		this.communicationDisabledUntil = communicationDisabledUntil
-	}
-
-	/**
-	 * Get the URL of the member's guild-specific avatar
-	 */
-	get avatarUrl(): string | null {
-		if (!this.user) return null
-		return this.avatar
-			? `https://cdn.discordapp.com/guilds/${this.guild.id}/users/${this.user?.id}/${this.avatar}.png`
-			: null
-	}
-}

package/src/structures/GuildStageOrVoiceChannel.ts

@@ -1,46 +0,0 @@
-import type {
-	APIGuildStageVoiceChannel,
-	APIGuildVoiceChannel,
-	ChannelType,
-	VideoQualityMode
-} from "discord-api-types/v10"
-import { BaseGuildChannel } from "../abstracts/BaseGuildChannel.js"
-
-export abstract class GuildStageOrVoiceChannel<
-	Type extends ChannelType.GuildStageVoice | ChannelType.GuildVoice
-> extends BaseGuildChannel<Type> {
-	/**
-	 * The bitrate of the channel.
-	 */
-	bitrate?: number | null
-	/**
-	 * The user limit of the channel.
-	 */
-	userLimit?: number | null
-	/**
-	 * The RTC region of the channel.
-	 * This is automatic when set to `null`.
-	 */
-	rtcRegion?: string | null
-	/**
-	 * The video quality mode of the channel.
-	 * 1 when not present.
-	 */
-	videoQualityMode?: VideoQualityMode | null
-
-	protected setSpecificData(
-		data: APIGuildStageVoiceChannel | APIGuildVoiceChannel
-	) {
-		this.bitrate = data.bitrate
-		this.userLimit = data.user_limit
-		this.rtcRegion = data.rtc_region
-		this.videoQualityMode = data.video_quality_mode
-	}
-}
-
-export class GuildStageChannel extends BaseGuildChannel<ChannelType.GuildStageVoice> {
-	protected setSpecificData() {}
-}
-export class GuildVoiceChannel extends BaseGuildChannel<ChannelType.GuildVoice> {
-	protected setSpecificData() {}
-}