@buape/carbon 0.2.0 → 0.3.1

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() {}
-}

package/src/structures/GuildTextChannel.ts

@@ -1,21 +0,0 @@
-import { type APIGuildTextChannel, ChannelType } from "discord-api-types/v10"
-import { BaseGuildTextChannel } from "../abstracts/BaseGuildTextChannel.js"
-
-export class GuildTextChannel extends BaseGuildTextChannel<ChannelType.GuildText> {
-	type: ChannelType.GuildText = ChannelType.GuildText
-	/**
-	 * The default auto archive duration of threads in the channel.
-	 */
-	defaultAutoArchiveDuration?: number | null
-	/**
-	 * The default thread rate limit per user of the channel.
-	 */
-	defaultThreadRateLimitPerUser?: number | null
-
-	protected setMoreSpecificData(
-		data: APIGuildTextChannel<ChannelType.GuildText>
-	) {
-		this.defaultAutoArchiveDuration = data.default_auto_archive_duration
-		this.defaultThreadRateLimitPerUser = data.default_thread_rate_limit_per_user
-	}
-}

package/src/structures/GuildThreadChannel.ts

@@ -1,150 +0,0 @@
-import {
-	type APIThreadChannel,
-	Routes,
-	type ThreadChannelType
-} from "discord-api-types/v10"
-import { BaseGuildChannel } from "../abstracts/BaseGuildChannel.js"
-
-export class GuildThreadChannel<
-	Type extends ThreadChannelType
-> extends BaseGuildChannel<Type> {
-	/**
-	 * Whether the thread is archived.
-	 */
-	archived?: boolean
-	/**
-	 * The duration until the thread is auto archived.
-	 */
-	autoArchiveDuration?: number
-	/**
-	 * The timestamp of when the thread was archived.
-	 */
-	archiveTimestamp?: string
-	/**
-	 * Whether the thread is locked.
-	 */
-	locked?: boolean
-	/**
-	 * Whether non-moderators can add other non-moderators to a thread; only available on private threads
-	 */
-	invitable?: boolean
-	/**
-	 * The timestamp of when the thread was created.
-	 */
-	createTimestamp?: string
-	/**
-	 * The number of messages in the thread.
-	 */
-	messageCount?: number
-	/**
-	 * The number of members in the thread.
-	 *
-	 * @remarks
-	 * This is only accurate until 50, after that, Discord stops counting.
-	 */
-	memberCount?: number
-	/**
-	 * The ID of the owner of the thread.
-	 */
-	ownerId?: string
-	/**
-	 * The number of messages sent in the thread.
-	 */
-	totalMessageSent?: number
-	/**
-	 * The tags applied to the thread.
-	 */
-	appliedTags?: string[]
-
-	protected setSpecificData(data: APIThreadChannel) {
-		this.archived = data.thread_metadata?.archived
-		this.autoArchiveDuration = data.thread_metadata?.auto_archive_duration
-		this.archiveTimestamp = data.thread_metadata?.archive_timestamp
-		this.locked = data.thread_metadata?.locked
-		this.invitable = data.thread_metadata?.invitable
-		this.createTimestamp = data.thread_metadata?.create_timestamp
-		this.messageCount = data.message_count
-		this.memberCount = data.member_count
-		this.ownerId = data.owner_id
-		this.totalMessageSent = data.total_message_sent
-		this.appliedTags = data.applied_tags
-	}
-
-	/**
-	 * Join the thread
-	 */
-	async join() {
-		await this.addMember("@me")
-	}
-
-	/**
-	 * Add a member to the thread
-	 */
-	async addMember(userId: string) {
-		await this.client.rest.put(Routes.threadMembers(this.id, userId))
-	}
-
-	/**
-	 * Leave the thread
-	 */
-	async leave() {
-		await this.removeMember("@me")
-	}
-
-	/**
-	 * Get the pinned messages in the thread
-	 */
-	async removeMember(userId: string) {
-		await this.client.rest.delete(Routes.threadMembers(this.id, userId))
-	}
-
-	/**
-	 * Archive the thread
-	 */
-	async archive() {
-		await this.client.rest.patch(Routes.channel(this.id), {
-			body: { archive: true }
-		})
-		this.archived = true
-	}
-
-	/**
-	 * Unarchive the thread
-	 */
-	async unarchive() {
-		await this.client.rest.patch(Routes.channel(this.id), {
-			body: { archive: false }
-		})
-		this.archived = false
-	}
-
-	/**
-	 * Set the auto archive duration of the thread
-	 */
-	async setAutoArchiveDuration(duration: number) {
-		await this.client.rest.patch(Routes.channel(this.id), {
-			body: { auto_archive_duration: duration }
-		})
-		this.autoArchiveDuration = duration
-	}
-
-	/**
-	 * Lock the thread
-	 */
-	async lock() {
-		await this.client.rest.put(Routes.channel(this.id), {
-			body: { locked: true }
-		})
-		this.locked = true
-	}
-
-	/**
-	 * Unlock the thread
-	 */
-	async unlock() {
-		await this.client.rest.put(Routes.channel(this.id), {
-			body: { locked: false }
-		})
-		this.locked = false
-	}
-}

package/src/structures/Message.ts

@@ -1,124 +0,0 @@
-import {
-	type APIChannel,
-	type APIMessage,
-	type APIThreadChannel,
-	type RESTPostAPIChannelThreadsJSONBody,
-	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 { GuildThreadChannel } from "./GuildThreadChannel.js"
-import { User } from "./User.js"
-
-export class Message extends Base {
-	/**
-	 * The ID of the message
-	 */
-	id: string
-	/**
-	 * The ID of the channel the message is in
-	 */
-	channelId: string
-	/**
-	 * Whether the message is a partial message (meaning it does not have all the data).
-	 * If this is true, you should use {@link Message.fetch} to get the full data of the message.
-	 */
-	partial: boolean
-
-	private rawData: APIMessage | null = null
-
-	constructor(
-		client: Client,
-		rawDataOrIds:
-			| APIMessage
-			| {
-					id: string
-					channel_id: string
-			  }
-	) {
-		super(client)
-		this.id = rawDataOrIds.id
-		this.channelId = rawDataOrIds.channel_id
-		if (Object.keys(rawDataOrIds).length === 2) {
-			this.partial = true
-		} else {
-			this.partial = false
-			this.setData(rawDataOrIds as APIMessage)
-		}
-	}
-
-	private setData(data: typeof this.rawData) {
-		this.rawData = data
-		if (!data) throw new Error("Cannot set data without having data... smh")
-	}
-
-	/**
-	 * Fetch updated data for this message.
-	 * If the message is partial, this will fetch all the data for the message and populate the fields.
-	 * If the message is not partial, all fields will be updated with new values from Discord.
-	 */
-	async fetch() {
-		const newData = (await this.client.rest.get(
-			Routes.channelMessage(this.channelId, this.id)
-		)) as APIMessage
-		if (!newData) throw new Error(`Message ${this.id} not found`)
-
-		this.setData(newData)
-	}
-
-	/**
-	 * Delete this message from Discord
-	 */
-	async delete() {
-		return await this.client.rest.delete(
-			Routes.channelMessage(this.channelId, this.id)
-		)
-	}
-
-	get author(): User | null {
-		if (this.rawData?.webhook_id) return null // TODO: Add webhook user
-		// Check if we have an additional property on the author object, in which case we have a full user object
-		if (this.rawData?.author.username)
-			return new User(this.client, this.rawData.author)
-		// This means we only have a partial user object
-		if (this.rawData?.author.id)
-			return new User(this.client, this.rawData.author.id)
-		return null
-	}
-
-	async fetchChannel() {
-		const data = (await this.client.rest.get(
-			Routes.channel(this.channelId)
-		)) as APIChannel
-		return channelFactory(this.client, data)
-	}
-
-	/**
-	 * Pin this message
-	 */
-	async pin() {
-		await this.client.rest.put(Routes.channelPin(this.channelId, this.id))
-	}
-
-	/**
-	 * Unpin this message
-	 */
-	async unpin() {
-		await this.client.rest.delete(Routes.channelPin(this.channelId, this.id))
-	}
-
-	/**
-	 * Start a thread with this message as the associated start message.
-	 * If you want to start a thread without a start message, use {@link BaseGuildTextChannel.startThread}
-	 */
-	async startThread(data: RESTPostAPIChannelThreadsJSONBody) {
-		const thread = (await this.client.rest.post(
-			Routes.threads(this.channelId, this.id),
-			{
-				body: { ...data }
-			}
-		)) as APIThreadChannel
-		return new GuildThreadChannel(this.client, thread)
-	}
-}