SeedcordErrorCode

One or more configured emojis could not be resolved at startup.

A webhook reporter's env var is set but fails webhook URL validation.

A configured webhook does not exist on Discord (deleted, or a wrong id or token).

The generated route manifest was imported before seedcord build generated it.

A required environment variable is not present.

An environment variable is present and fails validation.

A command usable in a guild is registered without the Guilds intent that caches guilds.

The running Node or Bun version is below the range seedcord declares for it in engines.

DISCORD_BOT_TOKEN passed its shape check and carries no readable application id.

An edge config sets a REST sweeper interval.

Attempted to add lifecycle tasks after startup already completed.

Attempted to add lifecycle tasks while startup is still running.

Attempted to remove lifecycle tasks while startup is still running.

Provided lifecycle phase identifier is not recognized.

Startup phase completed with one or more task failures.

A lifecycle task exceeded its configured timeout.

A host whose startup failed was started again.

The configured shutdown deadline is zero, negative, or not finite.

Multiple Seedcord instances were created simultaneously.

Plugins cannot be mutated after the core has finished initializing.

A plugin tried to register with a key that already exists.

Bot role lookup failed within the provided guild.

A bot controller was constructed without its required handlers directory.

A file in a scanned directory threw while being imported.

A scanned directory could not be read.

A plugin was attached under a key the framework logs on.

The application id was read before startup resolved it.

A generated accessor was read before startup resolved its values.

A startup or shutdown task was added to a core built by createSeedcord.

emit was called on the bus. It reaches listeners and skips every subscriber.

A command decorator passed 'config' while commands.guilds is empty.

Discord refused the command deploy for one guild.

A plugin was attached under a group name the bot already uses.

A plugin was attached at a name that holds a group of plugins.

A plugin key is empty, has an empty part, or carries more than one dot.

An attached plugin doesn't extend the Plugin class of the bot's @seedcord/core.

A command decorator attempted to re-register an existing command scope.

A global command decorator specified guild IDs, which is not allowed.

A guild command decorator omitted the required guild ID list.

Middleware priority provided by the decorator was not a finite number.

A WebhookLog subclass is missing its @WebhookUrl decorator.

A middleware decorator was given an empty filter array.

Two interaction handlers registered the same route within a scope.

Two different middleware classes share a class name.

A manifest array lists a class that does not extend the base for that array.

A manifest array lists a class whose decorator is missing. Nothing registered.

A reply method was called in an ack state where it is illegal.

A reply component failed to serialize to raw API data.

edit() was passed a message the interaction did not send.

update() or deferUpdate() was called on a modal with no source message.

A withResponse interaction callback returned no created message.

A customId definition prefix contains a reserved character (a colon or a control char).

A customId field name is integer-like, which JS would silently reorder.

A oneOf() or someOf() field was declared with no choices.

An int() field was declared with min greater than max.

A field rejected the value given to encode().

An encoded customId exceeds Discord's 100-character limit.

A field name is declared more than once in the same customId chain.

A component handler is missing the route decorator that matches its base.

match() received a decoded route with no matching arm.

A slash handler's match() has no arm for the command route that fired.

An autocomplete handler's match() has no arm for the focused field that fired.

An event handler's match() has no arm for the event name that fired.

Event middleware read this.eventName but was constructed without a fired event name.

An autocomplete payload carried no focused option.

A context menu handler's match() has no arm for the command name that fired.

No field in the submitted modal carries the requested custom id.

A modal field getter was called on a field of another kind.

Nothing was picked in a modal field read as required.

A channel select field picked a channel outside the types getSelectedChannels() allows.

A customId was minted under an older shape of the same definition.

A customId wire is corrupt, truncated, or was minted by a different definition.

dispatch.require() was called for a key nothing wrote on this dispatch.

A Cooldown gate was given a duration string that is not a well-formed positive duration.

A paginator source was given a perPage that is not a positive integer.

A control row was assembled with more than the five buttons Discord allows.

A control row was assembled with no controls.

A control row repeats the same control, which would collide the custom_ids.

A color value could not be resolved to a Discord color integer.

A resolved color fell outside Discord's 0x000000 to 0xffffff range.

A plugin's constructor rejected its options through rejectOptions.

Two or more plugins threw while disposing.

A plugin declared a lifecycle timeout that is not a positive, finite number of milliseconds.

Mongoose service class is missing the @RegisterMongooseService decorator.

Mongoose client failed to establish a connection.

Mongoose client failed to disconnect cleanly during shutdown.

Mongoose services was accessed before the plugin finished initializing.

Mongoose rejected the model, usually a duplicate model name or an absent schema.

A mongoose service was registered with an empty model name override.

Kysely service class is missing the @RegisterKyselyService decorator.

Kysely service class is missing its table metadata.

Migration manager received an invalid step count.

Migration direction was not recognized.

Provided migrations path could not be resolved.

No migration files were found for execution.

A migration module failed to export the expected functions.

An arbitrary (non-Error) failure was reported by a migration.

Postgres pool failed to close cleanly during shutdown.

Kysely services was accessed before the plugin finished initializing.

Postgres pool failed to establish a connection.

Bootstrapper failed to ensure the target Postgres database exists.

Two listed migration files share a name once their extensions are stripped.

Config file default export was not an object.

Config is missing the required instance string.

Unable to locate a Seedcord config file.

CLI entry file does not exist.

Failed to import a TypeScript entry file.

Native import and jiti fallback both failed.

Seedcord instance export is missing a start() method.

Seedcord instance threw during startup.

Config is missing the required entry string.

Entry file must be inside the configured root directory.

Unable to locate a TypeScript config file for builds.

TypeScript reported diagnostics during emit.

Unable to write the generated bootstrap file.

Two commands resolve to the same slash route during codegen.

The commands directory could not be read during codegen.

Two context-menu commands of the same kind share a name during codegen.

Could not resolve the application from the bot token during commands --clean.

commands --clean ran with neither --guild nor --all-guilds.

commands --clean combined --purge with --all-guilds, which would wipe every guild.

An interactive prompt was cancelled (Ctrl-C), so the command aborts without changes.

commands --clean --all-guilds matched more guilds than the safety threshold without --yes.

commands --clean --apply ran in a non-interactive environment without --yes, where it cannot prompt.

The cloudflared metrics server never reported a quick-tunnel hostname.

Discord rejected the tunnel URL as an interactions endpoint.

The tunnel URL never answered its health probe.

A config field is present with the wrong shape.

A class carrying @RegisterCommand threw while codegen constructed it.

A create prompt was cancelled (Ctrl-C), and nothing has been written yet.

A flag supplied an answer for a question the earlier answers skip.

A flag carried a value its question rejects.

The command line did not parse.

The target path already holds something.

A command the scaffolder shelled out to exited non-zero.