@djs-commands/core

Modern Discord.js command handler — TypeScript-first, Components V2 native, with pluggable persistence.

📘 Full documentation: https://djscommands.deoxy.dev

Install

bun add @djs-commands/core discord.js
# or: pnpm / npm / yarn

discord.js@^14.26 is a peer dependency.

Quick start

import { Client, GatewayIntentBits } from "discord.js";
import { createCommandHandler, defineCommand } from "@djs-commands/core";

const ping = defineCommand({
	name: "ping",
	description: "Replies with pong",
	run: async ({ reply }) => {
		await reply("pong");
	},
});

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

const handler = createCommandHandler({ client, commands: [ping] });
await handler.ready;

await client.login(process.env.DISCORD_TOKEN);

Prefer scaffolding? Run npx create-djs-commands my-bot and you're online in under a minute.

What's in the box

• defineCommand — typed slash + legacy prefix commands with shared CommandRunContext. Docs →
• Validators — built-in ownerOnly / guildOnly / channels / permissions / roles, plus custom Validator functions. Docs →
• Cooldowns — four scopes (perUser / perGuild / perUserPerGuild / global); pluggable CacheAdapter for distributed setups. Docs →
• Plugins — bundle commands and lifecycle hooks; setup/teardown awaited at boot. Docs →
• Storage — generic Storage adapter contract drives guild_prefix, disabled_commands, channel_locks framework models, plus your own. Docs →
• Components V2 — function-form builders (button, container, section, modal, …); pair with @djs-commands/jsx for JSX. Docs →
• fs-autoloader — commandDir autoloads files; hot reloads in dev.

Companion packages

| Package | Purpose | |---|---| | @djs-commands/jsx | Components V2 JSX runtime | | @djs-commands/adapter-drizzle | Drizzle/Postgres Storage | | @djs-commands/adapter-prisma | Prisma Storage | | @djs-commands/adapter-mongoose | Mongoose Storage (v1 continuity path) | | @djs-commands/adapter-redis | Redis CacheAdapter for distributed cooldowns | | create-djs-commands | npx create-djs-commands scaffolding tool |

Migrating from v1?

@d3oxy/[email protected] is preserved at the v1-final-commit git tag and is no longer maintained. Every v1 API has a v2 equivalent — see the v1 → v2 migration guide.

License

MIT · Issues + discussions on GitHub.