@stonyx/discord 0.1.1-beta.136 → 0.1.1-beta.138

package/README.md

@@ -11,7 +11,7 @@ Discord bot module for the [Stonyx framework](https://github.com/abofs/stonyx),
 * **Command auto-discovery:** Drop command files into a directory and the framework registers them automatically.
 * **Event handler auto-discovery:** Same pattern for Discord gateway events.
 * **Intent auto-derivation:** Required intents computed from discovered event handlers.
-* **Lazy initialization:** Bot only starts if a token is configured and commands/events exist.
+* **Token-gated start:** The bot logs in only when a token is configured. With a token and no commands or events, it still logs in, so a send-only bot works.
 * **Singleton pattern:** Matches conventions of `@stonyx/sockets` and `@stonyx/events`.
 * **Utility methods:** sendMessage, reply with auto-chunking, role management, and more.
 
@@ -23,6 +23,8 @@ pnpm install @stonyx/discord
 
 ## Quick Start
 
+The examples below are complete files: each one imports only from `@stonyx/discord` subpaths, so it runs in an app that depends on nothing but `@stonyx/discord`. The repo's `test/sample/` directory holds a command and an event handler written the same way ([source](https://github.com/abofs/stonyx-discord/tree/dev/test/sample)), and the test suite loads them on every run.
+
 ### 1. Create handler directories
 
 ```
@@ -36,8 +38,8 @@ discord-events/         # default directory (configurable)
 
 ```javascript
 // discord-commands/ping.js
-import { SlashCommandBuilder } from 'discord.js';
-import { Command } from '@stonyx/discord';
+import { SlashCommandBuilder } from '@stonyx/discord/base';
+import Command from '@stonyx/discord/command';
 
 export default class PingCommand extends Command {
   data = new SlashCommandBuilder()
@@ -54,14 +56,14 @@ export default class PingCommand extends Command {
 
 ```javascript
 // discord-events/message-create.js
-import { EventHandler } from '@stonyx/discord';
+import EventHandler from '@stonyx/discord/event-handler';
 
 export default class MessageCreateHandler extends EventHandler {
   static event = 'messageCreate';
 
-  handle(message) {
+  async handle(message) {
     if (message.author.bot) return;
-    console.log(`${message.author.username}: ${message.content}`);
+    if (message.content === '!ping') await message.reply('pong');
   }
 }
 ```
@@ -74,7 +76,18 @@ Stonyx auto-initializes the bot when your app boots — no manual wiring needed:
 stonyx serve
 ```
 
-`Discord.init()` (called by the Stonyx module loader) awaits `new DiscordBot().init()`, which discovers commands/events, derives intents, and connects to the gateway. The lazy-init guards still apply: if `DISCORD_TOKEN` is unset or no commands/events exist, the bot skips login.
+`Discord.init()` (called by the Stonyx module loader) awaits `new DiscordBot().init()`, which discovers commands/events, derives intents, and connects to the gateway. If `DISCORD_TOKEN` is unset, the bot skips login. With a token it always logs in, even when no commands or events exist.
+
+## Exports
+
+| Import | Provides |
+|--------|----------|
+| `@stonyx/discord` | `Discord` (default) — the Stonyx module entry point; no named exports |
+| `@stonyx/discord/bot` | `DiscordBot` (default) — the bot singleton and its utility methods |
+| `@stonyx/discord/command` | `Command` (default) — base class for slash commands |
+| `@stonyx/discord/event-handler` | `EventHandler` (default) — base class for gateway event handlers |
+| `@stonyx/discord/message` | `chunkMessage` — message chunking helper |
+| `@stonyx/discord/base` | Re-exports of common discord.js classes (`SlashCommandBuilder`, `Client`, `GatewayIntentBits`, `Partials`, ...) |
 
 ## Command Architecture
 
@@ -148,7 +161,7 @@ The framework automatically computes the required intents from your registered e
 | `voiceStateUpdate` | `GuildVoiceStates` |
 | `interactionCreate` | *(none — handled by default)* |
 
-**`Guilds` is always included** when commands are registered.
+**`Guilds` is always included**, whether or not any commands or events are registered.
 
 ### Intent-to-Partial Mapping
 
@@ -174,7 +187,7 @@ Values are resolved against `GatewayIntentBits` and `Partials` enums from discor
 
 ## Utility Methods
 
-All methods are on the `DiscordBot` instance (accessible via `this._bot` in commands/handlers or `new DiscordBot()`).
+All methods are on the `DiscordBot` instance (accessible via `this._bot` in commands/handlers, or `new DiscordBot()` after `import DiscordBot from '@stonyx/discord/bot'`).
 
 ### sendMessage(content, channelId, imagePath?)
 

package/package.json

@@ -4,7 +4,7 @@
     "stonyx-async",
     "stonyx-module"
   ],
-  "version": "0.1.1-beta.136",
+  "version": "0.1.1-beta.138",
   "description": "Discord bot module for the Stonyx framework",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",
@@ -64,13 +64,13 @@
     "stonyx": ">=0.2.3-beta.4"
   },
   "devDependencies": {
-    "@stonyx/utils": "0.2.3-beta.27",
+    "@stonyx/utils": "0.2.3-beta.28",
     "@types/node": "^25.5.2",
     "@types/qunit": "^2.19.13",
     "@types/sinon": "^21.0.1",
     "qunit": "^2.24.1",
     "sinon": "^21.0.0",
-    "stonyx": "0.2.3-beta.100",
+    "stonyx": "0.2.3-beta.101",
     "tsx": "^4.21.0",
     "typescript": "^5.8.3"
   },