@stonyx/discord 0.1.1-beta.55 → 0.1.1-beta.56

package/README.md

@@ -241,10 +241,10 @@ const guild = await bot.getGuild();
 
 ### clearChannelMessages(channelId)
 
-Delete all fetched messages in a channel (up to `maxMessagesPerRequest`).
+Delete all fetched messages in a channel (up to `maxMessagesPerRequest`). Awaits every delete via `Promise.allSettled` and resolves with a structured `{ deleted, failed, errors }` so callers can act on partial failure. Never throws on individual delete failures; emits a single `log.warn` summary when any deletes fail.
 
 ```javascript
-await bot.clearChannelMessages('123456789');
+const { deleted, failed, errors } = await bot.clearChannelMessages('123456789');
 ```
 
 ### giveRole(memberId, roleId)
@@ -297,7 +297,7 @@ Configuration is read from `stonyx/config` under `discord`:
 | `getChannelMessages(channelId, options?)` | Fetch channel messages |
 | `getChannelMessage(channelId, messageId)` | Fetch a single message |
 | `getGuild(guildId?)` | Fetch a guild |
-| `clearChannelMessages(channelId)` | Delete messages in a channel |
+| `clearChannelMessages(channelId)` | Delete messages in a channel; returns `{ deleted, failed, errors }` and never throws on partial failure |
 | `giveRole(memberId, roleId)` | Add a role to a member |
 | `close()` | Destroy the Discord client and clear singleton |
 | `reset()` | Close + clear all commands and handlers |

package/dist/bot.d.ts

@@ -1,5 +1,10 @@
 import { Client } from 'discord.js';
 import type { ChatInputCommandInteraction, Message } from 'discord.js';
+export interface ClearChannelMessagesResult {
+    deleted: number;
+    failed: number;
+    errors: Error[];
+}
 interface CommandInstance {
     data?: {
         name: string;
@@ -36,7 +41,7 @@ export default class DiscordBot {
     getChannelMessages(channelId: string, options?: Record<string, unknown>): Promise<unknown>;
     getChannelMessage(channelId: string, messageId: string): Promise<unknown>;
     getGuild(guildId?: string): Promise<unknown>;
-    clearChannelMessages(channelId: string): Promise<unknown[]>;
+    clearChannelMessages(channelId: string): Promise<ClearChannelMessagesResult>;
     giveRole(memberId: string, roleId: string): Promise<void>;
     close(): void;
     reset(): void;

package/dist/bot.js

@@ -186,10 +186,20 @@ export default class DiscordBot {
         return await this.client.guilds.fetch(guildId || config.discord.serverId || '');
     }
     async clearChannelMessages(channelId) {
-        const promises = [];
         const messages = await this.getChannelMessages(channelId);
-        messages.forEach(message => promises.push(message.delete()));
-        return Promise.all(promises);
+        const settled = await Promise.allSettled([...messages.values()].map(m => m.delete()));
+        const errors = settled
+            .filter((s) => s.status === 'rejected')
+            .map(s => s.reason instanceof Error ? s.reason : new Error(String(s.reason)));
+        const result = {
+            deleted: settled.length - errors.length,
+            failed: errors.length,
+            errors,
+        };
+        if (result.failed > 0) {
+            log.warn(`clearChannelMessages partial failure on channel ${channelId}: deleted=${result.deleted} failed=${result.failed} errors=${errors.map(String).join('; ')}`);
+        }
+        return result;
     }
     async giveRole(memberId, roleId) {
         const guild = await this.getGuild();

package/package.json

@@ -4,7 +4,7 @@
     "stonyx-async",
     "stonyx-module"
   ],
-  "version": "0.1.1-beta.55",
+  "version": "0.1.1-beta.56",
   "description": "Discord bot module for the Stonyx framework",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",