create-seedcord 0.1.1 → 0.1.2-next.0

package/README.md

@@ -1,13 +1,31 @@
-<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>
 
-# create-seedcord
+<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>
 
-Scaffold a new seedcord bot project.
+<br />
+
+<div align="center">
+
+[![npm](https://img.shields.io/npm/v/create-seedcord?style=flat-square&logo=npm&logoColor=c8341f&label=&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/create-seedcord) [![node](https://img.shields.io/node/v/create-seedcord?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![license](https://img.shields.io/npm/l/create-seedcord?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)
+
+</div>
+
+## About
+
+`create-seedcord` scaffolds a new seedcord bot project.
+
+Until v1.0.0, minor versions can break.
 
 ## Usage
 
@@ -19,7 +37,7 @@ yarn create seedcord my-bot
 
 It asks where the project goes, how Discord reaches your bot, what the bot should react to, your bot token, and an accent color. Then it writes the project, installs, formats, generates your command types, and makes the first commit.
 
-On Windows, run it from Windows Terminal. The prompts fall back to ASCII in `cmd.exe`, so the boxes draw as `T`, `|`, and `o`.
+On Windows, run it from Windows Terminal. The prompts fall back to ASCII in `cmd.exe` making the boxes draw as `T`, `|`, and `o`.
 
 ## Flags
 
@@ -38,13 +56,6 @@ With no terminal to ask on, it reads the flags alone. It names the flag that wou
 
 ## What you get
 
-You get a TypeScript project with one slash command, its handler, a sample event handler (if you picked `gateway`), `seedcord.config.ts`, eslint, prettier, and a `.env` listing every key the framework reads.
+A TypeScript project holding one slash command, its handler, a sample event handler (if you picked `gateway`), `seedcord.config.ts`, eslint, prettier, and a `.env` listing every key the framework reads.
 
 `pnpm dev` starts it with hot reload. On the http transport it also opens a cloudflared tunnel and sets it up, and Discord posts interactions to that URL.
-
-## Docs
-
-- Guide: <https://guide.seedcord.org>
-- API reference: <https://docs.seedcord.org>
-
-Part of the [seedcord](https://github.com/seedcord/seedcord) framework. Until a major v1.0.0 release, expect breaking changes in minor versions.

package/dist/index.mjs

@@ -1922,27 +1922,23 @@ const chalk = createChalk();
 const chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 
 //#endregion
-//#region ../../packages/errors/dist/SeedcordError-B5hcAoT3.mjs
+//#region ../../packages/errors/dist/SeedcordError-BLQ8_el7.mjs
 /**
 * 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. */
@@ -1979,18 +1975,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. */
@@ -2055,6 +2049,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. */
@@ -2095,76 +2091,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. */
@@ -2179,16 +2153,33 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["CreateStepFailed"] = 3206] = "CreateStepFailed";
 	return SeedcordErrorCode;
 }({});
+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
+};
 /** @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.",
@@ -2207,22 +2198,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.`,
@@ -2245,6 +2235,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.",
@@ -2265,41 +2256,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}`,
@@ -2330,117 +2310,117 @@ 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
+//#region src/cli/banner.ts
+function banner(version = "0.1.2-next.0") {
+	const wordmark = `${paint.flesh.bold("seed")}${paint.rind.bold("cord")}${paint.mute(" create")}`;
+	if (version === void 0) return wordmark;
+	return `${wordmark}${paint.pith(` • v${version}`)}`;
 }
 
 //#endregion
 //#region ../../packages/errors/dist/internal.index.mjs
-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
-};
+const ENV_NAME = "DISCORD_BOT_TOKEN";
 /** @internal */
 function validateDiscordToken(raw) {
-	if (raw === null || raw === void 0) throw new SeedcordError(1001);
-	if (typeof raw !== "string") throw new SeedcordError(1002);
+	if (raw === null || raw === void 0) throw new SeedcordError(1005, [ENV_NAME]);
+	if (typeof raw !== "string") throw new SeedcordError(1006, [ENV_NAME]);
 	const value = raw.trim();
-	if (value === "") throw new SeedcordError(1001);
-	if (!/^[A-Za-z\d_-]{24,}\.[A-Za-z\d_-]{6,}\.[A-Za-z\d_-]{27,}$/.test(value)) throw new SeedcordError(1002);
+	if (value === "") throw new SeedcordError(1005, [ENV_NAME]);
+	if (!/^[A-Za-z\d_-]{24,}\.[A-Za-z\d_-]{6,}\.[A-Za-z\d_-]{27,}$/.test(value)) throw new SeedcordError(1006, [ENV_NAME]);
 	return value;
 }
 
-//#endregion
-//#region src/cli/banner.ts
-function banner(version = "0.1.1") {
-	const wordmark = `${paint.flesh.bold("seed")}${paint.rind.bold("cord")}`;
-	if (version === void 0) return wordmark;
-	return `${wordmark}${paint.pith(` • v${version}`)}`;
-}
-
 //#endregion
 //#region src/interview/steps/requireAnswer.ts
 function requireAnswer(value) {