meocord 1.8.0 → 1.8.2

package/dist/cjs/testing/index.cjs

@@ -361,12 +361,70 @@ function findPrototypeMethod(instance, name) {
 // Convenience wrappers for common discord.js classes
 // ---------------------------------------------------------------------------
 /** Creates a mock {@link User}. All methods are auto-stubbed as `jest.fn()`. */ const createMockUser = ()=>createMockInteraction(discord_js.User);
-/** Creates a mock {@link Client}. Managers like `client.users` are nested stubs. */ const createMockClient = ()=>createMockInteraction(discord_js.Client);
-/** Creates a mock {@link Guild}. Managers like `guild.members` are nested stubs. */ const createMockGuild = ()=>createMockInteraction(discord_js.Guild);
+/**
+ * Creates a mock {@link Client}.
+ *
+ * Manager methods that are constructor-assigned (not on the prototype) are
+ * pre-initialized as `jest.fn()` so they work out of the box without manual
+ * setup: `users.fetch`, `channels.fetch`, `guilds.fetch`, and
+ * `application.commands.fetch`.
+ */ function createMockClient() {
+    const instance = Object.create(discord_js.Client.prototype);
+    // Manager properties are constructor-assigned — pre-initialize as prototype-based
+    // stubs so ALL manager methods (not just fetch) are auto-stubbed as jest.fn().
+    const appInstance = Object.create(null);
+    appInstance.commands = stubDeep(Object.create(discord_js.ApplicationCommandManager.prototype));
+    instance.users = stubDeep(Object.create(discord_js.UserManager.prototype));
+    instance.channels = stubDeep(Object.create(discord_js.ChannelManager.prototype));
+    instance.guilds = stubDeep(Object.create(discord_js.GuildManager.prototype));
+    instance.user = stubDeep(Object.create(discord_js.ClientUser.prototype));
+    instance.application = stubDeep(appInstance);
+    return stubDeep(instance);
+}
+/**
+ * Creates a mock {@link Guild}.
+ *
+ * Manager properties are constructor-assigned in discord.js. This factory
+ * pre-initializes each as a prototype-based stub so all methods are
+ * auto-stubbed as `jest.fn()`.
+ *
+ * Pre-initialized: `members`, `channels`, `roles`, `bans`.
+ */ function createMockGuild() {
+    const instance = Object.create(discord_js.Guild.prototype);
+    instance.members = stubDeep(Object.create(discord_js.GuildMemberManager.prototype));
+    instance.channels = stubDeep(Object.create(discord_js.GuildChannelManager.prototype));
+    instance.roles = stubDeep(Object.create(discord_js.RoleManager.prototype));
+    instance.bans = stubDeep(Object.create(discord_js.GuildBanManager.prototype));
+    return stubDeep(instance);
+}
 /**
  * Creates a mock channel of the given class (e.g. `TextChannel`, `DMChannel`).
- * All methods are auto-stubbed as `jest.fn()`.
- */ const createMockChannel = (Class)=>createMockInteraction(Class);
+ *
+ * Manager properties that are constructor-assigned in discord.js are
+ * pre-initialized as prototype-based stubs so all methods are auto-stubbed
+ * as `jest.fn()`:
+ * - Guild text channels (`TextChannel`, `NewsChannel`): `messages`, `threads`
+ * - `DMChannel`: `messages`
+ * - `ThreadChannel`: `messages`, `members`
+ */ function createMockChannel(Class) {
+    const instance = Object.create(Class.prototype);
+    // Guild text channels (TextChannel, NewsChannel) — messages & threads
+    // assigned in BaseGuildTextChannel constructor
+    if ('messages' in Class.prototype || Class.name === 'TextChannel' || Class.name === 'NewsChannel') {
+        instance.messages = stubDeep(Object.create(discord_js.GuildMessageManager.prototype));
+        instance.threads = stubDeep(Object.create(discord_js.ThreadManager.prototype));
+    }
+    // DMChannel — messages assigned in DMChannel constructor
+    if (Class.name === 'DMChannel') {
+        instance.messages = stubDeep(Object.create(discord_js.DMMessageManager.prototype));
+    }
+    // ThreadChannel — messages & members assigned in ThreadChannel constructor
+    if (Class.name === 'ThreadChannel') {
+        instance.messages = stubDeep(Object.create(discord_js.MessageManager.prototype));
+        instance.members = stubDeep(Object.create(discord_js.ThreadMemberManager.prototype));
+    }
+    return stubDeep(instance);
+}
 /**
  * Creates a smart mock {@link Message}.
  *
@@ -374,14 +432,54 @@ function findPrototypeMethod(instance, name) {
  * `pin()`, and `unpin()` throw if the message has already been deleted.
  * `edit()` and `reply()` resolve to a new mock `Message` instance.
  *
+ * Constructor-assigned and getter properties are pre-initialized as
+ * prototype-based stubs so `msg.author.send`, `msg.member.fetch`,
+ * `msg.channel.send`, `msg.guild.members.fetch`, `msg.thread.fetch`,
+ * and `msg.mentions.has` all work out of the box.
+ *
  * All methods remain `jest.fn()` — overridable per test.
  *
  * Note: `createMockInteraction`'s `followUp()` and `editReply()` stubs return
  * a `createMockMessage()` by default, matching the official return types.
- */ function createMockMessage() {
+ */ /**
+ * Internal guild stub for use inside createMockMessage.
+ * Reuses the same manager stubs as createMockGuild but avoids
+ * a circular reference in the module.
+ */ function createMockGuildForMessage() {
+    const guild = Object.create(discord_js.Guild.prototype);
+    guild.members = stubDeep(Object.create(discord_js.GuildMemberManager.prototype));
+    guild.channels = stubDeep(Object.create(discord_js.GuildChannelManager.prototype));
+    guild.roles = stubDeep(Object.create(discord_js.RoleManager.prototype));
+    guild.bans = stubDeep(Object.create(discord_js.GuildBanManager.prototype));
+    return stubDeep(guild);
+}
+function createMockMessage() {
     const instance = Object.create(discord_js.Message.prototype);
     const stubs = new Map();
     instance.deleted = false;
+    // Constructor-assigned — set as prototype-based stubs
+    instance.author = stubDeep(Object.create(discord_js.User.prototype));
+    // Getters on the prototype — the proxy sees them as functions and returns
+    // jest.fn(), which is wrong. Pre-initialize as own properties to shadow
+    // the prototype getters.
+    Object.defineProperty(instance, 'member', {
+        value: stubDeep(Object.create(discord_js.GuildMember.prototype)),
+        writable: true
+    });
+    Object.defineProperty(instance, 'channel', {
+        value: stubDeep(Object.create(discord_js.TextChannel.prototype)),
+        writable: true
+    });
+    Object.defineProperty(instance, 'guild', {
+        value: createMockGuildForMessage(),
+        writable: true
+    });
+    Object.defineProperty(instance, 'thread', {
+        value: stubDeep(Object.create(discord_js.ThreadChannel.prototype)),
+        writable: true
+    });
+    // MessageMentions — constructor-assigned, has methods like .has(), .members
+    instance.mentions = stubDeep(Object.create(discord_js.MessageMentions.prototype));
     const alreadyDeleted = ()=>new Error('This message has already been deleted.');
     stubs.set('delete', globals.jest.fn(async ()=>{
         if (instance.deleted) throw alreadyDeleted();

package/dist/esm/testing/mock-interaction.js

@@ -1,6 +1,6 @@
 import 'reflect-metadata';
 import { jest } from '@jest/globals';
-import { InteractionType, ComponentType, ApplicationCommandType, CommandInteractionOptionResolver, Message, User, Client, Guild } from 'discord.js';
+import { InteractionType, ComponentType, ApplicationCommandType, CommandInteractionOptionResolver, GuildMessageManager, ThreadManager, DMMessageManager, MessageManager, ThreadMemberManager, Client, ApplicationCommandManager, UserManager, ChannelManager, GuildManager, ClientUser, Guild, GuildMemberManager, GuildChannelManager, RoleManager, GuildBanManager, Message, User, GuildMember, TextChannel, ThreadChannel, MessageMentions } from 'discord.js';
 
 // ---------------------------------------------------------------------------
 // stubDeep — Proxy that auto-creates jest.fn() on any property access
@@ -250,12 +250,70 @@ function findPrototypeMethod(instance, name) {
 // Convenience wrappers for common discord.js classes
 // ---------------------------------------------------------------------------
 /** Creates a mock {@link User}. All methods are auto-stubbed as `jest.fn()`. */ const createMockUser = ()=>createMockInteraction(User);
-/** Creates a mock {@link Client}. Managers like `client.users` are nested stubs. */ const createMockClient = ()=>createMockInteraction(Client);
-/** Creates a mock {@link Guild}. Managers like `guild.members` are nested stubs. */ const createMockGuild = ()=>createMockInteraction(Guild);
+/**
+ * Creates a mock {@link Client}.
+ *
+ * Manager methods that are constructor-assigned (not on the prototype) are
+ * pre-initialized as `jest.fn()` so they work out of the box without manual
+ * setup: `users.fetch`, `channels.fetch`, `guilds.fetch`, and
+ * `application.commands.fetch`.
+ */ function createMockClient() {
+    const instance = Object.create(Client.prototype);
+    // Manager properties are constructor-assigned — pre-initialize as prototype-based
+    // stubs so ALL manager methods (not just fetch) are auto-stubbed as jest.fn().
+    const appInstance = Object.create(null);
+    appInstance.commands = stubDeep(Object.create(ApplicationCommandManager.prototype));
+    instance.users = stubDeep(Object.create(UserManager.prototype));
+    instance.channels = stubDeep(Object.create(ChannelManager.prototype));
+    instance.guilds = stubDeep(Object.create(GuildManager.prototype));
+    instance.user = stubDeep(Object.create(ClientUser.prototype));
+    instance.application = stubDeep(appInstance);
+    return stubDeep(instance);
+}
+/**
+ * Creates a mock {@link Guild}.
+ *
+ * Manager properties are constructor-assigned in discord.js. This factory
+ * pre-initializes each as a prototype-based stub so all methods are
+ * auto-stubbed as `jest.fn()`.
+ *
+ * Pre-initialized: `members`, `channels`, `roles`, `bans`.
+ */ function createMockGuild() {
+    const instance = Object.create(Guild.prototype);
+    instance.members = stubDeep(Object.create(GuildMemberManager.prototype));
+    instance.channels = stubDeep(Object.create(GuildChannelManager.prototype));
+    instance.roles = stubDeep(Object.create(RoleManager.prototype));
+    instance.bans = stubDeep(Object.create(GuildBanManager.prototype));
+    return stubDeep(instance);
+}
 /**
  * Creates a mock channel of the given class (e.g. `TextChannel`, `DMChannel`).
- * All methods are auto-stubbed as `jest.fn()`.
- */ const createMockChannel = (Class)=>createMockInteraction(Class);
+ *
+ * Manager properties that are constructor-assigned in discord.js are
+ * pre-initialized as prototype-based stubs so all methods are auto-stubbed
+ * as `jest.fn()`:
+ * - Guild text channels (`TextChannel`, `NewsChannel`): `messages`, `threads`
+ * - `DMChannel`: `messages`
+ * - `ThreadChannel`: `messages`, `members`
+ */ function createMockChannel(Class) {
+    const instance = Object.create(Class.prototype);
+    // Guild text channels (TextChannel, NewsChannel) — messages & threads
+    // assigned in BaseGuildTextChannel constructor
+    if ('messages' in Class.prototype || Class.name === 'TextChannel' || Class.name === 'NewsChannel') {
+        instance.messages = stubDeep(Object.create(GuildMessageManager.prototype));
+        instance.threads = stubDeep(Object.create(ThreadManager.prototype));
+    }
+    // DMChannel — messages assigned in DMChannel constructor
+    if (Class.name === 'DMChannel') {
+        instance.messages = stubDeep(Object.create(DMMessageManager.prototype));
+    }
+    // ThreadChannel — messages & members assigned in ThreadChannel constructor
+    if (Class.name === 'ThreadChannel') {
+        instance.messages = stubDeep(Object.create(MessageManager.prototype));
+        instance.members = stubDeep(Object.create(ThreadMemberManager.prototype));
+    }
+    return stubDeep(instance);
+}
 /**
  * Creates a smart mock {@link Message}.
  *
@@ -263,14 +321,54 @@ function findPrototypeMethod(instance, name) {
  * `pin()`, and `unpin()` throw if the message has already been deleted.
  * `edit()` and `reply()` resolve to a new mock `Message` instance.
  *
+ * Constructor-assigned and getter properties are pre-initialized as
+ * prototype-based stubs so `msg.author.send`, `msg.member.fetch`,
+ * `msg.channel.send`, `msg.guild.members.fetch`, `msg.thread.fetch`,
+ * and `msg.mentions.has` all work out of the box.
+ *
  * All methods remain `jest.fn()` — overridable per test.
  *
  * Note: `createMockInteraction`'s `followUp()` and `editReply()` stubs return
  * a `createMockMessage()` by default, matching the official return types.
- */ function createMockMessage() {
+ */ /**
+ * Internal guild stub for use inside createMockMessage.
+ * Reuses the same manager stubs as createMockGuild but avoids
+ * a circular reference in the module.
+ */ function createMockGuildForMessage() {
+    const guild = Object.create(Guild.prototype);
+    guild.members = stubDeep(Object.create(GuildMemberManager.prototype));
+    guild.channels = stubDeep(Object.create(GuildChannelManager.prototype));
+    guild.roles = stubDeep(Object.create(RoleManager.prototype));
+    guild.bans = stubDeep(Object.create(GuildBanManager.prototype));
+    return stubDeep(guild);
+}
+function createMockMessage() {
     const instance = Object.create(Message.prototype);
     const stubs = new Map();
     instance.deleted = false;
+    // Constructor-assigned — set as prototype-based stubs
+    instance.author = stubDeep(Object.create(User.prototype));
+    // Getters on the prototype — the proxy sees them as functions and returns
+    // jest.fn(), which is wrong. Pre-initialize as own properties to shadow
+    // the prototype getters.
+    Object.defineProperty(instance, 'member', {
+        value: stubDeep(Object.create(GuildMember.prototype)),
+        writable: true
+    });
+    Object.defineProperty(instance, 'channel', {
+        value: stubDeep(Object.create(TextChannel.prototype)),
+        writable: true
+    });
+    Object.defineProperty(instance, 'guild', {
+        value: createMockGuildForMessage(),
+        writable: true
+    });
+    Object.defineProperty(instance, 'thread', {
+        value: stubDeep(Object.create(ThreadChannel.prototype)),
+        writable: true
+    });
+    // MessageMentions — constructor-assigned, has methods like .has(), .members
+    instance.mentions = stubDeep(Object.create(MessageMentions.prototype));
     const alreadyDeleted = ()=>new Error('This message has already been deleted.');
     stubs.set('delete', jest.fn(async ()=>{
         if (instance.deleted) throw alreadyDeleted();

package/dist/types/testing/index.d.ts

@@ -117,27 +117,36 @@ interface InteractionClass<T> {
 declare function createMockInteraction<T extends object>(Class: InteractionClass<T>): DeepMocked<T>;
 /** Creates a mock {@link User}. All methods are auto-stubbed as `jest.fn()`. */
 declare const createMockUser: () => DeepMocked<User>;
-/** Creates a mock {@link Client}. Managers like `client.users` are nested stubs. */
-declare const createMockClient: () => DeepMocked<Client>;
-/** Creates a mock {@link Guild}. Managers like `guild.members` are nested stubs. */
-declare const createMockGuild: () => DeepMocked<Guild>;
 /**
- * Creates a mock channel of the given class (e.g. `TextChannel`, `DMChannel`).
- * All methods are auto-stubbed as `jest.fn()`.
+ * Creates a mock {@link Client}.
+ *
+ * Manager methods that are constructor-assigned (not on the prototype) are
+ * pre-initialized as `jest.fn()` so they work out of the box without manual
+ * setup: `users.fetch`, `channels.fetch`, `guilds.fetch`, and
+ * `application.commands.fetch`.
  */
-declare const createMockChannel: <T extends Channel>(Class: InteractionClass<T>) => DeepMocked<T>;
+declare function createMockClient(): DeepMocked<Client>;
 /**
- * Creates a smart mock {@link Message}.
+ * Creates a mock {@link Guild}.
  *
- * Tracks a `deleted` boolean. `delete()`, `edit()`, `reply()`, `react()`,
- * `pin()`, and `unpin()` throw if the message has already been deleted.
- * `edit()` and `reply()` resolve to a new mock `Message` instance.
+ * Manager properties are constructor-assigned in discord.js. This factory
+ * pre-initializes each as a prototype-based stub so all methods are
+ * auto-stubbed as `jest.fn()`.
  *
- * All methods remain `jest.fn()` — overridable per test.
+ * Pre-initialized: `members`, `channels`, `roles`, `bans`.
+ */
+declare function createMockGuild(): DeepMocked<Guild>;
+/**
+ * Creates a mock channel of the given class (e.g. `TextChannel`, `DMChannel`).
  *
- * Note: `createMockInteraction`'s `followUp()` and `editReply()` stubs return
- * a `createMockMessage()` by default, matching the official return types.
+ * Manager properties that are constructor-assigned in discord.js are
+ * pre-initialized as prototype-based stubs so all methods are auto-stubbed
+ * as `jest.fn()`:
+ * - Guild text channels (`TextChannel`, `NewsChannel`): `messages`, `threads`
+ * - `DMChannel`: `messages`
+ * - `ThreadChannel`: `messages`, `members`
  */
+declare function createMockChannel<T extends Channel>(Class: InteractionClass<T>): DeepMocked<T>;
 declare function createMockMessage(): DeepMocked<Message>;
 interface ChatInputOptions {
     subcommandGroup?: string | null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "meocord",
   "description": "Decorator-based Discord bot framework built on discord.js. Brings NestJS-style controllers, dependency injection, guards, and testing utilities to bot development — with a full CLI and TypeScript-first design.",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "type": "module",
   "scripts": {
     "lint": "eslint --fix . && tsc --noEmit && tsc --noEmit --project tsconfig.test.json",