@ovencord/discord.js 14.16.3

package/src/managers/AutoModerationRuleManager.ts

@@ -0,0 +1,307 @@
+import { Collection  } from '@ovencord/collection';
+import { Routes  } from 'discord-api-types/v10';
+import { AutoModerationRule  } from '../structures/AutoModerationRule.js';
+import { CachedManager  } from './CachedManager.js';
+
+/**
+ * Manages API methods for auto moderation rules and stores their cache.
+ *
+ * @extends {CachedManager}
+ */
+export class AutoModerationRuleManager extends CachedManager {
+  public guild: any;
+  constructor(guild, iterable) {
+    super(guild.client, AutoModerationRule, iterable);
+
+    /**
+     * The guild this manager belongs to.
+     *
+     * @type {Guild}
+     */
+    this.guild = guild;
+  }
+
+  /**
+   * The cache of this manager
+   *
+   * @type {Collection<Snowflake, AutoModerationRule>}
+   * @name AutoModerationRuleManager#cache
+   */
+
+  /**
+   * Resolves an {@link AutoModerationRuleResolvable} to an {@link AutoModerationRule} object.
+   *
+   * @method resolve
+   * @memberof AutoModerationRuleManager
+   * @instance
+   * @param {AutoModerationRuleResolvable} autoModerationRule The AutoModerationRule resolvable to resolve
+   * @returns {?AutoModerationRule}
+   */
+
+  /**
+   * Resolves an {@link AutoModerationRuleResolvable} to a {@link AutoModerationRule} id.
+   *
+   * @method resolveId
+   * @memberof AutoModerationRuleManager
+   * @instance
+   * @param {AutoModerationRuleResolvable} autoModerationRule The AutoModerationRule resolvable to resolve
+   * @returns {?Snowflake}
+   */
+
+  _add(data, cache) {
+    return super._add(data, cache, { extras: [this.guild] });
+  }
+
+  /**
+   * Options used to set the trigger metadata of an auto moderation rule.
+   *
+   * @typedef {Object} AutoModerationTriggerMetadataOptions
+   * @property {string[]} [keywordFilter] The substrings that will be searched for in the content
+   * @property {string[]} [regexPatterns] The regular expression patterns which will be matched against the content
+   * <info>Only Rust-flavored regular expressions are supported.</info>
+   * @property {AutoModerationRuleKeywordPresetType[]} [presets]
+   * The internally pre-defined wordsets which will be searched for in the content
+   * @property {string[]} [allowList] The substrings that will be exempt from triggering
+   * {@link AutoModerationRuleTriggerType.Keyword},
+   * {@link AutoModerationRuleTriggerType.KeywordPreset},
+   * and {@link AutoModerationRuleTriggerType.MemberProfile}
+   * @property {?number} [mentionTotalLimit] The total number of role & user mentions allowed per message
+   * @property {boolean} [mentionRaidProtectionEnabled] Whether to automatically detect mention raids
+   */
+
+  /**
+   * Options used to set the actions of an auto moderation rule.
+   *
+   * @typedef {Object} AutoModerationActionOptions
+   * @property {AutoModerationActionType} type The type of this auto moderation rule action
+   * @property {AutoModerationActionMetadataOptions} [metadata] Additional metadata needed during execution
+   * <info>This property is required if using a `type` of
+   * {@link AutoModerationActionType.SendAlertMessage} or {@link AutoModerationActionType.Timeout}.</info>
+   */
+
+  /**
+   * Options used to set the metadata of an auto moderation rule action.
+   *
+   * @typedef {Object} AutoModerationActionMetadataOptions
+   * @property {GuildTextChannelResolvable|ThreadChannel} [channel] The channel to which content will be logged
+   * @property {number} [durationSeconds] The timeout duration in seconds
+   * @property {string} [customMessage] The custom message that is shown whenever a message is blocked
+   */
+
+  /**
+   * Options used to create an auto moderation rule.
+   *
+   * @typedef {Object} AutoModerationRuleCreateOptions
+   * @property {string} name The name of the auto moderation rule
+   * @property {AutoModerationRuleEventType} eventType The event type of the auto moderation rule
+   * @property {AutoModerationRuleTriggerType} triggerType The trigger type of the auto moderation rule
+   * @property {AutoModerationTriggerMetadataOptions} [triggerMetadata] The trigger metadata of the auto moderation rule
+   * <info>This property is required if using a `triggerType` of
+   * {@link AutoModerationRuleTriggerType.Keyword},
+   * {@link AutoModerationRuleTriggerType.KeywordPreset},
+   * {@link AutoModerationRuleTriggerType.MentionSpam},
+   * or {@link AutoModerationRuleTriggerType.MemberProfile}.</info>
+   * @property {AutoModerationActionOptions[]} actions
+   * The actions that will execute when the auto moderation rule is triggered
+   * @property {boolean} [enabled] Whether the auto moderation rule should be enabled
+   * @property {Collection<Snowflake, Role>|RoleResolvable[]} [exemptRoles]
+   * The roles that should not be affected by the auto moderation rule
+   * @property {Collection<Snowflake, GuildChannel|ThreadChannel>|GuildChannelResolvable[]} [exemptChannels]
+   * The channels that should not be affected by the auto moderation rule
+   * @property {string} [reason] The reason for creating the auto moderation rule
+   */
+
+  /**
+   * Creates a new auto moderation rule.
+   *
+   * @param {AutoModerationRuleCreateOptions} options Options for creating the auto moderation rule
+   * @returns {Promise<AutoModerationRule>}
+   */
+  async create({
+    name,
+    eventType,
+    triggerType,
+    triggerMetadata,
+    actions,
+    enabled,
+    exemptRoles,
+    exemptChannels,
+    reason,
+  }) {
+    const data = await this.client.rest.post(Routes.guildAutoModerationRules(this.guild.id), {
+      body: {
+        name,
+        event_type: eventType,
+        trigger_type: triggerType,
+        trigger_metadata: triggerMetadata && {
+          keyword_filter: triggerMetadata.keywordFilter,
+          regex_patterns: triggerMetadata.regexPatterns,
+          presets: triggerMetadata.presets,
+          allow_list: triggerMetadata.allowList,
+          mention_total_limit: triggerMetadata.mentionTotalLimit,
+          mention_raid_protection_enabled: triggerMetadata.mentionRaidProtectionEnabled,
+        },
+        actions: actions.map(action => ({
+          type: action.type,
+          metadata: {
+            duration_seconds: action.metadata?.durationSeconds,
+            channel_id: action.metadata?.channel && this.guild.channels.resolveId(action.metadata.channel),
+            custom_message: action.metadata?.customMessage,
+          },
+        })),
+        enabled,
+        exempt_roles: exemptRoles?.map(exemptRole => this.guild.roles.resolveId(exemptRole)),
+        exempt_channels: exemptChannels?.map(exemptChannel => this.guild.channels.resolveId(exemptChannel)),
+      },
+      reason,
+    });
+
+    return this._add(data);
+  }
+
+  /**
+   * Options used to edit an auto moderation rule.
+   *
+   * @typedef {Object} AutoModerationRuleEditOptions
+   * @property {string} [name] The name of the auto moderation rule
+   * @property {AutoModerationRuleEventType} [eventType] The event type of the auto moderation rule
+   * @property {AutoModerationTriggerMetadataOptions} [triggerMetadata] The trigger metadata of the auto moderation rule
+   * @property {AutoModerationActionOptions[]} [actions]
+   * The actions that will execute when the auto moderation rule is triggered
+   * @property {boolean} [enabled] Whether the auto moderation rule should be enabled
+   * @property {Collection<Snowflake, Role>|RoleResolvable[]} [exemptRoles]
+   * The roles that should not be affected by the auto moderation rule
+   * @property {Collection<Snowflake, GuildChannel|ThreadChannel>|GuildChannelResolvable[]} [exemptChannels]
+   * The channels that should not be affected by the auto moderation rule
+   * @property {string} [reason] The reason for creating the auto moderation rule
+   */
+
+  /**
+   * Edits an auto moderation rule.
+   *
+   * @param {AutoModerationRuleResolvable} autoModerationRule The auto moderation rule to edit
+   * @param {AutoModerationRuleEditOptions} options Options for editing the auto moderation rule
+   * @returns {Promise<AutoModerationRule>}
+   */
+  async edit(
+    autoModerationRule,
+    { name, eventType, triggerMetadata, actions, enabled, exemptRoles, exemptChannels, reason },
+  ) {
+    const autoModerationRuleId = this.resolveId(autoModerationRule);
+
+    const data = await this.client.rest.patch(Routes.guildAutoModerationRule(this.guild.id, autoModerationRuleId), {
+      body: {
+        name,
+        event_type: eventType,
+        trigger_metadata: triggerMetadata && {
+          keyword_filter: triggerMetadata.keywordFilter,
+          regex_patterns: triggerMetadata.regexPatterns,
+          presets: triggerMetadata.presets,
+          allow_list: triggerMetadata.allowList,
+          mention_total_limit: triggerMetadata.mentionTotalLimit,
+          mention_raid_protection_enabled: triggerMetadata.mentionRaidProtectionEnabled,
+        },
+        actions: actions?.map(action => ({
+          type: action.type,
+          metadata: {
+            duration_seconds: action.metadata?.durationSeconds,
+            channel_id: action.metadata?.channel && this.guild.channels.resolveId(action.metadata.channel),
+            custom_message: action.metadata?.customMessage,
+          },
+        })),
+        enabled,
+        exempt_roles: exemptRoles?.map(exemptRole => this.guild.roles.resolveId(exemptRole)),
+        exempt_channels: exemptChannels?.map(exemptChannel => this.guild.channels.resolveId(exemptChannel)),
+      },
+      reason,
+    });
+
+    return this._add(data);
+  }
+
+  /**
+   * Data that can be resolved to give an AutoModerationRule object. This can be:
+   * - An AutoModerationRule
+   * - A Snowflake
+   *
+   * @typedef {AutoModerationRule|Snowflake} AutoModerationRuleResolvable
+   */
+
+  /**
+   * Options used to fetch a single auto moderation rule from a guild.
+   *
+   * @typedef {BaseFetchOptions} FetchAutoModerationRuleOptions
+   * @property {AutoModerationRuleResolvable} autoModerationRule The auto moderation rule to fetch
+   */
+
+  /**
+   * Options used to fetch all auto moderation rules from a guild.
+   *
+   * @typedef {Object} FetchAutoModerationRulesOptions
+   * @property {boolean} [cache] Whether to cache the fetched auto moderation rules
+   */
+
+  /**
+   * Fetches auto moderation rules from Discord.
+   *
+   * @param {AutoModerationRuleResolvable|FetchAutoModerationRuleOptions|FetchAutoModerationRulesOptions} [options]
+   * Options for fetching auto moderation rule(s)
+   * @returns {Promise<AutoModerationRule|Collection<Snowflake, AutoModerationRule>>}
+   * @example
+   * // Fetch all auto moderation rules from a guild without caching
+   * guild.autoModerationRules.fetch({ cache: false })
+   *   .then(console.log)
+   *   .catch(console.error);
+   * @example
+   * // Fetch a single auto moderation rule
+   * guild.autoModerationRules.fetch('979083472868098119')
+   *   .then(console.log)
+   *   .catch(console.error);
+   * @example
+   * // Fetch a single auto moderation rule without checking cache and without caching
+   * guild.autoModerationRules.fetch({ autoModerationRule: '979083472868098119', cache: false, force: true })
+   *   .then(console.log)
+   *   .catch(console.error)
+   */
+  async fetch(options) {
+    if (!options) return this._fetchMany();
+    const { autoModerationRule, cache, force } = options;
+    const resolvedAutoModerationRule = this.resolveId(autoModerationRule ?? options);
+    if (resolvedAutoModerationRule) {
+      return this._fetchSingle({ autoModerationRule: resolvedAutoModerationRule, cache, force });
+    }
+
+    return this._fetchMany(options);
+  }
+
+  async _fetchSingle({ autoModerationRule, cache, force = false }) {
+    if (!force) {
+      const existing = this.cache.get(autoModerationRule);
+      if (existing) return existing;
+    }
+
+    const data = await this.client.rest.get(Routes.guildAutoModerationRule(this.guild.id, autoModerationRule));
+    return this._add(data, cache);
+  }
+
+  async _fetchMany(options = {}) {
+    const data = await this.client.rest.get(Routes.guildAutoModerationRules(this.guild.id));
+
+    return data.reduce(
+      (col, autoModerationRule) => col.set(autoModerationRule.id, this._add(autoModerationRule, options.cache)),
+      new Collection(),
+    );
+  }
+
+  /**
+   * Deletes an auto moderation rule.
+   *
+   * @param {AutoModerationRuleResolvable} autoModerationRule The auto moderation rule to delete
+   * @param {string} [reason] The reason for deleting the auto moderation rule
+   * @returns {Promise<void>}
+   */
+  async delete(autoModerationRule, reason) {
+    const autoModerationRuleId = this.resolveId(autoModerationRule);
+    await this.client.rest.delete(Routes.guildAutoModerationRule(this.guild.id, autoModerationRuleId), { reason });
+  }
+}

package/src/managers/BaseManager.ts

@@ -0,0 +1,13 @@
+
+/**
+ * Manages the API methods of a data model.
+ *
+ * @abstract
+ */
+export abstract class BaseManager {
+  public client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+}

package/src/managers/CachedManager.ts

@@ -0,0 +1,56 @@
+
+import { MakeCacheOverrideSymbol  } from '../util/Symbols.js';
+import { DataManager  } from './DataManager.js';
+
+/**
+ * Manages the API methods of a data model with a mutable cache of instances.
+ *
+ * @extends {DataManager}
+ * @abstract
+ */
+export abstract class CachedManager extends DataManager {
+  public _cache: any;
+  public holds: any;
+
+  constructor(client: any, holds: any, iterable?: any) {
+    super(client, holds);
+
+    this.holds = holds;
+
+    Object.defineProperty(this, '_cache', {
+      value: (this.client as any).options.makeCache({
+        holds: this.holds,
+        manager: this.constructor,
+        managerType: (this.constructor as any)[MakeCacheOverrideSymbol] ?? this.constructor,
+      }),
+    });
+
+    if (iterable) {
+      for (const item of iterable) {
+        this._add(item);
+      }
+    }
+  }
+
+  override get cache(): any {
+    return this._cache;
+  }
+
+  _add(data: any, cache = true, { id, extras = [] as any[] }: { id?: string; extras?: any[] } = {}) {
+    const existing = (this.cache as any).get(id ?? data.id);
+    if (existing) {
+      if (cache) {
+        if (typeof existing._patch === 'function') existing._patch(data);
+        return existing;
+      }
+
+      const clone = typeof existing._clone === 'function' ? existing._clone() : existing;
+      if (typeof clone._patch === 'function') clone._patch(data);
+      return clone;
+    }
+
+    const entry = this.holds ? new this.holds(this.client, data, ...extras) : data;
+    if (cache) (this.cache as any).set(id ?? entry.id, entry);
+    return entry;
+  }
+}

package/src/managers/CategoryChannelChildManager.ts

@@ -0,0 +1,81 @@
+import { GuildChannel  } from '../structures/GuildChannel.js';
+import { DataManager  } from './DataManager.js';
+
+/**
+ * Manages API methods for CategoryChannels' children.
+ *
+ * @extends {DataManager}
+ */
+export class CategoryChannelChildManager extends DataManager {
+  constructor(channel) {
+    super(channel.client, GuildChannel);
+    /**
+     * The category channel this manager belongs to
+     *
+     * @type {CategoryChannel}
+     */
+    this.channel = channel;
+  }
+
+  /**
+   * The channels that are a part of this category
+   *
+   * @type {Collection<Snowflake, GuildChannel>}
+   * @readonly
+   */
+  get cache() {
+    return this.guild.channels.cache.filter(channel => channel.parentId === this.channel.id);
+  }
+
+  /**
+   * The guild this manager belongs to
+   *
+   * @type {Guild}
+   * @readonly
+   */
+  get guild() {
+    return this.channel.guild;
+  }
+
+  /**
+   * Options for creating a channel using {@link CategoryChannelChildManager#create}.
+   *
+   * @typedef {Object} CategoryCreateChannelOptions
+   * @property {string} name The name for the new channel
+   * @property {ChannelType} [type=ChannelType.GuildText] The type of the new channel.
+   * @property {string} [topic] The topic for the new channel
+   * @property {boolean} [nsfw] Whether the new channel is NSFW
+   * @property {number} [bitrate] Bitrate of the new channel in bits (only voice)
+   * @property {number} [userLimit] Maximum amount of users allowed in the new channel (only voice)
+   * @property {OverwriteResolvable[]|Collection<Snowflake, OverwriteResolvable>} [permissionOverwrites]
+   * Permission overwrites of the new channel
+   * @property {number} [position] Position of the new channel
+   * @property {number} [rateLimitPerUser] The rate limit per user (slowmode) for the new channel in seconds
+   * @property {string} [rtcRegion] The specific region of the new channel.
+   * @property {VideoQualityMode} [videoQualityMode] The camera video quality mode of the voice channel
+   * @property {number} [defaultThreadRateLimitPerUser] The initial rate limit per user (slowmode)
+   * to set on newly created threads in a channel.
+   * @property {GuildForumTagData[]} [availableTags] The tags that can be used in this channel (forum only).
+   * @property {DefaultReactionEmoji} [defaultReactionEmoji]
+   * The emoji to show in the add reaction button on a thread in a guild forum channel.
+   * @property {ThreadAutoArchiveDuration} [defaultAutoArchiveDuration]
+   * The default auto archive duration for all new threads in this channel
+   * @property {SortOrderType} [defaultSortOrder] The default sort order mode used to order posts (forum only).
+   * @property {ForumLayoutType} [defaultForumLayout] The default layout used to display posts (forum only).
+   * @property {string} [reason] Reason for creating the new channel
+   */
+
+  /**
+   * Creates a new channel within this category.
+   * <info>You cannot create a channel of type {@link ChannelType.GuildCategory} inside a CategoryChannel.</info>
+   *
+   * @param {CategoryCreateChannelOptions} options Options for creating the new channel
+   * @returns {Promise<GuildChannel>}
+   */
+  async create(options) {
+    return this.guild.channels.create({
+      ...options,
+      parent: this.channel.id,
+    });
+  }
+}

package/src/managers/ChannelManager.ts

@@ -0,0 +1,194 @@
+import process from 'node:process';
+import { lazy, isFileBodyEncodable, isJSONEncodable  } from '@ovencord/util';
+import { Routes  } from 'discord-api-types/v10';
+import { BaseChannel  } from '../structures/BaseChannel.js';
+import { MessagePayload  } from '../structures/MessagePayload.js';
+import { createChannel  } from '../util/Channels.js';
+import { ThreadChannelTypes  } from '../util/Constants.js';
+import { Events  } from '../util/Events.js';
+import { CachedManager  } from './CachedManager.js';
+
+const getMessage = lazy(() => require('../structures/Message.js').Message);
+
+let cacheWarningEmitted = false;
+
+/**
+ * A manager of channels belonging to a client
+ *
+ * @extends {CachedManager}
+ */
+export class ChannelManager extends CachedManager {
+  public client: any;
+  constructor(client, iterable) {
+    super(client, BaseChannel, iterable);
+    const defaultCaching =
+      this._cache.constructor.name === 'Collection' ||
+      this._cache.maxSize === undefined ||
+      this._cache.maxSize === Infinity;
+    if (!cacheWarningEmitted && !defaultCaching) {
+      cacheWarningEmitted = true;
+      process.emitWarning(
+        `Overriding the cache handling for ${this.constructor.name} is unsupported and breaks functionality.`,
+        'UnsupportedCacheOverwriteWarning',
+      );
+    }
+  }
+
+  /**
+   * The cache of Channels
+   *
+   * @type {Collection<Snowflake, BaseChannel>}
+   * @name ChannelManager#cache
+   */
+
+  _add(data, guild, { cache = true, allowUnknownGuild = false } = {}) {
+    const existing = this.cache.get(data.id);
+    if (existing) {
+      if (cache) existing._patch(data);
+      guild?.channels?._add(existing);
+      if (ThreadChannelTypes.includes(existing.type)) {
+        existing.parent?.threads?._add(existing);
+      }
+
+      return existing;
+    }
+
+    const channel = createChannel(this.client, data, guild, { allowUnknownGuild });
+
+    if (!channel) {
+      this.client.emit(Events.Debug, `Failed to find guild, or unknown type for channel ${data.id} ${data.type}`);
+      return null;
+    }
+
+    if (cache && !allowUnknownGuild) this.cache.set(channel.id, channel);
+
+    return channel;
+  }
+
+  _remove(id) {
+    const channel = this.cache.get(id);
+    channel?.guild?.channels.cache.delete(id);
+
+    for (const [code, invite] of channel?.guild?.invites.cache ?? []) {
+      if (invite.channelId === id) channel.guild.invites.cache.delete(code);
+    }
+
+    channel?.parent?.threads?.cache.delete(id);
+    this.cache.delete(id);
+
+    if (channel?.threads) {
+      for (const threadId of channel.threads.cache.keys()) {
+        this.cache.delete(threadId);
+        channel.guild?.channels.cache.delete(threadId);
+      }
+    }
+  }
+
+  /**
+   * Data that can be resolved to give a Channel object. This can be:
+   * - A Channel object
+   * - A Snowflake
+   *
+   * @typedef {BaseChannel|Snowflake} ChannelResolvable
+   */
+
+  /**
+   * Resolves a ChannelResolvable to a Channel object.
+   *
+   * @method resolve
+   * @memberof ChannelManager
+   * @instance
+   * @param {ChannelResolvable} channel The channel resolvable to resolve
+   * @returns {?BaseChannel}
+   */
+
+  /**
+   * Resolves a ChannelResolvable to a channel id string.
+   *
+   * @method resolveId
+   * @memberof ChannelManager
+   * @instance
+   * @param {ChannelResolvable} channel The channel resolvable to resolve
+   * @returns {?Snowflake}
+   */
+
+  /**
+   * Options for fetching a channel from Discord
+   *
+   * @typedef {BaseFetchOptions} FetchChannelOptions
+   * @property {boolean} [allowUnknownGuild=false] Allows the channel to be returned even if the guild is not in cache,
+   * it will not be cached. <warn>Many of the properties and methods on the returned channel will throw errors</warn>
+   */
+
+  /**
+   * Obtains a channel from Discord, or the channel cache if it's already available.
+   *
+   * @param {Snowflake} id The channel's id
+   * @param {FetchChannelOptions} [options] Additional options for this fetch
+   * @returns {Promise<?BaseChannel>}
+   * @example
+   * // Fetch a channel by its id
+   * client.channels.fetch('222109930545610754')
+   *   .then(channel => console.log(channel.name))
+   *   .catch(console.error);
+   */
+  async fetch(id, { allowUnknownGuild = false, cache = true, force = false } = {}) {
+    if (!force) {
+      const existing = this.cache.get(id);
+      if (existing && !existing.partial) return existing;
+    }
+
+    const data = await this.client.rest.get(Routes.channel(id));
+    return this._add(data, null, { cache, allowUnknownGuild });
+  }
+
+  /**
+   * Creates a message in a channel.
+   *
+   * @param {TextChannelResolvable} channel The channel to send the message to
+   * @param {string|MessagePayload|MessageCreateOptions|JSONEncodable<RESTPostAPIChannelMessageJSONBody>|FileBodyEncodable<RESTPostAPIChannelMessageJSONBody>} options The options to provide
+   * @returns {Promise<Message>}
+   * @example
+   * // Send a basic message
+   * client.channels.createMessage(channel, 'hello!')
+   *   .then(message => console.log(`Sent message: ${message.content}`))
+   *   .catch(console.error);
+   * @example
+   * // Send a remote file
+   * client.channels.createMessage(channel, {
+   *   files: ['https://github.com/discordjs.png']
+   * })
+   *   .then(console.log)
+   *   .catch(console.error);
+   * @example
+   * // Send a local file
+   * client.channels.createMessage(channel, {
+   *   files: [{
+   *     attachment: 'entire/path/to/file.jpg',
+   *     name: 'file.jpg',
+   *     description: 'A description of the file'
+   *   }]
+   * })
+   *   .then(console.log)
+   *   .catch(console.error);
+   */
+  async createMessage(channel, options) {
+    let payload;
+
+    if (options instanceof MessagePayload) {
+      payload = await options.resolveBody().resolveFiles();
+    } else if (isFileBodyEncodable(options)) {
+      payload = options.toFileBody();
+    } else if (isJSONEncodable(options)) {
+      payload = { body: options.toJSON() };
+    } else {
+      payload = await MessagePayload.create(this, options).resolveBody().resolveFiles();
+    }
+
+    const resolvedChannelId = this.resolveId(channel);
+    const resolvedChannel = this.resolve(channel);
+    const data = await this.client.rest.post(Routes.channelMessages(resolvedChannelId), payload);
+
+    return resolvedChannel?.messages._add(data) ?? new (getMessage())(this.client, data);
+  }
+}

package/src/managers/DMMessageManager.ts

@@ -0,0 +1,15 @@
+import { MessageManager  } from './MessageManager.js';
+
+/**
+ * Manages API methods for messages in direct message channels and holds their cache.
+ *
+ * @extends {MessageManager}
+ */
+export class DMMessageManager extends MessageManager {
+  /**
+   * The channel that the messages belong to
+   *
+   * @name DMMessageManager#channel
+   * @type {DMChannel}
+   */
+}