@seedcord/errors 0.3.4 → 0.4.0

package/README.md

@@ -1,16 +1,55 @@
-<p align="center">
+<div align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://cdn.seedcord.org/assets/wordmark-dark.webp" />
     <img src="https://cdn.seedcord.org/assets/wordmark-light.webp" alt="seedcord" width="440" />
   </picture>
-</p>
+</div>
 
----
+<div align="center">
+  <h3>The whole Discord bot, wired and typed</h3>
+  <a href="https://seedcord.org">Website</a> ·
+  <a href="https://guide.seedcord.org">Guide</a> ·
+  <a href="https://docs.seedcord.org">Reference</a> ·
+  <a href="https://discord.gg/DzFxY58WXf">Discord</a>
+</div>
 
-_This repository is a work in progress._
+<br />
 
-- There are no stable releases yet but changes are being made actively.
-- Until a major v1.0.0 release for seedcord, expect breaking changes in minor versions.
-- Documentation will come soon as well!
+<div align="center">
 
-If you'd like to try it out, you can check out the code in `mock`
+[![npm](https://img.shields.io/npm/v/@seedcord/errors?style=flat-square&logo=npm&logoColor=c8341f&label=&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/@seedcord/errors) [![node](https://img.shields.io/node/v/@seedcord/errors?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![license](https://img.shields.io/npm/l/@seedcord/errors?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)
+
+</div>
+
+## About
+
+`@seedcord/errors` holds every error seedcord throws. Each one carries a registered code from `SeedcordErrorCode`, so a caller can branch on one specific failure.
+
+Framework code never throws a raw `Error`. A third-party throw may be translated into one of these before you catch it.
+
+Until v1.0.0, minor versions can break.
+
+## Installation
+
+Your transport already re-exports this.
+
+```sh
+pnpm add @seedcord/errors
+```
+
+## Usage
+
+`isSeedcordError` narrows on the class and the code together:
+
+```ts
+import { isSeedcordError, SeedcordErrorCode } from '@seedcord/errors';
+
+try {
+    await run();
+} catch (error) {
+    if (isSeedcordError(error, 'SeedcordError', SeedcordErrorCode.CliCancelled)) return;
+    throw error;
+}
+```
+
+Called with one argument it narrows to any seedcord error.

package/dist/{SeedcordError-B5hcAoT3.mjs → SeedcordError-BLQ8_el7.mjs}

@@ -5,22 +5,18 @@ import chalk from "chalk";
 * All Seedcord error codes.
 */
 let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
-	/** DISCORD_BOT_TOKEN is not present in the environment. */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigMissingDiscordToken"] = 1001] = "ConfigMissingDiscordToken";
-	/** DISCORD_BOT_TOKEN is present but fails validation. */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigIncorrectDiscordToken"] = 1002] = "ConfigIncorrectDiscordToken";
 	/** One or more configured emojis could not be resolved at startup. */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigEmojiUnresolved"] = 1003] = "ConfigEmojiUnresolved";
+	SeedcordErrorCode[SeedcordErrorCode["ConfigEmojiUnresolved"] = 1001] = "ConfigEmojiUnresolved";
 	/** A webhook reporter's env var is set but fails webhook URL validation. */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigWebhookUrlInvalid"] = 1004] = "ConfigWebhookUrlInvalid";
+	SeedcordErrorCode[SeedcordErrorCode["ConfigWebhookUrlInvalid"] = 1002] = "ConfigWebhookUrlInvalid";
 	/** A configured webhook does not exist on Discord (deleted, or a wrong id or token). */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigWebhookNotFound"] = 1005] = "ConfigWebhookNotFound";
-	/** DISCORD_PUBLIC_KEY is not present in the environment. */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigMissingPublicKey"] = 1006] = "ConfigMissingPublicKey";
-	/** DISCORD_PUBLIC_KEY is present but fails validation. */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigIncorrectPublicKey"] = 1007] = "ConfigIncorrectPublicKey";
+	SeedcordErrorCode[SeedcordErrorCode["ConfigWebhookNotFound"] = 1003] = "ConfigWebhookNotFound";
 	/** The generated route manifest was imported before `seedcord build` generated it. */
-	SeedcordErrorCode[SeedcordErrorCode["ConfigManifestNotGenerated"] = 1008] = "ConfigManifestNotGenerated";
+	SeedcordErrorCode[SeedcordErrorCode["ConfigManifestNotGenerated"] = 1004] = "ConfigManifestNotGenerated";
+	/** A required environment variable is not present. */
+	SeedcordErrorCode[SeedcordErrorCode["ConfigMissingEnv"] = 1005] = "ConfigMissingEnv";
+	/** An environment variable is present and fails validation. */
+	SeedcordErrorCode[SeedcordErrorCode["ConfigInvalidEnv"] = 1006] = "ConfigInvalidEnv";
 	/** Attempted to add lifecycle tasks after startup already completed. */
 	SeedcordErrorCode[SeedcordErrorCode["LifecycleAddAfterCompletion"] = 1101] = "LifecycleAddAfterCompletion";
 	/** Attempted to add lifecycle tasks while startup is still running. */
@@ -57,18 +53,16 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["CoreAccessorUnresolved"] = 1210] = "CoreAccessorUnresolved";
 	/** Interaction middleware decorated with disallowed event filters. */
 	SeedcordErrorCode[SeedcordErrorCode["DecoratorInteractionEventFilter"] = 1301] = "DecoratorInteractionEventFilter";
-	/** A decorator could not find the original method being decorated. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorMethodNotFound"] = 1302] = "DecoratorMethodNotFound";
 	/** A command decorator attempted to re-register an existing command scope. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandAlreadyRegistered"] = 1303] = "DecoratorCommandAlreadyRegistered";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandAlreadyRegistered"] = 1302] = "DecoratorCommandAlreadyRegistered";
 	/** A global command decorator specified guild IDs, which is not allowed. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGlobalWithGuilds"] = 1304] = "DecoratorCommandGlobalWithGuilds";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGlobalWithGuilds"] = 1303] = "DecoratorCommandGlobalWithGuilds";
 	/** A guild command decorator omitted the required guild ID list. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGuildWithoutGuilds"] = 1305] = "DecoratorCommandGuildWithoutGuilds";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGuildWithoutGuilds"] = 1304] = "DecoratorCommandGuildWithoutGuilds";
 	/** Middleware priority provided by the decorator was not a finite number. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorInvalidMiddlewarePriority"] = 1306] = "DecoratorInvalidMiddlewarePriority";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorInvalidMiddlewarePriority"] = 1305] = "DecoratorInvalidMiddlewarePriority";
 	/** A WebhookLog subclass is missing its `@WebhookUrl` decorator. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorWebhookUrlMissing"] = 1307] = "DecoratorWebhookUrlMissing";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorWebhookUrlMissing"] = 1306] = "DecoratorWebhookUrlMissing";
 	/** Two interaction handlers registered the same route within a scope. */
 	SeedcordErrorCode[SeedcordErrorCode["InteractionDuplicateRoute"] = 1401] = "InteractionDuplicateRoute";
 	/** Two different interaction middleware classes share a class name. */
@@ -133,6 +127,8 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["ColorOutOfRange"] = 1902] = "ColorOutOfRange";
 	/** A plugin's constructor rejected its options through `rejectOptions`. */
 	SeedcordErrorCode[SeedcordErrorCode["PluginOptionsRejected"] = 2001] = "PluginOptionsRejected";
+	/** Two or more plugins threw while disposing. */
+	SeedcordErrorCode[SeedcordErrorCode["PluginDisposeFailures"] = 2002] = "PluginDisposeFailures";
 	/** Mongoose service class is missing the `@RegisterMongooseService` decorator. */
 	SeedcordErrorCode[SeedcordErrorCode["PluginMongooseServiceDecoratorMissing"] = 2101] = "PluginMongooseServiceDecoratorMissing";
 	/** Mongoose client failed to establish a connection. */
@@ -173,76 +169,54 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidExport"] = 3101] = "CliConfigInvalidExport";
 	/** Config is missing the required instance string. */
 	SeedcordErrorCode[SeedcordErrorCode["CliConfigMissingInstance"] = 3102] = "CliConfigMissingInstance";
-	/** Config root was provided but not a string. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidRoot"] = 3103] = "CliConfigInvalidRoot";
 	/** Unable to locate a Seedcord config file. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigNotFound"] = 3104] = "CliConfigNotFound";
+	SeedcordErrorCode[SeedcordErrorCode["CliConfigNotFound"] = 3103] = "CliConfigNotFound";
 	/** CLI entry file does not exist. */
-	SeedcordErrorCode[SeedcordErrorCode["CliEntryNotFound"] = 3105] = "CliEntryNotFound";
+	SeedcordErrorCode[SeedcordErrorCode["CliEntryNotFound"] = 3104] = "CliEntryNotFound";
 	/** tsx failed to import the provided entry file. */
-	SeedcordErrorCode[SeedcordErrorCode["CliTsxImportFailed"] = 3106] = "CliTsxImportFailed";
+	SeedcordErrorCode[SeedcordErrorCode["CliTsxImportFailed"] = 3105] = "CliTsxImportFailed";
 	/** Native import and jiti fallback both failed. */
-	SeedcordErrorCode[SeedcordErrorCode["CliImportFailed"] = 3107] = "CliImportFailed";
+	SeedcordErrorCode[SeedcordErrorCode["CliImportFailed"] = 3106] = "CliImportFailed";
 	/** Seedcord instance export is missing a start() method. */
-	SeedcordErrorCode[SeedcordErrorCode["CliInstanceInvalid"] = 3108] = "CliInstanceInvalid";
+	SeedcordErrorCode[SeedcordErrorCode["CliInstanceInvalid"] = 3107] = "CliInstanceInvalid";
 	/** Seedcord instance threw during startup. */
-	SeedcordErrorCode[SeedcordErrorCode["CliStartFailed"] = 3109] = "CliStartFailed";
+	SeedcordErrorCode[SeedcordErrorCode["CliStartFailed"] = 3108] = "CliStartFailed";
 	/** Config is missing the required entry string. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigMissingEntry"] = 3110] = "CliConfigMissingEntry";
-	/** Config build options must be an object when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuild"] = 3111] = "CliConfigInvalidBuild";
-	/** Config build outDir must be a string when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuildOutDir"] = 3112] = "CliConfigInvalidBuildOutDir";
-	/** Config build tsconfig must be a string when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuildTsconfig"] = 3113] = "CliConfigInvalidBuildTsconfig";
-	/** Config build bootstrap must be a string when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuildBootstrap"] = 3114] = "CliConfigInvalidBuildBootstrap";
+	SeedcordErrorCode[SeedcordErrorCode["CliConfigMissingEntry"] = 3109] = "CliConfigMissingEntry";
 	/** Entry file must be inside the configured root directory. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigEntryOutsideRoot"] = 3115] = "CliConfigEntryOutsideRoot";
+	SeedcordErrorCode[SeedcordErrorCode["CliConfigEntryOutsideRoot"] = 3110] = "CliConfigEntryOutsideRoot";
 	/** Unable to locate a TypeScript config file for builds. */
-	SeedcordErrorCode[SeedcordErrorCode["CliBuildTsconfigNotFound"] = 3116] = "CliBuildTsconfigNotFound";
+	SeedcordErrorCode[SeedcordErrorCode["CliBuildTsconfigNotFound"] = 3111] = "CliBuildTsconfigNotFound";
 	/** TypeScript reported diagnostics during emit. */
-	SeedcordErrorCode[SeedcordErrorCode["CliBuildFailed"] = 3117] = "CliBuildFailed";
+	SeedcordErrorCode[SeedcordErrorCode["CliBuildFailed"] = 3112] = "CliBuildFailed";
 	/** Unable to write the generated bootstrap file. */
-	SeedcordErrorCode[SeedcordErrorCode["CliBootstrapWriteFailed"] = 3118] = "CliBootstrapWriteFailed";
-	/** Config hmr typecheck tsconfig must be a string when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidTsconfig"] = 3119] = "CliConfigInvalidTsconfig";
-	/** Config hmr options must be an object when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidHmr"] = 3120] = "CliConfigInvalidHmr";
-	/** Config hmr restart patterns must be an array of strings when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidHmrRestart"] = 3121] = "CliConfigInvalidHmrRestart";
+	SeedcordErrorCode[SeedcordErrorCode["CliBootstrapWriteFailed"] = 3113] = "CliBootstrapWriteFailed";
 	/** Two commands resolve to the same slash route during codegen. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCodegenDuplicateRoute"] = 3122] = "CliCodegenDuplicateRoute";
+	SeedcordErrorCode[SeedcordErrorCode["CliCodegenDuplicateRoute"] = 3114] = "CliCodegenDuplicateRoute";
 	/** The commands directory could not be read during codegen. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCodegenCommandsDirUnreadable"] = 3123] = "CliCodegenCommandsDirUnreadable";
+	SeedcordErrorCode[SeedcordErrorCode["CliCodegenCommandsDirUnreadable"] = 3115] = "CliCodegenCommandsDirUnreadable";
 	/** Two context-menu commands of the same kind share a name during codegen. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCodegenDuplicateContextMenu"] = 3124] = "CliCodegenDuplicateContextMenu";
+	SeedcordErrorCode[SeedcordErrorCode["CliCodegenDuplicateContextMenu"] = 3116] = "CliCodegenDuplicateContextMenu";
 	/** Could not resolve the application from the bot token during `commands --clean`. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCleanAppFetchFailed"] = 3125] = "CliCleanAppFetchFailed";
+	SeedcordErrorCode[SeedcordErrorCode["CliCleanAppFetchFailed"] = 3117] = "CliCleanAppFetchFailed";
 	/** `commands --clean` ran with neither --guild nor --all-guilds. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCleanNoGuilds"] = 3126] = "CliCleanNoGuilds";
+	SeedcordErrorCode[SeedcordErrorCode["CliCleanNoGuilds"] = 3118] = "CliCleanNoGuilds";
 	/** `commands --clean` combined --purge with --all-guilds, which would wipe every guild. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCleanPurgeAllGuilds"] = 3127] = "CliCleanPurgeAllGuilds";
+	SeedcordErrorCode[SeedcordErrorCode["CliCleanPurgeAllGuilds"] = 3119] = "CliCleanPurgeAllGuilds";
 	/** An interactive prompt was cancelled (Ctrl-C), so the command aborts without changes. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCancelled"] = 3128] = "CliCancelled";
+	SeedcordErrorCode[SeedcordErrorCode["CliCancelled"] = 3120] = "CliCancelled";
 	/** `commands --clean --all-guilds` matched more guilds than the safety threshold without `--yes`. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCleanLargeBotUnconfirmed"] = 3129] = "CliCleanLargeBotUnconfirmed";
+	SeedcordErrorCode[SeedcordErrorCode["CliCleanLargeBotUnconfirmed"] = 3121] = "CliCleanLargeBotUnconfirmed";
 	/** `commands --clean --apply` ran in a non-interactive environment without `--yes`, where it cannot prompt. */
-	SeedcordErrorCode[SeedcordErrorCode["CliCleanApplyNeedsYes"] = 3130] = "CliCleanApplyNeedsYes";
-	/** Config hmr rollback flag must be a boolean when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidHmrRollback"] = 3131] = "CliConfigInvalidHmrRollback";
-	/** Config tunnel must be a boolean or an https URL when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidTunnel"] = 3132] = "CliConfigInvalidTunnel";
+	SeedcordErrorCode[SeedcordErrorCode["CliCleanApplyNeedsYes"] = 3122] = "CliCleanApplyNeedsYes";
 	/** The cloudflared metrics server never reported a quick-tunnel hostname. */
-	SeedcordErrorCode[SeedcordErrorCode["CliTunnelUrlUnavailable"] = 3133] = "CliTunnelUrlUnavailable";
+	SeedcordErrorCode[SeedcordErrorCode["CliTunnelUrlUnavailable"] = 3123] = "CliTunnelUrlUnavailable";
 	/** Discord rejected the tunnel URL as an interactions endpoint. */
-	SeedcordErrorCode[SeedcordErrorCode["CliTunnelNotVerified"] = 3134] = "CliTunnelNotVerified";
+	SeedcordErrorCode[SeedcordErrorCode["CliTunnelNotVerified"] = 3124] = "CliTunnelNotVerified";
 	/** The tunnel URL never answered its health probe. */
-	SeedcordErrorCode[SeedcordErrorCode["CliTunnelUnreachable"] = 3135] = "CliTunnelUnreachable";
-	/** Config hmr typecheck flag must be a boolean or object when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidHmrTypecheck"] = 3136] = "CliConfigInvalidHmrTypecheck";
-	/** Config idleAnimation flag must be a boolean when provided. */
-	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidIdleAnimation"] = 3137] = "CliConfigInvalidIdleAnimation";
+	SeedcordErrorCode[SeedcordErrorCode["CliTunnelUnreachable"] = 3125] = "CliTunnelUnreachable";
+	/** A config field is present with the wrong shape. */
+	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidField"] = 3126] = "CliConfigInvalidField";
 	/** A create prompt was cancelled (Ctrl-C), and nothing has been written yet. */
 	SeedcordErrorCode[SeedcordErrorCode["CreateCancelled"] = 3201] = "CreateCancelled";
 	/** A flag supplied an answer for a question the earlier answers skip. */
@@ -258,18 +232,38 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	return SeedcordErrorCode;
 }({});
 
+//#endregion
+//#region src/palette.ts
+const BRAND = {
+	flesh: "#f04e36",
+	rind: "#6fab49",
+	pith: "#f8f6e8"
+};
+const paint = {
+	sky: chalk.hex("#8fc7ff"),
+	iris: chalk.hex("#e29bff"),
+	mint: chalk.hex("#66d98a"),
+	amber: chalk.hex("#ffc061"),
+	coral: chalk.hex("#ff6b85"),
+	flesh: chalk.hex(BRAND.flesh),
+	rind: chalk.hex(BRAND.rind),
+	pith: chalk.hex(BRAND.pith),
+	mute: chalk.dim,
+	bold: chalk.bold,
+	italic: chalk.italic,
+	underline: chalk.underline
+};
+
 //#endregion
 //#region src/ErrorMessages.ts
 /** @internal */
 const messages = {
-	[1001]: () => "Missing DISCORD_BOT_TOKEN environment variable.",
-	[1002]: () => "Invalid DISCORD_BOT_TOKEN value.",
-	[1006]: () => "Missing DISCORD_PUBLIC_KEY environment variable.",
-	[1007]: () => "Invalid DISCORD_PUBLIC_KEY value. Expected 64 hex characters.",
-	[1008]: () => "The route manifest is generated by `seedcord build`. Run the build before importing it.",
-	[1004]: (envKey) => `${envKey} is not a well-formed Discord webhook url.`,
-	[1005]: (envKey) => `The webhook behind ${envKey} does not exist on Discord.`,
-	[1003]: (count, failures) => `Could not resolve ${count} configured emoji${count === 1 ? "" : "s"} at startup.\n${failures}`,
+	[1005]: (name) => `Missing ${name} environment variable.`,
+	[1006]: (name, expected) => expected ? `Invalid ${name} value. Expected ${expected}.` : `Invalid ${name} value.`,
+	[1004]: () => "The route manifest is generated by `seedcord build`. Run the build before importing it.",
+	[1002]: (envKey) => `${envKey} is not a well-formed Discord webhook url.`,
+	[1003]: (envKey) => `The webhook behind ${envKey} does not exist on Discord.`,
+	[1001]: (count, failures) => `Could not resolve ${count} configured emoji${count === 1 ? "" : "s"} at startup.\n${failures}`,
 	[1101]: () => "Cannot add tasks after startup sequence has already completed.",
 	[1102]: () => "Cannot add tasks while startup sequence is in progress.",
 	[1103]: () => "Cannot remove tasks while startup sequence is in progress.",
@@ -288,22 +282,21 @@ const messages = {
 	[1209]: () => "The bot's application id could not be resolved.",
 	[1210]: (accessor, key) => `${accessor}.${key} has no value yet. ${accessor} fills during startup, and a read at the top of a file runs before that.`,
 	[1301]: () => "Interaction middleware cannot specify event filters.",
-	[1302]: () => "Decorator could not locate the original method. Ensure the method exists before applying the decorator.",
-	[1303]: (commandName, existingScope, requestedScope) => `Command "${commandName}" is already registered as a "${existingScope}" command and cannot be re-registered as a "${requestedScope}" command.`,
-	[1304]: () => "RegisterCommand(\"global\") cannot have guilds specified.",
-	[1305]: () => "RegisterCommand(\"guild\") requires a non-empty guilds array.",
-	[1306]: () => "Middleware priority must be a finite number.",
-	[1307]: (className) => `${className} extends WebhookLog and needs a @WebhookUrl decorator naming its env var.`,
+	[1302]: (commandName, existingScope, requestedScope) => `Command "${commandName}" is already registered as a "${existingScope}" command and cannot be re-registered as a "${requestedScope}" command.`,
+	[1303]: () => "RegisterCommand(\"global\") cannot have guilds specified.",
+	[1304]: () => "RegisterCommand(\"guild\") requires a non-empty guilds array.",
+	[1305]: () => "Middleware priority must be a finite number.",
+	[1306]: (className) => `${className} extends WebhookLog and needs a @WebhookUrl decorator naming its env var.`,
 	[1401]: (route, first, second) => `Two interaction handlers resolve to the same route \`${route}\`. Registered by ${first} and ${second}. Rename one.`,
 	[1402]: (name) => `Two different interaction middleware classes share the name \`${name}\`. Rename one so they do not collide.`,
 	[1403]: (route, exportName, from) => `Route \`${route}\` loads \`${exportName}\` from ${from}, which exports no such name.`,
 	[1404]: (keys, exportName, from) => `Subscriber row for \`${keys}\` loads \`${exportName}\` from ${from}, which does not extend Subscriber.`,
 	[1405]: (route, from) => `Route \`${route}\` failed to import ${from}.`,
-	[1501]: (method, reason, alternative, routeId) => `${chalk.cyan(`${method}()`)} was called when ${reason}.\n${alternative} (route ${chalk.cyan(routeId)})`,
-	[1502]: (componentClass, index, detail, routeId) => `${chalk.cyan(componentClass)} at components[${index}] failed to serialize: ${detail.replace(/\.$/, "")}. (route ${chalk.cyan(routeId)})`,
-	[1503]: (method, targetId, routeId) => `${chalk.cyan(`${method}()`)} was passed message ${targetId}, which this interaction did not send.\nPass a message this interaction sent, returned by reply(), followUp(), edit(), or update(). (route ${chalk.cyan(routeId)})`,
-	[1504]: (method, routeId) => `${chalk.cyan(`${method}()`)} was called on a modal opened from a command, which has no source message.\nUse reply() or defer() instead. (route ${chalk.cyan(routeId)})`,
-	[1505]: (method, routeId) => `The interaction callback for ${chalk.cyan(`${method}()`)} returned no message. (route ${chalk.cyan(routeId)})`,
+	[1501]: (method, reason, alternative, routeId) => `${paint.sky(`${method}()`)} was called when ${reason}.\n${alternative} (route ${paint.mute(routeId)})`,
+	[1502]: (componentClass, index, detail, routeId) => `${paint.sky(componentClass)} at components[${index}] failed to serialize: ${detail.replace(/\.$/, "")}. (route ${paint.mute(routeId)})`,
+	[1503]: (method, targetId, routeId) => `${paint.sky(`${method}()`)} was passed message ${targetId}, which this interaction did not send.\nPass a message this interaction sent, returned by reply(), followUp(), edit(), or update(). (route ${paint.mute(routeId)})`,
+	[1504]: (method, routeId) => `${paint.sky(`${method}()`)} was called on a modal opened from a command, which has no source message.\nUse reply() or defer() instead. (route ${paint.mute(routeId)})`,
+	[1505]: (method, routeId) => `The interaction callback for ${paint.sky(`${method}()`)} returned no message. (route ${paint.mute(routeId)})`,
 	[1601]: (prefix) => `customId prefix ${JSON.stringify(prefix)} must be a non-empty string without a colon or control character.`,
 	[1602]: (field) => `customId field name ${JSON.stringify(field)} is integer-like, which JS reorders. Use a non-numeric name.`,
 	[1603]: (field) => `customId field ${JSON.stringify(field)} uses oneOf() with no choices.`,
@@ -326,6 +319,7 @@ const messages = {
 	[1901]: (value) => `Cannot convert ${value} into a color.`,
 	[1902]: () => "Color must be within the range 0 to 16777215 (0xffffff).",
 	[2001]: (pluginName, reason) => `${pluginName} rejected its options, ${reason.replace(/\.$/, "")}.`,
+	[2002]: (count) => `${count} plugins failed to dispose.`,
 	[2101]: (className) => `Missing @RegisterMongooseService on ${className}.`,
 	[2102]: (databaseName) => databaseName ? `Could not connect to MongoDB (${databaseName}).` : "Could not connect to MongoDB.",
 	[2103]: () => "Failed to disconnect from MongoDB cleanly during shutdown.",
@@ -346,41 +340,30 @@ const messages = {
 	[2212]: (databaseName) => `Failed to ensure database ${databaseName} exists.`,
 	[3101]: () => "Config file must default export an object.",
 	[3102]: () => "Config must include an `instance` string that points to your Seedcord default export.",
-	[3103]: () => "Config `root` must be a string when provided.",
-	[3104]: (baseDir, candidates) => `Unable to locate a Seedcord config in ${baseDir}. Searched for ${candidates.join(", ")}.`,
-	[3110]: () => "Config must include an `entry` string that points to your startup script.",
-	[3111]: () => "Config `build` must be an object when provided.",
-	[3112]: () => "Config `build.outDir` must be a string when provided.",
-	[3113]: () => "Config `build.tsconfig` must be a string when provided.",
-	[3114]: () => "Config `build.bootstrap` must be a string when provided.",
-	[3115]: (entryPath, root) => `Entry file ${entryPath} must reside inside configured root ${root}.`,
-	[3105]: (entryPath) => `Cannot find entry file at ${entryPath}.`,
-	[3106]: (entryPath, reason) => `Failed to import ${entryPath} via tsx: ${reason}`,
-	[3107]: (entryPath, nativeReason, fallbackReason) => `Failed to import ${entryPath}: ${nativeReason} (the jiti fallback also failed: ${fallbackReason})`,
-	[3108]: () => "Seedcord instance must default export an object with a start() method.",
-	[3109]: (instancePath, reason) => `Failed to start Seedcord from ${instancePath}: ${reason}`,
-	[3116]: (hint) => `Unable to resolve a tsconfig for builds (${hint}). Provide build.tsconfig or add tsconfig.build.json / tsconfig.json.`,
-	[3117]: (diagnostics) => `TypeScript build failed:\n${diagnostics}`,
-	[3118]: (targetPath, reason) => `Failed to write bootstrap file at ${targetPath}: ${reason}`,
-	[3119]: () => "Config `hmr.typecheck.tsconfig` must be a string when provided.",
-	[3120]: () => "Config `hmr` must be an object when provided.",
-	[3121]: () => "Config `hmr.restart` must be an array of strings when provided.",
-	[3131]: () => "Config `hmr.rollback` must be a boolean when provided.",
-	[3136]: () => "Config `hmr.typecheck` must be a boolean or an object when provided.",
-	[3137]: () => "Config `idleAnimation` must be a boolean when provided.",
-	[3122]: (route, firstFile, secondFile) => `Two commands resolve to the same slash route \`${route}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,
-	[3123]: (dir, reason) => `Could not read the commands directory ${dir} during codegen. ${reason}`,
-	[3124]: (kind, name, firstFile, secondFile) => `Two ${kind} context-menu commands share the name \`${name}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,
-	[3125]: (reason) => `Could not resolve the application from the bot token. ${reason}`,
-	[3126]: () => "No guilds given. Pass --guild <ids...> or --all-guilds. Global commands are never touched.",
-	[3127]: () => "--purge cannot be combined with --all-guilds. Use --guild <ids> to purge specific guilds.",
-	[3128]: () => "Cancelled.",
-	[3129]: (count) => `Refusing to scan ${count} guilds without confirmation. Re-run with --yes, or name specific guilds with --guild <ids>.`,
-	[3130]: () => "Refusing to delete without confirmation in a non-interactive environment. Re-run with --yes.",
-	[3132]: () => "Config `tunnel` must be a boolean or an https URL.",
-	[3133]: (seconds) => `cloudflared did not report a tunnel URL within ${seconds}s. Check that the binary runs and that the network allows it.`,
-	[3134]: (url) => `Discord rejected ${url} as an interactions endpoint.`,
-	[3135]: (url, seconds) => `${url} did not answer within ${seconds}s, so nothing was PATCHed to Discord.`,
+	[3103]: (baseDir, candidates) => `Unable to locate a Seedcord config in ${baseDir}. Searched for ${candidates.join(", ")}.`,
+	[3109]: () => "Config must include an `entry` string that points to your startup script.",
+	[3110]: (entryPath, root) => `Entry file ${entryPath} must reside inside configured root ${root}.`,
+	[3104]: (entryPath) => `Cannot find entry file at ${entryPath}.`,
+	[3105]: (entryPath, reason) => `Failed to import ${entryPath} via tsx: ${reason}`,
+	[3106]: (entryPath, nativeReason, fallbackReason) => `Failed to import ${entryPath}: ${nativeReason} (the jiti fallback also failed: ${fallbackReason})`,
+	[3107]: () => "Seedcord instance must default export an object with a start() method.",
+	[3108]: (instancePath, reason) => `Failed to start Seedcord from ${instancePath}: ${reason}`,
+	[3111]: (hint) => `Unable to resolve a tsconfig for builds (${hint}). Provide build.tsconfig or add tsconfig.build.json / tsconfig.json.`,
+	[3112]: (diagnostics) => `TypeScript build failed:\n${diagnostics}`,
+	[3113]: (targetPath, reason) => `Failed to write bootstrap file at ${targetPath}: ${reason}`,
+	[3114]: (route, firstFile, secondFile) => `Two commands resolve to the same slash route \`${route}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,
+	[3115]: (dir, reason) => `Could not read the commands directory ${dir} during codegen. ${reason}`,
+	[3116]: (kind, name, firstFile, secondFile) => `Two ${kind} context-menu commands share the name \`${name}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,
+	[3117]: (reason) => `Could not resolve the application from the bot token. ${reason}`,
+	[3118]: () => "No guilds given. Pass --guild <ids...> or --all-guilds. Global commands are never touched.",
+	[3119]: () => "--purge cannot be combined with --all-guilds. Use --guild <ids> to purge specific guilds.",
+	[3120]: () => "Cancelled.",
+	[3121]: (count) => `Refusing to scan ${count} guilds without confirmation. Re-run with --yes, or name specific guilds with --guild <ids>.`,
+	[3122]: () => "Refusing to delete without confirmation in a non-interactive environment. Re-run with --yes.",
+	[3123]: (seconds) => `cloudflared did not report a tunnel URL within ${seconds}s. Check that the binary runs and that the network allows it.`,
+	[3124]: (url) => `Discord rejected ${url} as an interactions endpoint.`,
+	[3125]: (url, seconds) => `${url} did not answer within ${seconds}s, so nothing was PATCHed to Discord.`,
+	[3126]: (field, expected) => `Config \`${field}\` must be ${expected} when provided.`,
 	[3201]: () => "Cancelled.",
 	[3202]: (flag) => `The --${flag} flag does not apply to the answers you gave.`,
 	[3203]: (flag, reason) => `--${flag}: ${reason}`,
@@ -414,81 +397,96 @@ function resolveMessage(code, args) {
 	return formatSeedcordErrorMessage(code, args);
 }
 function formatErrorName(name, _identifier, code) {
-	return `${chalk.bold.red(name)}[${chalk.gray(code)}]`;
+	return `${paint.coral.bold(name)}[${paint.mute(code)}]`;
+}
+const kIdentifier = Symbol.for("seedcord.errors.identifier");
+const CODED = Symbol.for("seedcord.errors.coded");
+function brand(prototype) {
+	Object.defineProperty(prototype, CODED, { value: true });
+}
+function isCoded(error) {
+	return typeof error === "object" && error !== null && CODED in error;
 }
-/**
-* Base class for Seedcord errors.
-*/
 var SeedcordError = class extends Error {
 	code;
-	identifier;
+	[kIdentifier];
 	type = "SeedcordError";
 	constructor(code, ...rest) {
 		const { args, options } = resolveCtorInputs(rest);
 		const message = resolveMessage(code, args);
 		super(message, options);
 		this.code = code;
-		this.identifier = resolveIdentifier(code);
-		this.name = formatErrorName(new.target.name, this.identifier, this.code);
+		this[kIdentifier] = resolveIdentifier(code);
+		this.name = formatErrorName(new.target.name, this[kIdentifier], this.code);
 		Object.setPrototypeOf(this, new.target.prototype);
 		if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, new.target);
 	}
 };
-/**
-* TypeError class for Seedcord errors.
-*/
+brand(SeedcordError.prototype);
 var SeedcordTypeError = class extends TypeError {
 	code;
-	identifier;
+	[kIdentifier];
 	type = "SeedcordTypeError";
 	constructor(code, ...rest) {
 		const { args, options } = resolveCtorInputs(rest);
 		const message = resolveMessage(code, args);
 		super(message, options);
 		this.code = code;
-		this.identifier = resolveIdentifier(code);
-		this.name = formatErrorName(new.target.name, this.identifier, this.code);
+		this[kIdentifier] = resolveIdentifier(code);
+		this.name = formatErrorName(new.target.name, this[kIdentifier], this.code);
 		Object.setPrototypeOf(this, new.target.prototype);
 		if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, new.target);
 	}
 };
-/**
-* RangeError class for Seedcord errors.
-*/
+brand(SeedcordTypeError.prototype);
 var SeedcordRangeError = class extends RangeError {
 	code;
-	identifier;
+	[kIdentifier];
 	type = "SeedcordRangeError";
 	constructor(code, ...rest) {
 		const { args, options } = resolveCtorInputs(rest);
 		const message = resolveMessage(code, args);
 		super(message, options);
 		this.code = code;
-		this.identifier = resolveIdentifier(code);
-		this.name = formatErrorName(new.target.name, this.identifier, this.code);
+		this[kIdentifier] = resolveIdentifier(code);
+		this.name = formatErrorName(new.target.name, this[kIdentifier], this.code);
+		Object.setPrototypeOf(this, new.target.prototype);
+		if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, new.target);
+	}
+};
+brand(SeedcordRangeError.prototype);
+var SeedcordAggregateError = class extends AggregateError {
+	code;
+	[kIdentifier];
+	type = "SeedcordAggregateError";
+	constructor(code, errors, ...rest) {
+		const { args, options } = resolveCtorInputs(rest);
+		const message = resolveMessage(code, args);
+		super(errors, message, options);
+		this.code = code;
+		this[kIdentifier] = resolveIdentifier(code);
+		this.name = formatErrorName(new.target.name, this[kIdentifier], this.code);
 		Object.setPrototypeOf(this, new.target.prototype);
 		if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, new.target);
 	}
 };
+brand(SeedcordAggregateError.prototype);
 /**
 * Determines whether an unknown value is a Seedcord error, with optional narrowing by class and error code.
 *
 * @param error - The value to inspect.
-* @param type - Optional error class discriminator (Error, TypeError, or RangeError).
+* @param type - Optional error class discriminator.
 * @param code - Optional {@link SeedcordErrorCode} discriminator to narrow by code.
 * @typeParam Type - What kind of {@link SeedcordErrorTypeString} to filter by.
 * @typeParam Code - The specific {@link SeedcordErrorCode} to filter by.
 */
 function isSeedcordError(error, type, code) {
-	const isSeedcordErrorInstance = error instanceof SeedcordError && error.type === "SeedcordError";
-	const isSeedcordTypeErrorInstance = error instanceof SeedcordTypeError && error.type === "SeedcordTypeError";
-	const isSeedcordRangeErrorInstance = error instanceof SeedcordRangeError && error.type === "SeedcordRangeError";
-	if (!isSeedcordErrorInstance && !isSeedcordTypeErrorInstance && !isSeedcordRangeErrorInstance) return false;
-	if (!(type ? type === "SeedcordError" && isSeedcordErrorInstance || type === "SeedcordTypeError" && isSeedcordTypeErrorInstance || type === "SeedcordRangeError" && isSeedcordRangeErrorInstance : true)) return false;
+	if (!isCoded(error)) return false;
+	if (type && error.type !== type) return false;
 	if (code === void 0) return true;
-	return error.code === code;
+	return error[kIdentifier] === resolveIdentifier(code);
 }
 
 //#endregion
-export { SeedcordErrorCode as a, isSeedcordError as i, SeedcordRangeError as n, SeedcordTypeError as r, SeedcordError as t };
-//# sourceMappingURL=SeedcordError-B5hcAoT3.mjs.map
+export { isSeedcordError as a, SeedcordErrorCode as c, SeedcordTypeError as i, SeedcordError as n, BRAND as o, SeedcordRangeError as r, paint as s, SeedcordAggregateError as t };
+//# sourceMappingURL=SeedcordError-BLQ8_el7.mjs.map