@seedcord/errors 0.13.0 → 0.14.0

package/README.md

@@ -10,7 +10,7 @@
   <a href="https://seedcord.org">Website</a> ·
   <a href="https://seedcord.org/guide">Guide</a> ·
   <a href="https://seedcord.org/docs">Reference</a> ·
-  <a href="https://discord.gg/DzFxY58WXf">Discord</a>
+  <a href="https://seedcord.org/chat/">Discord</a>
 </div>
 
 <br />
@@ -23,33 +23,31 @@
 
 ## About
 
-`@seedcord/errors` holds every error seedcord throws. Each one carries a registered code from `SeedcordErrorCode`, so a caller can branch on one specific failure.
+`@seedcord/errors` defines the codes for every error seedcord throws, in `SeedcordErrorCode`. `isSeedcordError` checks a caught value against a code, so your code can react to one specific failure.
 
-Framework code never throws a raw `Error`. A third-party throw may be translated into one of these before you catch it.
+Both seedcord transports depend on it and re-export it, so a bot imports `isSeedcordError` from its transport. Install it directly in a plugin or a library that catches errors from a seedcord package, like [`@seedcord/custom-id`](https://www.npmjs.com/package/@seedcord/custom-id) in a discord.js bot.
 
-Until v1.0.0, minor versions can break.
+seedcord is pre-1.0, so a minor version can break your code. Each release's changelog says what changed and how to update.
 
 ## Installation
 
-Your transport already re-exports this.
-
 ```sh
 pnpm add @seedcord/errors
 ```
 
 ## Usage
 
-`isSeedcordError` narrows on the class and the code together:
+Say `Approve` is a `CustomId` from `@seedcord/custom-id`, and a click arrives on a button built from an older version of it:
 
 ```ts
 import { isSeedcordError, SeedcordErrorCode } from '@seedcord/errors';
 
 try {
-    await run();
+    Approve.decode(interaction.customId);
 } catch (error) {
-    if (isSeedcordError(error, 'SeedcordError', SeedcordErrorCode.CliCancelled)) return;
-    throw error;
+    if (!isSeedcordError(error, 'SeedcordError', SeedcordErrorCode.CustomIdWireStale)) throw error;
+    await interaction.reply('This button is out of date. Run the command again.');
 }
 ```
 
-Called with one argument it narrows to any seedcord error.
+The [error handling guide](https://seedcord.org/guide/replying/error-behavior) covers how a seedcord bot replies to an error.

package/dist/SeedcordError-Cce9qKW3.d.mts

@@ -0,0 +1,583 @@
+import { ColorSupportLevel } from "chalk";
+//#region src/ErrorCodes.d.ts
+/**
+ * All Seedcord error codes.
+ */
+declare enum SeedcordErrorCode {
+  /** Two or more configured emojis failed to resolve at startup. */
+  ConfigEmojiUnresolved = 1001,
+  /** A configured emoji is neither a name nor a `[name, guildId]` pair. */
+  ConfigEmojiInvalid = 1002,
+  /** The application or guild a configured emoji points at has no emoji with that name. */
+  ConfigEmojiNotFound = 1003,
+  /** Reading the emojis of the application or guild a configured emoji points at failed. */
+  ConfigEmojiSourceUnreadable = 1004,
+  /** Discord has no webhook at a configured URL, because it was deleted or the id or token is wrong. */
+  ConfigWebhookNotFound = 1005,
+  /** A required environment variable is unset. */
+  ConfigMissingEnv = 1006,
+  /** An environment variable is set to a value seedcord cannot use. */
+  ConfigInvalidEnv = 1007,
+  /** A command that runs in guilds is registered without the `Guilds` intent, so discord.js caches no guild. */
+  MissingGuildsIntent = 1008,
+  /** The running Node or Bun is older than the range seedcord declares in `engines`. */
+  UnsupportedRuntimeVersion = 1009,
+  /** An edge config sets a REST sweeper interval. */
+  ConfigEdgeRestSweeper = 1010,
+  /** Another process already listens on the port seedcord tries to listen on. */
+  PortInUse = 1011,
+  /** A startup task was added or removed while startup ran, or added after it finished. */
+  LifecycleTaskChangeRejected = 1101,
+  /** A lifecycle call got a phase that is not a member of `StartupPhase` or `ShutdownPhase`. */
+  LifecycleUnknownPhase = 1102,
+  /** One or more tasks failed during a startup phase. */
+  LifecyclePhaseFailures = 1103,
+  /** A lifecycle task ran past its timeout. */
+  LifecycleTaskTimeout = 1104,
+  /** A host whose startup failed was started again. */
+  LifecycleRestartAfterFailure = 1105,
+  /** A shutdown deadline or a plugin's lifecycle timeout is zero, negative, or not finite. */
+  LifecycleInvalidTimeout = 1106,
+  /** A second Seedcord instance was constructed while one already exists. */
+  CoreSingletonViolation = 1201,
+  /** A plugin was attached after the bot started. */
+  CorePluginAfterInit = 1202,
+  /** A plugin was attached under a key another plugin already uses. */
+  CorePluginKeyExists = 1203,
+  /** The bot's own role is missing from the guild's role cache. */
+  CoreBotRoleMissing = 1204,
+  /** A bot controller was constructed without the folder that holds its handlers. */
+  CoreControllerPathMissing = 1205,
+  /** seedcord could not import a file in the bot or in the CLI. */
+  CoreImportFailed = 1206,
+  /** A file or folder that seedcord reads could not be read. */
+  CorePathUnreadable = 1207,
+  /** A plugin was attached under a key that the framework logs on. */
+  CorePluginReservedChannel = 1208,
+  /** The application id was read before startup resolved it. */
+  CoreApplicationUnavailable = 1209,
+  /** A generated accessor like `Emojis` or `Commands` was read for a key that has no value yet. */
+  CoreAccessorUnresolved = 1210,
+  /** A shutdown task was added on an edge bot. Cloudflare stops an isolate without a shutdown hook. */
+  CoreLifecycleUnavailable = 1211,
+  /** `emit` was called on the bus. It calls the listeners and skips every subscriber. */
+  CoreBusEmitUnavailable = 1212,
+  /** A command registers to the `'config'` guilds while `commands.guilds` is empty. */
+  CoreCommandGuildsEmpty = 1213,
+  /** Discord refused the command deploy for one guild. */
+  CoreCommandGuildDeployFailed = 1214,
+  /** A plugin was attached under a group name the bot already uses. */
+  CorePluginGroupTaken = 1215,
+  /** A plugin was attached at a name that holds a group of plugins. */
+  CorePluginKeyHoldsGroup = 1216,
+  /** A plugin key is empty, has an empty part, or has more than one dot. */
+  CorePluginKeyMalformed = 1217,
+  /** An attached plugin extends the `Plugin` class of a different copy of `@seedcord/core`. */
+  CorePluginFromOtherCore = 1218,
+  /** A folder or the `build.start` file is outside `root`. */
+  CorePathOutsideRoot = 1219,
+  /** A plugin declares a transport or runtime the bot doesn't use. */
+  CorePluginScopeMismatch = 1220,
+  /** A node http bot got a request through `fetch` before `start()` was called. */
+  CoreFetchBeforeStart = 1221,
+  /** An edge worker got a POST without the ids that `seedcord build` writes into it. */
+  CoreEdgeUnbuilt = 1222,
+  /** A relative folder was read in a process that never got the bot's `root`. */
+  CoreDirectoryRootUnknown = 1223,
+  /** Discord refused the global command deploy. */
+  CoreCommandGlobalDeployFailed = 1224,
+  /** A built bot read a folder that did not exist under `root` when `seedcord build` ran. */
+  CoreDirectoryNotBuilt = 1225,
+  /** A webhook sender was constructed with a URL that is not a Discord webhook URL. */
+  CoreWebhookUrlInvalid = 1226,
+  /** Reading from Discord with `DISCORD_BOT_TOKEN` failed, like the application, its public key, or its commands. */
+  CoreDiscordReadFailed = 1227,
+  /** Two routes, commands, migrations, or customId fields have the same name, or two code files build to the same file. */
+  CoreDuplicateName = 1228,
+  /** A Vite plugin from `vitePlugins` threw while Vite started or loaded a file, or failed when seedcord called `vitePlugins`. */
+  CoreVitePluginThrew = 1229,
+  /** `readFiles` read a folder that `files` in `seedcord.config.ts` leaves out. */
+  CoreDirectoryNotListed = 1230,
+  /** A folder is inside one that `seedcord build` skips, like a dot-folder, `node_modules`, `outDir` or the logs folder. */
+  CoreDirectorySkipped = 1231,
+  /** A command class carries `@RegisterCommand` twice. */
+  DecoratorCommandAlreadyRegistered = 1301,
+  /** `@RegisterCommand('global')` was given guild ids. */
+  DecoratorCommandGlobalWithGuilds = 1302,
+  /** `@RegisterCommand('guild')` was given no guild ids. */
+  DecoratorCommandGuildWithoutGuilds = 1303,
+  /** A middleware decorator sets a priority that is not a finite number. */
+  DecoratorInvalidMiddlewarePriority = 1304,
+  /** A `WebhookLog` subclass is missing its `@WebhookUrl` decorator. */
+  DecoratorWebhookUrlMissing = 1305,
+  /** A middleware decorator got an empty filter array. */
+  DecoratorEmptyMiddlewareFilter = 1306,
+  /** A reply method was called in an ack state where Discord rejects it. */
+  ReplyIllegalAckState = 1501,
+  /** A reply component threw while seedcord serialized it. */
+  ReplyComponentSerialization = 1502,
+  /** `edit()` got a message that the interaction did not send. */
+  ReplyForeignEditTarget = 1503,
+  /** `update()` or `deferUpdate()` was called on a modal that has no source message. */
+  ReplyUpdateWithoutSource = 1504,
+  /** Discord's response to a `withResponse` callback has no message in it. */
+  ReplyCallbackMissingMessage = 1505,
+  /** A customId prefix is empty, or holds a colon or a control character. */
+  CustomIdInvalidPrefix = 1601,
+  /** A customId field name looks like an integer. JS reorders integer keys. */
+  CustomIdReservedFieldName = 1602,
+  /** A `oneOf()` or `someOf()` field was declared with no choices. */
+  CustomIdEmptyChoices = 1603,
+  /** An `int()` field was declared with a min greater than its max. */
+  CustomIdInvalidBounds = 1604,
+  /** `encode()` got a value that doesn't fit its field. */
+  CustomIdValueRejected = 1605,
+  /** An encoded customId is longer than the 100 characters Discord allows. */
+  CustomIdWireTooLong = 1606,
+  /** A component handler is missing the route decorator that matches its base. */
+  CustomIdHandlerRouteMissing = 1607,
+  /** A handler's `match()` has no arm for the route, field, event, or command that fired. */
+  MatchArmMissing = 1608,
+  /** An event handler or middleware read the fired event's name but was constructed without one. */
+  EventNameUnavailable = 1609,
+  /** Discord sent an autocomplete payload with no focused option. */
+  AutocompleteNoFocusedOption = 1610,
+  /** The submitted modal has no field with the requested custom id. */
+  ModalFieldNotFound = 1611,
+  /** A modal field getter was called on a field of another kind. */
+  ModalFieldWrongKind = 1612,
+  /** A modal field read as required has nothing picked. */
+  ModalFieldEmpty = 1613,
+  /** A channel select returned a channel whose type the `getSelectedChannels()` call excludes. */
+  ModalFieldChannelType = 1614,
+  /** A customId was encoded under an older shape of the same definition. */
+  CustomIdWireStale = 1615,
+  /** A customId is corrupt, truncated, or was encoded by a different definition. */
+  CustomIdWireInvalid = 1616,
+  /** `dispatch.require()` was called for a key that nothing set on this dispatch. */
+  DispatchStateMissing = 1617,
+  /** A `Cooldown` gate got a duration that doesn't parse, or one of zero or less. */
+  GateInvalidCooldownDuration = 1701,
+  /** A paginator got a `perPage` that is not a positive integer. */
+  PaginationInvalidPerPage = 1801,
+  /** A control row has no controls, or more than the five buttons Discord allows. */
+  PaginationControlCount = 1802,
+  /** A control row lists the same control twice. Its two buttons would share a custom_id. */
+  PaginationDuplicateControls = 1803,
+  /** A color value doesn't resolve to a Discord color integer. */
+  ColorUnresolvable = 1901,
+  /** A resolved color is outside Discord's range of 0x000000 to 0xffffff. */
+  ColorOutOfRange = 1902,
+  /** `renderTable` got a `maxWidth` or `padding` outside the values it accepts. */
+  UtilTableOptionInvalid = 1951,
+  /** `assertNever` ran with a value that its types ruled out. */
+  UtilUnhandledUnionMember = 1952,
+  /** `WinstonFileSink` got a `filename` with a folder in it. File logs always go in the logs folder. */
+  LoggerFileNameHasFolder = 1971,
+  /** A plugin's constructor called `rejectOptions` on the options it got. */
+  PluginOptionsRejected = 2001,
+  /** Two or more plugins threw while disposing. */
+  PluginDisposeFailures = 2002,
+  /** A plugin service class is missing the decorator that registers it. */
+  PluginServiceDecoratorMissing = 2003,
+  /** A plugin's `services` was read before the plugin finished `init()`. */
+  PluginServicesNotReady = 2004,
+  /** A plugin could not connect to the service it wraps. */
+  PluginConnectionFailed = 2005,
+  /** A plugin could not close its connection cleanly during shutdown. */
+  PluginDisconnectFailed = 2006,
+  /** Mongoose threw while building a model, usually for a duplicate model name or a missing schema. */
+  PluginMongooseModelCreationFailed = 2101,
+  /** A mongoose service was registered with an empty model name. */
+  PluginMongooseModelNameMissing = 2102,
+  /** A kysely service class has no table. */
+  PluginKyselyServiceTableMissing = 2201,
+  /** A migration run got a step count that is not a non-negative integer. */
+  PluginKyselyInvalidStepCount = 2202,
+  /** A migration run got a direction other than `up` or `down`. */
+  PluginKyselyUnknownDirection = 2203,
+  /** A file in the migrations folder has no `up` function. */
+  PluginKyselyInvalidMigrationModule = 2204,
+  /** A migration failed with a thrown value that is not an `Error`. */
+  PluginKyselyNonErrorFailure = 2205,
+  /** Creating the target Postgres database failed. */
+  PluginKyselyBootstrapFailed = 2206,
+  /** Someone pressed Ctrl-C at a prompt in `seedcord` or `create-seedcord`. */
+  CliCancelled = 3001,
+  /** The seedcord config file's default export is not an object. */
+  CliConfigInvalidExport = 3101,
+  /** No seedcord config file exists in the folder the CLI searched. */
+  CliConfigNotFound = 3102,
+  /** The file that `instance` or `build.start` in the seedcord config points at does not exist. */
+  CliFileNotFound = 3103,
+  /** The instance file's default export is not a constructed `Seedcord`. */
+  CliInstanceInvalid = 3104,
+  /** The bot threw during startup. */
+  CliStartFailed = 3105,
+  /** `build.tsconfig` points at a missing file, or it is unset and the config's folder has no `tsconfig.json`. */
+  CliTsconfigNotFound = 3106,
+  /** `seedcord build` found type errors. */
+  CliBuildFailed = 3107,
+  /** `commands clean` or `commands purge` ran without a flag that picks where it deletes. */
+  CliNoScopeGiven = 3108,
+  /** cloudflared never reported a quick tunnel hostname. */
+  CliTunnelUrlUnavailable = 3109,
+  /** Discord rejected the tunnel URL as an interactions endpoint. */
+  CliTunnelNotVerified = 3110,
+  /** The tunnel URL never answered its health probe. */
+  CliTunnelUnreachable = 3111,
+  /** A field in the seedcord config is missing or has the wrong shape. */
+  CliConfigInvalidField = 3112,
+  /** A class carrying `@RegisterCommand` threw while seedcord constructed it. */
+  CliCommandConstructorThrew = 3113,
+  /** Vite threw while bundling the bot. */
+  CliBundleFailed = 3114,
+  /** `build.outDir` is `root` or a folder that contains it. */
+  CliConfigOutDirDeletesRoot = 3115,
+  /** The project is missing a dev dependency the CLI runs, like `typescript` or `@cloudflare/vite-plugin`. */
+  CliDependencyMissing = 3116,
+  /** `build.outDir` already has other files in it. */
+  CliBuildOutDirNotEmpty = 3117,
+  /** One CLI step found two or more problems. Each one is in the error's `errors`. */
+  CliProblems = 3118,
+  /** `seedcord codegen --check` found the committed augmentations out of date. */
+  CliCodegenOutOfDate = 3119,
+  /** A file or folder in the project has a `#` in its path. */
+  CliPathHasHash = 3120,
+  /** An edge bot's tsconfig is missing the `workerd` condition. */
+  CliEdgeWithoutWorkerdCondition = 3121,
+  /** A bot with no `cloudflare.config.ts` sets the `workerd` condition in its tsconfig. */
+  CliWorkerdConditionWithoutCloudflareConfig = 3122,
+  /** TypeScript could not read the project's tsconfig, or Cloudflare's config loader could not read `cloudflare.config.ts`. */
+  CliConfigFileUnreadable = 3123,
+  /** The CLI could not start the TypeScript compiler. */
+  CliTypescriptNotStarted = 3124,
+  /** A config file sets a field this bot can't set, like `entrypoint` in an edge bot's `cloudflare.config.ts`. */
+  CliConfigFieldUnused = 3125,
+  /** An edge bot's `compatibilityDate` is older than Cloudflare's Node compat default, and no flag turns it on. */
+  CliEdgeCompatDateTooOld = 3126,
+  /** An edge bot sets `no_nodejs_compat`. */
+  CliEdgeNodeCompatOff = 3127,
+  /** The build could not start the edge worker in workerd. */
+  CliEdgeBootFailed = 3128,
+  /** An edge bot's `root` holds its seedcord config. */
+  CliEdgeRootHoldsConfig = 3129,
+  /** An edge build found commands in code that have no deployed id on Discord. */
+  CliEdgeCommandsNotDeployed = 3130,
+  /** Something called the dev runtime before `start()` finished or after `stop()`. This is a bug in seedcord. */
+  CliDevRuntimeNotRunning = 3131,
+  /** `seedcord commands deploy` ran on a bot whose `commands.path` is `null`. */
+  CliDeployNoCommandsFolder = 3132,
+  /** `seedcord commands deploy` ran without `--yes` where it cannot ask first. */
+  CliDeployNeedsYes = 3133,
+  /** A class carrying `@RegisterCommand` builds a component that is not a command or a context menu. */
+  CliCommandNotACommand = 3134,
+  /** `seedcord commands clean` or `purge` could not delete some of the commands it picked. */
+  CliCommandsNotDeleted = 3135,
+  /** The CLI ran on Bun for an edge bot. */
+  CliEdgeOnBun = 3136,
+  /** An edge bot's `cloudflare.config.ts` sets no `worker`. */
+  CliEdgeNoWorker = 3137,
+  /** The running `seedcord` is a different install from the project's own. */
+  CliNotProjectInstall = 3138,
+  /** Vite's environments leave out the one seedcord runs the bot in. */
+  CliViteEnvironmentMissing = 3139,
+  /** A folder that `files` in `seedcord.config.ts` lists is missing or is a file. */
+  CliListedFolderUnusable = 3140,
+  /** Another `seedcord dev` already runs a bot on the same Discord application. */
+  CliDevAlreadyRunning = 3141,
+  /** The folder that holds the dev session locks belongs to another user. */
+  CliDevLockFolderNotOwned = 3142,
+  /** A flag answers a question that the earlier answers skip. */
+  CreateFlagNotApplicable = 3201,
+  /** A flag has a value its question rejects. */
+  CreateInvalidAnswer = 3202,
+  /** The command line did not parse. */
+  CreateBadUsage = 3203,
+  /** The target path already has files in it. */
+  CreateTargetNotEmpty = 3204,
+  /** A command that create-seedcord ran exited non-zero. */
+  CreateStepFailed = 3205
+}
+//#endregion
+//#region src/palette.d.ts
+declare const BRAND: {
+  readonly flesh: "#f04e36";
+  readonly rind: "#6fab49";
+  readonly pith: "#f8f6e8";
+};
+declare function setColorLevel(level: ColorSupportLevel): void;
+declare const paint: {
+  readonly sky: import("chalk").ChalkInstance;
+  readonly path: (path: string) => string;
+  readonly iris: import("chalk").ChalkInstance;
+  readonly mint: import("chalk").ChalkInstance;
+  readonly amber: import("chalk").ChalkInstance;
+  readonly coral: import("chalk").ChalkInstance;
+  readonly flesh: import("chalk").ChalkInstance;
+  readonly rind: import("chalk").ChalkInstance;
+  readonly pith: import("chalk").ChalkInstance;
+  readonly mute: import("chalk").ChalkInstance;
+  readonly check: "✔︎";
+  readonly cross: "✘";
+  readonly bold: import("chalk").ChalkInstance;
+  readonly italic: import("chalk").ChalkInstance;
+  readonly underline: import("chalk").ChalkInstance;
+};
+declare const WORDMARK: string;
+//#endregion
+//#region src/ErrorMessages.d.ts
+interface VitePluginPlace {
+  hook?: string | undefined;
+  loading?: {
+    kind: 'file';
+    path: string;
+  } | {
+    kind: 'virtual';
+    id: string;
+  } | undefined;
+}
+declare const listedFolderProblems: {
+  missing: string;
+  file: string;
+  outsideProject: string;
+};
+/** @internal */
+declare const messages: {
+  1001: (count: number) => string;
+  1002: (key: string) => string;
+  1003: (key: string, name: string, where: string) => string;
+  1004: (key: string, name: string, where: string, reason: string, fix: string) => string;
+  1005: (envKey: string) => string;
+  1006: (name: string) => string;
+  1007: (name: string, expected: string, why?: string) => string;
+  1008: (commands: readonly string[]) => string;
+  1009: (runtime: string, required: string, running: string) => string;
+  1010: (key: string) => string;
+  1011: (port: number, setting: string, configFile?: string) => string;
+  1101: (action: "add" | "remove", startup: "running" | "finished") => string;
+  1102: (phase: unknown) => string;
+  1103: (phase: string, failures: number) => string;
+  1104: (taskName: string, timeout: number) => string;
+  1105: () => string;
+  1106: (setting: string, value: number) => string;
+  1201: () => string;
+  1202: () => string;
+  1203: (key: string) => string;
+  1204: (guildId?: string) => string;
+  1205: (controllerName: string, pathKind: string) => string;
+  1206: (file: string, reason: string) => string;
+  1229: (plugin: string, place: VitePluginPlace, configFile: string, reason: string) => string;
+  1207: (path: string, reason: string) => string;
+  1219: (path: string, root: string) => string;
+  1223: (dir: string) => string;
+  1225: (dir: string, root: string) => string;
+  1230: (dir: string) => string;
+  1231: (dir: string) => string;
+  1215: (head: string, key: string) => string;
+  1217: (key: string, reason: string) => string;
+  1218: (plugin: string) => string;
+  1220: (plugin: string, axis: string, declared: string, host: string) => string;
+  1216: (key: string) => string;
+  1208: (key: string) => string;
+  1209: () => string;
+  1222: () => string;
+  1221: () => string;
+  1210: (accessor: string, key: string) => string;
+  1211: () => string;
+  1212: (event: string) => string;
+  1213: (commandName: string) => string;
+  1214: (guildId: string, reason: string, status?: number) => string;
+  1224: (reason: string, status?: number) => string;
+  1226: (className: string) => string;
+  1227: (what: string, reason: string, fix?: string) => string;
+  1228: (kind: string, name: string, sources?: readonly string[], note?: string) => string;
+  1301: (commandName: string, existingCall: string, requestedCall: string) => string;
+  1302: (className: string) => string;
+  1303: (className: string) => string;
+  1304: (className: string, priority: string) => string;
+  1305: (className: string) => string;
+  1306: (className: string, key: string) => string;
+  1501: (method: string, reason: string, alternative: string, routeId: string) => string;
+  1502: (componentClass: string, index: number, detail: string, routeId: string) => string;
+  1503: (method: string, targetId: string, routeId: string) => string;
+  1504: (method: string, routeId: string) => string;
+  1505: (method: string, routeId: string) => string;
+  1601: (prefix: string) => string;
+  1602: (field: string) => string;
+  1603: (field: string, method: string) => string;
+  1604: (field: string, min: number, max: number) => string;
+  1605: (field: string, expected: string, value: string) => string;
+  1606: (prefix: string, length: number) => string;
+  1607: (className: string) => string;
+  1608: (handler: string, kind: string, value: string) => string;
+  1609: (handler: string, read: string) => string;
+  1610: () => string;
+  1611: (customId: string) => string;
+  1612: (customId: string, kind: string, getter?: string) => string;
+  1613: (customId: string) => string;
+  1614: (customId: string, picked: string, allowed: readonly string[]) => string;
+  1615: (prefix: string) => string;
+  1616: (detail: string) => string;
+  1617: (key: string) => string;
+  1701: (input: string) => string;
+  1801: (perPage: number) => string;
+  1802: (count: number, max: number) => string;
+  1803: (key: string) => string;
+  1901: (value: string) => string;
+  1902: (value: number) => string;
+  1951: (option: string, expected: string, value: number) => string;
+  1952: (value: string) => string;
+  1971: (filename: string, logsFolder: string) => string;
+  2001: (pluginName: string, reason: string) => string;
+  2002: (count: number) => string;
+  2003: (decorator: string, className: string) => string;
+  2004: (pluginName: string) => string;
+  2005: (service: string, target?: string) => string;
+  2006: (service: string) => string;
+  2101: (modelName: string, className: string) => string;
+  2102: (className: string) => string;
+  2201: (className: string) => string;
+  2202: (steps: number) => string;
+  2203: (direction: unknown) => string;
+  2204: (filePath: string) => string;
+  2205: (message: string) => string;
+  2206: (databaseName: string) => string;
+  3001: () => string;
+  3101: () => string;
+  3102: (baseDir: string, candidates: readonly string[]) => string;
+  3112: (field: string, expected: string) => string;
+  3103: (path: string, field: string) => string;
+  3104: (instancePath: string) => string;
+  3105: (instancePath: string, reason: string) => string;
+  3106: (configDir: string, configured?: string) => string;
+  3116: (packages: readonly string[], projectDir: string, why: string) => string;
+  3107: (diagnostics: string) => string;
+  3114: (reason: string) => string;
+  3115: (outDir: string, root: string) => string;
+  3117: (outDir: string) => string;
+  3118: (count: number) => string;
+  3130: (lines: readonly string[]) => string;
+  3131: (method: string) => string;
+  3132: (instance: string) => string;
+  3133: () => string;
+  3108: (flags: readonly string[], note?: string) => string;
+  3113: (name: string, file: string, reason: string) => string;
+  3134: (name: string, file: string) => string;
+  3135: () => string;
+  3136: () => string;
+  3137: (cloudflareConfig: string) => string;
+  3138: (cliDir: string, projectInstall: string) => string;
+  3139: (name: string, created: readonly string[]) => string;
+  3140: (folder: string, problem: keyof typeof listedFolderProblems) => string;
+  3141: (configDir: string, pid: number, startedAt: string, lockFile: string) => string;
+  3142: (folder: string) => string;
+  3119: (outputPath: string) => string;
+  3121: (cloudflareConfig: string, tsconfig: string) => string;
+  3122: (tsconfig: string, configDir: string) => string;
+  3123: (tool: string, file: string, output: string) => string;
+  3125: (field: string, file: string, why: string) => string;
+  3126: (cloudflareConfig: string, date: string, firstDate: string) => string;
+  3127: (cloudflareConfig: string) => string;
+  3128: (reason: string) => string;
+  3129: (configFile: string, root: string) => string;
+  3124: (tsc: string, reason: string) => string;
+  3120: (path: string) => string;
+  3109: (seconds: number) => string;
+  3110: (url: string) => string;
+  3111: (url: string, seconds: number) => string;
+  3201: (flag: string) => string;
+  3202: (flag: string, reason: string) => string;
+  3203: (reason: string) => string;
+  3204: (target: string) => string;
+  3205: (command: string, reason: string) => string;
+};
+/** @internal */
+type SeedcordErrorArguments<Code extends SeedcordErrorCode> = Parameters<(typeof messages)[Code]>;
+//#endregion
+//#region src/SeedcordError.d.ts
+/**
+ * String literal type for Seedcord error identifiers.
+ *
+ * @internal
+ */
+type SeedcordErrorIdentifier = keyof typeof SeedcordErrorCode;
+/**
+ * Options for Seedcord errors.
+ *
+ * @internal
+ */
+interface SeedcordErrorOptions extends ErrorOptions {}
+type SeedcordErrorCtorRest<Code extends SeedcordErrorCode> = SeedcordErrorArguments<Code> extends [] ? [options?: SeedcordErrorOptions] : [args: SeedcordErrorArguments<Code>, options?: SeedcordErrorOptions];
+/**
+ * String literal type for Seedcord error class names. Names the `type` argument of
+ * {@link isSeedcordError}.
+ */
+type SeedcordErrorTypeString = `Seedcord${'Error' | 'TypeError' | 'RangeError' | 'AggregateError'}`;
+declare const kIdentifier: unique symbol;
+interface BaseSeedcordError {
+  readonly code: SeedcordErrorCode;
+  readonly [kIdentifier]: SeedcordErrorIdentifier;
+  readonly type: SeedcordErrorTypeString;
+}
+declare class SeedcordError<Code extends SeedcordErrorCode = SeedcordErrorCode> extends Error implements BaseSeedcordError {
+  readonly code: Code;
+  readonly [kIdentifier]: SeedcordErrorIdentifier;
+  readonly type = "SeedcordError";
+  constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>);
+}
+declare class SeedcordTypeError<Code extends SeedcordErrorCode = SeedcordErrorCode> extends TypeError implements BaseSeedcordError {
+  readonly code: Code;
+  readonly [kIdentifier]: SeedcordErrorIdentifier;
+  readonly type = "SeedcordTypeError";
+  constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>);
+}
+declare class SeedcordRangeError<Code extends SeedcordErrorCode = SeedcordErrorCode> extends RangeError implements BaseSeedcordError {
+  readonly code: Code;
+  readonly [kIdentifier]: SeedcordErrorIdentifier;
+  readonly type = "SeedcordRangeError";
+  constructor(code: Code, ...rest: SeedcordErrorCtorRest<Code>);
+}
+declare class SeedcordAggregateError<Code extends SeedcordErrorCode = SeedcordErrorCode> extends AggregateError implements BaseSeedcordError {
+  readonly code: Code;
+  readonly [kIdentifier]: SeedcordErrorIdentifier;
+  readonly type = "SeedcordAggregateError";
+  constructor(code: Code, errors: readonly unknown[], ...rest: SeedcordErrorCtorRest<Code>);
+}
+/**
+ * Variant type for Seedcord error classes.
+ *
+ * @internal
+ */
+type SeedcordErrorVariant<Type extends SeedcordErrorTypeString, Code extends SeedcordErrorCode> = Type extends 'SeedcordError' ? SeedcordError<Code> : Type extends 'SeedcordTypeError' ? SeedcordTypeError<Code> : Type extends 'SeedcordRangeError' ? SeedcordRangeError<Code> : SeedcordAggregateError<Code>;
+/**
+ * Union type of all Seedcord error variants for a specific error code.
+ *
+ * @internal
+ */
+type AnySeedcordErrorForCode<Code extends SeedcordErrorCode> = { [Variant in SeedcordErrorTypeString]: SeedcordErrorVariant<Variant, Code>; }[SeedcordErrorTypeString];
+/**
+ * Union type of all Seedcord errors filtered by error class.
+ *
+ * @internal
+ */
+type ErrorTypeFilter<Type extends SeedcordErrorTypeString | undefined> = Type extends SeedcordErrorTypeString ? { [Code in SeedcordErrorCode]: SeedcordErrorVariant<Type, Code>; }[SeedcordErrorCode] : AnySeedcordErrorForCode<SeedcordErrorCode>;
+/**
+ * Union type of all Seedcord errors filtered by error class and error code.
+ *
+ * @internal
+ */
+type ErrorCodeFilter<Type extends SeedcordErrorTypeString | undefined, Code extends SeedcordErrorCode | undefined> = Code extends SeedcordErrorCode ? Type extends SeedcordErrorTypeString ? SeedcordErrorVariant<Type, Code> : AnySeedcordErrorForCode<Code> : ErrorTypeFilter<Type>;
+/**
+ * Determines whether an unknown value is a Seedcord error, with optional narrowing by class and error code.
+ *
+ * @param error - The value to inspect.
+ * @param type - Optional error class discriminator.
+ * @param code - Optional {@link SeedcordErrorCode} discriminator to narrow by code.
+ * @typeParam Type - What kind of {@link SeedcordErrorTypeString} to filter by.
+ * @typeParam Code - The specific {@link SeedcordErrorCode} to filter by.
+ */
+declare function isSeedcordError<Type extends SeedcordErrorTypeString | undefined, Code extends SeedcordErrorCode | undefined>(error: unknown, type?: Type, code?: Code): error is ErrorCodeFilter<Type, Code>;
+//#endregion
+export { SeedcordTypeError as a, VitePluginPlace as c, paint as d, setColorLevel as f, SeedcordRangeError as i, BRAND as l, SeedcordError as n, isSeedcordError as o, SeedcordErrorCode as p, SeedcordErrorTypeString as r, SeedcordErrorArguments as s, SeedcordAggregateError as t, WORDMARK as u };
+//# sourceMappingURL=SeedcordError-Cce9qKW3.d.mts.map