NoveCord Changelog & Release Notes

Version 0.1.1Latest

Released: December 6, 2024

🆕 New Features

Webhook System

Complete Discord webhook implementation with built-in rate limiting and message management.

  • • Send, edit, delete, and fetch webhook messages
  • • Automatic rate limit handling with retry logic
  • • Thread support for organized messaging
  • • Event emitter for 'send', 'rateLimit', and 'error' events
  • • Support for embeds, components, and rich content
  • • Custom username and avatar configuration
Example - Basic Webhook Usage
const { Webhook } = require('novecord');
const webhook = new Webhook('WEBHOOK_ID', 'WEBHOOK_TOKEN', {
username: 'Custom Bot',
avatar_url: 'https://example.com/avatar.png'
});
// Send message with embed
const embed = new Embed()
.setTitle('Server Status')
.setColor(0x00ff00);
await webhook.send({
content: 'Status update:',
embeds: [embed]
});

Throttler System

Request throttling and queue management system for controlling API rate limits.

  • • Limit concurrent operations to prevent rate limiting
  • • Automatic queue management with FIFO processing
  • • Promise-based API for easy integration
  • • Perfect for Discord API and webhook rate limiting
  • • Configurable concurrency limits
Example - API Throttling
const { Throttler } = require('novecord');
const apiThrottler = new Throttler(50); // Max 50 concurrent requests
// Throttle API calls
async function sendMessageThrottled(channelId, content) {
return apiThrottler.enqueue(async () => {
return client.sendMessage(channelId, { content });
});
}
// Send multiple messages safely
for (const message of messages) {
await sendMessageThrottled(channelId, message);
}

🔄 WebSocket Stability Improvements

Heartbeat Acknowledgement Control

Added validation for heartbeat responses from Discord Gateway to detect and handle unhealthy connections.

  • • Every heartbeat message (op 1) now expects a heartbeat ACK response (op 11)
  • • If ACK is not received within the expected interval, connection is considered unhealthy
  • • Prevents "ghost connections" that appear connected but don't respond

Automatic Reconnect Mechanism

Implemented robust reconnection logic with exponential backoff to handle connection drops gracefully.

  • • Automatic reconnection when connection closes or heartbeat ACK fails
  • • Exponential backoff prevents rapid reconnection attempts
  • • Maximum reconnect delay capped at 60 seconds

Session Resume Support

Added session resume capability to continue from where the bot left off after reconnection.

  • • Preserves session_id and sequence number across reconnections
  • • Resumes existing session instead of re-identifying when possible
  • • Reduces Discord API load and improves reconnection speed

🔧 Enhanced Op Code Handling

  • Op 7: Server reconnect request handling
  • Op 9: Session resume request processing
  • Op 11: Heartbeat acknowledgement tracking
  • • Improved connection state management

📦 Installation

npm install novecord@latest

This update brings major new features for webhook management and request throttling.
Your NoveCord bots now have enterprise-grade reliability and rate limit protection.

Version 0.1.0Previous

View 0.1.0 changelog

Components V2 support, interaction fixes, and structure updates...

Version 0.0.9Previous

View 0.0.9 changelog

Previous release with version info API and improved uptime tracking...