Skip to main content

General

Why is my client not starting?

Check these common issues:
  1. Missing configuration - Ensure required options are set:
  1. Invalid token - Verify your Discord token is correct and not expired.
  2. Missing intents - Discord requires specific intents:
  1. Network issues - Check your internet connection and firewall settings.

How do I enable debug mode?

Set the debug option to true:
Or use an environment variable:
Debug mode outputs detailed logs including:
  • API request/response details
  • Database queries
  • Event emissions
  • Internal state changes

Can I extend the event system?

Yes, you can create custom events:
You can also create typed events with TypeScript:

Installation

What Node.js version is required?

Sorionlib requires Node.js 16.0.0 or higher. Check your version:

How do I update Sorionlib?

Or install a specific version:

Are there any peer dependencies?

No, Sorionlib bundles all required dependencies. However, for Discord functionality, you may want to install discord.js for additional features:

API client

How do I handle rate limiting?

The API client handles rate limiting automatically with retries. You can customize the behavior:

How do I add custom headers to all requests?

How do I handle file uploads?

Database

How do I connect to multiple databases?

Create multiple instances:

How do I handle connection failures?

Listen to connection events:

Discord

How do I register slash commands?

How do I handle button interactions?

How do I create embeds?

Troubleshooting

I’m getting “Cannot find module ‘sorionlib’”

Ensure Sorionlib is installed:
Check your import statement matches your module system:

TypeScript types are not working

Ensure you have TypeScript 4.5 or higher:
Types are included in the package, no @types package needed.

Memory usage is high

  1. Close unused connections:
  1. Clear caches:
  1. Use streaming for large datasets: