@stonyx/discord 0.1.1-alpha.16 → 0.1.1-alpha.18

package/README.md

@@ -180,6 +180,15 @@ All methods are on the `DiscordBot` instance (accessible via `this._bot` in comm
 
 Send a text message to a channel. Optionally attach an image file.
 
+Messages are delivered reliably across connection state transitions:
+- If the bot is **ready**, the message is sent immediately.
+- If the bot is **connecting or disconnected**, the message is queued and auto-delivered when the connection resumes.
+- **Transient failures** (5xx, network errors) are retried up to 3 times with exponential backoff.
+- Queued messages expire after **5 minutes** (TTL) — stale messages are rejected rather than sent late.
+- The queue holds up to **1000** messages; excess messages are rejected with a "queue full" error.
+
+The returned promise resolves when the message is actually delivered or rejects on permanent failure.
+
 ```javascript
 await bot.sendMessage('Hello world', '123456789');
 await bot.sendMessage('Check this out', '123456789', './screenshot.png');
@@ -289,8 +298,8 @@ Configuration is read from `stonyx/config` under `discord`:
 | `commands` | `Object` — registered command instances keyed by name |
 | `eventHandlers` | `Array` — registered event handler instances |
 | `client` | Discord.js `Client` instance (after init) |
-| `ready` | `Promise` — resolves when the bot is connected and ready |
-| `sendMessage(content, channelId, imagePath?)` | Send a message to a channel |
+| `ready` | `Promise` — resolves when the bot is connected and ready; re-pends on gateway disconnects |
+| `sendMessage(content, channelId, imagePath?)` | Send a message to a channel (queues during disconnections, retries transient failures) |
 | `sendFile(file, messageObject)` | Replace a message with a file attachment |
 | `reply(interaction, content)` | Reply with auto-chunking |
 | `updateStatus(name, type?)` | Set bot presence |
@@ -299,8 +308,8 @@ Configuration is read from `stonyx/config` under `discord`:
 | `getGuild(guildId?)` | Fetch a guild |
 | `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 |
+| `close()` | Destroy the Discord client, reject pending queue, clear singleton |
+| `reset()` | Close + clear all commands, handlers, and connection state |
 
 ### Command
 

package/dist/bot.js

@@ -5,6 +5,7 @@ import { forEachFileImport } from '@stonyx/utils/file';
 import { deriveIntents, derivePartials } from './intents.js';
 import { chunkMessage } from './message.js';
 const MAX_RETRIES = 3;
+const MAX_QUEUE_SIZE = 1000;
 const QUEUE_TTL = 300_000; // 5 minutes
 const READY_TIMEOUT = 30_000; // 30 seconds
 const RETRYABLE_NETWORK_CODES = new Set(['ECONNRESET', 'ETIMEDOUT', 'ECONNREFUSED']);
@@ -85,6 +86,8 @@ export default class DiscordBot {
             log.error('Discord session invalidated — rejecting all queued messages');
             const entries = this._queue.splice(0);
             for (const entry of entries) {
+                if (entry.timerId !== null)
+                    clearTimeout(entry.timerId);
                 entry.reject(new Error('Discord session invalidated'));
             }
         });
@@ -177,6 +180,9 @@ export default class DiscordBot {
         return this._enqueue(content, channelId, imagePath);
     }
     _enqueue(content, channelId, imagePath) {
+        if (this._queue.length >= MAX_QUEUE_SIZE) {
+            return Promise.reject(new Error('Message queue full'));
+        }
         return new Promise((resolve, reject) => {
             this._queue.push({
                 content,
@@ -186,10 +192,14 @@ export default class DiscordBot {
                 reject,
                 retries: 0,
                 enqueuedAt: Date.now(),
+                timerId: null,
             });
         });
     }
     _enqueueForRetry(content, channelId, imagePath, retries) {
+        if (this._queue.length >= MAX_QUEUE_SIZE) {
+            return Promise.reject(new Error('Message queue full'));
+        }
         return new Promise((resolve, reject) => {
             const entry = {
                 content,
@@ -199,6 +209,7 @@ export default class DiscordBot {
                 reject,
                 retries,
                 enqueuedAt: Date.now(),
+                timerId: null,
             };
             this._queue.push(entry);
             this._scheduleRetry(entry);
@@ -206,7 +217,8 @@ export default class DiscordBot {
     }
     _scheduleRetry(entry) {
         const backoff = Math.min(1000 * Math.pow(2, entry.retries) + Math.floor(Math.random() * 500), 30000);
-        setTimeout(() => {
+        entry.timerId = setTimeout(() => {
+            entry.timerId = null;
             // Only process if the entry is still in the queue (wasn't rejected by close/invalidated)
             const idx = this._queue.indexOf(entry);
             if (idx === -1)
@@ -373,9 +385,11 @@ export default class DiscordBot {
         await member.roles.add(role);
     }
     close() {
-        // Reject all pending queue entries
+        // Cancel all pending retry timers and reject all queue entries
         const entries = this._queue.splice(0);
         for (const entry of entries) {
+            if (entry.timerId !== null)
+                clearTimeout(entry.timerId);
             entry.reject(new Error('Discord bot closed'));
         }
         if (this.client) {

package/package.json

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