meocord 4.1.0 → 4.1.2

package/dist/cli.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "meocordVersion": "4.1.0",
+  "meocordVersion": "4.1.2",
   "name": "meocord",
   "description": "CLI for managing the MeoCord application",
   "usage": "[options] [command]",

package/dist/esm/common/deprecation.js

@@ -8,10 +8,16 @@ const warned = new Set();
  */ function warnDeprecatedBehaviour(logger, old, outcome, replacement) {
     warnOnce(logger, `${old} is deprecated; in the next major version (5.0) it ${outcome}. Use ${replacement} instead.`);
 }
+/**
+ * Warns once per run that a mock reads `value` as a placeholder where discord.js computes it, saying what 5.0 gives
+ * and how to set it.
+ */ function warnPlaceholder(logger, value, outcome, how) {
+    warnOnce(logger, `${value} reads a placeholder here; in the next major version (5.0) ${outcome}. ${how}`);
+}
 function warnOnce(logger, text) {
     if (warned.has(text)) return;
     warned.add(text);
     logger.warn(text);
 }
 
-export { warnDeprecated, warnDeprecatedBehaviour };
+export { warnDeprecated, warnDeprecatedBehaviour, warnPlaceholder };

package/dist/esm/package.json.js

@@ -1,4 +1,4 @@
-var version = "4.1.0";
+var version = "4.1.2";
 var engines = {
 	node: ">=22.13"
 };

package/dist/esm/testing/discord-defaults.js

@@ -1,6 +1,7 @@
-import { GuildPremiumTier, GuildVerificationLevel, GuildNSFWLevel, Locale, Guild, ClientUser, User, GuildMember, PermissionsBitField, Role, MessageType, Message, CommandInteraction, AutocompleteInteraction, BaseInteraction, ChannelType, TextChannel, NewsChannel, VoiceChannel, ForumChannel, MediaChannel, ThreadChannel, DMChannel, GuildChannel, BaseChannel, Client, SnowflakeUtil } from 'discord.js';
-import { memberRoles, createMockUser } from './mock-interaction.js';
+import { GuildPremiumTier, GuildVerificationLevel, GuildNSFWLevel, Locale, Guild, ClientUser, User, GuildMember, Role, Collection, MessageType, Message, CommandInteraction, AutocompleteInteraction, GuildChannel, BaseInteraction, ChannelType, TextChannel, NewsChannel, VoiceChannel, ForumChannel, MediaChannel, ThreadChannel, DMChannel, BaseChannel, Client, BaseGuild, SnowflakeUtil, PermissionsBitField } from 'discord.js';
+import { memberRoles, createMockUser, createMockGuild } from './mock-interaction.js';
 
+/** A permission set with none, frozen as discord.js freezes the ones it gives. */ const noPermissions = ()=>new PermissionsBitField().freeze();
 /** A property discord.js computes from the others: its own getter runs, reading the mock's values. */ const REAL_GETTER = Symbol('real getter');
 const snowflake = ()=>SnowflakeUtil.generate().toString();
 /** A class and its defaults, typed together so a default that stops fitting its property fails to compile. */ const defaultsOf = (Class, defaults)=>[
@@ -44,6 +45,7 @@ const snowflake = ()=>SnowflakeUtil.generate().toString();
         system: ()=>false,
         tag: REAL_GETTER,
         displayName: REAL_GETTER,
+        defaultAvatarURL: REAL_GETTER,
         createdTimestamp: REAL_GETTER,
         createdAt: REAL_GETTER
     }),
@@ -52,7 +54,12 @@ const snowflake = ()=>SnowflakeUtil.generate().toString();
         id: REAL_GETTER,
         nickname: ()=>null,
         avatar: ()=>null,
-        joinedTimestamp: ()=>null,
+        // In the server since the mock was made, as a member Discord sends always is
+        joinedTimestamp: ()=>Date.now(),
+        joinedAt: REAL_GETTER,
+        partial: REAL_GETTER,
+        premiumSince: REAL_GETTER,
+        communicationDisabledUntil: REAL_GETTER,
         premiumSinceTimestamp: ()=>null,
         communicationDisabledUntilTimestamp: ()=>null,
         pending: ()=>false,
@@ -65,7 +72,24 @@ const snowflake = ()=>SnowflakeUtil.generate().toString();
         name: ()=>'role',
         // Above @everyone, which a server's role manager makes at position 0
         position: ()=>1,
-        permissions: ()=>new PermissionsBitField().freeze()
+        // Every role has a server; one made without is in one of its own, unless a guild given it takes it in
+        guild: ()=>createMockGuild(),
+        rawPosition: (role)=>role.position,
+        permissions: noPermissions,
+        hoist: ()=>false,
+        managed: ()=>false,
+        mentionable: ()=>false,
+        icon: ()=>null,
+        unicodeEmoji: ()=>null,
+        tags: ()=>null,
+        colors: ()=>({
+                primaryColor: 0,
+                secondaryColor: null,
+                tertiaryColor: null
+            }),
+        hexColor: REAL_GETTER,
+        createdTimestamp: REAL_GETTER,
+        createdAt: REAL_GETTER
     }),
     // A message's text says which handler it is for, so it stays the test's to give, as a command's name does
     defaultsOf(Message, {
@@ -78,6 +102,10 @@ const snowflake = ()=>SnowflakeUtil.generate().toString();
         nonce: ()=>null,
         position: ()=>null,
         activity: ()=>null,
+        reference: ()=>null,
+        poll: ()=>null,
+        interactionMetadata: ()=>null,
+        stickers: ()=>new Collection(),
         url: REAL_GETTER
     }),
     // A command's name and a component's customId say which handler a call is for, so they stay the test's to give
@@ -95,7 +123,13 @@ const snowflake = ()=>SnowflakeUtil.generate().toString();
         version: ()=>1,
         context: ()=>null,
         // What Discord sends with an interaction in a server, the member's permissions there; typed for a cached one
-        memberPermissions: (interaction)=>interaction.guildId && interaction.member instanceof GuildMember ? interaction.member.permissions : null
+        memberPermissions: (interaction)=>interaction.guildId && interaction.member instanceof GuildMember ? interaction.member.permissions : null,
+        // The bot's permissions where the interaction was made: its member's in the channel, or none outside a server
+        appPermissions: (interaction)=>{
+            const { guild, channel } = interaction;
+            const me = guild instanceof Guild ? guild.members.me : null;
+            return (me && channel instanceof GuildChannel ? channel.permissionsFor(me) : null) ?? noPermissions();
+        }
     }),
     defaultsOf(TextChannel, {
         type: ()=>ChannelType.GuildText,
@@ -142,8 +176,12 @@ const snowflake = ()=>SnowflakeUtil.generate().toString();
     }),
     defaultsOf(Client, {
         readyTimestamp: ()=>Date.now(),
+        readyAt: REAL_GETTER,
         uptime: REAL_GETTER,
         token: ()=>null
+    }),
+    defaultsOf(BaseGuild, {
+        nameAcronym: REAL_GETTER
     })
 ]);
 /** The default a mock of `target`'s class has for `key`, read from the nearest class that has one. */ function discordDefault(target, key) {

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

@@ -1,12 +1,8 @@
 // Framework-agnostic mock function, so `meocord/testing` depends on neither jest nor vitest.
 // Both detect it through `_isMockFunction` and read `fn.mock.calls` in their assertions.
+// Each call signature of `T`, up to four, as a union: `Parameters` and `ReturnType` read only an overloaded function's
+// last signature, such as the list form of a manager's `fetch`
 /**
- * One call's outcome, as a mock function records it: the value it returned, or the error it threw.
- *
- * @group Testing
- * @category Mocks
- * @see {@link MockState}
- */ /**
  * Tells whether a value is a mock function: one from `meocord/testing`, `jest.fn()` or `vi.fn()`.
  *
  * Use it in a helper that takes mocks and real functions alike, such as one that sets a default on every mock method.