@seedcord/services 0.7.1 → 0.8.0-next.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,350 +0,0 @@
1
- import chalk from "chalk";
2
-
3
- //#region src/Errors/ErrorCodes.ts
4
- /**
5
- * All Seedcord error codes.
6
- */
7
- let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
8
- /** DISCORD_BOT_TOKEN is not present in the environment. */
9
- SeedcordErrorCode[SeedcordErrorCode["ConfigMissingDiscordToken"] = 1001] = "ConfigMissingDiscordToken";
10
- /** DISCORD_BOT_TOKEN is present but fails validation. */
11
- SeedcordErrorCode[SeedcordErrorCode["ConfigIncorrectDiscordToken"] = 1004] = "ConfigIncorrectDiscordToken";
12
- /** UNKNOWN_EXCEPTION_WEBHOOK_URL is missing when configuring the reporter. */
13
- SeedcordErrorCode[SeedcordErrorCode["ConfigUnknownExceptionWebhookMissing"] = 1002] = "ConfigUnknownExceptionWebhookMissing";
14
- /** UNKNOWN_EXCEPTION_WEBHOOK_URL is present but fails URL validation. */
15
- SeedcordErrorCode[SeedcordErrorCode["ConfigUnknownExceptionWebhookInvalid"] = 1003] = "ConfigUnknownExceptionWebhookInvalid";
16
- /** Attempted to add lifecycle tasks after startup already completed. */
17
- SeedcordErrorCode[SeedcordErrorCode["LifecycleAddAfterCompletion"] = 1101] = "LifecycleAddAfterCompletion";
18
- /** Attempted to add lifecycle tasks while startup is still running. */
19
- SeedcordErrorCode[SeedcordErrorCode["LifecycleAddDuringRun"] = 1102] = "LifecycleAddDuringRun";
20
- /** Attempted to remove lifecycle tasks while startup is still running. */
21
- SeedcordErrorCode[SeedcordErrorCode["LifecycleRemoveDuringRun"] = 1103] = "LifecycleRemoveDuringRun";
22
- /** Provided lifecycle phase identifier is not recognized. */
23
- SeedcordErrorCode[SeedcordErrorCode["LifecycleUnknownPhase"] = 1104] = "LifecycleUnknownPhase";
24
- /** Startup phase completed with one or more task failures. */
25
- SeedcordErrorCode[SeedcordErrorCode["LifecyclePhaseFailures"] = 1105] = "LifecyclePhaseFailures";
26
- /** A lifecycle task exceeded its configured timeout. */
27
- SeedcordErrorCode[SeedcordErrorCode["LifecycleTaskTimeout"] = 1106] = "LifecycleTaskTimeout";
28
- /** Multiple Seedcord instances were created simultaneously. */
29
- SeedcordErrorCode[SeedcordErrorCode["CoreSingletonViolation"] = 1201] = "CoreSingletonViolation";
30
- /** Plugins cannot be mutated after the core has finished initializing. */
31
- SeedcordErrorCode[SeedcordErrorCode["CorePluginAfterInit"] = 1202] = "CorePluginAfterInit";
32
- /** A plugin tried to register with a key that already exists. */
33
- SeedcordErrorCode[SeedcordErrorCode["CorePluginKeyExists"] = 1203] = "CorePluginKeyExists";
34
- /** Bot role lookup failed within the provided guild. */
35
- SeedcordErrorCode[SeedcordErrorCode["CoreBotRoleMissing"] = 1204] = "CoreBotRoleMissing";
36
- /** A bot controller was constructed without its required handlers directory. */
37
- SeedcordErrorCode[SeedcordErrorCode["CoreControllerPathMissing"] = 1205] = "CoreControllerPathMissing";
38
- /** Interaction middleware decorated with disallowed event filters. */
39
- SeedcordErrorCode[SeedcordErrorCode["DecoratorInteractionEventFilter"] = 1301] = "DecoratorInteractionEventFilter";
40
- /** A decorator could not find the original method being decorated. */
41
- SeedcordErrorCode[SeedcordErrorCode["DecoratorMethodNotFound"] = 1302] = "DecoratorMethodNotFound";
42
- /** A command decorator attempted to re-register an existing command scope. */
43
- SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandAlreadyRegistered"] = 1303] = "DecoratorCommandAlreadyRegistered";
44
- /** A global command decorator specified guild IDs, which is not allowed. */
45
- SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGlobalWithGuilds"] = 1304] = "DecoratorCommandGlobalWithGuilds";
46
- /** A guild command decorator omitted the required guild ID list. */
47
- SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGuildWithoutGuilds"] = 1305] = "DecoratorCommandGuildWithoutGuilds";
48
- /** Middleware priority provided by the decorator was not a finite number. */
49
- SeedcordErrorCode[SeedcordErrorCode["DecoratorInvalidMiddlewarePriority"] = 1306] = "DecoratorInvalidMiddlewarePriority";
50
- /** StrictEventEmitter.waitFor was aborted via its AbortSignal. */
51
- SeedcordErrorCode[SeedcordErrorCode["EventEmitterWaitForAborted"] = 1501] = "EventEmitterWaitForAborted";
52
- /** StrictEventEmitter.waitFor exceeded its configured timeout. */
53
- SeedcordErrorCode[SeedcordErrorCode["EventEmitterWaitForTimeout"] = 1502] = "EventEmitterWaitForTimeout";
54
- /** A customId definition prefix contains a reserved character (a colon or a control char). */
55
- SeedcordErrorCode[SeedcordErrorCode["CustomIdInvalidPrefix"] = 1601] = "CustomIdInvalidPrefix";
56
- /** A customId field name is integer-like, which JS would silently reorder. */
57
- SeedcordErrorCode[SeedcordErrorCode["CustomIdReservedFieldName"] = 1602] = "CustomIdReservedFieldName";
58
- /** A oneOf() field was declared with no choices. */
59
- SeedcordErrorCode[SeedcordErrorCode["CustomIdEmptyChoices"] = 1603] = "CustomIdEmptyChoices";
60
- /** An int() field was declared with min greater than max. */
61
- SeedcordErrorCode[SeedcordErrorCode["CustomIdInvalidBounds"] = 1604] = "CustomIdInvalidBounds";
62
- /** A value passed to encode() is outside its field's allowed range. */
63
- SeedcordErrorCode[SeedcordErrorCode["CustomIdValueOutOfRange"] = 1605] = "CustomIdValueOutOfRange";
64
- /** An encoded customId exceeds Discord's 100-character limit. */
65
- SeedcordErrorCode[SeedcordErrorCode["CustomIdWireTooLong"] = 1606] = "CustomIdWireTooLong";
66
- /** A field name is declared more than once in the same customId chain. */
67
- SeedcordErrorCode[SeedcordErrorCode["CustomIdDuplicateFieldName"] = 1607] = "CustomIdDuplicateFieldName";
68
- /** A component handler is missing its route decorator (\@ButtonRoute / \@ModalRoute / \@SelectMenuRoute). */
69
- SeedcordErrorCode[SeedcordErrorCode["CustomIdHandlerRouteMissing"] = 1608] = "CustomIdHandlerRouteMissing";
70
- /** match() received a decoded route with no matching arm. */
71
- SeedcordErrorCode[SeedcordErrorCode["CustomIdMatchArmMissing"] = 1609] = "CustomIdMatchArmMissing";
72
- /** A slash handler's match() has no arm for the command route that fired. */
73
- SeedcordErrorCode[SeedcordErrorCode["SlashMatchArmMissing"] = 1610] = "SlashMatchArmMissing";
74
- /** An autocomplete handler's match() has no arm for the focused field that fired. */
75
- SeedcordErrorCode[SeedcordErrorCode["AutocompleteMatchArmMissing"] = 1611] = "AutocompleteMatchArmMissing";
76
- /** An event handler's match() has no arm for the event name that fired. */
77
- SeedcordErrorCode[SeedcordErrorCode["EventMatchArmMissing"] = 1612] = "EventMatchArmMissing";
78
- /** Event middleware read `this.eventName` but was constructed without a fired event name. */
79
- SeedcordErrorCode[SeedcordErrorCode["EventMiddlewareNameUnavailable"] = 1613] = "EventMiddlewareNameUnavailable";
80
- /** Mongo service class is missing the `@RegisterMongoService` decorator. */
81
- SeedcordErrorCode[SeedcordErrorCode["PluginMongoServiceDecoratorMissing"] = 2101] = "PluginMongoServiceDecoratorMissing";
82
- /** Mongo model class is missing the `@RegisterMongoModel` decorator. */
83
- SeedcordErrorCode[SeedcordErrorCode["PluginMongoModelDecoratorMissing"] = 2102] = "PluginMongoModelDecoratorMissing";
84
- /** Mongo client failed to establish a connection. */
85
- SeedcordErrorCode[SeedcordErrorCode["PluginMongoConnectionFailed"] = 2103] = "PluginMongoConnectionFailed";
86
- /** Mongo client failed to disconnect cleanly during shutdown. */
87
- SeedcordErrorCode[SeedcordErrorCode["PluginMongoDisconnectFailed"] = 2104] = "PluginMongoDisconnectFailed";
88
- /** Mongo `services` was accessed before the plugin finished initializing. */
89
- SeedcordErrorCode[SeedcordErrorCode["PluginMongoServicesNotReady"] = 2105] = "PluginMongoServicesNotReady";
90
- /** KPG service class is missing the `@RegisterKpgService` decorator. */
91
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgServiceDecoratorMissing"] = 2201] = "PluginKpgServiceDecoratorMissing";
92
- /** KPG service class is missing its table metadata. */
93
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgServiceTableMissing"] = 2202] = "PluginKpgServiceTableMissing";
94
- /** Migration manager received an invalid step count. */
95
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgInvalidStepCount"] = 2203] = "PluginKpgInvalidStepCount";
96
- /** Migration direction was not recognized. */
97
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgUnknownDirection"] = 2204] = "PluginKpgUnknownDirection";
98
- /** Provided migrations path could not be resolved. */
99
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgUnresolvedMigrationsPath"] = 2205] = "PluginKpgUnresolvedMigrationsPath";
100
- /** No migration files were found for execution. */
101
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgNoMigrationFiles"] = 2206] = "PluginKpgNoMigrationFiles";
102
- /** A migration module failed to export the expected functions. */
103
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgInvalidMigrationModule"] = 2207] = "PluginKpgInvalidMigrationModule";
104
- /** An arbitrary (non-Error) failure was reported by a migration. */
105
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgNonErrorFailure"] = 2208] = "PluginKpgNonErrorFailure";
106
- /** Postgres pool failed to close cleanly during shutdown. */
107
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgDisconnectFailed"] = 2209] = "PluginKpgDisconnectFailed";
108
- /** KPG `services` was accessed before the plugin finished initializing. */
109
- SeedcordErrorCode[SeedcordErrorCode["PluginKpgServicesNotReady"] = 2210] = "PluginKpgServicesNotReady";
110
- /** Config file default export was not an object. */
111
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidExport"] = 3101] = "CliConfigInvalidExport";
112
- /** Config is missing the required instance string. */
113
- SeedcordErrorCode[SeedcordErrorCode["CliConfigMissingInstance"] = 3102] = "CliConfigMissingInstance";
114
- /** Config root was provided but not a string. */
115
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidRoot"] = 3103] = "CliConfigInvalidRoot";
116
- /** Unable to locate a Seedcord config file. */
117
- SeedcordErrorCode[SeedcordErrorCode["CliConfigNotFound"] = 3104] = "CliConfigNotFound";
118
- /** CLI entry file does not exist. */
119
- SeedcordErrorCode[SeedcordErrorCode["CliEntryNotFound"] = 3105] = "CliEntryNotFound";
120
- /** tsx failed to import the provided entry file. */
121
- SeedcordErrorCode[SeedcordErrorCode["CliTsxImportFailed"] = 3106] = "CliTsxImportFailed";
122
- /** Native import and jiti fallback both failed. */
123
- SeedcordErrorCode[SeedcordErrorCode["CliImportFailed"] = 3107] = "CliImportFailed";
124
- /** Seedcord instance export is missing a start() method. */
125
- SeedcordErrorCode[SeedcordErrorCode["CliInstanceInvalid"] = 3108] = "CliInstanceInvalid";
126
- /** Seedcord instance threw during startup. */
127
- SeedcordErrorCode[SeedcordErrorCode["CliStartFailed"] = 3109] = "CliStartFailed";
128
- /** Config is missing the required entry string. */
129
- SeedcordErrorCode[SeedcordErrorCode["CliConfigMissingEntry"] = 3110] = "CliConfigMissingEntry";
130
- /** Config build options must be an object when provided. */
131
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuild"] = 3111] = "CliConfigInvalidBuild";
132
- /** Config build outDir must be a string when provided. */
133
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuildOutDir"] = 3112] = "CliConfigInvalidBuildOutDir";
134
- /** Config build tsconfig must be a string when provided. */
135
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuildTsconfig"] = 3113] = "CliConfigInvalidBuildTsconfig";
136
- /** Config build bootstrap must be a string when provided. */
137
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidBuildBootstrap"] = 3114] = "CliConfigInvalidBuildBootstrap";
138
- /** Entry file must be inside the configured root directory. */
139
- SeedcordErrorCode[SeedcordErrorCode["CliConfigEntryOutsideRoot"] = 3115] = "CliConfigEntryOutsideRoot";
140
- /** Unable to locate a TypeScript config file for builds. */
141
- SeedcordErrorCode[SeedcordErrorCode["CliBuildTsconfigNotFound"] = 3116] = "CliBuildTsconfigNotFound";
142
- /** TypeScript reported diagnostics during emit. */
143
- SeedcordErrorCode[SeedcordErrorCode["CliBuildFailed"] = 3117] = "CliBuildFailed";
144
- /** Unable to write the generated bootstrap file. */
145
- SeedcordErrorCode[SeedcordErrorCode["CliBootstrapWriteFailed"] = 3118] = "CliBootstrapWriteFailed";
146
- /** Config tsconfig must be a string when provided. */
147
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidTsconfig"] = 3119] = "CliConfigInvalidTsconfig";
148
- /** Config hmr options must be an object when provided. */
149
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidHmr"] = 3120] = "CliConfigInvalidHmr";
150
- /** Config hmr restart patterns must be an array of strings when provided. */
151
- SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidHmrRestart"] = 3121] = "CliConfigInvalidHmrRestart";
152
- /** Two commands resolve to the same slash route during codegen. */
153
- SeedcordErrorCode[SeedcordErrorCode["CliCodegenDuplicateRoute"] = 3122] = "CliCodegenDuplicateRoute";
154
- /** The commands directory could not be read during codegen. */
155
- SeedcordErrorCode[SeedcordErrorCode["CliCodegenCommandsDirUnreadable"] = 3123] = "CliCodegenCommandsDirUnreadable";
156
- /** Two context-menu commands of the same kind share a name during codegen. */
157
- SeedcordErrorCode[SeedcordErrorCode["CliCodegenDuplicateContextMenu"] = 3124] = "CliCodegenDuplicateContextMenu";
158
- return SeedcordErrorCode;
159
- }({});
160
-
161
- //#endregion
162
- //#region src/Errors/ErrorMessages.ts
163
- /** @internal */
164
- const messages = {
165
- [1001]: () => "Missing DISCORD_BOT_TOKEN environment variable.",
166
- [1004]: () => "Invalid DISCORD_BOT_TOKEN value.",
167
- [1002]: () => "Missing UNKNOWN_EXCEPTION_WEBHOOK_URL environment variable.",
168
- [1003]: () => "Invalid UNKNOWN_EXCEPTION_WEBHOOK_URL value.",
169
- [1101]: () => "Cannot add tasks after startup sequence has already completed.",
170
- [1102]: () => "Cannot add tasks while startup sequence is in progress.",
171
- [1103]: () => "Cannot remove tasks while startup sequence is in progress.",
172
- [1104]: (phase) => `Unknown phase: ${String(phase)}.`,
173
- [1105]: (phase, failures) => `Phase ${phase} completed with ${failures} failed task${failures === 1 ? "" : "s"}.`,
174
- [1106]: (taskName, timeout) => `Task "${taskName}" timed out after ${timeout}ms.`,
175
- [1201]: () => "Seedcord can only be instantiated once. Use the existing instance instead.",
176
- [1202]: () => "Cannot attach a plugin after initialization.",
177
- [1203]: (key) => `Plugin with key "${key}" already exists.`,
178
- [1204]: (guildId) => guildId ? `Bot role not found in guild ${guildId}.` : "Bot role not found in guild.",
179
- [1205]: (controllerName, pathKind) => `${controllerName} was instantiated without a ${pathKind} path.`,
180
- [1301]: () => "Interaction middleware cannot specify event filters.",
181
- [1302]: () => "Decorator could not locate the original method. Ensure the method exists before applying the decorator.",
182
- [1303]: (commandName, existingScope, requestedScope) => `Command "${commandName}" is already registered as a "${existingScope}" command and cannot be re-registered as a "${requestedScope}" command.`,
183
- [1304]: () => "RegisterCommand(\"global\") cannot have guilds specified.",
184
- [1305]: () => "RegisterCommand(\"guild\") requires a non-empty guilds array.",
185
- [1306]: () => "Middleware priority must be a finite number.",
186
- [1501]: () => "waitFor was aborted via its AbortSignal.",
187
- [1502]: (timeout) => `waitFor timed out after ${timeout}ms.`,
188
- [1601]: (prefix) => `customId prefix ${JSON.stringify(prefix)} must be a non-empty string without a colon or control character.`,
189
- [1602]: (field) => `customId field name ${JSON.stringify(field)} is integer-like, which JS reorders. Use a non-numeric name.`,
190
- [1603]: (field) => `customId field ${JSON.stringify(field)} uses oneOf() with no choices.`,
191
- [1604]: (field, min, max) => `customId field ${JSON.stringify(field)} has min ${min} greater than max ${max}.`,
192
- [1605]: (field, value) => `customId field ${JSON.stringify(field)} got value ${value} outside its allowed range.`,
193
- [1606]: (length) => `Encoded customId is ${length} characters, Discord allows at most 100.`,
194
- [1607]: (field) => `customId field ${JSON.stringify(field)} is already defined in this chain.`,
195
- [1608]: (className) => `${className} is missing its route decorator (@ButtonRoute, @ModalRoute, or @SelectMenuRoute).`,
196
- [1609]: (prefix) => `match() has no arm for the decoded route ${JSON.stringify(prefix)}.`,
197
- [1610]: (route) => `match() has no arm for the command route ${JSON.stringify(route)}.`,
198
- [1611]: (field) => `match() has no arm for the focused field ${JSON.stringify(field)}.`,
199
- [1612]: (event) => `match() has no arm for the event ${JSON.stringify(event)}.`,
200
- [1613]: () => `this.eventName is only available on middleware the controller constructed with a fired event name.`,
201
- [2101]: (className) => `Missing @RegisterMongoService on ${className}.`,
202
- [2102]: (className) => `Missing @RegisterMongoModel on ${className}.`,
203
- [2103]: (databaseName) => databaseName ? `Could not connect to MongoDB (${databaseName}).` : "Could not connect to MongoDB.",
204
- [2104]: () => "Failed to disconnect from MongoDB cleanly during shutdown.",
205
- [2105]: () => "Mongo services accessed before the plugin finished initializing.",
206
- [2201]: (className) => `Missing @RegisterKpgService on ${className}.`,
207
- [2202]: (className) => `Missing table metadata for ${className}. Provide a table via @RegisterKpgService().`,
208
- [2203]: () => "Migration step count must be a non-negative integer.",
209
- [2204]: (direction) => `Unknown migration direction: ${String(direction)}.`,
210
- [2205]: (label) => `Unable to resolve migrations at path: ${label}.`,
211
- [2206]: () => "No migration files provided.",
212
- [2207]: (filePath) => `Migration file ${filePath} must export async functions up and down.`,
213
- [2208]: (message) => `Migration failure: ${message}.`,
214
- [2209]: () => "Failed to close the Postgres pool cleanly during shutdown.",
215
- [2210]: () => "KPG services accessed before the plugin finished initializing.",
216
- [3101]: () => "Config file must default export an object.",
217
- [3102]: () => "Config must include an `instance` string that points to your Seedcord default export.",
218
- [3103]: () => "Config `root` must be a string when provided.",
219
- [3104]: (baseDir, candidates) => `Unable to locate a Seedcord config in ${baseDir}. Searched for ${candidates.join(", ")}.`,
220
- [3110]: () => "Config must include an `entry` string that points to your startup script.",
221
- [3111]: () => "Config `build` must be an object when provided.",
222
- [3112]: () => "Config `build.outDir` must be a string when provided.",
223
- [3113]: () => "Config `build.tsconfig` must be a string when provided.",
224
- [3114]: () => "Config `build.bootstrap` must be a string when provided.",
225
- [3115]: (entryPath, root) => `Entry file ${entryPath} must reside inside configured root ${root}.`,
226
- [3105]: (entryPath) => `Cannot find entry file at ${entryPath}.`,
227
- [3106]: (entryPath, reason) => `Failed to import ${entryPath} via tsx: ${reason}.`,
228
- [3107]: (entryPath, nativeReason, fallbackReason) => `Failed to import ${entryPath}: ${nativeReason}. Fallback via jiti also failed: ${fallbackReason}.`,
229
- [3108]: () => "Seedcord instance must default export an object with a start() method.",
230
- [3109]: (instancePath, reason) => `Failed to start Seedcord from ${instancePath}: ${reason}.`,
231
- [3116]: (hint) => `Unable to resolve a tsconfig for builds (${hint}). Provide build.tsconfig or add tsconfig.build.json / tsconfig.json.`,
232
- [3117]: (diagnostics) => `TypeScript build failed:\n${diagnostics}`,
233
- [3118]: (targetPath, reason) => `Failed to write bootstrap file at ${targetPath}: ${reason}.`,
234
- [3119]: () => "Config `tsconfig` must be a string when provided.",
235
- [3120]: () => "Config `hmr` must be an object when provided.",
236
- [3121]: () => "Config `hmr.restart` must be an array of strings when provided.",
237
- [3122]: (route, firstFile, secondFile) => `Two commands resolve to the same slash route \`${route}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,
238
- [3123]: (dir, reason) => `Could not read the commands directory ${dir} during codegen. ${reason}.`,
239
- [3124]: (kind, name, firstFile, secondFile) => `Two ${kind} context-menu commands share the name \`${name}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`
240
- };
241
- /** @internal */
242
- function formatSeedcordErrorMessage(code, args) {
243
- const formatter = messages[code];
244
- return formatter(...args ?? []);
245
- }
246
-
247
- //#endregion
248
- //#region src/Errors/SeedcordError.ts
249
- function resolveIdentifier(code) {
250
- return SeedcordErrorCode[code];
251
- }
252
- function resolveCtorInputs(rest) {
253
- const [maybeArgsOrOptions, maybeOptions] = rest;
254
- if (Array.isArray(maybeArgsOrOptions)) {
255
- const result = { args: maybeArgsOrOptions };
256
- if (maybeOptions !== void 0) result.options = maybeOptions;
257
- return result;
258
- }
259
- const result = { args: void 0 };
260
- if (maybeArgsOrOptions !== void 0) result.options = maybeArgsOrOptions;
261
- return result;
262
- }
263
- function resolveMessage(code, args) {
264
- return formatSeedcordErrorMessage(code, args);
265
- }
266
- function formatErrorName(name, _identifier, code) {
267
- return `${chalk.bold.red(name)}[${chalk.gray(code)}]`;
268
- }
269
- /**
270
- * Base class for Seedcord errors.
271
- *
272
- * @internal
273
- */
274
- var SeedcordError = class extends Error {
275
- code;
276
- identifier;
277
- type = "SeedcordError";
278
- constructor(code, ...rest) {
279
- const { args, options } = resolveCtorInputs(rest);
280
- const message = resolveMessage(code, args);
281
- super(message, options);
282
- this.code = code;
283
- this.identifier = resolveIdentifier(code);
284
- this.name = formatErrorName(new.target.name, this.identifier, this.code);
285
- Object.setPrototypeOf(this, new.target.prototype);
286
- if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, new.target);
287
- }
288
- };
289
- /**
290
- * TypeError class for Seedcord errors.
291
- *
292
- * @internal
293
- */
294
- var SeedcordTypeError = class extends TypeError {
295
- code;
296
- identifier;
297
- type = "SeedcordTypeError";
298
- constructor(code, ...rest) {
299
- const { args, options } = resolveCtorInputs(rest);
300
- const message = resolveMessage(code, args);
301
- super(message, options);
302
- this.code = code;
303
- this.identifier = resolveIdentifier(code);
304
- this.name = formatErrorName(new.target.name, this.identifier, this.code);
305
- Object.setPrototypeOf(this, new.target.prototype);
306
- if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, new.target);
307
- }
308
- };
309
- /**
310
- * RangeError class for Seedcord errors.
311
- *
312
- * @internal
313
- */
314
- var SeedcordRangeError = class extends RangeError {
315
- code;
316
- identifier;
317
- type = "SeedcordRangeError";
318
- constructor(code, ...rest) {
319
- const { args, options } = resolveCtorInputs(rest);
320
- const message = resolveMessage(code, args);
321
- super(message, options);
322
- this.code = code;
323
- this.identifier = resolveIdentifier(code);
324
- this.name = formatErrorName(new.target.name, this.identifier, this.code);
325
- Object.setPrototypeOf(this, new.target.prototype);
326
- if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, new.target);
327
- }
328
- };
329
- /**
330
- * Determines whether an unknown value is a Seedcord error, with optional narrowing by class and error code.
331
- *
332
- * @param error - The value to inspect.
333
- * @param type - Optional error class discriminator (Error, TypeError, or RangeError).
334
- * @param code - Optional {@link SeedcordErrorCode} discriminator to narrow by code.
335
- * @typeParam Type - What kind of {@link SeedcordErrorTypeString} to filter by.
336
- * @typeParam Code - The specific {@link SeedcordErrorCode} to filter by.
337
- */
338
- function isSeedcordError(error, type, code) {
339
- const isSeedcordErrorInstance = error instanceof SeedcordError && error.type === "SeedcordError";
340
- const isSeedcordTypeErrorInstance = error instanceof SeedcordTypeError && error.type === "SeedcordTypeError";
341
- const isSeedcordRangeErrorInstance = error instanceof SeedcordRangeError && error.type === "SeedcordRangeError";
342
- if (!isSeedcordErrorInstance && !isSeedcordTypeErrorInstance && !isSeedcordRangeErrorInstance) return false;
343
- if (!(type ? type === "SeedcordError" && isSeedcordErrorInstance || type === "SeedcordTypeError" && isSeedcordTypeErrorInstance || type === "SeedcordRangeError" && isSeedcordRangeErrorInstance : true)) return false;
344
- if (code === void 0) return true;
345
- return error.code === code;
346
- }
347
-
348
- //#endregion
349
- export { SeedcordErrorCode as a, isSeedcordError as i, SeedcordRangeError as n, SeedcordTypeError as r, SeedcordError as t };
350
- //# sourceMappingURL=SeedcordError-E2D_RTuy.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"SeedcordError-E2D_RTuy.mjs","names":[],"sources":["../src/Errors/ErrorCodes.ts","../src/Errors/ErrorMessages.ts","../src/Errors/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\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 /** 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}\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\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.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} 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\n/**\n * Base interface for Seedcord error instances.\n *\n * @internal\n */\nexport interface BaseSeedcordError {\n readonly code: SeedcordErrorCode;\n readonly identifier: SeedcordErrorIdentifier;\n readonly type: SeedcordErrorTypeString;\n}\n\n/**\n * Base class for Seedcord errors.\n *\n * @internal\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 *\n * @internal\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 *\n * @internal\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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"}
@@ -1,6 +0,0 @@
1
- Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
2
- const require_SeedcordError = require('./SeedcordError-C1GYc1BF.cjs');
3
-
4
- exports.SeedcordError = require_SeedcordError.SeedcordError;
5
- exports.SeedcordRangeError = require_SeedcordError.SeedcordRangeError;
6
- exports.SeedcordTypeError = require_SeedcordError.SeedcordTypeError;
@@ -1 +0,0 @@
1
- export type * from './internal.index.d.mts'
@@ -1,2 +0,0 @@
1
- import { a as SeedcordTypeError, i as SeedcordRangeError, n as SeedcordError } from "./SeedcordError-D6uPv6qc.mjs";
2
- export { SeedcordError, SeedcordRangeError, SeedcordTypeError };
@@ -1,3 +0,0 @@
1
- import { n as SeedcordRangeError, r as SeedcordTypeError, t as SeedcordError } from "./SeedcordError-E2D_RTuy.mjs";
2
-
3
- export { SeedcordError, SeedcordRangeError, SeedcordTypeError };