@ovencord/discord.js 14.16.3

package/src/util/Events.ts

@@ -0,0 +1,178 @@
+
+/**
+ * @typedef {Object} Events
+ * @property {string} ApplicationCommandPermissionsUpdate applicationCommandPermissionsUpdate
+ * @property {string} AutoModerationActionExecution autoModerationActionExecution
+ * @property {string} AutoModerationRuleCreate autoModerationRuleCreate
+ * @property {string} AutoModerationRuleDelete autoModerationRuleDelete
+ * @property {string} AutoModerationRuleUpdate autoModerationRuleUpdate
+ * @property {string} CacheSweep cacheSweep
+ * @property {string} ChannelCreate channelCreate
+ * @property {string} ChannelDelete channelDelete
+ * @property {string} ChannelPinsUpdate channelPinsUpdate
+ * @property {string} ChannelUpdate channelUpdate
+ * @property {string} ClientReady clientReady
+ * @property {string} Debug debug
+ * @property {string} EntitlementCreate entitlementCreate
+ * @property {string} EntitlementUpdate entitlementUpdate
+ * @property {string} EntitlementDelete entitlementDelete
+ * @property {string} Error error
+ * @property {string} GuildAuditLogEntryCreate guildAuditLogEntryCreate
+ * @property {string} GuildAvailable guildAvailable
+ * @property {string} GuildBanAdd guildBanAdd
+ * @property {string} GuildBanRemove guildBanRemove
+ * @property {string} GuildCreate guildCreate
+ * @property {string} GuildDelete guildDelete
+ * @property {string} GuildEmojiCreate emojiCreate
+ * @property {string} GuildEmojiDelete emojiDelete
+ * @property {string} GuildEmojiUpdate emojiUpdate
+ * @property {string} GuildIntegrationsUpdate guildIntegrationsUpdate
+ * @property {string} GuildMemberAdd guildMemberAdd
+ * @property {string} GuildMemberAvailable guildMemberAvailable
+ * @property {string} GuildMemberRemove guildMemberRemove
+ * @property {string} GuildMembersChunk guildMembersChunk
+ * @property {string} GuildMemberUpdate guildMemberUpdate
+ * @property {string} GuildRoleCreate roleCreate
+ * @property {string} GuildRoleDelete roleDelete
+ * @property {string} GuildRoleUpdate roleUpdate
+ * @property {string} GuildScheduledEventCreate guildScheduledEventCreate
+ * @property {string} GuildScheduledEventDelete guildScheduledEventDelete
+ * @property {string} GuildScheduledEventUpdate guildScheduledEventUpdate
+ * @property {string} GuildScheduledEventUserAdd guildScheduledEventUserAdd
+ * @property {string} GuildScheduledEventUserRemove guildScheduledEventUserRemove
+ * @property {string} GuildSoundboardSoundCreate guildSoundboardSoundCreate
+ * @property {string} GuildSoundboardSoundDelete guildSoundboardSoundDelete
+ * @property {string} GuildSoundboardSoundsUpdate guildSoundboardSoundsUpdate
+ * @property {string} GuildSoundboardSoundUpdate guildSoundboardSoundUpdate
+ * @property {string} GuildStickerCreate stickerCreate
+ * @property {string} GuildStickerDelete stickerDelete
+ * @property {string} GuildStickerUpdate stickerUpdate
+ * @property {string} GuildUnavailable guildUnavailable
+ * @property {string} GuildUpdate guildUpdate
+ * @property {string} InteractionCreate interactionCreate
+ * @property {string} Invalidated invalidated
+ * @property {string} InviteCreate inviteCreate
+ * @property {string} InviteDelete inviteDelete
+ * @property {string} MessageBulkDelete messageDeleteBulk
+ * @property {string} MessageCreate messageCreate
+ * @property {string} MessageDelete messageDelete
+ * @property {string} MessagePollVoteAdd messagePollVoteAdd
+ * @property {string} MessagePollVoteRemove messagePollVoteRemove
+ * @property {string} MessageReactionAdd messageReactionAdd
+ * @property {string} MessageReactionRemove messageReactionRemove
+ * @property {string} MessageReactionRemoveAll messageReactionRemoveAll
+ * @property {string} MessageReactionRemoveEmoji messageReactionRemoveEmoji
+ * @property {string} MessageUpdate messageUpdate
+ * @property {string} PresenceUpdate presenceUpdate
+ * @property {string} SoundboardSounds soundboardSounds
+ * @property {string} StageInstanceCreate stageInstanceCreate
+ * @property {string} StageInstanceDelete stageInstanceDelete
+ * @property {string} StageInstanceUpdate stageInstanceUpdate
+ * @property {string} SubscriptionCreate subscriptionCreate
+ * @property {string} SubscriptionUpdate subscriptionUpdate
+ * @property {string} SubscriptionDelete subscriptionDelete
+ * @property {string} ThreadCreate threadCreate
+ * @property {string} ThreadDelete threadDelete
+ * @property {string} ThreadListSync threadListSync
+ * @property {string} ThreadMembersUpdate threadMembersUpdate
+ * @property {string} ThreadMemberUpdate threadMemberUpdate
+ * @property {string} ThreadUpdate threadUpdate
+ * @property {string} TypingStart typingStart
+ * @property {string} UserUpdate userUpdate
+ * @property {string} VoiceChannelEffectSend voiceChannelEffectSend
+ * @property {string} VoiceServerUpdate voiceServerUpdate
+ * @property {string} VoiceStateUpdate voiceStateUpdate
+ * @property {string} Warn warn
+ * @property {string} WebhooksUpdate webhooksUpdate
+ */
+
+// JSDoc for IntelliSense purposes
+/**
+ * @type {Events}
+ * @ignore
+ */
+exports.Events = {
+  ApplicationCommandPermissionsUpdate: 'applicationCommandPermissionsUpdate',
+  AutoModerationActionExecution: 'autoModerationActionExecution',
+  AutoModerationRuleCreate: 'autoModerationRuleCreate',
+  AutoModerationRuleDelete: 'autoModerationRuleDelete',
+  AutoModerationRuleUpdate: 'autoModerationRuleUpdate',
+  CacheSweep: 'cacheSweep',
+  ChannelCreate: 'channelCreate',
+  ChannelDelete: 'channelDelete',
+  ChannelPinsUpdate: 'channelPinsUpdate',
+  ChannelUpdate: 'channelUpdate',
+  ClientReady: 'clientReady',
+  Debug: 'debug',
+  EntitlementCreate: 'entitlementCreate',
+  EntitlementDelete: 'entitlementDelete',
+  EntitlementUpdate: 'entitlementUpdate',
+  Error: 'error',
+  GuildAuditLogEntryCreate: 'guildAuditLogEntryCreate',
+  GuildAvailable: 'guildAvailable',
+  GuildBanAdd: 'guildBanAdd',
+  GuildBanRemove: 'guildBanRemove',
+  GuildCreate: 'guildCreate',
+  GuildDelete: 'guildDelete',
+  GuildEmojiCreate: 'emojiCreate',
+  GuildEmojiDelete: 'emojiDelete',
+  GuildEmojiUpdate: 'emojiUpdate',
+  GuildIntegrationsUpdate: 'guildIntegrationsUpdate',
+  GuildMemberAdd: 'guildMemberAdd',
+  GuildMemberAvailable: 'guildMemberAvailable',
+  GuildMemberRemove: 'guildMemberRemove',
+  GuildMembersChunk: 'guildMembersChunk',
+  GuildMemberUpdate: 'guildMemberUpdate',
+  GuildRoleCreate: 'roleCreate',
+  GuildRoleDelete: 'roleDelete',
+  GuildRoleUpdate: 'roleUpdate',
+  GuildScheduledEventCreate: 'guildScheduledEventCreate',
+  GuildScheduledEventDelete: 'guildScheduledEventDelete',
+  GuildScheduledEventUpdate: 'guildScheduledEventUpdate',
+  GuildScheduledEventUserAdd: 'guildScheduledEventUserAdd',
+  GuildScheduledEventUserRemove: 'guildScheduledEventUserRemove',
+  GuildSoundboardSoundCreate: 'guildSoundboardSoundCreate',
+  GuildSoundboardSoundDelete: 'guildSoundboardSoundDelete',
+  GuildSoundboardSoundsUpdate: 'guildSoundboardSoundsUpdate',
+  GuildSoundboardSoundUpdate: 'guildSoundboardSoundUpdate',
+  GuildStickerCreate: 'stickerCreate',
+  GuildStickerDelete: 'stickerDelete',
+  GuildStickerUpdate: 'stickerUpdate',
+  GuildUnavailable: 'guildUnavailable',
+  GuildUpdate: 'guildUpdate',
+  InteractionCreate: 'interactionCreate',
+  Invalidated: 'invalidated',
+  InviteCreate: 'inviteCreate',
+  InviteDelete: 'inviteDelete',
+  MessageBulkDelete: 'messageDeleteBulk',
+  MessageCreate: 'messageCreate',
+  MessageDelete: 'messageDelete',
+  MessagePollVoteAdd: 'messagePollVoteAdd',
+  MessagePollVoteRemove: 'messagePollVoteRemove',
+  MessageReactionAdd: 'messageReactionAdd',
+  MessageReactionRemove: 'messageReactionRemove',
+  MessageReactionRemoveAll: 'messageReactionRemoveAll',
+  MessageReactionRemoveEmoji: 'messageReactionRemoveEmoji',
+  MessageUpdate: 'messageUpdate',
+  PresenceUpdate: 'presenceUpdate',
+  SoundboardSounds: 'soundboardSounds',
+  StageInstanceCreate: 'stageInstanceCreate',
+  StageInstanceDelete: 'stageInstanceDelete',
+  StageInstanceUpdate: 'stageInstanceUpdate',
+  SubscriptionCreate: 'subscriptionCreate',
+  SubscriptionDelete: 'subscriptionDelete',
+  SubscriptionUpdate: 'subscriptionUpdate',
+  ThreadCreate: 'threadCreate',
+  ThreadDelete: 'threadDelete',
+  ThreadListSync: 'threadListSync',
+  ThreadMembersUpdate: 'threadMembersUpdate',
+  ThreadMemberUpdate: 'threadMemberUpdate',
+  ThreadUpdate: 'threadUpdate',
+  TypingStart: 'typingStart',
+  UserUpdate: 'userUpdate',
+  VoiceChannelEffectSend: 'voiceChannelEffectSend',
+  VoiceServerUpdate: 'voiceServerUpdate',
+  VoiceStateUpdate: 'voiceStateUpdate',
+  Warn: 'warn',
+  WebhooksUpdate: 'webhooksUpdate',
+};

package/src/util/GuildMemberFlagsBitField.ts

@@ -0,0 +1,43 @@
+/* eslint-disable jsdoc/check-values */
+
+import { GuildMemberFlags  } from 'discord-api-types/v10';
+import { BitField  } from './BitField.js';
+
+/**
+ * Data structure that makes it easy to interact with a {@link GuildMember#flags} bitfield.
+ *
+ * @extends {BitField}
+ */
+export class GuildMemberFlagsBitField extends BitField {
+  /**
+   * Numeric guild member flags.
+   *
+   * @type {GuildMemberFlags}
+   * @memberof GuildMemberFlagsBitField
+   */
+  static Flags = GuildMemberFlags;
+}
+
+/**
+ * @name GuildMemberFlagsBitField
+ * @kind constructor
+ * @memberof GuildMemberFlagsBitField
+ * @param {BitFieldResolvable} [bits=0] Bit(s) to read from
+ */
+
+/**
+ * Bitfield of the packed bits
+ *
+ * @type {number}
+ * @name GuildMemberFlagsBitField#bitfield
+ */
+
+/**
+ * Data that can be resolved to give a guild member flag bitfield. This can be:
+ * - A string (see {@link GuildMemberFlagsBitField.Flags})
+ * - A guild member flag
+ * - An instance of GuildMemberFlagsBitField
+ * - An Array of GuildMemberFlagsResolvable
+ *
+ * @typedef {string|number|GuildMemberFlagsBitField|GuildMemberFlagsResolvable[]} GuildMemberFlagsResolvable
+ */

package/src/util/IntentsBitField.ts

@@ -0,0 +1,35 @@
+/* eslint-disable jsdoc/check-values */
+import { GatewayIntentBits  } from 'discord-api-types/v10';
+import { BitField  } from './BitField.js';
+
+/**
+ * Data structure that makes it easy to calculate intents.
+ *
+ * @extends {BitField}
+ */
+export class IntentsBitField extends BitField {
+  /**
+   * Numeric WebSocket intents
+   *
+   * @type {GatewayIntentBits}
+   * @memberof IntentsBitField
+   */
+  static Flags = GatewayIntentBits;
+}
+
+/**
+ * @name IntentsBitField
+ * @kind constructor
+ * @memberof IntentsBitField
+ * @param {IntentsResolvable} [bits=0] Bit(s) to read from
+ */
+
+/**
+ * Data that can be resolved to give a permission number. This can be:
+ * - A string (see {@link IntentsBitField.Flags})
+ * - An intents flag
+ * - An instance of {@link IntentsBitField}
+ * - An array of IntentsResolvable
+ *
+ * @typedef {string|number|IntentsBitField|IntentsResolvable[]} IntentsResolvable
+ */

package/src/util/InviteFlagsBitField.ts

@@ -0,0 +1,26 @@
+/* eslint-disable jsdoc/check-values */
+
+import { InviteFlags  } from 'discord-api-types/v10';
+import { BitField  } from './BitField.js';
+
+/**
+ * Data structure that makes it easy to interact with a {@link GuildInvite#flags} bit field.
+ *
+ * @extends {BitField}
+ */
+export class InviteFlagsBitField extends BitField {
+  /**
+   * Numeric invite flags.
+   *
+   * @type {InviteFlags}
+   * @memberof InviteFlagsBitField
+   */
+  static Flags = InviteFlags;
+}
+
+/**
+ * @name InviteFlagsBitField
+ * @kind constructor
+ * @memberof InviteFlagsBitField
+ * @param {BitFieldResolvable} [bits=0] Bit(s) to read from
+ */

package/src/util/Invites.ts

@@ -0,0 +1,27 @@
+import { InviteType  } from 'discord-api-types/v10';
+import { BaseInvite  } from '../structures/BaseInvite.js';
+import { GroupDMInvite  } from '../structures/GroupDMInvite.js';
+import { GuildInvite  } from '../structures/GuildInvite.js';
+
+/**
+ * Any invite.
+ *
+ * @typedef {GuildInvite|GroupDMInvite} Invite
+ */
+
+const InviteTypeToClass = {
+  [InviteType.Guild]: GuildInvite,
+  [InviteType.GroupDM]: GroupDMInvite,
+};
+
+/**
+ * Creates an invite.
+ *
+ * @param {Client} client The client
+ * @param {Object} data The data
+ * @returns {BaseInvite}
+ * @ignore
+ */
+export function createInvite(client, data) {
+  return new (InviteTypeToClass[data.type] ?? BaseInvite)(client, data);
+}

package/src/util/LimitedCollection.ts

@@ -0,0 +1,73 @@
+import { Collection  } from '@ovencord/collection';
+import { DiscordjsTypeError, ErrorCodes  } from '../errors/index.js';
+
+/**
+ * Options for defining the behavior of a LimitedCollection
+ *
+ * @typedef {Object} LimitedCollectionOptions
+ * @property {?number} [maxSize=Infinity] The maximum size of the Collection
+ * @property {?Function} [keepOverLimit=null] A function, which is passed the value and key of an entry, ran to decide
+ * to keep an entry past the maximum size
+ */
+
+/**
+ * A Collection which holds a max amount of entries.
+ *
+ * @extends {Collection}
+ * @param {LimitedCollectionOptions} [options={}] Options for constructing the Collection.
+ * @param {Iterable} [iterable=null] Optional entries passed to the Map constructor.
+ */
+export class LimitedCollection extends Collection {
+  public maxSize: any;
+  public keepOverLimit: any;
+  constructor(options = {}, iterable = undefined) {
+    if (typeof options !== 'object' || options === null) {
+      throw new DiscordjsTypeError(ErrorCodes.InvalidType, 'options', 'object', true);
+    }
+
+    const { maxSize = Infinity, keepOverLimit = null } = options;
+
+    if (typeof maxSize !== 'number') {
+      throw new DiscordjsTypeError(ErrorCodes.InvalidType, 'maxSize', 'number');
+    }
+
+    if (keepOverLimit !== null && typeof keepOverLimit !== 'function') {
+      throw new DiscordjsTypeError(ErrorCodes.InvalidType, 'keepOverLimit', 'function');
+    }
+
+    super(iterable);
+
+    /**
+     * The max size of the Collection.
+     *
+     * @type {number}
+     */
+    this.maxSize = maxSize;
+
+    /**
+     * A function called to check if an entry should be kept when the Collection is at max size.
+     *
+     * @type {?Function}
+     */
+    this.keepOverLimit = keepOverLimit;
+  }
+
+  set(key, value) {
+    if (this.maxSize === 0 && !this.keepOverLimit?.(value, key, this)) return this;
+    if (this.size >= this.maxSize && !this.has(key)) {
+      for (const [iteratedKey, iteratedValue] of this.entries()) {
+        const keep = this.keepOverLimit?.(iteratedValue, iteratedKey, this) ?? false;
+        if (!keep) {
+          this.delete(iteratedKey);
+          break;
+        }
+      }
+    }
+
+    return super.set(key, value);
+  }
+
+  static get [Symbol.species]() {
+    return Collection;
+  }
+}

package/src/util/MessageFlagsBitField.ts

@@ -0,0 +1,43 @@
+/* eslint-disable jsdoc/check-values */
+
+import { MessageFlags  } from 'discord-api-types/v10';
+import { BitField  } from './BitField.js';
+
+/**
+ * Data structure that makes it easy to interact with a {@link Message#flags} bitfield.
+ *
+ * @extends {BitField}
+ */
+export class MessageFlagsBitField extends BitField {
+  /**
+   * Numeric message flags.
+   *
+   * @type {MessageFlags}
+   * @memberof MessageFlagsBitField
+   */
+  static Flags = MessageFlags;
+}
+
+/**
+ * @name MessageFlagsBitField
+ * @kind constructor
+ * @memberof MessageFlagsBitField
+ * @param {BitFieldResolvable} [bits=0] Bit(s) to read from
+ */
+
+/**
+ * Data that can be resolved to give a message flags bit field. This can be:
+ * - A string (see {@link MessageFlagsBitField.Flags})
+ * - A message flag
+ * - An instance of {@link MessageFlagsBitField}
+ * - An array of `MessageFlagsResolvable`
+ *
+ * @typedef {string|number|MessageFlagsBitField|MessageFlagsResolvable[]} MessageFlagsResolvable
+ */
+
+/**
+ * Bitfield of the packed bits
+ *
+ * @type {number}
+ * @name MessageFlagsBitField#bitfield
+ */

package/src/util/Options.ts

@@ -0,0 +1,215 @@
+import { DefaultRestOptions, DefaultUserAgentAppendix  } from '@ovencord/rest';
+import { DefaultWebSocketManagerOptions  } from '@ovencord/ws';
+import { version  } from '../../package.json.js';
+import { toSnakeCase  } from './Transformers.js';
+
+/**
+ * @typedef {Object} CacheFactoryParams
+ * @property {Function} holds The class that the cache will hold.
+ * @property {Function} manager The fully extended manager class the cache is being requested from.
+ * @property {Function} managerType The base manager class the cache is being requested from.
+ */
+
+/**
+ * @typedef {Function} CacheFactory
+ * @param {CacheFactoryParams} params The parameters
+ * @returns {Collection} A Collection used to store the cache of the manager.
+ */
+
+/**
+ * Options for a client.
+ *
+ * @typedef {Object} ClientOptions
+ * @property {number} [closeTimeout=5_000] The amount of time in milliseconds to wait for the close frame to be received
+ * from the WebSocket. Don't have this too high/low. It's best to have it between 2_000-6_000 ms.
+ * @property {CacheFactory} [makeCache] Function to create a cache.
+ * You can use your own function, or the {@link Options} class to customize the Collection used for the cache.
+ * <warn>Overriding the cache used in `GuildManager`, `ChannelManager`, `GuildChannelManager`, `RoleManager`,
+ * and `PermissionOverwriteManager` is unsupported and **will** break functionality</warn>
+ * @property {MessageMentionOptions} [allowedMentions] The default value for {@link BaseMessageOptions#allowedMentions}
+ * @property {Partials[]} [partials] Structures allowed to be partial. This means events can be emitted even when
+ * they're missing all the data for a particular structure. See the "Partial Structures" topic on the
+ * {@link https://discordjs.guide/popular-topics/partials.html guide} for some
+ * important usage information, as partials require you to put checks in place when handling data.
+ * @property {boolean} [failIfNotExists=true] The default value for {@link MessageReplyOptions#failIfNotExists}
+ * @property {PresenceData} [presence] Presence data to use upon login
+ * @property {IntentsResolvable} intents Intents to enable for this connection
+ * @property {number} [waitGuildTimeout=15_000] Time in milliseconds that clients with the
+ * {@link GatewayIntentBits.Guilds} gateway intent should wait for missing guilds to be received before being ready.
+ * @property {SweeperOptions} [sweepers=this.DefaultSweeperSettings] Options for cache sweeping
+ * @property {WebSocketManagerOptions} [ws] Options for the WebSocketManager
+ * @property {RESTOptions} [rest] Options for the REST manager
+ * @property {Function} [jsonTransformer] A function used to transform outgoing json data
+ * @property {boolean} [enforceNonce=false] The default value for {@link MessageCreateOptions#enforceNonce}
+ */
+
+/**
+ * Options for {@link Sweepers} defining the behavior of cache sweeping
+ *
+ * @typedef {Object<SweeperKey, SweepOptions>} SweeperOptions
+ */
+
+/**
+ * Options for sweeping a single type of item from cache
+ *
+ * @typedef {Object} SweepOptions
+ * @property {number} interval The interval (in seconds) at which to perform sweeping of the item
+ * @property {number} [lifetime] How long an item should stay in cache until it is considered sweepable.
+ * <warn>This property is only valid for the `invites`, `messages`, and `threads` keys. The `filter` property
+ * is mutually exclusive to this property and takes priority</warn>
+ * @property {GlobalSweepFilter} filter The function used to determine the function passed to the sweep method
+ * <info>This property is optional when the key is `invites`, `messages`, or `threads` and `lifetime` is set</info>
+ */
+
+/**
+ * Contains various utilities for client options.
+ */
+export class Options extends null {
+  /**
+   * The default user agent appendix.
+   *
+   * @type {string}
+   * @memberof Options
+   * @private
+   */
+  static userAgentAppendix = `discord.js/${version} ${DefaultUserAgentAppendix}`.trimEnd();
+
+  /**
+   * The default client options.
+   *
+   * @returns {ClientOptions}
+   */
+  static createDefault() {
+    return {
+      closeTimeout: 5_000,
+      waitGuildTimeout: 15_000,
+      makeCache: this.cacheWithLimits(this.DefaultMakeCacheSettings),
+      partials: [],
+      failIfNotExists: true,
+      enforceNonce: false,
+      sweepers: this.DefaultSweeperSettings,
+      ws: {
+        ...DefaultWebSocketManagerOptions,
+        largeThreshold: 50,
+        version: 10,
+      },
+      rest: {
+        ...DefaultRestOptions,
+        userAgentAppendix: this.userAgentAppendix,
+      },
+      jsonTransformer: toSnakeCase,
+    };
+  }
+
+  /**
+   * Create a cache factory using predefined settings to sweep or limit.
+   *
+   * @param {Object<string, LimitedCollectionOptions|number>} [settings={}] Settings passed to the relevant constructor.
+   * If no setting is provided for a manager, it uses Collection.
+   * If a number is provided for a manager, it uses that number as the max size for a LimitedCollection.
+   * If LimitedCollectionOptions are provided for a manager, it uses those settings to form a LimitedCollection.
+   * @returns {CacheFactory}
+   * @example
+   * // Store up to 200 messages per channel and 200 members per guild, always keeping the client member.
+   * Options.cacheWithLimits({
+   *    MessageManager: 200,
+   *    GuildMemberManager: {
+   *      maxSize: 200,
+   *      keepOverLimit: (member) => member.id === client.user.id,
+   *    },
+   *  });
+   */
+  static cacheWithLimits(settings = {}) {
+    import { Collection  } from '@ovencord/collection';
+    import { LimitedCollection  } from './LimitedCollection.js';
+
+    return ({ managerType, manager }) => {
+      const setting = settings[manager.name] ?? settings[managerType.name];
+      /* eslint-disable-next-line eqeqeq */
+      if (setting == null) {
+        return new Collection();
+      }
+
+      if (typeof setting === 'number') {
+        if (setting === Infinity) {
+          return new Collection();
+        }
+
+        return new LimitedCollection({ maxSize: setting });
+      }
+
+      /* eslint-disable-next-line eqeqeq */
+      const noLimit = setting.maxSize == null || setting.maxSize === Infinity;
+      if (noLimit) {
+        return new Collection();
+      }
+
+      return new LimitedCollection(setting);
+    };
+  }
+
+  /**
+   * Create a cache factory that always caches everything.
+   *
+   * @returns {CacheFactory}
+   */
+  static cacheEverything() {
+    import { Collection  } from '@ovencord/collection';
+    return () => new Collection();
+  }
+
+  /**
+   * The default settings passed to {@link ClientOptions.makeCache}.
+   * The caches that this changes are:
+   * - `MessageManager` - Limit to 200 messages
+   * <info>If you want to keep default behavior and add on top of it you can use this object and add on to it, e.g.
+   * `makeCache: Options.cacheWithLimits({ ...Options.DefaultMakeCacheSettings, ReactionManager: 0 })`</info>
+   *
+   * @type {Object<string, LimitedCollectionOptions|number>}
+   */
+  static get DefaultMakeCacheSettings() {
+    return {
+      MessageManager: 200,
+    };
+  }
+
+  /**
+   * The default settings passed to {@link ClientOptions.sweepers}.
+   * The sweepers that this changes are:
+   * - `threads` - Sweep archived threads every hour, removing those archived more than 4 hours ago
+   * <info>If you want to keep default behavior and add on top of it you can use this object and add on to it, e.g.
+   * `sweepers: { ...Options.DefaultSweeperSettings, messages: { interval: 300, lifetime: 600 } }`</info>
+   *
+   * @type {SweeperOptions}
+   */
+  static get DefaultSweeperSettings() {
+    return {
+      threads: {
+        interval: 3_600,
+        lifetime: 14_400,
+      },
+    };
+  }
+}
+
+
+
+/**
+ * @external RESTOptions
+ * @see {@link https://discord.js.org/docs/packages/rest/stable/RESTOptions:Interface}
+ */
+
+/**
+ * @external WebSocketManager
+ * @see {@link https://discord.js.org/docs/packages/ws/stable/WebSocketManager:Class}
+ */
+
+/**
+ * @external IShardingStrategy
+ * @see {@link https://discord.js.org/docs/packages/ws/stable/IShardingStrategy:Interface}
+ */
+
+/**
+ * @external IIdentifyThrottler
+ * @see {@link https://discord.js.org/docs/packages/ws/stable/IIdentifyThrottler:Interface}
+ */