@seedcord/errors 0.2.0 → 0.2.1-next.1

package/LICENSE

@@ -175,7 +175,7 @@ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 
 END OF TERMS AND CONDITIONS
 
-Copyright 2025 Dhruv Jain (materwelonDhruv)
+Copyright 2026 Dhruv Jain (materwelonDhruv)
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

package/README.md

@@ -7,7 +7,7 @@
 _This repository is a work in progress._
 
 - There are no stable releases yet but changes are being made actively.
-- Till a major v1.0.0 release for seedcord, expect breaking changes in minor versions.
+- Until a major v1.0.0 release for seedcord, expect breaking changes in minor versions.
 - Documentation will come soon as well!
 
 If you'd like to try it out, you can check out the code in `mock`

package/dist/{SeedcordError-be6Sx70F.d.mts → SeedcordError-CVffUw6p.d.mts}

@@ -83,6 +83,14 @@ declare enum SeedcordErrorCode {
   EventMiddlewareNameUnavailable = 1613,
   /** A Cooldown gate was given a duration string that is not a well-formed positive duration. */
   GateInvalidCooldownDuration = 1701,
+  /** A paginator source was given a perPage that is not a positive integer. */
+  PaginationInvalidPerPage = 1801,
+  /** A control row was assembled with more than the five buttons Discord allows. */
+  PaginationTooManyControls = 1802,
+  /** A control row was assembled with no controls. */
+  PaginationEmptyControls = 1803,
+  /** A control row repeats the same control, which would collide the custom_ids. */
+  PaginationDuplicateControls = 1804,
   /** Mongo service class is missing the `@RegisterMongoService` decorator. */
   PluginMongoServiceDecoratorMissing = 2101,
   /** Mongo model class is missing the `@RegisterMongoModel` decorator. */
@@ -218,6 +226,10 @@ declare const messages: {
   1612: (event: string) => string;
   1613: () => string;
   1701: (input: string) => string;
+  1801: (perPage: number) => string;
+  1802: (count: number) => string;
+  1803: () => string;
+  1804: (key: string) => string;
   2101: (className: string) => string;
   2102: (className: string) => string;
   2103: (databaseName?: string) => string;
@@ -355,4 +367,4 @@ type ErrorCodeFilter<Type extends SeedcordErrorTypeString | undefined, Code exte
 declare function isSeedcordError<Type extends SeedcordErrorTypeString | undefined, Code extends SeedcordErrorCode | undefined>(error: unknown, type?: Type, code?: Code): error is ErrorCodeFilter<Type, Code>;
 //#endregion
 export { isSeedcordError as a, SeedcordTypeError as i, SeedcordErrorTypeString as n, SeedcordErrorCode as o, SeedcordRangeError as r, SeedcordError as t };
-//# sourceMappingURL=SeedcordError-be6Sx70F.d.mts.map
+//# sourceMappingURL=SeedcordError-CVffUw6p.d.mts.map

package/dist/{SeedcordError-CFIfQXET.mjs → SeedcordError-DW6ZuyOg.mjs}

@@ -85,6 +85,14 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["EventMiddlewareNameUnavailable"] = 1613] = "EventMiddlewareNameUnavailable";
 	/** A Cooldown gate was given a duration string that is not a well-formed positive duration. */
 	SeedcordErrorCode[SeedcordErrorCode["GateInvalidCooldownDuration"] = 1701] = "GateInvalidCooldownDuration";
+	/** A paginator source was given a perPage that is not a positive integer. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationInvalidPerPage"] = 1801] = "PaginationInvalidPerPage";
+	/** A control row was assembled with more than the five buttons Discord allows. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationTooManyControls"] = 1802] = "PaginationTooManyControls";
+	/** A control row was assembled with no controls. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationEmptyControls"] = 1803] = "PaginationEmptyControls";
+	/** A control row repeats the same control, which would collide the custom_ids. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationDuplicateControls"] = 1804] = "PaginationDuplicateControls";
 	/** Mongo service class is missing the `@RegisterMongoService` decorator. */
 	SeedcordErrorCode[SeedcordErrorCode["PluginMongoServiceDecoratorMissing"] = 2101] = "PluginMongoServiceDecoratorMissing";
 	/** Mongo model class is missing the `@RegisterMongoModel` decorator. */
@@ -222,6 +230,10 @@ const messages = {
 	[1612]: (event) => `match() has no arm for the event ${JSON.stringify(event)}.`,
 	[1613]: () => `this.eventName is only available on middleware the controller constructed with a fired event name.`,
 	[1701]: (input) => `Cooldown duration ${JSON.stringify(input)} is not valid. Pass a number of seconds or a duration string like '30m', '24h', or '500ms'.`,
+	[1801]: (perPage) => `perPage must be a positive integer, got ${perPage}.`,
+	[1802]: (count) => `A control row holds at most 5 buttons, got ${count}.`,
+	[1803]: () => `A control row must hold at least one control.`,
+	[1804]: (key) => `A control row cannot repeat the '${key}' control.`,
 	[2101]: (className) => `Missing @RegisterMongoService on ${className}.`,
 	[2102]: (className) => `Missing @RegisterMongoModel on ${className}.`,
 	[2103]: (databaseName) => databaseName ? `Could not connect to MongoDB (${databaseName}).` : "Could not connect to MongoDB.",
@@ -371,4 +383,4 @@ function isSeedcordError(error, type, code) {
 
 //#endregion
 export { SeedcordErrorCode as a, isSeedcordError as i, SeedcordRangeError as n, SeedcordTypeError as r, SeedcordError as t };
-//# sourceMappingURL=SeedcordError-CFIfQXET.mjs.map
+//# sourceMappingURL=SeedcordError-DW6ZuyOg.mjs.map

package/dist/SeedcordError-DW6ZuyOg.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedcordError-DW6ZuyOg.mjs","names":[],"sources":["../src/ErrorCodes.ts","../src/ErrorMessages.ts","../src/SeedcordError.ts"],"sourcesContent":["/* eslint-disable no-magic-numbers */\n\n/**\n * All Seedcord error codes.\n */\nexport enum SeedcordErrorCode {\n    /** DISCORD_BOT_TOKEN is not present in the environment. */\n    ConfigMissingDiscordToken = 1001,\n    /** DISCORD_BOT_TOKEN is present but fails validation. */\n    ConfigIncorrectDiscordToken = 1004,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigUnknownExceptionWebhookMissing = 1002,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigUnknownExceptionWebhookInvalid = 1003,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigHandledExceptionWebhookMissing = 1005,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigHandledExceptionWebhookInvalid = 1006,\n    /** One or more configured emojis could not be resolved at startup. */\n    ConfigEmojiUnresolved = 1007,\n\n    /** Attempted to add lifecycle tasks after startup already completed. */\n    LifecycleAddAfterCompletion = 1101,\n    /** Attempted to add lifecycle tasks while startup is still running. */\n    LifecycleAddDuringRun = 1102,\n    /** Attempted to remove lifecycle tasks while startup is still running. */\n    LifecycleRemoveDuringRun = 1103,\n    /** Provided lifecycle phase identifier is not recognized. */\n    LifecycleUnknownPhase = 1104,\n    /** Startup phase completed with one or more task failures. */\n    LifecyclePhaseFailures = 1105,\n    /** A lifecycle task exceeded its configured timeout. */\n    LifecycleTaskTimeout = 1106,\n\n    /** Multiple Seedcord instances were created simultaneously. */\n    CoreSingletonViolation = 1201,\n    /** Plugins cannot be mutated after the core has finished initializing. */\n    CorePluginAfterInit = 1202,\n    /** A plugin tried to register with a key that already exists. */\n    CorePluginKeyExists = 1203,\n    /** Bot role lookup failed within the provided guild. */\n    CoreBotRoleMissing = 1204,\n    /** A bot controller was constructed without its required handlers directory. */\n    CoreControllerPathMissing = 1205,\n\n    /** Interaction middleware decorated with disallowed event filters. */\n    DecoratorInteractionEventFilter = 1301,\n    /** A decorator could not find the original method being decorated. */\n    DecoratorMethodNotFound = 1302,\n    /** A command decorator attempted to re-register an existing command scope. */\n    DecoratorCommandAlreadyRegistered = 1303,\n    /** A global command decorator specified guild IDs, which is not allowed. */\n    DecoratorCommandGlobalWithGuilds = 1304,\n    /** A guild command decorator omitted the required guild ID list. */\n    DecoratorCommandGuildWithoutGuilds = 1305,\n    /** Middleware priority provided by the decorator was not a finite number. */\n    DecoratorInvalidMiddlewarePriority = 1306,\n\n    /** StrictEventEmitter.waitFor was aborted via its AbortSignal. */\n    EventEmitterWaitForAborted = 1501,\n    /** StrictEventEmitter.waitFor exceeded its configured timeout. */\n    EventEmitterWaitForTimeout = 1502,\n\n    /** A customId definition prefix contains a reserved character (a colon or a control char). */\n    CustomIdInvalidPrefix = 1601,\n    /** A customId field name is integer-like, which JS would silently reorder. */\n    CustomIdReservedFieldName = 1602,\n    /** A oneOf() field was declared with no choices. */\n    CustomIdEmptyChoices = 1603,\n    /** An int() field was declared with min greater than max. */\n    CustomIdInvalidBounds = 1604,\n    /** A value passed to encode() is outside its field's allowed range. */\n    CustomIdValueOutOfRange = 1605,\n    /** An encoded customId exceeds Discord's 100-character limit. */\n    CustomIdWireTooLong = 1606,\n    /** A field name is declared more than once in the same customId chain. */\n    CustomIdDuplicateFieldName = 1607,\n    /** A component handler is missing its route decorator (\\@ButtonRoute / \\@ModalRoute / \\@SelectMenuRoute). */\n    CustomIdHandlerRouteMissing = 1608,\n    /** match() received a decoded route with no matching arm. */\n    CustomIdMatchArmMissing = 1609,\n    /** A slash handler's match() has no arm for the command route that fired. */\n    SlashMatchArmMissing = 1610,\n    /** An autocomplete handler's match() has no arm for the focused field that fired. */\n    AutocompleteMatchArmMissing = 1611,\n    /** An event handler's match() has no arm for the event name that fired. */\n    EventMatchArmMissing = 1612,\n    /** Event middleware read `this.eventName` but was constructed without a fired event name. */\n    EventMiddlewareNameUnavailable = 1613,\n\n    /** A Cooldown gate was given a duration string that is not a well-formed positive duration. */\n    GateInvalidCooldownDuration = 1701,\n\n    /** A paginator source was given a perPage that is not a positive integer. */\n    PaginationInvalidPerPage = 1801,\n    /** A control row was assembled with more than the five buttons Discord allows. */\n    PaginationTooManyControls = 1802,\n    /** A control row was assembled with no controls. */\n    PaginationEmptyControls = 1803,\n    /** A control row repeats the same control, which would collide the custom_ids. */\n    PaginationDuplicateControls = 1804,\n\n    /** Mongo service class is missing the `@RegisterMongoService` decorator. */\n    PluginMongoServiceDecoratorMissing = 2101,\n    /** Mongo model class is missing the `@RegisterMongoModel` decorator. */\n    PluginMongoModelDecoratorMissing = 2102,\n    /** Mongo client failed to establish a connection. */\n    PluginMongoConnectionFailed = 2103,\n    /** Mongo client failed to disconnect cleanly during shutdown. */\n    PluginMongoDisconnectFailed = 2104,\n    /** Mongo `services` was accessed before the plugin finished initializing. */\n    PluginMongoServicesNotReady = 2105,\n\n    /** KPG service class is missing the `@RegisterKpgService` decorator. */\n    PluginKpgServiceDecoratorMissing = 2201,\n    /** KPG service class is missing its table metadata. */\n    PluginKpgServiceTableMissing = 2202,\n    /** Migration manager received an invalid step count. */\n    PluginKpgInvalidStepCount = 2203,\n    /** Migration direction was not recognized. */\n    PluginKpgUnknownDirection = 2204,\n    /** Provided migrations path could not be resolved. */\n    PluginKpgUnresolvedMigrationsPath = 2205,\n    /** No migration files were found for execution. */\n    PluginKpgNoMigrationFiles = 2206,\n    /** A migration module failed to export the expected functions. */\n    PluginKpgInvalidMigrationModule = 2207,\n    /** An arbitrary (non-Error) failure was reported by a migration. */\n    PluginKpgNonErrorFailure = 2208,\n    /** Postgres pool failed to close cleanly during shutdown. */\n    PluginKpgDisconnectFailed = 2209,\n    /** KPG `services` was accessed before the plugin finished initializing. */\n    PluginKpgServicesNotReady = 2210,\n\n    /** Config file default export was not an object. */\n    CliConfigInvalidExport = 3101,\n    /** Config is missing the required instance string. */\n    CliConfigMissingInstance = 3102,\n    /** Config root was provided but not a string. */\n    CliConfigInvalidRoot = 3103,\n    /** Unable to locate a Seedcord config file. */\n    CliConfigNotFound = 3104,\n    /** CLI entry file does not exist. */\n    CliEntryNotFound = 3105,\n    /** tsx failed to import the provided entry file. */\n    CliTsxImportFailed = 3106,\n    /** Native import and jiti fallback both failed. */\n    CliImportFailed = 3107,\n    /** Seedcord instance export is missing a start() method. */\n    CliInstanceInvalid = 3108,\n    /** Seedcord instance threw during startup. */\n    CliStartFailed = 3109,\n    /** Config is missing the required entry string. */\n    CliConfigMissingEntry = 3110,\n    /** Config build options must be an object when provided. */\n    CliConfigInvalidBuild = 3111,\n    /** Config build outDir must be a string when provided. */\n    CliConfigInvalidBuildOutDir = 3112,\n    /** Config build tsconfig must be a string when provided. */\n    CliConfigInvalidBuildTsconfig = 3113,\n    /** Config build bootstrap must be a string when provided. */\n    CliConfigInvalidBuildBootstrap = 3114,\n    /** Entry file must be inside the configured root directory. */\n    CliConfigEntryOutsideRoot = 3115,\n    /** Unable to locate a TypeScript config file for builds. */\n    CliBuildTsconfigNotFound = 3116,\n    /** TypeScript reported diagnostics during emit. */\n    CliBuildFailed = 3117,\n    /** Unable to write the generated bootstrap file. */\n    CliBootstrapWriteFailed = 3118,\n    /** Config tsconfig must be a string when provided. */\n    CliConfigInvalidTsconfig = 3119,\n    /** Config hmr options must be an object when provided. */\n    CliConfigInvalidHmr = 3120,\n    /** Config hmr restart patterns must be an array of strings when provided. */\n    CliConfigInvalidHmrRestart = 3121,\n    /** Two commands resolve to the same slash route during codegen. */\n    CliCodegenDuplicateRoute = 3122,\n    /** The commands directory could not be read during codegen. */\n    CliCodegenCommandsDirUnreadable = 3123,\n    /** Two context-menu commands of the same kind share a name during codegen. */\n    CliCodegenDuplicateContextMenu = 3124,\n    /** Could not resolve the application from the bot token during `commands --clean`. */\n    CliCleanAppFetchFailed = 3126,\n    /** `commands --clean` ran with neither --guild nor --all-guilds, so there is nothing to scan. */\n    CliCleanNoGuilds = 3127,\n    /** `commands --clean` combined --purge with --all-guilds, which would wipe every guild. */\n    CliCleanPurgeAllGuilds = 3128,\n    /** An interactive prompt was cancelled (Ctrl-C), so the command aborts without changes. */\n    CliCancelled = 3129,\n    /** `commands --clean --all-guilds` matched more guilds than the safety threshold without `--yes`. */\n    CliCleanLargeBotUnconfirmed = 3130,\n    /** `commands --clean --apply` ran in a non-interactive environment without `--yes`, where it cannot prompt. */\n    CliCleanApplyNeedsYes = 3131\n}\n","import { SeedcordErrorCode } from './ErrorCodes';\n\n/** @internal */\nconst messages = {\n    [SeedcordErrorCode.ConfigMissingDiscordToken]: () => 'Missing DISCORD_BOT_TOKEN environment variable.',\n    [SeedcordErrorCode.ConfigIncorrectDiscordToken]: () => 'Invalid DISCORD_BOT_TOKEN value.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing]: () =>\n        'Missing UNKNOWN_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid]: () => 'Invalid UNKNOWN_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookMissing]: () =>\n        'Missing HANDLED_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookInvalid]: () => 'Invalid HANDLED_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigEmojiUnresolved]: (count: number, failures: string) =>\n        `Could not resolve ${count} configured emoji${count === 1 ? '' : 's'} at startup.\\n${failures}`,\n\n    [SeedcordErrorCode.LifecycleAddAfterCompletion]: () =>\n        'Cannot add tasks after startup sequence has already completed.',\n    [SeedcordErrorCode.LifecycleAddDuringRun]: () => 'Cannot add tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleRemoveDuringRun]: () => 'Cannot remove tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleUnknownPhase]: (phase: unknown) => `Unknown phase: ${String(phase)}.`,\n    [SeedcordErrorCode.LifecyclePhaseFailures]: (phase: string, failures: number) =>\n        `Phase ${phase} completed with ${failures} failed task${failures === 1 ? '' : 's'}.`,\n    [SeedcordErrorCode.LifecycleTaskTimeout]: (taskName: string, timeout: number) =>\n        `Task \"${taskName}\" timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CoreSingletonViolation]: () =>\n        'Seedcord can only be instantiated once. Use the existing instance instead.',\n    [SeedcordErrorCode.CorePluginAfterInit]: () => 'Cannot attach a plugin after initialization.',\n    [SeedcordErrorCode.CorePluginKeyExists]: (key: string) => `Plugin with key \"${key}\" already exists.`,\n    [SeedcordErrorCode.CoreBotRoleMissing]: (guildId?: string) =>\n        guildId ? `Bot role not found in guild ${guildId}.` : 'Bot role not found in guild.',\n    [SeedcordErrorCode.CoreControllerPathMissing]: (controllerName: string, pathKind: string) =>\n        `${controllerName} was instantiated without a ${pathKind} path.`,\n\n    [SeedcordErrorCode.DecoratorInteractionEventFilter]: () => 'Interaction middleware cannot specify event filters.',\n    [SeedcordErrorCode.DecoratorMethodNotFound]: () =>\n        'Decorator could not locate the original method. Ensure the method exists before applying the decorator.',\n    [SeedcordErrorCode.DecoratorCommandAlreadyRegistered]: (\n        commandName: string,\n        existingScope: string,\n        requestedScope: string\n    ) =>\n        `Command \"${commandName}\" is already registered as a \"${existingScope}\" command and cannot be re-registered as a \"${requestedScope}\" command.`,\n    [SeedcordErrorCode.DecoratorCommandGlobalWithGuilds]: () =>\n        'RegisterCommand(\"global\") cannot have guilds specified.',\n    [SeedcordErrorCode.DecoratorCommandGuildWithoutGuilds]: () =>\n        'RegisterCommand(\"guild\") requires a non-empty guilds array.',\n    [SeedcordErrorCode.DecoratorInvalidMiddlewarePriority]: () => 'Middleware priority must be a finite number.',\n\n    [SeedcordErrorCode.EventEmitterWaitForAborted]: () => 'waitFor was aborted via its AbortSignal.',\n    [SeedcordErrorCode.EventEmitterWaitForTimeout]: (timeout: number) => `waitFor timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CustomIdInvalidPrefix]: (prefix: string) =>\n        `customId prefix ${JSON.stringify(prefix)} must be a non-empty string without a colon or control character.`,\n    [SeedcordErrorCode.CustomIdReservedFieldName]: (field: string) =>\n        `customId field name ${JSON.stringify(field)} is integer-like, which JS reorders. Use a non-numeric name.`,\n    [SeedcordErrorCode.CustomIdEmptyChoices]: (field: string) =>\n        `customId field ${JSON.stringify(field)} uses oneOf() with no choices.`,\n    [SeedcordErrorCode.CustomIdInvalidBounds]: (field: string, min: number, max: number) =>\n        `customId field ${JSON.stringify(field)} has min ${min} greater than max ${max}.`,\n    [SeedcordErrorCode.CustomIdValueOutOfRange]: (field: string, value: string) =>\n        `customId field ${JSON.stringify(field)} got value ${value} outside its allowed range.`,\n    [SeedcordErrorCode.CustomIdWireTooLong]: (length: number) =>\n        `Encoded customId is ${length} characters, Discord allows at most 100.`,\n    [SeedcordErrorCode.CustomIdDuplicateFieldName]: (field: string) =>\n        `customId field ${JSON.stringify(field)} is already defined in this chain.`,\n    [SeedcordErrorCode.CustomIdHandlerRouteMissing]: (className: string) =>\n        `${className} is missing its route decorator (@ButtonRoute, @ModalRoute, or @SelectMenuRoute).`,\n    [SeedcordErrorCode.CustomIdMatchArmMissing]: (prefix: string) =>\n        `match() has no arm for the decoded route ${JSON.stringify(prefix)}.`,\n    [SeedcordErrorCode.SlashMatchArmMissing]: (route: string) =>\n        `match() has no arm for the command route ${JSON.stringify(route)}.`,\n    [SeedcordErrorCode.AutocompleteMatchArmMissing]: (field: string) =>\n        `match() has no arm for the focused field ${JSON.stringify(field)}.`,\n    [SeedcordErrorCode.EventMatchArmMissing]: (event: string) =>\n        `match() has no arm for the event ${JSON.stringify(event)}.`,\n    [SeedcordErrorCode.EventMiddlewareNameUnavailable]: () =>\n        `this.eventName is only available on middleware the controller constructed with a fired event name.`,\n\n    [SeedcordErrorCode.GateInvalidCooldownDuration]: (input: string) =>\n        `Cooldown duration ${JSON.stringify(input)} is not valid. Pass a number of seconds or a duration string like '30m', '24h', or '500ms'.`,\n\n    [SeedcordErrorCode.PaginationInvalidPerPage]: (perPage: number) =>\n        `perPage must be a positive integer, got ${perPage}.`,\n    [SeedcordErrorCode.PaginationTooManyControls]: (count: number) =>\n        `A control row holds at most 5 buttons, got ${count}.`,\n    [SeedcordErrorCode.PaginationEmptyControls]: () => `A control row must hold at least one control.`,\n    [SeedcordErrorCode.PaginationDuplicateControls]: (key: string) =>\n        `A control row cannot repeat the '${key}' control.`,\n\n    [SeedcordErrorCode.PluginMongoServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoService on ${className}.`,\n    [SeedcordErrorCode.PluginMongoModelDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoModel on ${className}.`,\n    [SeedcordErrorCode.PluginMongoConnectionFailed]: (databaseName?: string) =>\n        databaseName ? `Could not connect to MongoDB (${databaseName}).` : 'Could not connect to MongoDB.',\n    [SeedcordErrorCode.PluginMongoDisconnectFailed]: () => 'Failed to disconnect from MongoDB cleanly during shutdown.',\n    [SeedcordErrorCode.PluginMongoServicesNotReady]: () =>\n        'Mongo services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.PluginKpgServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterKpgService on ${className}.`,\n    [SeedcordErrorCode.PluginKpgServiceTableMissing]: (className: string) =>\n        `Missing table metadata for ${className}. Provide a table via @RegisterKpgService().`,\n    [SeedcordErrorCode.PluginKpgInvalidStepCount]: () => 'Migration step count must be a non-negative integer.',\n    [SeedcordErrorCode.PluginKpgUnknownDirection]: (direction: unknown) =>\n        `Unknown migration direction: ${String(direction)}.`,\n    [SeedcordErrorCode.PluginKpgUnresolvedMigrationsPath]: (label: string) =>\n        `Unable to resolve migrations at path: ${label}.`,\n    [SeedcordErrorCode.PluginKpgNoMigrationFiles]: () => 'No migration files provided.',\n    [SeedcordErrorCode.PluginKpgInvalidMigrationModule]: (filePath: string) =>\n        `Migration file ${filePath} must export async functions up and down.`,\n    [SeedcordErrorCode.PluginKpgNonErrorFailure]: (message: string) => `Migration failure: ${message}.`,\n    [SeedcordErrorCode.PluginKpgDisconnectFailed]: () => 'Failed to close the Postgres pool cleanly during shutdown.',\n    [SeedcordErrorCode.PluginKpgServicesNotReady]: () =>\n        'KPG services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.CliConfigInvalidExport]: () => 'Config file must default export an object.',\n    [SeedcordErrorCode.CliConfigMissingInstance]: () =>\n        'Config must include an `instance` string that points to your Seedcord default export.',\n    [SeedcordErrorCode.CliConfigInvalidRoot]: () => 'Config `root` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigNotFound]: (baseDir: string, candidates: readonly string[]) =>\n        `Unable to locate a Seedcord config in ${baseDir}. Searched for ${candidates.join(', ')}.`,\n    [SeedcordErrorCode.CliConfigMissingEntry]: () =>\n        'Config must include an `entry` string that points to your startup script.',\n    [SeedcordErrorCode.CliConfigInvalidBuild]: () => 'Config `build` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildOutDir]: () => 'Config `build.outDir` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildTsconfig]: () => 'Config `build.tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildBootstrap]: () =>\n        'Config `build.bootstrap` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigEntryOutsideRoot]: (entryPath: string, root: string) =>\n        `Entry file ${entryPath} must reside inside configured root ${root}.`,\n    [SeedcordErrorCode.CliEntryNotFound]: (entryPath: string) => `Cannot find entry file at ${entryPath}.`,\n    [SeedcordErrorCode.CliTsxImportFailed]: (entryPath: string, reason: string) =>\n        `Failed to import ${entryPath} via tsx: ${reason}.`,\n    [SeedcordErrorCode.CliImportFailed]: (entryPath: string, nativeReason: string, fallbackReason: string) =>\n        `Failed to import ${entryPath}: ${nativeReason}. Fallback via jiti also failed: ${fallbackReason}.`,\n    [SeedcordErrorCode.CliInstanceInvalid]: () =>\n        'Seedcord instance must default export an object with a start() method.',\n    [SeedcordErrorCode.CliStartFailed]: (instancePath: string, reason: string) =>\n        `Failed to start Seedcord from ${instancePath}: ${reason}.`,\n    [SeedcordErrorCode.CliBuildTsconfigNotFound]: (hint: string) =>\n        `Unable to resolve a tsconfig for builds (${hint}). Provide build.tsconfig or add tsconfig.build.json / tsconfig.json.`,\n    [SeedcordErrorCode.CliBuildFailed]: (diagnostics: string) => `TypeScript build failed:\\n${diagnostics}`,\n    [SeedcordErrorCode.CliBootstrapWriteFailed]: (targetPath: string, reason: string) =>\n        `Failed to write bootstrap file at ${targetPath}: ${reason}.`,\n    [SeedcordErrorCode.CliConfigInvalidTsconfig]: () => 'Config `tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmr]: () => 'Config `hmr` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmrRestart]: () =>\n        'Config `hmr.restart` must be an array of strings when provided.',\n    [SeedcordErrorCode.CliCodegenDuplicateRoute]: (route: string, firstFile: string, secondFile: string) =>\n        `Two commands resolve to the same slash route \\`${route}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCodegenCommandsDirUnreadable]: (dir: string, reason: string) =>\n        `Could not read the commands directory ${dir} during codegen. ${reason}.`,\n    [SeedcordErrorCode.CliCodegenDuplicateContextMenu]: (\n        kind: string,\n        name: string,\n        firstFile: string,\n        secondFile: string\n    ) =>\n        `Two ${kind} context-menu commands share the name \\`${name}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCleanAppFetchFailed]: (reason: string) =>\n        `Could not resolve the application from the bot token. ${reason}.`,\n    [SeedcordErrorCode.CliCleanNoGuilds]: () =>\n        'No guilds given. Pass --guild <ids...> or --all-guilds. Global commands are never touched.',\n    [SeedcordErrorCode.CliCleanPurgeAllGuilds]: () =>\n        '--purge cannot be combined with --all-guilds. Use --guild <ids> to purge specific guilds.',\n    [SeedcordErrorCode.CliCancelled]: () => 'Cancelled.',\n    [SeedcordErrorCode.CliCleanLargeBotUnconfirmed]: (count: number) =>\n        `Refusing to scan ${count} guilds without confirmation. Re-run with --yes, or name specific guilds with --guild <ids>.`,\n    [SeedcordErrorCode.CliCleanApplyNeedsYes]: () =>\n        'Refusing to delete without confirmation in a non-interactive environment. Re-run with --yes.'\n} satisfies Record<SeedcordErrorCode, (...args: never[]) => string>;\n\n/** @internal */\nexport type SeedcordErrorArguments<Code extends SeedcordErrorCode> = Parameters<(typeof messages)[Code]>;\n\n/** @internal */\nexport function formatSeedcordErrorMessage<Code extends SeedcordErrorCode>(\n    code: Code,\n    args?: SeedcordErrorArguments<Code>\n): string {\n    const formatter = messages[code];\n    const resolvedArgs = (args ?? []) as unknown[];\n    return (formatter as (...params: unknown[]) => string)(...resolvedArgs);\n}\n","/* eslint-disable @typescript-eslint/no-unnecessary-condition */\nimport chalk from 'chalk';\n\nimport { SeedcordErrorCode } from './ErrorCodes';\nimport { formatSeedcordErrorMessage, type SeedcordErrorArguments } from './ErrorMessages';\n\n/**\n * String literal type for Seedcord error identifiers.\n *\n * @internal\n */\ntype SeedcordErrorIdentifier = keyof typeof SeedcordErrorCode;\n\n/**\n * Options for Seedcord errors.\n *\n * @internal\n */\ninterface SeedcordErrorOptions extends ErrorOptions {}\n\nfunction resolveIdentifier(code: SeedcordErrorCode): SeedcordErrorIdentifier {\n    return SeedcordErrorCode[code] as SeedcordErrorIdentifier;\n}\n\ntype SeedcordErrorPayload<Code extends SeedcordErrorCode> = SeedcordErrorArguments<Code> | undefined;\n\ntype SeedcordErrorCtorRest<Code extends SeedcordErrorCode> =\n    SeedcordErrorArguments<Code> extends []\n        ? [options?: SeedcordErrorOptions]\n        : [args: SeedcordErrorArguments<Code>, options?: SeedcordErrorOptions];\n\nfunction resolveCtorInputs<Code extends SeedcordErrorCode>(\n    rest: SeedcordErrorCtorRest<Code>\n): { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } {\n    const [maybeArgsOrOptions, maybeOptions] = rest;\n    if (Array.isArray(maybeArgsOrOptions)) {\n        const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n            args: maybeArgsOrOptions\n        };\n\n        if (maybeOptions !== undefined) {\n            result.options = maybeOptions;\n        }\n\n        return result;\n    }\n\n    const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n        args: undefined\n    };\n\n    if (maybeArgsOrOptions !== undefined) {\n        result.options = maybeArgsOrOptions;\n    }\n\n    return result;\n}\n\nfunction resolveMessage<Code extends SeedcordErrorCode>(code: Code, args: SeedcordErrorPayload<Code>): string {\n    return formatSeedcordErrorMessage(code, args);\n}\n\nfunction formatErrorName(name: string, _identifier: SeedcordErrorIdentifier, code: SeedcordErrorCode): string {\n    return `${chalk.bold.red(name)}[${chalk.gray(code)}]`;\n}\n\n/**\n * String literal type for Seedcord error class names.\n *\n * @internal\n */\nexport type SeedcordErrorTypeString = `Seedcord${'Error' | 'TypeError' | 'RangeError'}`;\n\ninterface BaseSeedcordError {\n    readonly code: SeedcordErrorCode;\n    readonly identifier: SeedcordErrorIdentifier;\n    readonly type: SeedcordErrorTypeString;\n}\n\n/**\n * Base class for Seedcord errors.\n */\nexport class SeedcordError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends Error\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * TypeError class for Seedcord errors.\n */\nexport class SeedcordTypeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends TypeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordTypeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * RangeError class for Seedcord errors.\n */\nexport class SeedcordRangeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends RangeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordRangeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * Variant type for Seedcord error classes.\n *\n * @internal\n */\ntype SeedcordErrorVariant<\n    Type extends SeedcordErrorTypeString,\n    Code extends SeedcordErrorCode\n> = Type extends 'SeedcordError'\n    ? SeedcordError<Code>\n    : Type extends 'SeedcordTypeError'\n      ? SeedcordTypeError<Code>\n      : SeedcordRangeError<Code>;\n\n/**\n * Union type of all Seedcord error variants for a specific error code.\n *\n * @internal\n */\ntype AnySeedcordErrorForCode<Code extends SeedcordErrorCode> = {\n    [Variant in SeedcordErrorTypeString]: SeedcordErrorVariant<Variant, Code>;\n}[SeedcordErrorTypeString];\n\n/**\n * Union type of all Seedcord errors filtered by error class.\n *\n * @internal\n */\ntype ErrorTypeFilter<Type extends SeedcordErrorTypeString | undefined> = Type extends SeedcordErrorTypeString\n    ? {\n          [Code in SeedcordErrorCode]: SeedcordErrorVariant<Type, Code>;\n      }[SeedcordErrorCode]\n    : AnySeedcordErrorForCode<SeedcordErrorCode>;\n\n/**\n * Union type of all Seedcord errors filtered by error class and error code.\n *\n * @internal\n */\nexport type ErrorCodeFilter<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n> = Code extends SeedcordErrorCode\n    ? Type extends SeedcordErrorTypeString\n        ? SeedcordErrorVariant<Type, Code>\n        : AnySeedcordErrorForCode<Code>\n    : ErrorTypeFilter<Type>;\n\n/**\n * Determines whether an unknown value is a Seedcord error, with optional narrowing by class and error code.\n *\n * @param error - The value to inspect.\n * @param type - Optional error class discriminator (Error, TypeError, or RangeError).\n * @param code - Optional {@link SeedcordErrorCode} discriminator to narrow by code.\n * @typeParam Type - What kind of {@link SeedcordErrorTypeString} to filter by.\n * @typeParam Code - The specific {@link SeedcordErrorCode} to filter by.\n */\nexport function isSeedcordError<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n>(error: unknown, type?: Type, code?: Code): error is ErrorCodeFilter<Type, Code> {\n    const isSeedcordErrorInstance = error instanceof SeedcordError && error.type === 'SeedcordError';\n    const isSeedcordTypeErrorInstance = error instanceof SeedcordTypeError && error.type === 'SeedcordTypeError';\n    const isSeedcordRangeErrorInstance = error instanceof SeedcordRangeError && error.type === 'SeedcordRangeError';\n\n    if (!isSeedcordErrorInstance && !isSeedcordTypeErrorInstance && !isSeedcordRangeErrorInstance) {\n        return false;\n    }\n\n    const matchesType = type\n        ? (type === 'SeedcordError' && isSeedcordErrorInstance) ||\n          (type === 'SeedcordTypeError' && isSeedcordTypeErrorInstance) ||\n          (type === 'SeedcordRangeError' && isSeedcordRangeErrorInstance)\n        : true;\n\n    if (!matchesType) return false;\n    if (code === undefined) return true;\n    return error.code === code;\n}\n"],"mappings":";;;;;;AAKA,IAAY,oBAAL;;CAEH;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAGA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAGA;;CAEA;;CAEA;;CAEA;;CAEA;;CAGA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAGA;;CAEA;;CAGA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAGA;;CAGA;;CAEA;;CAEA;;CAEA;;CAGA;;CAEA;;CAEA;;CAEA;;CAEA;;CAGA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAGA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;CAEA;;AACJ;;;;;AC/LA,MAAM,WAAW;eACwC;eACE;eAEnD;eAC4D;eAE5D;eAC4D;UACpB,OAAe,aACvD,qBAAqB,MAAM,mBAAmB,UAAU,IAAI,KAAK,IAAI,gBAAgB;eAGrF;eAC6C;eACG;UACR,UAAmB,kBAAkB,OAAO,KAAK,EAAE;UAClD,OAAe,aACxD,SAAS,MAAM,kBAAkB,SAAS,cAAc,aAAa,IAAI,KAAK,IAAI;UAC3C,UAAkB,YACzD,SAAS,SAAS,oBAAoB,QAAQ;eAG9C;eAC2C;UACL,QAAgB,oBAAoB,IAAI;UACzC,YACrC,UAAU,+BAA+B,QAAQ,KAAK;UACV,gBAAwB,aACpE,GAAG,eAAe,8BAA8B,SAAS;eAEF;eAEvD;UAEA,aACA,eACA,mBAEA,YAAY,YAAY,gCAAgC,cAAc,8CAA8C,eAAe;eAEnI;eAEA;eAC0D;eAER;UACL,YAAoB,2BAA2B,QAAQ;UAE5D,WACxC,mBAAmB,KAAK,UAAU,MAAM,EAAE;UACE,UAC5C,uBAAuB,KAAK,UAAU,KAAK,EAAE;UACN,UACvC,kBAAkB,KAAK,UAAU,KAAK,EAAE;UACA,OAAe,KAAa,QACpE,kBAAkB,KAAK,UAAU,KAAK,EAAE,WAAW,IAAI,oBAAoB,IAAI;UACrC,OAAe,UACzD,kBAAkB,KAAK,UAAU,KAAK,EAAE,aAAa,MAAM;UACrB,WACtC,uBAAuB,OAAO;UACe,UAC7C,kBAAkB,KAAK,UAAU,KAAK,EAAE;UACM,cAC9C,GAAG,UAAU;UAC6B,WAC1C,4CAA4C,KAAK,UAAU,MAAM,EAAE;UAC5B,UACvC,4CAA4C,KAAK,UAAU,KAAK,EAAE;UACpB,UAC9C,4CAA4C,KAAK,UAAU,KAAK,EAAE;UAC3B,UACvC,oCAAoC,KAAK,UAAU,KAAK,EAAE;eAE1D;UAE8C,UAC9C,qBAAqB,KAAK,UAAU,KAAK,EAAE;UAEA,YAC3C,2CAA2C,QAAQ;UACP,UAC5C,8CAA8C,MAAM;eACL;UACD,QAC9C,oCAAoC,IAAI;UAEa,cACrD,oCAAoC,UAAU;UACK,cACnD,kCAAkC,UAAU;UACE,iBAC9C,eAAe,iCAAiC,aAAa,MAAM;eAChB;eAEnD;UAEmD,cACnD,kCAAkC,UAAU;UACG,cAC/C,8BAA8B,UAAU;eACS;UACL,cAC5C,gCAAgC,OAAO,SAAS,EAAE;UACE,UACpD,yCAAyC,MAAM;eACE;UACC,aAClD,kBAAkB,SAAS;UACgB,YAAoB,sBAAsB,QAAQ;eAC5C;eAEjD;eAE8C;eAE9C;eAC4C;UACR,SAAiB,eACrD,yCAAyC,QAAQ,iBAAiB,WAAW,KAAK,IAAI,EAAE;eAExF;eAC6C;eACM;eACE;eAErD;UAC4C,WAAmB,SAC/D,cAAc,UAAU,sCAAsC,KAAK;UAChC,cAAsB,6BAA6B,UAAU;UAC3D,WAAmB,WACxD,oBAAoB,UAAU,YAAY,OAAO;UACf,WAAmB,cAAsB,mBAC3E,oBAAoB,UAAU,IAAI,aAAa,mCAAmC,eAAe;eAEjG;UACiC,cAAsB,WACvD,iCAAiC,aAAa,IAAI,OAAO;UACd,SAC3C,4CAA4C,KAAK;UAChB,gBAAwB,6BAA6B;UAC5C,YAAoB,WAC9D,qCAAqC,WAAW,IAAI,OAAO;eACX;eACL;eAE3C;UAC2C,OAAe,WAAmB,eAC7E,kDAAkD,MAAM,iBAAiB,UAAU,OAAO,WAAW;UACnD,KAAa,WAC/D,yCAAyC,IAAI,mBAAmB,OAAO;UAEvE,MACA,MACA,WACA,eAEA,OAAO,KAAK,0CAA0C,KAAK,iBAAiB,UAAU,OAAO,WAAW;UAC/D,WACzC,yDAAyD,OAAO;eAEhE;eAEA;eACoC;UACU,UAC9C,oBAAoB,MAAM;eAE1B;AACR;;AAMA,SAAgB,2BACZ,MACA,MACM;CACN,MAAM,YAAY,SAAS;CAE3B,OAAQ,UAA+C,GADjC,QAAQ,CAAC,CACuC;AAC1E;;;;ACrKA,SAAS,kBAAkB,MAAkD;CACzE,OAAO,kBAAkB;AAC7B;AASA,SAAS,kBACL,MACoE;CACpE,MAAM,CAAC,oBAAoB,gBAAgB;CAC3C,IAAI,MAAM,QAAQ,kBAAkB,GAAG;EACnC,MAAM,SAA+E,EACjF,MAAM,mBACV;EAEA,IAAI,iBAAiB,QACjB,OAAO,UAAU;EAGrB,OAAO;CACX;CAEA,MAAM,SAA+E,EACjF,MAAM,OACV;CAEA,IAAI,uBAAuB,QACvB,OAAO,UAAU;CAGrB,OAAO;AACX;AAEA,SAAS,eAA+C,MAAY,MAA0C;CAC1G,OAAO,2BAA2B,MAAM,IAAI;AAChD;AAEA,SAAS,gBAAgB,MAAc,aAAsC,MAAiC;CAC1G,OAAO,GAAG,MAAM,KAAK,IAAI,IAAI,EAAE,GAAG,MAAM,KAAK,IAAI,EAAE;AACvD;;;;AAkBA,IAAa,gBAAb,cACY,MAEZ;CACI,AAAgB;CAChB,AAAgB;CAChB,AAAgB,OAAO;CAEvB,YAAY,MAAY,GAAG,MAAmC;EAC1D,MAAM,EAAE,MAAM,YAAY,kBAAkB,IAAI;EAChD,MAAM,UAAU,eAAe,MAAM,IAAI;EACzC,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;EACZ,KAAK,aAAa,kBAAkB,IAAI;EACxC,KAAK,OAAO,gBAAgB,IAAI,OAAO,MAAM,KAAK,YAAY,KAAK,IAAI;EACvE,OAAO,eAAe,MAAM,IAAI,OAAO,SAAS;EAChD,IAAI,OAAO,MAAM,sBAAsB,YACnC,MAAM,kBAAkB,MAAM,IAAI,MAAM;CAEhD;AACJ;;;;AAKA,IAAa,oBAAb,cACY,UAEZ;CACI,AAAgB;CAChB,AAAgB;CAChB,AAAgB,OAAO;CAEvB,YAAY,MAAY,GAAG,MAAmC;EAC1D,MAAM,EAAE,MAAM,YAAY,kBAAkB,IAAI;EAChD,MAAM,UAAU,eAAe,MAAM,IAAI;EACzC,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;EACZ,KAAK,aAAa,kBAAkB,IAAI;EACxC,KAAK,OAAO,gBAAgB,IAAI,OAAO,MAAM,KAAK,YAAY,KAAK,IAAI;EACvE,OAAO,eAAe,MAAM,IAAI,OAAO,SAAS;EAChD,IAAI,OAAO,MAAM,sBAAsB,YACnC,MAAM,kBAAkB,MAAM,IAAI,MAAM;CAEhD;AACJ;;;;AAKA,IAAa,qBAAb,cACY,WAEZ;CACI,AAAgB;CAChB,AAAgB;CAChB,AAAgB,OAAO;CAEvB,YAAY,MAAY,GAAG,MAAmC;EAC1D,MAAM,EAAE,MAAM,YAAY,kBAAkB,IAAI;EAChD,MAAM,UAAU,eAAe,MAAM,IAAI;EACzC,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;EACZ,KAAK,aAAa,kBAAkB,IAAI;EACxC,KAAK,OAAO,gBAAgB,IAAI,OAAO,MAAM,KAAK,YAAY,KAAK,IAAI;EACvE,OAAO,eAAe,MAAM,IAAI,OAAO,SAAS;EAChD,IAAI,OAAO,MAAM,sBAAsB,YACnC,MAAM,kBAAkB,MAAM,IAAI,MAAM;CAEhD;AACJ;;;;;;;;;;AA2DA,SAAgB,gBAGd,OAAgB,MAAa,MAAmD;CAC9E,MAAM,0BAA0B,iBAAiB,iBAAiB,MAAM,SAAS;CACjF,MAAM,8BAA8B,iBAAiB,qBAAqB,MAAM,SAAS;CACzF,MAAM,+BAA+B,iBAAiB,sBAAsB,MAAM,SAAS;CAE3F,IAAI,CAAC,2BAA2B,CAAC,+BAA+B,CAAC,8BAC7D,OAAO;CASX,IAAI,EANgB,OACb,SAAS,mBAAmB,2BAC5B,SAAS,uBAAuB,+BAChC,SAAS,wBAAwB,+BAClC,OAEY,OAAO;CACzB,IAAI,SAAS,QAAW,OAAO;CAC/B,OAAO,MAAM,SAAS;AAC1B"}

package/dist/{SeedcordError-DM9aR_TV.cjs → SeedcordError-DuwkdU7a.cjs}

@@ -113,6 +113,14 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["EventMiddlewareNameUnavailable"] = 1613] = "EventMiddlewareNameUnavailable";
 	/** A Cooldown gate was given a duration string that is not a well-formed positive duration. */
 	SeedcordErrorCode[SeedcordErrorCode["GateInvalidCooldownDuration"] = 1701] = "GateInvalidCooldownDuration";
+	/** A paginator source was given a perPage that is not a positive integer. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationInvalidPerPage"] = 1801] = "PaginationInvalidPerPage";
+	/** A control row was assembled with more than the five buttons Discord allows. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationTooManyControls"] = 1802] = "PaginationTooManyControls";
+	/** A control row was assembled with no controls. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationEmptyControls"] = 1803] = "PaginationEmptyControls";
+	/** A control row repeats the same control, which would collide the custom_ids. */
+	SeedcordErrorCode[SeedcordErrorCode["PaginationDuplicateControls"] = 1804] = "PaginationDuplicateControls";
 	/** Mongo service class is missing the `@RegisterMongoService` decorator. */
 	SeedcordErrorCode[SeedcordErrorCode["PluginMongoServiceDecoratorMissing"] = 2101] = "PluginMongoServiceDecoratorMissing";
 	/** Mongo model class is missing the `@RegisterMongoModel` decorator. */
@@ -250,6 +258,10 @@ const messages = {
 	[1612]: (event) => `match() has no arm for the event ${JSON.stringify(event)}.`,
 	[1613]: () => `this.eventName is only available on middleware the controller constructed with a fired event name.`,
 	[1701]: (input) => `Cooldown duration ${JSON.stringify(input)} is not valid. Pass a number of seconds or a duration string like '30m', '24h', or '500ms'.`,
+	[1801]: (perPage) => `perPage must be a positive integer, got ${perPage}.`,
+	[1802]: (count) => `A control row holds at most 5 buttons, got ${count}.`,
+	[1803]: () => `A control row must hold at least one control.`,
+	[1804]: (key) => `A control row cannot repeat the '${key}' control.`,
 	[2101]: (className) => `Missing @RegisterMongoService on ${className}.`,
 	[2102]: (className) => `Missing @RegisterMongoModel on ${className}.`,
 	[2103]: (databaseName) => databaseName ? `Could not connect to MongoDB (${databaseName}).` : "Could not connect to MongoDB.",
@@ -428,4 +440,4 @@ Object.defineProperty(exports, 'isSeedcordError', {
     return isSeedcordError;
   }
 });
-//# sourceMappingURL=SeedcordError-DM9aR_TV.cjs.map
+//# sourceMappingURL=SeedcordError-DuwkdU7a.cjs.map

package/dist/SeedcordError-DuwkdU7a.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedcordError-DuwkdU7a.cjs","names":[],"sources":["../src/ErrorCodes.ts","../src/ErrorMessages.ts","../src/SeedcordError.ts"],"sourcesContent":["/* eslint-disable no-magic-numbers */\n\n/**\n * All Seedcord error codes.\n */\nexport enum SeedcordErrorCode {\n    /** DISCORD_BOT_TOKEN is not present in the environment. */\n    ConfigMissingDiscordToken = 1001,\n    /** DISCORD_BOT_TOKEN is present but fails validation. */\n    ConfigIncorrectDiscordToken = 1004,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigUnknownExceptionWebhookMissing = 1002,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigUnknownExceptionWebhookInvalid = 1003,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigHandledExceptionWebhookMissing = 1005,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigHandledExceptionWebhookInvalid = 1006,\n    /** One or more configured emojis could not be resolved at startup. */\n    ConfigEmojiUnresolved = 1007,\n\n    /** Attempted to add lifecycle tasks after startup already completed. */\n    LifecycleAddAfterCompletion = 1101,\n    /** Attempted to add lifecycle tasks while startup is still running. */\n    LifecycleAddDuringRun = 1102,\n    /** Attempted to remove lifecycle tasks while startup is still running. */\n    LifecycleRemoveDuringRun = 1103,\n    /** Provided lifecycle phase identifier is not recognized. */\n    LifecycleUnknownPhase = 1104,\n    /** Startup phase completed with one or more task failures. */\n    LifecyclePhaseFailures = 1105,\n    /** A lifecycle task exceeded its configured timeout. */\n    LifecycleTaskTimeout = 1106,\n\n    /** Multiple Seedcord instances were created simultaneously. */\n    CoreSingletonViolation = 1201,\n    /** Plugins cannot be mutated after the core has finished initializing. */\n    CorePluginAfterInit = 1202,\n    /** A plugin tried to register with a key that already exists. */\n    CorePluginKeyExists = 1203,\n    /** Bot role lookup failed within the provided guild. */\n    CoreBotRoleMissing = 1204,\n    /** A bot controller was constructed without its required handlers directory. */\n    CoreControllerPathMissing = 1205,\n\n    /** Interaction middleware decorated with disallowed event filters. */\n    DecoratorInteractionEventFilter = 1301,\n    /** A decorator could not find the original method being decorated. */\n    DecoratorMethodNotFound = 1302,\n    /** A command decorator attempted to re-register an existing command scope. */\n    DecoratorCommandAlreadyRegistered = 1303,\n    /** A global command decorator specified guild IDs, which is not allowed. */\n    DecoratorCommandGlobalWithGuilds = 1304,\n    /** A guild command decorator omitted the required guild ID list. */\n    DecoratorCommandGuildWithoutGuilds = 1305,\n    /** Middleware priority provided by the decorator was not a finite number. */\n    DecoratorInvalidMiddlewarePriority = 1306,\n\n    /** StrictEventEmitter.waitFor was aborted via its AbortSignal. */\n    EventEmitterWaitForAborted = 1501,\n    /** StrictEventEmitter.waitFor exceeded its configured timeout. */\n    EventEmitterWaitForTimeout = 1502,\n\n    /** A customId definition prefix contains a reserved character (a colon or a control char). */\n    CustomIdInvalidPrefix = 1601,\n    /** A customId field name is integer-like, which JS would silently reorder. */\n    CustomIdReservedFieldName = 1602,\n    /** A oneOf() field was declared with no choices. */\n    CustomIdEmptyChoices = 1603,\n    /** An int() field was declared with min greater than max. */\n    CustomIdInvalidBounds = 1604,\n    /** A value passed to encode() is outside its field's allowed range. */\n    CustomIdValueOutOfRange = 1605,\n    /** An encoded customId exceeds Discord's 100-character limit. */\n    CustomIdWireTooLong = 1606,\n    /** A field name is declared more than once in the same customId chain. */\n    CustomIdDuplicateFieldName = 1607,\n    /** A component handler is missing its route decorator (\\@ButtonRoute / \\@ModalRoute / \\@SelectMenuRoute). */\n    CustomIdHandlerRouteMissing = 1608,\n    /** match() received a decoded route with no matching arm. */\n    CustomIdMatchArmMissing = 1609,\n    /** A slash handler's match() has no arm for the command route that fired. */\n    SlashMatchArmMissing = 1610,\n    /** An autocomplete handler's match() has no arm for the focused field that fired. */\n    AutocompleteMatchArmMissing = 1611,\n    /** An event handler's match() has no arm for the event name that fired. */\n    EventMatchArmMissing = 1612,\n    /** Event middleware read `this.eventName` but was constructed without a fired event name. */\n    EventMiddlewareNameUnavailable = 1613,\n\n    /** A Cooldown gate was given a duration string that is not a well-formed positive duration. */\n    GateInvalidCooldownDuration = 1701,\n\n    /** A paginator source was given a perPage that is not a positive integer. */\n    PaginationInvalidPerPage = 1801,\n    /** A control row was assembled with more than the five buttons Discord allows. */\n    PaginationTooManyControls = 1802,\n    /** A control row was assembled with no controls. */\n    PaginationEmptyControls = 1803,\n    /** A control row repeats the same control, which would collide the custom_ids. */\n    PaginationDuplicateControls = 1804,\n\n    /** Mongo service class is missing the `@RegisterMongoService` decorator. */\n    PluginMongoServiceDecoratorMissing = 2101,\n    /** Mongo model class is missing the `@RegisterMongoModel` decorator. */\n    PluginMongoModelDecoratorMissing = 2102,\n    /** Mongo client failed to establish a connection. */\n    PluginMongoConnectionFailed = 2103,\n    /** Mongo client failed to disconnect cleanly during shutdown. */\n    PluginMongoDisconnectFailed = 2104,\n    /** Mongo `services` was accessed before the plugin finished initializing. */\n    PluginMongoServicesNotReady = 2105,\n\n    /** KPG service class is missing the `@RegisterKpgService` decorator. */\n    PluginKpgServiceDecoratorMissing = 2201,\n    /** KPG service class is missing its table metadata. */\n    PluginKpgServiceTableMissing = 2202,\n    /** Migration manager received an invalid step count. */\n    PluginKpgInvalidStepCount = 2203,\n    /** Migration direction was not recognized. */\n    PluginKpgUnknownDirection = 2204,\n    /** Provided migrations path could not be resolved. */\n    PluginKpgUnresolvedMigrationsPath = 2205,\n    /** No migration files were found for execution. */\n    PluginKpgNoMigrationFiles = 2206,\n    /** A migration module failed to export the expected functions. */\n    PluginKpgInvalidMigrationModule = 2207,\n    /** An arbitrary (non-Error) failure was reported by a migration. */\n    PluginKpgNonErrorFailure = 2208,\n    /** Postgres pool failed to close cleanly during shutdown. */\n    PluginKpgDisconnectFailed = 2209,\n    /** KPG `services` was accessed before the plugin finished initializing. */\n    PluginKpgServicesNotReady = 2210,\n\n    /** Config file default export was not an object. */\n    CliConfigInvalidExport = 3101,\n    /** Config is missing the required instance string. */\n    CliConfigMissingInstance = 3102,\n    /** Config root was provided but not a string. */\n    CliConfigInvalidRoot = 3103,\n    /** Unable to locate a Seedcord config file. */\n    CliConfigNotFound = 3104,\n    /** CLI entry file does not exist. */\n    CliEntryNotFound = 3105,\n    /** tsx failed to import the provided entry file. */\n    CliTsxImportFailed = 3106,\n    /** Native import and jiti fallback both failed. */\n    CliImportFailed = 3107,\n    /** Seedcord instance export is missing a start() method. */\n    CliInstanceInvalid = 3108,\n    /** Seedcord instance threw during startup. */\n    CliStartFailed = 3109,\n    /** Config is missing the required entry string. */\n    CliConfigMissingEntry = 3110,\n    /** Config build options must be an object when provided. */\n    CliConfigInvalidBuild = 3111,\n    /** Config build outDir must be a string when provided. */\n    CliConfigInvalidBuildOutDir = 3112,\n    /** Config build tsconfig must be a string when provided. */\n    CliConfigInvalidBuildTsconfig = 3113,\n    /** Config build bootstrap must be a string when provided. */\n    CliConfigInvalidBuildBootstrap = 3114,\n    /** Entry file must be inside the configured root directory. */\n    CliConfigEntryOutsideRoot = 3115,\n    /** Unable to locate a TypeScript config file for builds. */\n    CliBuildTsconfigNotFound = 3116,\n    /** TypeScript reported diagnostics during emit. */\n    CliBuildFailed = 3117,\n    /** Unable to write the generated bootstrap file. */\n    CliBootstrapWriteFailed = 3118,\n    /** Config tsconfig must be a string when provided. */\n    CliConfigInvalidTsconfig = 3119,\n    /** Config hmr options must be an object when provided. */\n    CliConfigInvalidHmr = 3120,\n    /** Config hmr restart patterns must be an array of strings when provided. */\n    CliConfigInvalidHmrRestart = 3121,\n    /** Two commands resolve to the same slash route during codegen. */\n    CliCodegenDuplicateRoute = 3122,\n    /** The commands directory could not be read during codegen. */\n    CliCodegenCommandsDirUnreadable = 3123,\n    /** Two context-menu commands of the same kind share a name during codegen. */\n    CliCodegenDuplicateContextMenu = 3124,\n    /** Could not resolve the application from the bot token during `commands --clean`. */\n    CliCleanAppFetchFailed = 3126,\n    /** `commands --clean` ran with neither --guild nor --all-guilds, so there is nothing to scan. */\n    CliCleanNoGuilds = 3127,\n    /** `commands --clean` combined --purge with --all-guilds, which would wipe every guild. */\n    CliCleanPurgeAllGuilds = 3128,\n    /** An interactive prompt was cancelled (Ctrl-C), so the command aborts without changes. */\n    CliCancelled = 3129,\n    /** `commands --clean --all-guilds` matched more guilds than the safety threshold without `--yes`. */\n    CliCleanLargeBotUnconfirmed = 3130,\n    /** `commands --clean --apply` ran in a non-interactive environment without `--yes`, where it cannot prompt. */\n    CliCleanApplyNeedsYes = 3131\n}\n","import { SeedcordErrorCode } from './ErrorCodes';\n\n/** @internal */\nconst messages = {\n    [SeedcordErrorCode.ConfigMissingDiscordToken]: () => 'Missing DISCORD_BOT_TOKEN environment variable.',\n    [SeedcordErrorCode.ConfigIncorrectDiscordToken]: () => 'Invalid DISCORD_BOT_TOKEN value.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing]: () =>\n        'Missing UNKNOWN_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid]: () => 'Invalid UNKNOWN_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookMissing]: () =>\n        'Missing HANDLED_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookInvalid]: () => 'Invalid HANDLED_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigEmojiUnresolved]: (count: number, failures: string) =>\n        `Could not resolve ${count} configured emoji${count === 1 ? '' : 's'} at startup.\\n${failures}`,\n\n    [SeedcordErrorCode.LifecycleAddAfterCompletion]: () =>\n        'Cannot add tasks after startup sequence has already completed.',\n    [SeedcordErrorCode.LifecycleAddDuringRun]: () => 'Cannot add tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleRemoveDuringRun]: () => 'Cannot remove tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleUnknownPhase]: (phase: unknown) => `Unknown phase: ${String(phase)}.`,\n    [SeedcordErrorCode.LifecyclePhaseFailures]: (phase: string, failures: number) =>\n        `Phase ${phase} completed with ${failures} failed task${failures === 1 ? '' : 's'}.`,\n    [SeedcordErrorCode.LifecycleTaskTimeout]: (taskName: string, timeout: number) =>\n        `Task \"${taskName}\" timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CoreSingletonViolation]: () =>\n        'Seedcord can only be instantiated once. Use the existing instance instead.',\n    [SeedcordErrorCode.CorePluginAfterInit]: () => 'Cannot attach a plugin after initialization.',\n    [SeedcordErrorCode.CorePluginKeyExists]: (key: string) => `Plugin with key \"${key}\" already exists.`,\n    [SeedcordErrorCode.CoreBotRoleMissing]: (guildId?: string) =>\n        guildId ? `Bot role not found in guild ${guildId}.` : 'Bot role not found in guild.',\n    [SeedcordErrorCode.CoreControllerPathMissing]: (controllerName: string, pathKind: string) =>\n        `${controllerName} was instantiated without a ${pathKind} path.`,\n\n    [SeedcordErrorCode.DecoratorInteractionEventFilter]: () => 'Interaction middleware cannot specify event filters.',\n    [SeedcordErrorCode.DecoratorMethodNotFound]: () =>\n        'Decorator could not locate the original method. Ensure the method exists before applying the decorator.',\n    [SeedcordErrorCode.DecoratorCommandAlreadyRegistered]: (\n        commandName: string,\n        existingScope: string,\n        requestedScope: string\n    ) =>\n        `Command \"${commandName}\" is already registered as a \"${existingScope}\" command and cannot be re-registered as a \"${requestedScope}\" command.`,\n    [SeedcordErrorCode.DecoratorCommandGlobalWithGuilds]: () =>\n        'RegisterCommand(\"global\") cannot have guilds specified.',\n    [SeedcordErrorCode.DecoratorCommandGuildWithoutGuilds]: () =>\n        'RegisterCommand(\"guild\") requires a non-empty guilds array.',\n    [SeedcordErrorCode.DecoratorInvalidMiddlewarePriority]: () => 'Middleware priority must be a finite number.',\n\n    [SeedcordErrorCode.EventEmitterWaitForAborted]: () => 'waitFor was aborted via its AbortSignal.',\n    [SeedcordErrorCode.EventEmitterWaitForTimeout]: (timeout: number) => `waitFor timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CustomIdInvalidPrefix]: (prefix: string) =>\n        `customId prefix ${JSON.stringify(prefix)} must be a non-empty string without a colon or control character.`,\n    [SeedcordErrorCode.CustomIdReservedFieldName]: (field: string) =>\n        `customId field name ${JSON.stringify(field)} is integer-like, which JS reorders. Use a non-numeric name.`,\n    [SeedcordErrorCode.CustomIdEmptyChoices]: (field: string) =>\n        `customId field ${JSON.stringify(field)} uses oneOf() with no choices.`,\n    [SeedcordErrorCode.CustomIdInvalidBounds]: (field: string, min: number, max: number) =>\n        `customId field ${JSON.stringify(field)} has min ${min} greater than max ${max}.`,\n    [SeedcordErrorCode.CustomIdValueOutOfRange]: (field: string, value: string) =>\n        `customId field ${JSON.stringify(field)} got value ${value} outside its allowed range.`,\n    [SeedcordErrorCode.CustomIdWireTooLong]: (length: number) =>\n        `Encoded customId is ${length} characters, Discord allows at most 100.`,\n    [SeedcordErrorCode.CustomIdDuplicateFieldName]: (field: string) =>\n        `customId field ${JSON.stringify(field)} is already defined in this chain.`,\n    [SeedcordErrorCode.CustomIdHandlerRouteMissing]: (className: string) =>\n        `${className} is missing its route decorator (@ButtonRoute, @ModalRoute, or @SelectMenuRoute).`,\n    [SeedcordErrorCode.CustomIdMatchArmMissing]: (prefix: string) =>\n        `match() has no arm for the decoded route ${JSON.stringify(prefix)}.`,\n    [SeedcordErrorCode.SlashMatchArmMissing]: (route: string) =>\n        `match() has no arm for the command route ${JSON.stringify(route)}.`,\n    [SeedcordErrorCode.AutocompleteMatchArmMissing]: (field: string) =>\n        `match() has no arm for the focused field ${JSON.stringify(field)}.`,\n    [SeedcordErrorCode.EventMatchArmMissing]: (event: string) =>\n        `match() has no arm for the event ${JSON.stringify(event)}.`,\n    [SeedcordErrorCode.EventMiddlewareNameUnavailable]: () =>\n        `this.eventName is only available on middleware the controller constructed with a fired event name.`,\n\n    [SeedcordErrorCode.GateInvalidCooldownDuration]: (input: string) =>\n        `Cooldown duration ${JSON.stringify(input)} is not valid. Pass a number of seconds or a duration string like '30m', '24h', or '500ms'.`,\n\n    [SeedcordErrorCode.PaginationInvalidPerPage]: (perPage: number) =>\n        `perPage must be a positive integer, got ${perPage}.`,\n    [SeedcordErrorCode.PaginationTooManyControls]: (count: number) =>\n        `A control row holds at most 5 buttons, got ${count}.`,\n    [SeedcordErrorCode.PaginationEmptyControls]: () => `A control row must hold at least one control.`,\n    [SeedcordErrorCode.PaginationDuplicateControls]: (key: string) =>\n        `A control row cannot repeat the '${key}' control.`,\n\n    [SeedcordErrorCode.PluginMongoServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoService on ${className}.`,\n    [SeedcordErrorCode.PluginMongoModelDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoModel on ${className}.`,\n    [SeedcordErrorCode.PluginMongoConnectionFailed]: (databaseName?: string) =>\n        databaseName ? `Could not connect to MongoDB (${databaseName}).` : 'Could not connect to MongoDB.',\n    [SeedcordErrorCode.PluginMongoDisconnectFailed]: () => 'Failed to disconnect from MongoDB cleanly during shutdown.',\n    [SeedcordErrorCode.PluginMongoServicesNotReady]: () =>\n        'Mongo services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.PluginKpgServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterKpgService on ${className}.`,\n    [SeedcordErrorCode.PluginKpgServiceTableMissing]: (className: string) =>\n        `Missing table metadata for ${className}. Provide a table via @RegisterKpgService().`,\n    [SeedcordErrorCode.PluginKpgInvalidStepCount]: () => 'Migration step count must be a non-negative integer.',\n    [SeedcordErrorCode.PluginKpgUnknownDirection]: (direction: unknown) =>\n        `Unknown migration direction: ${String(direction)}.`,\n    [SeedcordErrorCode.PluginKpgUnresolvedMigrationsPath]: (label: string) =>\n        `Unable to resolve migrations at path: ${label}.`,\n    [SeedcordErrorCode.PluginKpgNoMigrationFiles]: () => 'No migration files provided.',\n    [SeedcordErrorCode.PluginKpgInvalidMigrationModule]: (filePath: string) =>\n        `Migration file ${filePath} must export async functions up and down.`,\n    [SeedcordErrorCode.PluginKpgNonErrorFailure]: (message: string) => `Migration failure: ${message}.`,\n    [SeedcordErrorCode.PluginKpgDisconnectFailed]: () => 'Failed to close the Postgres pool cleanly during shutdown.',\n    [SeedcordErrorCode.PluginKpgServicesNotReady]: () =>\n        'KPG services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.CliConfigInvalidExport]: () => 'Config file must default export an object.',\n    [SeedcordErrorCode.CliConfigMissingInstance]: () =>\n        'Config must include an `instance` string that points to your Seedcord default export.',\n    [SeedcordErrorCode.CliConfigInvalidRoot]: () => 'Config `root` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigNotFound]: (baseDir: string, candidates: readonly string[]) =>\n        `Unable to locate a Seedcord config in ${baseDir}. Searched for ${candidates.join(', ')}.`,\n    [SeedcordErrorCode.CliConfigMissingEntry]: () =>\n        'Config must include an `entry` string that points to your startup script.',\n    [SeedcordErrorCode.CliConfigInvalidBuild]: () => 'Config `build` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildOutDir]: () => 'Config `build.outDir` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildTsconfig]: () => 'Config `build.tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildBootstrap]: () =>\n        'Config `build.bootstrap` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigEntryOutsideRoot]: (entryPath: string, root: string) =>\n        `Entry file ${entryPath} must reside inside configured root ${root}.`,\n    [SeedcordErrorCode.CliEntryNotFound]: (entryPath: string) => `Cannot find entry file at ${entryPath}.`,\n    [SeedcordErrorCode.CliTsxImportFailed]: (entryPath: string, reason: string) =>\n        `Failed to import ${entryPath} via tsx: ${reason}.`,\n    [SeedcordErrorCode.CliImportFailed]: (entryPath: string, nativeReason: string, fallbackReason: string) =>\n        `Failed to import ${entryPath}: ${nativeReason}. Fallback via jiti also failed: ${fallbackReason}.`,\n    [SeedcordErrorCode.CliInstanceInvalid]: () =>\n        'Seedcord instance must default export an object with a start() method.',\n    [SeedcordErrorCode.CliStartFailed]: (instancePath: string, reason: string) =>\n        `Failed to start Seedcord from ${instancePath}: ${reason}.`,\n    [SeedcordErrorCode.CliBuildTsconfigNotFound]: (hint: string) =>\n        `Unable to resolve a tsconfig for builds (${hint}). Provide build.tsconfig or add tsconfig.build.json / tsconfig.json.`,\n    [SeedcordErrorCode.CliBuildFailed]: (diagnostics: string) => `TypeScript build failed:\\n${diagnostics}`,\n    [SeedcordErrorCode.CliBootstrapWriteFailed]: (targetPath: string, reason: string) =>\n        `Failed to write bootstrap file at ${targetPath}: ${reason}.`,\n    [SeedcordErrorCode.CliConfigInvalidTsconfig]: () => 'Config `tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmr]: () => 'Config `hmr` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmrRestart]: () =>\n        'Config `hmr.restart` must be an array of strings when provided.',\n    [SeedcordErrorCode.CliCodegenDuplicateRoute]: (route: string, firstFile: string, secondFile: string) =>\n        `Two commands resolve to the same slash route \\`${route}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCodegenCommandsDirUnreadable]: (dir: string, reason: string) =>\n        `Could not read the commands directory ${dir} during codegen. ${reason}.`,\n    [SeedcordErrorCode.CliCodegenDuplicateContextMenu]: (\n        kind: string,\n        name: string,\n        firstFile: string,\n        secondFile: string\n    ) =>\n        `Two ${kind} context-menu commands share the name \\`${name}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCleanAppFetchFailed]: (reason: string) =>\n        `Could not resolve the application from the bot token. ${reason}.`,\n    [SeedcordErrorCode.CliCleanNoGuilds]: () =>\n        'No guilds given. Pass --guild <ids...> or --all-guilds. Global commands are never touched.',\n    [SeedcordErrorCode.CliCleanPurgeAllGuilds]: () =>\n        '--purge cannot be combined with --all-guilds. Use --guild <ids> to purge specific guilds.',\n    [SeedcordErrorCode.CliCancelled]: () => 'Cancelled.',\n    [SeedcordErrorCode.CliCleanLargeBotUnconfirmed]: (count: number) =>\n        `Refusing to scan ${count} guilds without confirmation. Re-run with --yes, or name specific guilds with --guild <ids>.`,\n    [SeedcordErrorCode.CliCleanApplyNeedsYes]: () =>\n        'Refusing to delete without confirmation in a non-interactive environment. Re-run with --yes.'\n} satisfies Record<SeedcordErrorCode, (...args: never[]) => string>;\n\n/** @internal */\nexport type SeedcordErrorArguments<Code extends SeedcordErrorCode> = Parameters<(typeof messages)[Code]>;\n\n/** @internal */\nexport function formatSeedcordErrorMessage<Code extends SeedcordErrorCode>(\n    code: Code,\n    args?: SeedcordErrorArguments<Code>\n): string {\n    const formatter = messages[code];\n    const resolvedArgs = (args ?? []) as unknown[];\n    return (formatter as (...params: unknown[]) => string)(...resolvedArgs);\n}\n","/* eslint-disable @typescript-eslint/no-unnecessary-condition */\nimport chalk from 'chalk';\n\nimport { SeedcordErrorCode } from './ErrorCodes';\nimport { formatSeedcordErrorMessage, type SeedcordErrorArguments } from './ErrorMessages';\n\n/**\n * String literal type for Seedcord error identifiers.\n *\n * @internal\n */\ntype SeedcordErrorIdentifier = keyof typeof SeedcordErrorCode;\n\n/**\n * Options for Seedcord errors.\n *\n * @internal\n */\ninterface SeedcordErrorOptions extends ErrorOptions {}\n\nfunction resolveIdentifier(code: SeedcordErrorCode): SeedcordErrorIdentifier {\n    return SeedcordErrorCode[code] as SeedcordErrorIdentifier;\n}\n\ntype SeedcordErrorPayload<Code extends SeedcordErrorCode> = SeedcordErrorArguments<Code> | undefined;\n\ntype SeedcordErrorCtorRest<Code extends SeedcordErrorCode> =\n    SeedcordErrorArguments<Code> extends []\n        ? [options?: SeedcordErrorOptions]\n        : [args: SeedcordErrorArguments<Code>, options?: SeedcordErrorOptions];\n\nfunction resolveCtorInputs<Code extends SeedcordErrorCode>(\n    rest: SeedcordErrorCtorRest<Code>\n): { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } {\n    const [maybeArgsOrOptions, maybeOptions] = rest;\n    if (Array.isArray(maybeArgsOrOptions)) {\n        const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n            args: maybeArgsOrOptions\n        };\n\n        if (maybeOptions !== undefined) {\n            result.options = maybeOptions;\n        }\n\n        return result;\n    }\n\n    const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n        args: undefined\n    };\n\n    if (maybeArgsOrOptions !== undefined) {\n        result.options = maybeArgsOrOptions;\n    }\n\n    return result;\n}\n\nfunction resolveMessage<Code extends SeedcordErrorCode>(code: Code, args: SeedcordErrorPayload<Code>): string {\n    return formatSeedcordErrorMessage(code, args);\n}\n\nfunction formatErrorName(name: string, _identifier: SeedcordErrorIdentifier, code: SeedcordErrorCode): string {\n    return `${chalk.bold.red(name)}[${chalk.gray(code)}]`;\n}\n\n/**\n * String literal type for Seedcord error class names.\n *\n * @internal\n */\nexport type SeedcordErrorTypeString = `Seedcord${'Error' | 'TypeError' | 'RangeError'}`;\n\ninterface BaseSeedcordError {\n    readonly code: SeedcordErrorCode;\n    readonly identifier: SeedcordErrorIdentifier;\n    readonly type: SeedcordErrorTypeString;\n}\n\n/**\n * Base class for Seedcord errors.\n */\nexport class SeedcordError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends Error\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * TypeError class for Seedcord errors.\n */\nexport class SeedcordTypeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends TypeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordTypeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * RangeError class for Seedcord errors.\n */\nexport class SeedcordRangeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends RangeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordRangeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * Variant type for Seedcord error classes.\n *\n * @internal\n */\ntype SeedcordErrorVariant<\n    Type extends SeedcordErrorTypeString,\n    Code extends SeedcordErrorCode\n> = Type extends 'SeedcordError'\n    ? SeedcordError<Code>\n    : Type extends 'SeedcordTypeError'\n      ? SeedcordTypeError<Code>\n      : SeedcordRangeError<Code>;\n\n/**\n * Union type of all Seedcord error variants for a specific error code.\n *\n * @internal\n */\ntype AnySeedcordErrorForCode<Code extends SeedcordErrorCode> = {\n    [Variant in SeedcordErrorTypeString]: SeedcordErrorVariant<Variant, Code>;\n}[SeedcordErrorTypeString];\n\n/**\n * Union type of all Seedcord errors filtered by error class.\n *\n * @internal\n */\ntype ErrorTypeFilter<Type extends SeedcordErrorTypeString | undefined> = Type extends SeedcordErrorTypeString\n    ? {\n          [Code in SeedcordErrorCode]: SeedcordErrorVariant<Type, Code>;\n      }[SeedcordErrorCode]\n    : AnySeedcordErrorForCode<SeedcordErrorCode>;\n\n/**\n * Union type of all Seedcord errors filtered by error class and error code.\n *\n * @internal\n */\nexport type ErrorCodeFilter<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n> = Code extends SeedcordErrorCode\n    ? Type extends SeedcordErrorTypeString\n        ? SeedcordErrorVariant<Type, Code>\n        : AnySeedcordErrorForCode<Code>\n    : ErrorTypeFilter<Type>;\n\n/**\n * Determines whether an unknown value is a Seedcord error, with optional narrowing by class and error code.\n *\n * @param error - The value to inspect.\n * @param type - Optional error class discriminator (Error, TypeError, or RangeError).\n * @param code - Optional {@link SeedcordErrorCode} discriminator to narrow by code.\n * @typeParam Type - What kind of {@link SeedcordErrorTypeString} to filter by.\n * @typeParam Code - The specific {@link SeedcordErrorCode} to filter by.\n */\nexport function isSeedcordError<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n>(error: unknown, type?: Type, code?: Code): error is ErrorCodeFilter<Type, Code> {\n    const isSeedcordErrorInstance = error instanceof SeedcordError && error.type === 'SeedcordError';\n    const isSeedcordTypeErrorInstance = error instanceof SeedcordTypeError && error.type === 'SeedcordTypeError';\n    const isSeedcordRangeErrorInstance = error instanceof SeedcordRangeError && error.type === 'SeedcordRangeError';\n\n    if (!isSeedcordErrorInstance && !isSeedcordTypeErrorInstance && !isSeedcordRangeErrorInstance) {\n        return false;\n    }\n\n    const matchesType = type\n        ? (type === 'SeedcordError' && isSeedcordErrorInstance) ||\n          (type === 'SeedcordTypeError' && isSeedcordTypeErrorInstance) ||\n          (type === 'SeedcordRangeError' && isSeedcordRangeErrorInstance)\n        : true;\n\n    if (!matchesType) return false;\n    if (code === undefined) return true;\n    return error.code === code;\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_SeedcordError = require('./SeedcordError-DM9aR_TV.cjs');
+const require_SeedcordError = require('./SeedcordError-DuwkdU7a.cjs');
 
 //#region src/index.ts
 /** Package version */
-const version = "0.2.0";
+const version = "0.2.1-next.1";
 
 //#endregion
 exports.SeedcordErrorCode = require_SeedcordError.SeedcordErrorCode;

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as isSeedcordError, n as SeedcordErrorTypeString, o as SeedcordErrorCode } from "./SeedcordError-be6Sx70F.mjs";
+import { a as isSeedcordError, n as SeedcordErrorTypeString, o as SeedcordErrorCode } from "./SeedcordError-CVffUw6p.mjs";
 
 //#region src/index.d.ts
 /** Package version */

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { a as SeedcordErrorCode, i as isSeedcordError } from "./SeedcordError-CFIfQXET.mjs";
+import { a as SeedcordErrorCode, i as isSeedcordError } from "./SeedcordError-DW6ZuyOg.mjs";
 
 //#region src/index.ts
 /** Package version */
-const version = "0.2.0";
+const version = "0.2.1-next.1";
 
 //#endregion
 export { SeedcordErrorCode, isSeedcordError, version };

package/dist/internal.index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_SeedcordError = require('./SeedcordError-DM9aR_TV.cjs');
+const require_SeedcordError = require('./SeedcordError-DuwkdU7a.cjs');
 
 //#region src/validateDiscordToken.ts
 /** @internal */

package/dist/internal.index.d.mts

@@ -1,4 +1,4 @@
-import { i as SeedcordTypeError, r as SeedcordRangeError, t as SeedcordError } from "./SeedcordError-be6Sx70F.mjs";
+import { i as SeedcordTypeError, r as SeedcordRangeError, t as SeedcordError } from "./SeedcordError-CVffUw6p.mjs";
 
 //#region src/validateDiscordToken.d.ts
 /** @internal */

package/dist/internal.index.mjs

@@ -1,4 +1,4 @@
-import { a as SeedcordErrorCode, n as SeedcordRangeError, r as SeedcordTypeError, t as SeedcordError } from "./SeedcordError-CFIfQXET.mjs";
+import { a as SeedcordErrorCode, n as SeedcordRangeError, r as SeedcordTypeError, t as SeedcordError } from "./SeedcordError-DW6ZuyOg.mjs";
 
 //#region src/validateDiscordToken.ts
 /** @internal */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seedcord/errors",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.2.1-next.1",
   "description": "Framework error classes for Seedcord packages",
   "repository": {
     "type": "git",
@@ -44,9 +44,9 @@
     "chalk": "^5.6.2"
   },
   "devDependencies": {
-    "@seedcord/eslint-config": "1.4.2",
-    "@seedcord/tsconfig": "2.0.0",
-    "@seedcord/tsdown-config": "2.0.0"
+    "@seedcord/eslint-config": "1.4.3-next.0",
+    "@seedcord/tsconfig": "2.0.1-next.0",
+    "@seedcord/tsdown-config": "2.0.1-next.0"
   },
   "publishConfig": {
     "access": "public",
@@ -64,5 +64,5 @@
     "test:watch": "vitest dev",
     "coverage": "vitest run --coverage"
   },
-  "readme": "<p align=\"center\">\n  <img src=\"https://cdn.seedcord.org/assets/banner.webp\" alt=\"seedcord\" width=\"100%\" />\n</p>\n\n---\n\n_This repository is a work in progress._\n\n- There are no stable releases yet but changes are being made actively.\n- Till a major v1.0.0 release for seedcord, expect breaking changes in minor versions.\n- Documentation will come soon as well!\n\nIf you'd like to try it out, you can check out the code in `mock`\n"
+  "readme": "<p align=\"center\">\n  <img src=\"https://cdn.seedcord.org/assets/banner.webp\" alt=\"seedcord\" width=\"100%\" />\n</p>\n\n---\n\n_This repository is a work in progress._\n\n- There are no stable releases yet but changes are being made actively.\n- Until a major v1.0.0 release for seedcord, expect breaking changes in minor versions.\n- Documentation will come soon as well!\n\nIf you'd like to try it out, you can check out the code in `mock`\n"
 }

package/dist/SeedcordError-CFIfQXET.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"SeedcordError-CFIfQXET.mjs","names":[],"sources":["../src/ErrorCodes.ts","../src/ErrorMessages.ts","../src/SeedcordError.ts"],"sourcesContent":["/* eslint-disable no-magic-numbers */\n\n/**\n * All Seedcord error codes.\n */\nexport enum SeedcordErrorCode {\n    /** DISCORD_BOT_TOKEN is not present in the environment. */\n    ConfigMissingDiscordToken = 1001,\n    /** DISCORD_BOT_TOKEN is present but fails validation. */\n    ConfigIncorrectDiscordToken = 1004,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigUnknownExceptionWebhookMissing = 1002,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigUnknownExceptionWebhookInvalid = 1003,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigHandledExceptionWebhookMissing = 1005,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigHandledExceptionWebhookInvalid = 1006,\n    /** One or more configured emojis could not be resolved at startup. */\n    ConfigEmojiUnresolved = 1007,\n\n    /** Attempted to add lifecycle tasks after startup already completed. */\n    LifecycleAddAfterCompletion = 1101,\n    /** Attempted to add lifecycle tasks while startup is still running. */\n    LifecycleAddDuringRun = 1102,\n    /** Attempted to remove lifecycle tasks while startup is still running. */\n    LifecycleRemoveDuringRun = 1103,\n    /** Provided lifecycle phase identifier is not recognized. */\n    LifecycleUnknownPhase = 1104,\n    /** Startup phase completed with one or more task failures. */\n    LifecyclePhaseFailures = 1105,\n    /** A lifecycle task exceeded its configured timeout. */\n    LifecycleTaskTimeout = 1106,\n\n    /** Multiple Seedcord instances were created simultaneously. */\n    CoreSingletonViolation = 1201,\n    /** Plugins cannot be mutated after the core has finished initializing. */\n    CorePluginAfterInit = 1202,\n    /** A plugin tried to register with a key that already exists. */\n    CorePluginKeyExists = 1203,\n    /** Bot role lookup failed within the provided guild. */\n    CoreBotRoleMissing = 1204,\n    /** A bot controller was constructed without its required handlers directory. */\n    CoreControllerPathMissing = 1205,\n\n    /** Interaction middleware decorated with disallowed event filters. */\n    DecoratorInteractionEventFilter = 1301,\n    /** A decorator could not find the original method being decorated. */\n    DecoratorMethodNotFound = 1302,\n    /** A command decorator attempted to re-register an existing command scope. */\n    DecoratorCommandAlreadyRegistered = 1303,\n    /** A global command decorator specified guild IDs, which is not allowed. */\n    DecoratorCommandGlobalWithGuilds = 1304,\n    /** A guild command decorator omitted the required guild ID list. */\n    DecoratorCommandGuildWithoutGuilds = 1305,\n    /** Middleware priority provided by the decorator was not a finite number. */\n    DecoratorInvalidMiddlewarePriority = 1306,\n\n    /** StrictEventEmitter.waitFor was aborted via its AbortSignal. */\n    EventEmitterWaitForAborted = 1501,\n    /** StrictEventEmitter.waitFor exceeded its configured timeout. */\n    EventEmitterWaitForTimeout = 1502,\n\n    /** A customId definition prefix contains a reserved character (a colon or a control char). */\n    CustomIdInvalidPrefix = 1601,\n    /** A customId field name is integer-like, which JS would silently reorder. */\n    CustomIdReservedFieldName = 1602,\n    /** A oneOf() field was declared with no choices. */\n    CustomIdEmptyChoices = 1603,\n    /** An int() field was declared with min greater than max. */\n    CustomIdInvalidBounds = 1604,\n    /** A value passed to encode() is outside its field's allowed range. */\n    CustomIdValueOutOfRange = 1605,\n    /** An encoded customId exceeds Discord's 100-character limit. */\n    CustomIdWireTooLong = 1606,\n    /** A field name is declared more than once in the same customId chain. */\n    CustomIdDuplicateFieldName = 1607,\n    /** A component handler is missing its route decorator (\\@ButtonRoute / \\@ModalRoute / \\@SelectMenuRoute). */\n    CustomIdHandlerRouteMissing = 1608,\n    /** match() received a decoded route with no matching arm. */\n    CustomIdMatchArmMissing = 1609,\n    /** A slash handler's match() has no arm for the command route that fired. */\n    SlashMatchArmMissing = 1610,\n    /** An autocomplete handler's match() has no arm for the focused field that fired. */\n    AutocompleteMatchArmMissing = 1611,\n    /** An event handler's match() has no arm for the event name that fired. */\n    EventMatchArmMissing = 1612,\n    /** Event middleware read `this.eventName` but was constructed without a fired event name. */\n    EventMiddlewareNameUnavailable = 1613,\n\n    /** A Cooldown gate was given a duration string that is not a well-formed positive duration. */\n    GateInvalidCooldownDuration = 1701,\n\n    /** Mongo service class is missing the `@RegisterMongoService` decorator. */\n    PluginMongoServiceDecoratorMissing = 2101,\n    /** Mongo model class is missing the `@RegisterMongoModel` decorator. */\n    PluginMongoModelDecoratorMissing = 2102,\n    /** Mongo client failed to establish a connection. */\n    PluginMongoConnectionFailed = 2103,\n    /** Mongo client failed to disconnect cleanly during shutdown. */\n    PluginMongoDisconnectFailed = 2104,\n    /** Mongo `services` was accessed before the plugin finished initializing. */\n    PluginMongoServicesNotReady = 2105,\n\n    /** KPG service class is missing the `@RegisterKpgService` decorator. */\n    PluginKpgServiceDecoratorMissing = 2201,\n    /** KPG service class is missing its table metadata. */\n    PluginKpgServiceTableMissing = 2202,\n    /** Migration manager received an invalid step count. */\n    PluginKpgInvalidStepCount = 2203,\n    /** Migration direction was not recognized. */\n    PluginKpgUnknownDirection = 2204,\n    /** Provided migrations path could not be resolved. */\n    PluginKpgUnresolvedMigrationsPath = 2205,\n    /** No migration files were found for execution. */\n    PluginKpgNoMigrationFiles = 2206,\n    /** A migration module failed to export the expected functions. */\n    PluginKpgInvalidMigrationModule = 2207,\n    /** An arbitrary (non-Error) failure was reported by a migration. */\n    PluginKpgNonErrorFailure = 2208,\n    /** Postgres pool failed to close cleanly during shutdown. */\n    PluginKpgDisconnectFailed = 2209,\n    /** KPG `services` was accessed before the plugin finished initializing. */\n    PluginKpgServicesNotReady = 2210,\n\n    /** Config file default export was not an object. */\n    CliConfigInvalidExport = 3101,\n    /** Config is missing the required instance string. */\n    CliConfigMissingInstance = 3102,\n    /** Config root was provided but not a string. */\n    CliConfigInvalidRoot = 3103,\n    /** Unable to locate a Seedcord config file. */\n    CliConfigNotFound = 3104,\n    /** CLI entry file does not exist. */\n    CliEntryNotFound = 3105,\n    /** tsx failed to import the provided entry file. */\n    CliTsxImportFailed = 3106,\n    /** Native import and jiti fallback both failed. */\n    CliImportFailed = 3107,\n    /** Seedcord instance export is missing a start() method. */\n    CliInstanceInvalid = 3108,\n    /** Seedcord instance threw during startup. */\n    CliStartFailed = 3109,\n    /** Config is missing the required entry string. */\n    CliConfigMissingEntry = 3110,\n    /** Config build options must be an object when provided. */\n    CliConfigInvalidBuild = 3111,\n    /** Config build outDir must be a string when provided. */\n    CliConfigInvalidBuildOutDir = 3112,\n    /** Config build tsconfig must be a string when provided. */\n    CliConfigInvalidBuildTsconfig = 3113,\n    /** Config build bootstrap must be a string when provided. */\n    CliConfigInvalidBuildBootstrap = 3114,\n    /** Entry file must be inside the configured root directory. */\n    CliConfigEntryOutsideRoot = 3115,\n    /** Unable to locate a TypeScript config file for builds. */\n    CliBuildTsconfigNotFound = 3116,\n    /** TypeScript reported diagnostics during emit. */\n    CliBuildFailed = 3117,\n    /** Unable to write the generated bootstrap file. */\n    CliBootstrapWriteFailed = 3118,\n    /** Config tsconfig must be a string when provided. */\n    CliConfigInvalidTsconfig = 3119,\n    /** Config hmr options must be an object when provided. */\n    CliConfigInvalidHmr = 3120,\n    /** Config hmr restart patterns must be an array of strings when provided. */\n    CliConfigInvalidHmrRestart = 3121,\n    /** Two commands resolve to the same slash route during codegen. */\n    CliCodegenDuplicateRoute = 3122,\n    /** The commands directory could not be read during codegen. */\n    CliCodegenCommandsDirUnreadable = 3123,\n    /** Two context-menu commands of the same kind share a name during codegen. */\n    CliCodegenDuplicateContextMenu = 3124,\n    /** Could not resolve the application from the bot token during `commands --clean`. */\n    CliCleanAppFetchFailed = 3126,\n    /** `commands --clean` ran with neither --guild nor --all-guilds, so there is nothing to scan. */\n    CliCleanNoGuilds = 3127,\n    /** `commands --clean` combined --purge with --all-guilds, which would wipe every guild. */\n    CliCleanPurgeAllGuilds = 3128,\n    /** An interactive prompt was cancelled (Ctrl-C), so the command aborts without changes. */\n    CliCancelled = 3129,\n    /** `commands --clean --all-guilds` matched more guilds than the safety threshold without `--yes`. */\n    CliCleanLargeBotUnconfirmed = 3130,\n    /** `commands --clean --apply` ran in a non-interactive environment without `--yes`, where it cannot prompt. */\n    CliCleanApplyNeedsYes = 3131\n}\n","import { SeedcordErrorCode } from './ErrorCodes';\n\n/** @internal */\nconst messages = {\n    [SeedcordErrorCode.ConfigMissingDiscordToken]: () => 'Missing DISCORD_BOT_TOKEN environment variable.',\n    [SeedcordErrorCode.ConfigIncorrectDiscordToken]: () => 'Invalid DISCORD_BOT_TOKEN value.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing]: () =>\n        'Missing UNKNOWN_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid]: () => 'Invalid UNKNOWN_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookMissing]: () =>\n        'Missing HANDLED_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookInvalid]: () => 'Invalid HANDLED_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigEmojiUnresolved]: (count: number, failures: string) =>\n        `Could not resolve ${count} configured emoji${count === 1 ? '' : 's'} at startup.\\n${failures}`,\n\n    [SeedcordErrorCode.LifecycleAddAfterCompletion]: () =>\n        'Cannot add tasks after startup sequence has already completed.',\n    [SeedcordErrorCode.LifecycleAddDuringRun]: () => 'Cannot add tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleRemoveDuringRun]: () => 'Cannot remove tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleUnknownPhase]: (phase: unknown) => `Unknown phase: ${String(phase)}.`,\n    [SeedcordErrorCode.LifecyclePhaseFailures]: (phase: string, failures: number) =>\n        `Phase ${phase} completed with ${failures} failed task${failures === 1 ? '' : 's'}.`,\n    [SeedcordErrorCode.LifecycleTaskTimeout]: (taskName: string, timeout: number) =>\n        `Task \"${taskName}\" timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CoreSingletonViolation]: () =>\n        'Seedcord can only be instantiated once. Use the existing instance instead.',\n    [SeedcordErrorCode.CorePluginAfterInit]: () => 'Cannot attach a plugin after initialization.',\n    [SeedcordErrorCode.CorePluginKeyExists]: (key: string) => `Plugin with key \"${key}\" already exists.`,\n    [SeedcordErrorCode.CoreBotRoleMissing]: (guildId?: string) =>\n        guildId ? `Bot role not found in guild ${guildId}.` : 'Bot role not found in guild.',\n    [SeedcordErrorCode.CoreControllerPathMissing]: (controllerName: string, pathKind: string) =>\n        `${controllerName} was instantiated without a ${pathKind} path.`,\n\n    [SeedcordErrorCode.DecoratorInteractionEventFilter]: () => 'Interaction middleware cannot specify event filters.',\n    [SeedcordErrorCode.DecoratorMethodNotFound]: () =>\n        'Decorator could not locate the original method. Ensure the method exists before applying the decorator.',\n    [SeedcordErrorCode.DecoratorCommandAlreadyRegistered]: (\n        commandName: string,\n        existingScope: string,\n        requestedScope: string\n    ) =>\n        `Command \"${commandName}\" is already registered as a \"${existingScope}\" command and cannot be re-registered as a \"${requestedScope}\" command.`,\n    [SeedcordErrorCode.DecoratorCommandGlobalWithGuilds]: () =>\n        'RegisterCommand(\"global\") cannot have guilds specified.',\n    [SeedcordErrorCode.DecoratorCommandGuildWithoutGuilds]: () =>\n        'RegisterCommand(\"guild\") requires a non-empty guilds array.',\n    [SeedcordErrorCode.DecoratorInvalidMiddlewarePriority]: () => 'Middleware priority must be a finite number.',\n\n    [SeedcordErrorCode.EventEmitterWaitForAborted]: () => 'waitFor was aborted via its AbortSignal.',\n    [SeedcordErrorCode.EventEmitterWaitForTimeout]: (timeout: number) => `waitFor timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CustomIdInvalidPrefix]: (prefix: string) =>\n        `customId prefix ${JSON.stringify(prefix)} must be a non-empty string without a colon or control character.`,\n    [SeedcordErrorCode.CustomIdReservedFieldName]: (field: string) =>\n        `customId field name ${JSON.stringify(field)} is integer-like, which JS reorders. Use a non-numeric name.`,\n    [SeedcordErrorCode.CustomIdEmptyChoices]: (field: string) =>\n        `customId field ${JSON.stringify(field)} uses oneOf() with no choices.`,\n    [SeedcordErrorCode.CustomIdInvalidBounds]: (field: string, min: number, max: number) =>\n        `customId field ${JSON.stringify(field)} has min ${min} greater than max ${max}.`,\n    [SeedcordErrorCode.CustomIdValueOutOfRange]: (field: string, value: string) =>\n        `customId field ${JSON.stringify(field)} got value ${value} outside its allowed range.`,\n    [SeedcordErrorCode.CustomIdWireTooLong]: (length: number) =>\n        `Encoded customId is ${length} characters, Discord allows at most 100.`,\n    [SeedcordErrorCode.CustomIdDuplicateFieldName]: (field: string) =>\n        `customId field ${JSON.stringify(field)} is already defined in this chain.`,\n    [SeedcordErrorCode.CustomIdHandlerRouteMissing]: (className: string) =>\n        `${className} is missing its route decorator (@ButtonRoute, @ModalRoute, or @SelectMenuRoute).`,\n    [SeedcordErrorCode.CustomIdMatchArmMissing]: (prefix: string) =>\n        `match() has no arm for the decoded route ${JSON.stringify(prefix)}.`,\n    [SeedcordErrorCode.SlashMatchArmMissing]: (route: string) =>\n        `match() has no arm for the command route ${JSON.stringify(route)}.`,\n    [SeedcordErrorCode.AutocompleteMatchArmMissing]: (field: string) =>\n        `match() has no arm for the focused field ${JSON.stringify(field)}.`,\n    [SeedcordErrorCode.EventMatchArmMissing]: (event: string) =>\n        `match() has no arm for the event ${JSON.stringify(event)}.`,\n    [SeedcordErrorCode.EventMiddlewareNameUnavailable]: () =>\n        `this.eventName is only available on middleware the controller constructed with a fired event name.`,\n\n    [SeedcordErrorCode.GateInvalidCooldownDuration]: (input: string) =>\n        `Cooldown duration ${JSON.stringify(input)} is not valid. Pass a number of seconds or a duration string like '30m', '24h', or '500ms'.`,\n\n    [SeedcordErrorCode.PluginMongoServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoService on ${className}.`,\n    [SeedcordErrorCode.PluginMongoModelDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoModel on ${className}.`,\n    [SeedcordErrorCode.PluginMongoConnectionFailed]: (databaseName?: string) =>\n        databaseName ? `Could not connect to MongoDB (${databaseName}).` : 'Could not connect to MongoDB.',\n    [SeedcordErrorCode.PluginMongoDisconnectFailed]: () => 'Failed to disconnect from MongoDB cleanly during shutdown.',\n    [SeedcordErrorCode.PluginMongoServicesNotReady]: () =>\n        'Mongo services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.PluginKpgServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterKpgService on ${className}.`,\n    [SeedcordErrorCode.PluginKpgServiceTableMissing]: (className: string) =>\n        `Missing table metadata for ${className}. Provide a table via @RegisterKpgService().`,\n    [SeedcordErrorCode.PluginKpgInvalidStepCount]: () => 'Migration step count must be a non-negative integer.',\n    [SeedcordErrorCode.PluginKpgUnknownDirection]: (direction: unknown) =>\n        `Unknown migration direction: ${String(direction)}.`,\n    [SeedcordErrorCode.PluginKpgUnresolvedMigrationsPath]: (label: string) =>\n        `Unable to resolve migrations at path: ${label}.`,\n    [SeedcordErrorCode.PluginKpgNoMigrationFiles]: () => 'No migration files provided.',\n    [SeedcordErrorCode.PluginKpgInvalidMigrationModule]: (filePath: string) =>\n        `Migration file ${filePath} must export async functions up and down.`,\n    [SeedcordErrorCode.PluginKpgNonErrorFailure]: (message: string) => `Migration failure: ${message}.`,\n    [SeedcordErrorCode.PluginKpgDisconnectFailed]: () => 'Failed to close the Postgres pool cleanly during shutdown.',\n    [SeedcordErrorCode.PluginKpgServicesNotReady]: () =>\n        'KPG services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.CliConfigInvalidExport]: () => 'Config file must default export an object.',\n    [SeedcordErrorCode.CliConfigMissingInstance]: () =>\n        'Config must include an `instance` string that points to your Seedcord default export.',\n    [SeedcordErrorCode.CliConfigInvalidRoot]: () => 'Config `root` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigNotFound]: (baseDir: string, candidates: readonly string[]) =>\n        `Unable to locate a Seedcord config in ${baseDir}. Searched for ${candidates.join(', ')}.`,\n    [SeedcordErrorCode.CliConfigMissingEntry]: () =>\n        'Config must include an `entry` string that points to your startup script.',\n    [SeedcordErrorCode.CliConfigInvalidBuild]: () => 'Config `build` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildOutDir]: () => 'Config `build.outDir` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildTsconfig]: () => 'Config `build.tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildBootstrap]: () =>\n        'Config `build.bootstrap` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigEntryOutsideRoot]: (entryPath: string, root: string) =>\n        `Entry file ${entryPath} must reside inside configured root ${root}.`,\n    [SeedcordErrorCode.CliEntryNotFound]: (entryPath: string) => `Cannot find entry file at ${entryPath}.`,\n    [SeedcordErrorCode.CliTsxImportFailed]: (entryPath: string, reason: string) =>\n        `Failed to import ${entryPath} via tsx: ${reason}.`,\n    [SeedcordErrorCode.CliImportFailed]: (entryPath: string, nativeReason: string, fallbackReason: string) =>\n        `Failed to import ${entryPath}: ${nativeReason}. Fallback via jiti also failed: ${fallbackReason}.`,\n    [SeedcordErrorCode.CliInstanceInvalid]: () =>\n        'Seedcord instance must default export an object with a start() method.',\n    [SeedcordErrorCode.CliStartFailed]: (instancePath: string, reason: string) =>\n        `Failed to start Seedcord from ${instancePath}: ${reason}.`,\n    [SeedcordErrorCode.CliBuildTsconfigNotFound]: (hint: string) =>\n        `Unable to resolve a tsconfig for builds (${hint}). Provide build.tsconfig or add tsconfig.build.json / tsconfig.json.`,\n    [SeedcordErrorCode.CliBuildFailed]: (diagnostics: string) => `TypeScript build failed:\\n${diagnostics}`,\n    [SeedcordErrorCode.CliBootstrapWriteFailed]: (targetPath: string, reason: string) =>\n        `Failed to write bootstrap file at ${targetPath}: ${reason}.`,\n    [SeedcordErrorCode.CliConfigInvalidTsconfig]: () => 'Config `tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmr]: () => 'Config `hmr` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmrRestart]: () =>\n        'Config `hmr.restart` must be an array of strings when provided.',\n    [SeedcordErrorCode.CliCodegenDuplicateRoute]: (route: string, firstFile: string, secondFile: string) =>\n        `Two commands resolve to the same slash route \\`${route}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCodegenCommandsDirUnreadable]: (dir: string, reason: string) =>\n        `Could not read the commands directory ${dir} during codegen. ${reason}.`,\n    [SeedcordErrorCode.CliCodegenDuplicateContextMenu]: (\n        kind: string,\n        name: string,\n        firstFile: string,\n        secondFile: string\n    ) =>\n        `Two ${kind} context-menu commands share the name \\`${name}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCleanAppFetchFailed]: (reason: string) =>\n        `Could not resolve the application from the bot token. ${reason}.`,\n    [SeedcordErrorCode.CliCleanNoGuilds]: () =>\n        'No guilds given. Pass --guild <ids...> or --all-guilds. Global commands are never touched.',\n    [SeedcordErrorCode.CliCleanPurgeAllGuilds]: () =>\n        '--purge cannot be combined with --all-guilds. Use --guild <ids> to purge specific guilds.',\n    [SeedcordErrorCode.CliCancelled]: () => 'Cancelled.',\n    [SeedcordErrorCode.CliCleanLargeBotUnconfirmed]: (count: number) =>\n        `Refusing to scan ${count} guilds without confirmation. Re-run with --yes, or name specific guilds with --guild <ids>.`,\n    [SeedcordErrorCode.CliCleanApplyNeedsYes]: () =>\n        'Refusing to delete without confirmation in a non-interactive environment. Re-run with --yes.'\n} satisfies Record<SeedcordErrorCode, (...args: never[]) => string>;\n\n/** @internal */\nexport type SeedcordErrorArguments<Code extends SeedcordErrorCode> = Parameters<(typeof messages)[Code]>;\n\n/** @internal */\nexport function formatSeedcordErrorMessage<Code extends SeedcordErrorCode>(\n    code: Code,\n    args?: SeedcordErrorArguments<Code>\n): string {\n    const formatter = messages[code];\n    const resolvedArgs = (args ?? []) as unknown[];\n    return (formatter as (...params: unknown[]) => string)(...resolvedArgs);\n}\n","/* eslint-disable @typescript-eslint/no-unnecessary-condition */\nimport chalk from 'chalk';\n\nimport { SeedcordErrorCode } from './ErrorCodes';\nimport { formatSeedcordErrorMessage, type SeedcordErrorArguments } from './ErrorMessages';\n\n/**\n * String literal type for Seedcord error identifiers.\n *\n * @internal\n */\ntype SeedcordErrorIdentifier = keyof typeof SeedcordErrorCode;\n\n/**\n * Options for Seedcord errors.\n *\n * @internal\n */\ninterface SeedcordErrorOptions extends ErrorOptions {}\n\nfunction resolveIdentifier(code: SeedcordErrorCode): SeedcordErrorIdentifier {\n    return SeedcordErrorCode[code] as SeedcordErrorIdentifier;\n}\n\ntype SeedcordErrorPayload<Code extends SeedcordErrorCode> = SeedcordErrorArguments<Code> | undefined;\n\ntype SeedcordErrorCtorRest<Code extends SeedcordErrorCode> =\n    SeedcordErrorArguments<Code> extends []\n        ? [options?: SeedcordErrorOptions]\n        : [args: SeedcordErrorArguments<Code>, options?: SeedcordErrorOptions];\n\nfunction resolveCtorInputs<Code extends SeedcordErrorCode>(\n    rest: SeedcordErrorCtorRest<Code>\n): { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } {\n    const [maybeArgsOrOptions, maybeOptions] = rest;\n    if (Array.isArray(maybeArgsOrOptions)) {\n        const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n            args: maybeArgsOrOptions\n        };\n\n        if (maybeOptions !== undefined) {\n            result.options = maybeOptions;\n        }\n\n        return result;\n    }\n\n    const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n        args: undefined\n    };\n\n    if (maybeArgsOrOptions !== undefined) {\n        result.options = maybeArgsOrOptions;\n    }\n\n    return result;\n}\n\nfunction resolveMessage<Code extends SeedcordErrorCode>(code: Code, args: SeedcordErrorPayload<Code>): string {\n    return formatSeedcordErrorMessage(code, args);\n}\n\nfunction formatErrorName(name: string, _identifier: SeedcordErrorIdentifier, code: SeedcordErrorCode): string {\n    return `${chalk.bold.red(name)}[${chalk.gray(code)}]`;\n}\n\n/**\n * String literal type for Seedcord error class names.\n *\n * @internal\n */\nexport type SeedcordErrorTypeString = `Seedcord${'Error' | 'TypeError' | 'RangeError'}`;\n\ninterface BaseSeedcordError {\n    readonly code: SeedcordErrorCode;\n    readonly identifier: SeedcordErrorIdentifier;\n    readonly type: SeedcordErrorTypeString;\n}\n\n/**\n * Base class for Seedcord errors.\n */\nexport class SeedcordError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends Error\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * TypeError class for Seedcord errors.\n */\nexport class SeedcordTypeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends TypeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordTypeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * RangeError class for Seedcord errors.\n */\nexport class SeedcordRangeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends RangeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordRangeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * Variant type for Seedcord error classes.\n *\n * @internal\n */\ntype SeedcordErrorVariant<\n    Type extends SeedcordErrorTypeString,\n    Code extends SeedcordErrorCode\n> = Type extends 'SeedcordError'\n    ? SeedcordError<Code>\n    : Type extends 'SeedcordTypeError'\n      ? SeedcordTypeError<Code>\n      : SeedcordRangeError<Code>;\n\n/**\n * Union type of all Seedcord error variants for a specific error code.\n *\n * @internal\n */\ntype AnySeedcordErrorForCode<Code extends SeedcordErrorCode> = {\n    [Variant in SeedcordErrorTypeString]: SeedcordErrorVariant<Variant, Code>;\n}[SeedcordErrorTypeString];\n\n/**\n * Union type of all Seedcord errors filtered by error class.\n *\n * @internal\n */\ntype ErrorTypeFilter<Type extends SeedcordErrorTypeString | undefined> = Type extends SeedcordErrorTypeString\n    ? {\n          [Code in SeedcordErrorCode]: SeedcordErrorVariant<Type, Code>;\n      }[SeedcordErrorCode]\n    : AnySeedcordErrorForCode<SeedcordErrorCode>;\n\n/**\n * Union type of all Seedcord errors filtered by error class and error code.\n *\n * @internal\n */\nexport type ErrorCodeFilter<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n> = Code extends SeedcordErrorCode\n    ? Type extends SeedcordErrorTypeString\n        ? SeedcordErrorVariant<Type, Code>\n        : AnySeedcordErrorForCode<Code>\n    : ErrorTypeFilter<Type>;\n\n/**\n * Determines whether an unknown value is a Seedcord error, with optional narrowing by class and error code.\n *\n * @param error - The value to inspect.\n * @param type - Optional error class discriminator (Error, TypeError, or RangeError).\n * @param code - Optional {@link SeedcordErrorCode} discriminator to narrow by code.\n * @typeParam Type - What kind of {@link SeedcordErrorTypeString} to filter by.\n * @typeParam Code - The specific {@link SeedcordErrorCode} to filter by.\n */\nexport function isSeedcordError<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n>(error: unknown, type?: Type, code?: Code): error is ErrorCodeFilter<Type, Code> {\n    const isSeedcordErrorInstance = error instanceof SeedcordError && error.type === 'SeedcordError';\n    const isSeedcordTypeErrorInstance = error instanceof SeedcordTypeError && error.type === 'SeedcordTypeError';\n    const isSeedcordRangeErrorInstance = error instanceof SeedcordRangeError && error.type === 'SeedcordRangeError';\n\n    if (!isSeedcordErrorInstance && !isSeedcordTypeErrorInstance && !isSeedcordRangeErrorInstance) {\n        return false;\n    }\n\n    const matchesType = type\n        ? (type === 'SeedcordError' && isSeedcordErrorInstance) ||\n          (type === 'SeedcordTypeError' && isSeedcordTypeErrorInstance) ||\n          (type === 'SeedcordRangeError' && isSeedcordRangeErrorInstance)\n        : true;\n\n    if (!matchesType) return false;\n    if (code === undefined) return true;\n    return error.code === code;\n}\n"],"mappings":"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"}

package/dist/SeedcordError-DM9aR_TV.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"SeedcordError-DM9aR_TV.cjs","names":[],"sources":["../src/ErrorCodes.ts","../src/ErrorMessages.ts","../src/SeedcordError.ts"],"sourcesContent":["/* eslint-disable no-magic-numbers */\n\n/**\n * All Seedcord error codes.\n */\nexport enum SeedcordErrorCode {\n    /** DISCORD_BOT_TOKEN is not present in the environment. */\n    ConfigMissingDiscordToken = 1001,\n    /** DISCORD_BOT_TOKEN is present but fails validation. */\n    ConfigIncorrectDiscordToken = 1004,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigUnknownExceptionWebhookMissing = 1002,\n    /** UNKNOWN_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigUnknownExceptionWebhookInvalid = 1003,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */\n    ConfigHandledExceptionWebhookMissing = 1005,\n    /** HANDLED_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */\n    ConfigHandledExceptionWebhookInvalid = 1006,\n    /** One or more configured emojis could not be resolved at startup. */\n    ConfigEmojiUnresolved = 1007,\n\n    /** Attempted to add lifecycle tasks after startup already completed. */\n    LifecycleAddAfterCompletion = 1101,\n    /** Attempted to add lifecycle tasks while startup is still running. */\n    LifecycleAddDuringRun = 1102,\n    /** Attempted to remove lifecycle tasks while startup is still running. */\n    LifecycleRemoveDuringRun = 1103,\n    /** Provided lifecycle phase identifier is not recognized. */\n    LifecycleUnknownPhase = 1104,\n    /** Startup phase completed with one or more task failures. */\n    LifecyclePhaseFailures = 1105,\n    /** A lifecycle task exceeded its configured timeout. */\n    LifecycleTaskTimeout = 1106,\n\n    /** Multiple Seedcord instances were created simultaneously. */\n    CoreSingletonViolation = 1201,\n    /** Plugins cannot be mutated after the core has finished initializing. */\n    CorePluginAfterInit = 1202,\n    /** A plugin tried to register with a key that already exists. */\n    CorePluginKeyExists = 1203,\n    /** Bot role lookup failed within the provided guild. */\n    CoreBotRoleMissing = 1204,\n    /** A bot controller was constructed without its required handlers directory. */\n    CoreControllerPathMissing = 1205,\n\n    /** Interaction middleware decorated with disallowed event filters. */\n    DecoratorInteractionEventFilter = 1301,\n    /** A decorator could not find the original method being decorated. */\n    DecoratorMethodNotFound = 1302,\n    /** A command decorator attempted to re-register an existing command scope. */\n    DecoratorCommandAlreadyRegistered = 1303,\n    /** A global command decorator specified guild IDs, which is not allowed. */\n    DecoratorCommandGlobalWithGuilds = 1304,\n    /** A guild command decorator omitted the required guild ID list. */\n    DecoratorCommandGuildWithoutGuilds = 1305,\n    /** Middleware priority provided by the decorator was not a finite number. */\n    DecoratorInvalidMiddlewarePriority = 1306,\n\n    /** StrictEventEmitter.waitFor was aborted via its AbortSignal. */\n    EventEmitterWaitForAborted = 1501,\n    /** StrictEventEmitter.waitFor exceeded its configured timeout. */\n    EventEmitterWaitForTimeout = 1502,\n\n    /** A customId definition prefix contains a reserved character (a colon or a control char). */\n    CustomIdInvalidPrefix = 1601,\n    /** A customId field name is integer-like, which JS would silently reorder. */\n    CustomIdReservedFieldName = 1602,\n    /** A oneOf() field was declared with no choices. */\n    CustomIdEmptyChoices = 1603,\n    /** An int() field was declared with min greater than max. */\n    CustomIdInvalidBounds = 1604,\n    /** A value passed to encode() is outside its field's allowed range. */\n    CustomIdValueOutOfRange = 1605,\n    /** An encoded customId exceeds Discord's 100-character limit. */\n    CustomIdWireTooLong = 1606,\n    /** A field name is declared more than once in the same customId chain. */\n    CustomIdDuplicateFieldName = 1607,\n    /** A component handler is missing its route decorator (\\@ButtonRoute / \\@ModalRoute / \\@SelectMenuRoute). */\n    CustomIdHandlerRouteMissing = 1608,\n    /** match() received a decoded route with no matching arm. */\n    CustomIdMatchArmMissing = 1609,\n    /** A slash handler's match() has no arm for the command route that fired. */\n    SlashMatchArmMissing = 1610,\n    /** An autocomplete handler's match() has no arm for the focused field that fired. */\n    AutocompleteMatchArmMissing = 1611,\n    /** An event handler's match() has no arm for the event name that fired. */\n    EventMatchArmMissing = 1612,\n    /** Event middleware read `this.eventName` but was constructed without a fired event name. */\n    EventMiddlewareNameUnavailable = 1613,\n\n    /** A Cooldown gate was given a duration string that is not a well-formed positive duration. */\n    GateInvalidCooldownDuration = 1701,\n\n    /** Mongo service class is missing the `@RegisterMongoService` decorator. */\n    PluginMongoServiceDecoratorMissing = 2101,\n    /** Mongo model class is missing the `@RegisterMongoModel` decorator. */\n    PluginMongoModelDecoratorMissing = 2102,\n    /** Mongo client failed to establish a connection. */\n    PluginMongoConnectionFailed = 2103,\n    /** Mongo client failed to disconnect cleanly during shutdown. */\n    PluginMongoDisconnectFailed = 2104,\n    /** Mongo `services` was accessed before the plugin finished initializing. */\n    PluginMongoServicesNotReady = 2105,\n\n    /** KPG service class is missing the `@RegisterKpgService` decorator. */\n    PluginKpgServiceDecoratorMissing = 2201,\n    /** KPG service class is missing its table metadata. */\n    PluginKpgServiceTableMissing = 2202,\n    /** Migration manager received an invalid step count. */\n    PluginKpgInvalidStepCount = 2203,\n    /** Migration direction was not recognized. */\n    PluginKpgUnknownDirection = 2204,\n    /** Provided migrations path could not be resolved. */\n    PluginKpgUnresolvedMigrationsPath = 2205,\n    /** No migration files were found for execution. */\n    PluginKpgNoMigrationFiles = 2206,\n    /** A migration module failed to export the expected functions. */\n    PluginKpgInvalidMigrationModule = 2207,\n    /** An arbitrary (non-Error) failure was reported by a migration. */\n    PluginKpgNonErrorFailure = 2208,\n    /** Postgres pool failed to close cleanly during shutdown. */\n    PluginKpgDisconnectFailed = 2209,\n    /** KPG `services` was accessed before the plugin finished initializing. */\n    PluginKpgServicesNotReady = 2210,\n\n    /** Config file default export was not an object. */\n    CliConfigInvalidExport = 3101,\n    /** Config is missing the required instance string. */\n    CliConfigMissingInstance = 3102,\n    /** Config root was provided but not a string. */\n    CliConfigInvalidRoot = 3103,\n    /** Unable to locate a Seedcord config file. */\n    CliConfigNotFound = 3104,\n    /** CLI entry file does not exist. */\n    CliEntryNotFound = 3105,\n    /** tsx failed to import the provided entry file. */\n    CliTsxImportFailed = 3106,\n    /** Native import and jiti fallback both failed. */\n    CliImportFailed = 3107,\n    /** Seedcord instance export is missing a start() method. */\n    CliInstanceInvalid = 3108,\n    /** Seedcord instance threw during startup. */\n    CliStartFailed = 3109,\n    /** Config is missing the required entry string. */\n    CliConfigMissingEntry = 3110,\n    /** Config build options must be an object when provided. */\n    CliConfigInvalidBuild = 3111,\n    /** Config build outDir must be a string when provided. */\n    CliConfigInvalidBuildOutDir = 3112,\n    /** Config build tsconfig must be a string when provided. */\n    CliConfigInvalidBuildTsconfig = 3113,\n    /** Config build bootstrap must be a string when provided. */\n    CliConfigInvalidBuildBootstrap = 3114,\n    /** Entry file must be inside the configured root directory. */\n    CliConfigEntryOutsideRoot = 3115,\n    /** Unable to locate a TypeScript config file for builds. */\n    CliBuildTsconfigNotFound = 3116,\n    /** TypeScript reported diagnostics during emit. */\n    CliBuildFailed = 3117,\n    /** Unable to write the generated bootstrap file. */\n    CliBootstrapWriteFailed = 3118,\n    /** Config tsconfig must be a string when provided. */\n    CliConfigInvalidTsconfig = 3119,\n    /** Config hmr options must be an object when provided. */\n    CliConfigInvalidHmr = 3120,\n    /** Config hmr restart patterns must be an array of strings when provided. */\n    CliConfigInvalidHmrRestart = 3121,\n    /** Two commands resolve to the same slash route during codegen. */\n    CliCodegenDuplicateRoute = 3122,\n    /** The commands directory could not be read during codegen. */\n    CliCodegenCommandsDirUnreadable = 3123,\n    /** Two context-menu commands of the same kind share a name during codegen. */\n    CliCodegenDuplicateContextMenu = 3124,\n    /** Could not resolve the application from the bot token during `commands --clean`. */\n    CliCleanAppFetchFailed = 3126,\n    /** `commands --clean` ran with neither --guild nor --all-guilds, so there is nothing to scan. */\n    CliCleanNoGuilds = 3127,\n    /** `commands --clean` combined --purge with --all-guilds, which would wipe every guild. */\n    CliCleanPurgeAllGuilds = 3128,\n    /** An interactive prompt was cancelled (Ctrl-C), so the command aborts without changes. */\n    CliCancelled = 3129,\n    /** `commands --clean --all-guilds` matched more guilds than the safety threshold without `--yes`. */\n    CliCleanLargeBotUnconfirmed = 3130,\n    /** `commands --clean --apply` ran in a non-interactive environment without `--yes`, where it cannot prompt. */\n    CliCleanApplyNeedsYes = 3131\n}\n","import { SeedcordErrorCode } from './ErrorCodes';\n\n/** @internal */\nconst messages = {\n    [SeedcordErrorCode.ConfigMissingDiscordToken]: () => 'Missing DISCORD_BOT_TOKEN environment variable.',\n    [SeedcordErrorCode.ConfigIncorrectDiscordToken]: () => 'Invalid DISCORD_BOT_TOKEN value.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing]: () =>\n        'Missing UNKNOWN_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid]: () => 'Invalid UNKNOWN_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookMissing]: () =>\n        'Missing HANDLED_EXCEPTION_WEBHOOK_URL environment variable.',\n    [SeedcordErrorCode.ConfigHandledExceptionWebhookInvalid]: () => 'Invalid HANDLED_EXCEPTION_WEBHOOK_URL value.',\n    [SeedcordErrorCode.ConfigEmojiUnresolved]: (count: number, failures: string) =>\n        `Could not resolve ${count} configured emoji${count === 1 ? '' : 's'} at startup.\\n${failures}`,\n\n    [SeedcordErrorCode.LifecycleAddAfterCompletion]: () =>\n        'Cannot add tasks after startup sequence has already completed.',\n    [SeedcordErrorCode.LifecycleAddDuringRun]: () => 'Cannot add tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleRemoveDuringRun]: () => 'Cannot remove tasks while startup sequence is in progress.',\n    [SeedcordErrorCode.LifecycleUnknownPhase]: (phase: unknown) => `Unknown phase: ${String(phase)}.`,\n    [SeedcordErrorCode.LifecyclePhaseFailures]: (phase: string, failures: number) =>\n        `Phase ${phase} completed with ${failures} failed task${failures === 1 ? '' : 's'}.`,\n    [SeedcordErrorCode.LifecycleTaskTimeout]: (taskName: string, timeout: number) =>\n        `Task \"${taskName}\" timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CoreSingletonViolation]: () =>\n        'Seedcord can only be instantiated once. Use the existing instance instead.',\n    [SeedcordErrorCode.CorePluginAfterInit]: () => 'Cannot attach a plugin after initialization.',\n    [SeedcordErrorCode.CorePluginKeyExists]: (key: string) => `Plugin with key \"${key}\" already exists.`,\n    [SeedcordErrorCode.CoreBotRoleMissing]: (guildId?: string) =>\n        guildId ? `Bot role not found in guild ${guildId}.` : 'Bot role not found in guild.',\n    [SeedcordErrorCode.CoreControllerPathMissing]: (controllerName: string, pathKind: string) =>\n        `${controllerName} was instantiated without a ${pathKind} path.`,\n\n    [SeedcordErrorCode.DecoratorInteractionEventFilter]: () => 'Interaction middleware cannot specify event filters.',\n    [SeedcordErrorCode.DecoratorMethodNotFound]: () =>\n        'Decorator could not locate the original method. Ensure the method exists before applying the decorator.',\n    [SeedcordErrorCode.DecoratorCommandAlreadyRegistered]: (\n        commandName: string,\n        existingScope: string,\n        requestedScope: string\n    ) =>\n        `Command \"${commandName}\" is already registered as a \"${existingScope}\" command and cannot be re-registered as a \"${requestedScope}\" command.`,\n    [SeedcordErrorCode.DecoratorCommandGlobalWithGuilds]: () =>\n        'RegisterCommand(\"global\") cannot have guilds specified.',\n    [SeedcordErrorCode.DecoratorCommandGuildWithoutGuilds]: () =>\n        'RegisterCommand(\"guild\") requires a non-empty guilds array.',\n    [SeedcordErrorCode.DecoratorInvalidMiddlewarePriority]: () => 'Middleware priority must be a finite number.',\n\n    [SeedcordErrorCode.EventEmitterWaitForAborted]: () => 'waitFor was aborted via its AbortSignal.',\n    [SeedcordErrorCode.EventEmitterWaitForTimeout]: (timeout: number) => `waitFor timed out after ${timeout}ms.`,\n\n    [SeedcordErrorCode.CustomIdInvalidPrefix]: (prefix: string) =>\n        `customId prefix ${JSON.stringify(prefix)} must be a non-empty string without a colon or control character.`,\n    [SeedcordErrorCode.CustomIdReservedFieldName]: (field: string) =>\n        `customId field name ${JSON.stringify(field)} is integer-like, which JS reorders. Use a non-numeric name.`,\n    [SeedcordErrorCode.CustomIdEmptyChoices]: (field: string) =>\n        `customId field ${JSON.stringify(field)} uses oneOf() with no choices.`,\n    [SeedcordErrorCode.CustomIdInvalidBounds]: (field: string, min: number, max: number) =>\n        `customId field ${JSON.stringify(field)} has min ${min} greater than max ${max}.`,\n    [SeedcordErrorCode.CustomIdValueOutOfRange]: (field: string, value: string) =>\n        `customId field ${JSON.stringify(field)} got value ${value} outside its allowed range.`,\n    [SeedcordErrorCode.CustomIdWireTooLong]: (length: number) =>\n        `Encoded customId is ${length} characters, Discord allows at most 100.`,\n    [SeedcordErrorCode.CustomIdDuplicateFieldName]: (field: string) =>\n        `customId field ${JSON.stringify(field)} is already defined in this chain.`,\n    [SeedcordErrorCode.CustomIdHandlerRouteMissing]: (className: string) =>\n        `${className} is missing its route decorator (@ButtonRoute, @ModalRoute, or @SelectMenuRoute).`,\n    [SeedcordErrorCode.CustomIdMatchArmMissing]: (prefix: string) =>\n        `match() has no arm for the decoded route ${JSON.stringify(prefix)}.`,\n    [SeedcordErrorCode.SlashMatchArmMissing]: (route: string) =>\n        `match() has no arm for the command route ${JSON.stringify(route)}.`,\n    [SeedcordErrorCode.AutocompleteMatchArmMissing]: (field: string) =>\n        `match() has no arm for the focused field ${JSON.stringify(field)}.`,\n    [SeedcordErrorCode.EventMatchArmMissing]: (event: string) =>\n        `match() has no arm for the event ${JSON.stringify(event)}.`,\n    [SeedcordErrorCode.EventMiddlewareNameUnavailable]: () =>\n        `this.eventName is only available on middleware the controller constructed with a fired event name.`,\n\n    [SeedcordErrorCode.GateInvalidCooldownDuration]: (input: string) =>\n        `Cooldown duration ${JSON.stringify(input)} is not valid. Pass a number of seconds or a duration string like '30m', '24h', or '500ms'.`,\n\n    [SeedcordErrorCode.PluginMongoServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoService on ${className}.`,\n    [SeedcordErrorCode.PluginMongoModelDecoratorMissing]: (className: string) =>\n        `Missing @RegisterMongoModel on ${className}.`,\n    [SeedcordErrorCode.PluginMongoConnectionFailed]: (databaseName?: string) =>\n        databaseName ? `Could not connect to MongoDB (${databaseName}).` : 'Could not connect to MongoDB.',\n    [SeedcordErrorCode.PluginMongoDisconnectFailed]: () => 'Failed to disconnect from MongoDB cleanly during shutdown.',\n    [SeedcordErrorCode.PluginMongoServicesNotReady]: () =>\n        'Mongo services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.PluginKpgServiceDecoratorMissing]: (className: string) =>\n        `Missing @RegisterKpgService on ${className}.`,\n    [SeedcordErrorCode.PluginKpgServiceTableMissing]: (className: string) =>\n        `Missing table metadata for ${className}. Provide a table via @RegisterKpgService().`,\n    [SeedcordErrorCode.PluginKpgInvalidStepCount]: () => 'Migration step count must be a non-negative integer.',\n    [SeedcordErrorCode.PluginKpgUnknownDirection]: (direction: unknown) =>\n        `Unknown migration direction: ${String(direction)}.`,\n    [SeedcordErrorCode.PluginKpgUnresolvedMigrationsPath]: (label: string) =>\n        `Unable to resolve migrations at path: ${label}.`,\n    [SeedcordErrorCode.PluginKpgNoMigrationFiles]: () => 'No migration files provided.',\n    [SeedcordErrorCode.PluginKpgInvalidMigrationModule]: (filePath: string) =>\n        `Migration file ${filePath} must export async functions up and down.`,\n    [SeedcordErrorCode.PluginKpgNonErrorFailure]: (message: string) => `Migration failure: ${message}.`,\n    [SeedcordErrorCode.PluginKpgDisconnectFailed]: () => 'Failed to close the Postgres pool cleanly during shutdown.',\n    [SeedcordErrorCode.PluginKpgServicesNotReady]: () =>\n        'KPG services accessed before the plugin finished initializing.',\n\n    [SeedcordErrorCode.CliConfigInvalidExport]: () => 'Config file must default export an object.',\n    [SeedcordErrorCode.CliConfigMissingInstance]: () =>\n        'Config must include an `instance` string that points to your Seedcord default export.',\n    [SeedcordErrorCode.CliConfigInvalidRoot]: () => 'Config `root` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigNotFound]: (baseDir: string, candidates: readonly string[]) =>\n        `Unable to locate a Seedcord config in ${baseDir}. Searched for ${candidates.join(', ')}.`,\n    [SeedcordErrorCode.CliConfigMissingEntry]: () =>\n        'Config must include an `entry` string that points to your startup script.',\n    [SeedcordErrorCode.CliConfigInvalidBuild]: () => 'Config `build` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildOutDir]: () => 'Config `build.outDir` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildTsconfig]: () => 'Config `build.tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidBuildBootstrap]: () =>\n        'Config `build.bootstrap` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigEntryOutsideRoot]: (entryPath: string, root: string) =>\n        `Entry file ${entryPath} must reside inside configured root ${root}.`,\n    [SeedcordErrorCode.CliEntryNotFound]: (entryPath: string) => `Cannot find entry file at ${entryPath}.`,\n    [SeedcordErrorCode.CliTsxImportFailed]: (entryPath: string, reason: string) =>\n        `Failed to import ${entryPath} via tsx: ${reason}.`,\n    [SeedcordErrorCode.CliImportFailed]: (entryPath: string, nativeReason: string, fallbackReason: string) =>\n        `Failed to import ${entryPath}: ${nativeReason}. Fallback via jiti also failed: ${fallbackReason}.`,\n    [SeedcordErrorCode.CliInstanceInvalid]: () =>\n        'Seedcord instance must default export an object with a start() method.',\n    [SeedcordErrorCode.CliStartFailed]: (instancePath: string, reason: string) =>\n        `Failed to start Seedcord from ${instancePath}: ${reason}.`,\n    [SeedcordErrorCode.CliBuildTsconfigNotFound]: (hint: string) =>\n        `Unable to resolve a tsconfig for builds (${hint}). Provide build.tsconfig or add tsconfig.build.json / tsconfig.json.`,\n    [SeedcordErrorCode.CliBuildFailed]: (diagnostics: string) => `TypeScript build failed:\\n${diagnostics}`,\n    [SeedcordErrorCode.CliBootstrapWriteFailed]: (targetPath: string, reason: string) =>\n        `Failed to write bootstrap file at ${targetPath}: ${reason}.`,\n    [SeedcordErrorCode.CliConfigInvalidTsconfig]: () => 'Config `tsconfig` must be a string when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmr]: () => 'Config `hmr` must be an object when provided.',\n    [SeedcordErrorCode.CliConfigInvalidHmrRestart]: () =>\n        'Config `hmr.restart` must be an array of strings when provided.',\n    [SeedcordErrorCode.CliCodegenDuplicateRoute]: (route: string, firstFile: string, secondFile: string) =>\n        `Two commands resolve to the same slash route \\`${route}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCodegenCommandsDirUnreadable]: (dir: string, reason: string) =>\n        `Could not read the commands directory ${dir} during codegen. ${reason}.`,\n    [SeedcordErrorCode.CliCodegenDuplicateContextMenu]: (\n        kind: string,\n        name: string,\n        firstFile: string,\n        secondFile: string\n    ) =>\n        `Two ${kind} context-menu commands share the name \\`${name}\\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,\n    [SeedcordErrorCode.CliCleanAppFetchFailed]: (reason: string) =>\n        `Could not resolve the application from the bot token. ${reason}.`,\n    [SeedcordErrorCode.CliCleanNoGuilds]: () =>\n        'No guilds given. Pass --guild <ids...> or --all-guilds. Global commands are never touched.',\n    [SeedcordErrorCode.CliCleanPurgeAllGuilds]: () =>\n        '--purge cannot be combined with --all-guilds. Use --guild <ids> to purge specific guilds.',\n    [SeedcordErrorCode.CliCancelled]: () => 'Cancelled.',\n    [SeedcordErrorCode.CliCleanLargeBotUnconfirmed]: (count: number) =>\n        `Refusing to scan ${count} guilds without confirmation. Re-run with --yes, or name specific guilds with --guild <ids>.`,\n    [SeedcordErrorCode.CliCleanApplyNeedsYes]: () =>\n        'Refusing to delete without confirmation in a non-interactive environment. Re-run with --yes.'\n} satisfies Record<SeedcordErrorCode, (...args: never[]) => string>;\n\n/** @internal */\nexport type SeedcordErrorArguments<Code extends SeedcordErrorCode> = Parameters<(typeof messages)[Code]>;\n\n/** @internal */\nexport function formatSeedcordErrorMessage<Code extends SeedcordErrorCode>(\n    code: Code,\n    args?: SeedcordErrorArguments<Code>\n): string {\n    const formatter = messages[code];\n    const resolvedArgs = (args ?? []) as unknown[];\n    return (formatter as (...params: unknown[]) => string)(...resolvedArgs);\n}\n","/* eslint-disable @typescript-eslint/no-unnecessary-condition */\nimport chalk from 'chalk';\n\nimport { SeedcordErrorCode } from './ErrorCodes';\nimport { formatSeedcordErrorMessage, type SeedcordErrorArguments } from './ErrorMessages';\n\n/**\n * String literal type for Seedcord error identifiers.\n *\n * @internal\n */\ntype SeedcordErrorIdentifier = keyof typeof SeedcordErrorCode;\n\n/**\n * Options for Seedcord errors.\n *\n * @internal\n */\ninterface SeedcordErrorOptions extends ErrorOptions {}\n\nfunction resolveIdentifier(code: SeedcordErrorCode): SeedcordErrorIdentifier {\n    return SeedcordErrorCode[code] as SeedcordErrorIdentifier;\n}\n\ntype SeedcordErrorPayload<Code extends SeedcordErrorCode> = SeedcordErrorArguments<Code> | undefined;\n\ntype SeedcordErrorCtorRest<Code extends SeedcordErrorCode> =\n    SeedcordErrorArguments<Code> extends []\n        ? [options?: SeedcordErrorOptions]\n        : [args: SeedcordErrorArguments<Code>, options?: SeedcordErrorOptions];\n\nfunction resolveCtorInputs<Code extends SeedcordErrorCode>(\n    rest: SeedcordErrorCtorRest<Code>\n): { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } {\n    const [maybeArgsOrOptions, maybeOptions] = rest;\n    if (Array.isArray(maybeArgsOrOptions)) {\n        const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n            args: maybeArgsOrOptions\n        };\n\n        if (maybeOptions !== undefined) {\n            result.options = maybeOptions;\n        }\n\n        return result;\n    }\n\n    const result: { args: SeedcordErrorPayload<Code>; options?: SeedcordErrorOptions } = {\n        args: undefined\n    };\n\n    if (maybeArgsOrOptions !== undefined) {\n        result.options = maybeArgsOrOptions;\n    }\n\n    return result;\n}\n\nfunction resolveMessage<Code extends SeedcordErrorCode>(code: Code, args: SeedcordErrorPayload<Code>): string {\n    return formatSeedcordErrorMessage(code, args);\n}\n\nfunction formatErrorName(name: string, _identifier: SeedcordErrorIdentifier, code: SeedcordErrorCode): string {\n    return `${chalk.bold.red(name)}[${chalk.gray(code)}]`;\n}\n\n/**\n * String literal type for Seedcord error class names.\n *\n * @internal\n */\nexport type SeedcordErrorTypeString = `Seedcord${'Error' | 'TypeError' | 'RangeError'}`;\n\ninterface BaseSeedcordError {\n    readonly code: SeedcordErrorCode;\n    readonly identifier: SeedcordErrorIdentifier;\n    readonly type: SeedcordErrorTypeString;\n}\n\n/**\n * Base class for Seedcord errors.\n */\nexport class SeedcordError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends Error\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * TypeError class for Seedcord errors.\n */\nexport class SeedcordTypeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends TypeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordTypeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * RangeError class for Seedcord errors.\n */\nexport class SeedcordRangeError<Code extends SeedcordErrorCode = SeedcordErrorCode>\n    extends RangeError\n    implements BaseSeedcordError\n{\n    public readonly code: Code;\n    public readonly identifier: SeedcordErrorIdentifier;\n    public readonly type = 'SeedcordRangeError';\n\n    constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>) {\n        const { args, options } = resolveCtorInputs(rest);\n        const message = resolveMessage(code, args);\n        super(message, options);\n        this.code = code;\n        this.identifier = resolveIdentifier(code);\n        this.name = formatErrorName(new.target.name, this.identifier, this.code);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (typeof Error.captureStackTrace === 'function') {\n            Error.captureStackTrace(this, new.target);\n        }\n    }\n}\n\n/**\n * Variant type for Seedcord error classes.\n *\n * @internal\n */\ntype SeedcordErrorVariant<\n    Type extends SeedcordErrorTypeString,\n    Code extends SeedcordErrorCode\n> = Type extends 'SeedcordError'\n    ? SeedcordError<Code>\n    : Type extends 'SeedcordTypeError'\n      ? SeedcordTypeError<Code>\n      : SeedcordRangeError<Code>;\n\n/**\n * Union type of all Seedcord error variants for a specific error code.\n *\n * @internal\n */\ntype AnySeedcordErrorForCode<Code extends SeedcordErrorCode> = {\n    [Variant in SeedcordErrorTypeString]: SeedcordErrorVariant<Variant, Code>;\n}[SeedcordErrorTypeString];\n\n/**\n * Union type of all Seedcord errors filtered by error class.\n *\n * @internal\n */\ntype ErrorTypeFilter<Type extends SeedcordErrorTypeString | undefined> = Type extends SeedcordErrorTypeString\n    ? {\n          [Code in SeedcordErrorCode]: SeedcordErrorVariant<Type, Code>;\n      }[SeedcordErrorCode]\n    : AnySeedcordErrorForCode<SeedcordErrorCode>;\n\n/**\n * Union type of all Seedcord errors filtered by error class and error code.\n *\n * @internal\n */\nexport type ErrorCodeFilter<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n> = Code extends SeedcordErrorCode\n    ? Type extends SeedcordErrorTypeString\n        ? SeedcordErrorVariant<Type, Code>\n        : AnySeedcordErrorForCode<Code>\n    : ErrorTypeFilter<Type>;\n\n/**\n * Determines whether an unknown value is a Seedcord error, with optional narrowing by class and error code.\n *\n * @param error - The value to inspect.\n * @param type - Optional error class discriminator (Error, TypeError, or RangeError).\n * @param code - Optional {@link SeedcordErrorCode} discriminator to narrow by code.\n * @typeParam Type - What kind of {@link SeedcordErrorTypeString} to filter by.\n * @typeParam Code - The specific {@link SeedcordErrorCode} to filter by.\n */\nexport function isSeedcordError<\n    Type extends SeedcordErrorTypeString | undefined,\n    Code extends SeedcordErrorCode | undefined\n>(error: unknown, type?: Type, code?: Code): error is ErrorCodeFilter<Type, Code> {\n    const isSeedcordErrorInstance = error instanceof SeedcordError && error.type === 'SeedcordError';\n    const isSeedcordTypeErrorInstance = error instanceof SeedcordTypeError && error.type === 'SeedcordTypeError';\n    const isSeedcordRangeErrorInstance = error instanceof SeedcordRangeError && error.type === 'SeedcordRangeError';\n\n    if (!isSeedcordErrorInstance && !isSeedcordTypeErrorInstance && !isSeedcordRangeErrorInstance) {\n        return false;\n    }\n\n    const matchesType = type\n        ? (type === 'SeedcordError' && isSeedcordErrorInstance) ||\n          (type === 'SeedcordTypeError' && isSeedcordTypeErrorInstance) ||\n          (type === 'SeedcordRangeError' && isSeedcordRangeErrorInstance)\n        : true;\n\n    if (!matchesType) return false;\n    if (code === undefined) return true;\n    return error.code === code;\n}\n"],"mappings":"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"}