1 files changed, 81 insertions, 3 deletions

diff --git a/src/lib/extensions/discord.js/BushMessageManager.d.ts b/src/lib/extensions/discord.js/BushMessageManager.d.ts
index f6bc8e7..84918c0 100644
--- a/src/lib/extensions/discord.js/BushMessageManager.d.ts
+++ b/src/lib/extensions/discord.js/BushMessageManager.d.ts
@@ -1,4 +1,4 @@
-import { BushMessageResolvable, type BushMessage, type BushTextBasedChannels } from '#lib';
+import { BushMessageResolvable, BushTextBasedChannel, type BushMessage } from '#lib';
 import {
 	CachedManager,
 	type BaseFetchOptions,
@@ -11,17 +11,95 @@ import {
 } from 'discord.js';
 import type { RawMessageData } from 'discord.js/typings/rawDataTypes';
 
+/**
+ * Manages API methods for Messages and holds their cache.
+ */
 export class BushMessageManager extends CachedManager<Snowflake, BushMessage, BushMessageResolvable> {
-	public constructor(channel: BushTextBasedChannels, iterable?: Iterable<RawMessageData>);
-	public channel: BushTextBasedChannels;
+	public constructor(channel: BushTextBasedChannel, iterable?: Iterable<RawMessageData>);
+
+	/**
+	 * The channel that the messages belong to
+	 */
+	public channel: BushTextBasedChannel;
+
+	/**
+	 * The cache of Messages
+	 */
 	public cache: Collection<Snowflake, BushMessage>;
+
+	/**
+	 * Publishes a message in an announcement channel to all channels following it, even if it's not cached.
+	 * @param message The message to publish
+	 */
 	public crosspost(message: BushMessageResolvable): Promise<BushMessage>;
+
+	/**
+	 * Deletes a message, even if it's not cached.
+	 * @param message The message to delete
+	 */
 	public delete(message: BushMessageResolvable): Promise<void>;
+
+	/**
+	 * Edits a message, even if it's not cached.
+	 * @param message The message to edit
+	 * @param options The options to edit the message
+	 */
 	public edit(message: BushMessageResolvable, options: MessagePayload | MessageEditOptions): Promise<BushMessage>;
+
+	/**
+	 * Gets a message, or messages, from this channel.
+	 * <info>The returned Collection does not contain reaction users of the messages if they were not cached.
+	 * Those need to be fetched separately in such a case.</info>
+	 * @param message The id of the message to fetch, or query parameters.
+	 * @param options Additional options for this fetch
+	 * @example
+	 * // Get message
+	 * channel.messages.fetch('99539446449315840')
+	 *   .then(message => console.log(message.content))
+	 *   .catch(console.error);
+	 * @example
+	 * // Get messages
+	 * channel.messages.fetch({ limit: 10 })
+	 *   .then(messages => console.log(`Received ${messages.size} messages`))
+	 *   .catch(console.error);
+	 * @example
+	 * // Get messages and filter by user id
+	 * channel.messages.fetch()
+	 *   .then(messages => console.log(`${messages.filter(m => m.author.id === '84484653687267328').size} messages`))
+	 *   .catch(console.error);
+	 */
 	public fetch(message: Snowflake, options?: BaseFetchOptions): Promise<BushMessage>;
 	public fetch(options?: ChannelLogsQueryOptions, cacheOptions?: BaseFetchOptions): Promise<Collection<Snowflake, BushMessage>>;
+
+	/**
+	 * Fetches the pinned messages of this channel and returns a collection of them.
+	 * <info>The returned Collection does not contain any reaction data of the messages.
+	 * Those need to be fetched separately.</info>
+	 * @param cache Whether to cache the message(s)
+	 * @example
+	 * // Get pinned messages
+	 * channel.messages.fetchPinned()
+	 *   .then(messages => console.log(`Received ${messages.size} messages`))
+	 *   .catch(console.error);
+	 */
 	public fetchPinned(cache?: boolean): Promise<Collection<Snowflake, BushMessage>>;
+
+	/**
+	 * Adds a reaction to a message, even if it's not cached.
+	 * @param message The message to react to
+	 * @param emoji The emoji to react with
+	 */
 	public react(message: BushMessageResolvable, emoji: EmojiIdentifierResolvable): Promise<void>;
+
+	/**
+	 * Pins a message to the channel's pinned messages, even if it's not cached.
+	 * @param message The message to pin
+	 */
 	public pin(message: BushMessageResolvable): Promise<void>;
+
+	/**
+	 * Unpins a message from the channel's pinned messages, even if it's not cached.
+	 * @param message The message to unpin
+	 */
 	public unpin(message: BushMessageResolvable): Promise<void>;
 }