Lint

djs-core check scans your src/**/*.ts files for patterns that break Discord APIs or fight the framework. It ships with @djs-core/dev — no extra install.

Quick start

1. Add a script

   {
     "scripts": {
       "check": "djs-core check"
     }
   }

2. Run the linter

   bun run check
   # or
   djs-core check

3. Auto-fix what you can

   djs-core check --fix

CLI options

# Lint another folder
djs-core check --path ./my-bot

# Only check ephemeral usage
djs-core check --rule no-ephemeral

# Fix deprecated constructors
djs-core check --fix --rule no-generic-constructor

Exit codes

• 0 — no errors (warnings alone are OK)
• 1 — at least one error severity issue, or unknown --rule name

Warnings never fail the command on their own. Handy for CI: block on errors, tolerate warnings while you migrate.

Rules

no-ephemeral

Discord.js deprecated ephemeral: true. Use MessageFlags instead.

// bad
await interaction.reply({ content: "secret", ephemeral: true });

// good
import { MessageFlags } from "discord.js";

await interaction.reply({
  content: "secret",
  flags: [MessageFlags.Ephemeral],
});

--fix rewrites the property and adds the MessageFlags import when missing.

no-generic-constructor

Component data types belong on .withData<T>(), not on the constructor.

Applies to: Button, Modal, StringSelectMenu, UserSelectMenu, RoleSelectMenu, ChannelSelectMenu, MentionableSelectMenu.

// bad
new Button<{ id: string }>().setCustomId("x").run(...)

// good
new Button().withData<{ id: string }>().setCustomId("x").run(...)

prefer-typed-options

Declare options on the command builder and use the typed options parameter in .run().

// bad
.run(async (interaction) => {
  const name = interaction.options.getString("name", true);
})

// good
.addStringOption((opt) => opt.setName("name").setRequired(true))
.run(async (interaction, options) => {
  const name = options.name; // string
})

No auto-fix — you refactor the handler yourself.

require-description

Every slash command needs a description in Discord.

// bad
export default new Command().run(async (interaction) => { ... });

// good
export default new Command()
  .setDescription("Ping the bot")
  .run(async (interaction) => { ... });

--fix inserts .setDescription("TODO: add a description") so you fill in the real text later.

CI

djs-core check

Add it next to bun test in your pipeline. Use --fix locally, not in CI — let the job fail so you see what broke.