create-seedcord 0.2.0 → 0.3.0

package/dist/index.mjs

@@ -1922,7 +1922,7 @@ const chalk = createChalk();
 const chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 
 //#endregion
-//#region ../../packages/errors/dist/SeedcordError-DnV6q4mB.mjs
+//#region ../../packages/errors/dist/SeedcordError-C3HkJAhQ.mjs
 /**
 * All Seedcord error codes.
 */
@@ -1959,6 +1959,8 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["LifecycleTaskTimeout"] = 1106] = "LifecycleTaskTimeout";
 	/** A host whose startup failed was started again. */
 	SeedcordErrorCode[SeedcordErrorCode["LifecycleRestartAfterFailure"] = 1107] = "LifecycleRestartAfterFailure";
+	/** The configured shutdown deadline is zero, negative, or not finite. */
+	SeedcordErrorCode[SeedcordErrorCode["LifecycleInvalidShutdownDeadline"] = 1108] = "LifecycleInvalidShutdownDeadline";
 	/** Multiple Seedcord instances were created simultaneously. */
 	SeedcordErrorCode[SeedcordErrorCode["CoreSingletonViolation"] = 1201] = "CoreSingletonViolation";
 	/** Plugins cannot be mutated after the core has finished initializing. */
@@ -1983,22 +1985,32 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["CoreLifecycleUnavailable"] = 1211] = "CoreLifecycleUnavailable";
 	/** `emit` was called on the bus. It reaches listeners and skips every subscriber. */
 	SeedcordErrorCode[SeedcordErrorCode["CoreBusEmitUnavailable"] = 1212] = "CoreBusEmitUnavailable";
-	/** Interaction middleware decorated with disallowed event filters. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorInteractionEventFilter"] = 1301] = "DecoratorInteractionEventFilter";
+	/** A command decorator passed `'config'` while `commands.guilds` is empty. */
+	SeedcordErrorCode[SeedcordErrorCode["CoreCommandGuildsEmpty"] = 1213] = "CoreCommandGuildsEmpty";
+	/** Discord refused the command deploy for one guild. */
+	SeedcordErrorCode[SeedcordErrorCode["CoreCommandGuildDeployFailed"] = 1214] = "CoreCommandGuildDeployFailed";
+	/** A plugin was attached under a group name the bot already uses. */
+	SeedcordErrorCode[SeedcordErrorCode["CorePluginGroupTaken"] = 1215] = "CorePluginGroupTaken";
+	/** A plugin was attached at a name that holds a group of plugins. */
+	SeedcordErrorCode[SeedcordErrorCode["CorePluginKeyHoldsGroup"] = 1216] = "CorePluginKeyHoldsGroup";
+	/** A plugin key is empty, has an empty part, or carries more than one dot. */
+	SeedcordErrorCode[SeedcordErrorCode["CorePluginKeyMalformed"] = 1217] = "CorePluginKeyMalformed";
 	/** A command decorator attempted to re-register an existing command scope. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandAlreadyRegistered"] = 1302] = "DecoratorCommandAlreadyRegistered";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandAlreadyRegistered"] = 1301] = "DecoratorCommandAlreadyRegistered";
 	/** A global command decorator specified guild IDs, which is not allowed. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGlobalWithGuilds"] = 1303] = "DecoratorCommandGlobalWithGuilds";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGlobalWithGuilds"] = 1302] = "DecoratorCommandGlobalWithGuilds";
 	/** A guild command decorator omitted the required guild ID list. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGuildWithoutGuilds"] = 1304] = "DecoratorCommandGuildWithoutGuilds";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorCommandGuildWithoutGuilds"] = 1303] = "DecoratorCommandGuildWithoutGuilds";
 	/** Middleware priority provided by the decorator was not a finite number. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorInvalidMiddlewarePriority"] = 1305] = "DecoratorInvalidMiddlewarePriority";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorInvalidMiddlewarePriority"] = 1304] = "DecoratorInvalidMiddlewarePriority";
 	/** A WebhookLog subclass is missing its `@WebhookUrl` decorator. */
-	SeedcordErrorCode[SeedcordErrorCode["DecoratorWebhookUrlMissing"] = 1306] = "DecoratorWebhookUrlMissing";
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorWebhookUrlMissing"] = 1305] = "DecoratorWebhookUrlMissing";
+	/** A middleware decorator was given an empty filter array. */
+	SeedcordErrorCode[SeedcordErrorCode["DecoratorEmptyMiddlewareFilter"] = 1306] = "DecoratorEmptyMiddlewareFilter";
 	/** Two interaction handlers registered the same route within a scope. */
 	SeedcordErrorCode[SeedcordErrorCode["InteractionDuplicateRoute"] = 1401] = "InteractionDuplicateRoute";
-	/** Two different interaction middleware classes share a class name. */
-	SeedcordErrorCode[SeedcordErrorCode["InteractionDuplicateMiddleware"] = 1402] = "InteractionDuplicateMiddleware";
+	/** Two different middleware classes share a class name. */
+	SeedcordErrorCode[SeedcordErrorCode["DuplicateMiddleware"] = 1402] = "DuplicateMiddleware";
 	/** A route manifest row gives an export name its module does not have. */
 	SeedcordErrorCode[SeedcordErrorCode["InteractionRouteExportMissing"] = 1403] = "InteractionRouteExportMissing";
 	/** A subscriber manifest row specifies an export that does not extend `Subscriber`. */
@@ -2019,17 +2031,17 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdInvalidPrefix"] = 1601] = "CustomIdInvalidPrefix";
 	/** A customId field name is integer-like, which JS would silently reorder. */
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdReservedFieldName"] = 1602] = "CustomIdReservedFieldName";
-	/** A oneOf() field was declared with no choices. */
+	/** A oneOf() or someOf() field was declared with no choices. */
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdEmptyChoices"] = 1603] = "CustomIdEmptyChoices";
 	/** An int() field was declared with min greater than max. */
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdInvalidBounds"] = 1604] = "CustomIdInvalidBounds";
-	/** A value passed to encode() is outside its field's allowed range. */
-	SeedcordErrorCode[SeedcordErrorCode["CustomIdValueOutOfRange"] = 1605] = "CustomIdValueOutOfRange";
+	/** A field rejected the value given to encode(). */
+	SeedcordErrorCode[SeedcordErrorCode["CustomIdValueRejected"] = 1605] = "CustomIdValueRejected";
 	/** An encoded customId exceeds Discord's 100-character limit. */
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdWireTooLong"] = 1606] = "CustomIdWireTooLong";
 	/** A field name is declared more than once in the same customId chain. */
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdDuplicateFieldName"] = 1607] = "CustomIdDuplicateFieldName";
-	/** A component handler is missing its route decorator (\@ButtonRoute / \@ModalRoute / \@SelectMenuRoute). */
+	/** A component handler is missing the route decorator that matches its base. */
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdHandlerRouteMissing"] = 1608] = "CustomIdHandlerRouteMissing";
 	/** match() received a decoded route with no matching arm. */
 	SeedcordErrorCode[SeedcordErrorCode["CustomIdMatchArmMissing"] = 1609] = "CustomIdMatchArmMissing";
@@ -2053,6 +2065,12 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["ModalFieldEmpty"] = 1618] = "ModalFieldEmpty";
 	/** A channel select field picked a channel outside the types getSelectedChannels() allows. */
 	SeedcordErrorCode[SeedcordErrorCode["ModalFieldChannelType"] = 1619] = "ModalFieldChannelType";
+	/** A customId was minted under an older shape of the same definition. */
+	SeedcordErrorCode[SeedcordErrorCode["CustomIdWireStale"] = 1620] = "CustomIdWireStale";
+	/** A customId wire is corrupt, truncated, or was minted by a different definition. */
+	SeedcordErrorCode[SeedcordErrorCode["CustomIdWireInvalid"] = 1621] = "CustomIdWireInvalid";
+	/** `dispatch.require()` was called for a key nothing wrote on this dispatch. */
+	SeedcordErrorCode[SeedcordErrorCode["DispatchStateMissing"] = 1622] = "DispatchStateMissing";
 	/** 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. */
@@ -2214,6 +2232,7 @@ const messages = {
 	[1105]: (phase, failures) => `Phase ${phase} completed with ${failures} failed task${failures === 1 ? "" : "s"}.`,
 	[1106]: (taskName, timeout) => `Task "${taskName}" timed out after ${timeout}ms.`,
 	[1107]: () => "Startup failed and this host cannot start again. Construct a new instance.",
+	[1108]: (declared) => `lifecycle.shutdownDeadline is ${declared}. Pass a positive number of milliseconds, or omit it for the default.`,
 	[1201]: () => "Seedcord can only be instantiated once. Use the existing instance instead.",
 	[1202]: () => "Cannot attach a plugin after initialization.",
 	[1203]: (key) => `Plugin with key "${key}" already exists.`,
@@ -2221,19 +2240,24 @@ const messages = {
 	[1205]: (controllerName, pathKind) => `${controllerName} was instantiated without a ${pathKind} path.`,
 	[1206]: (file) => `${file} threw while importing.`,
 	[1207]: (dir) => `${dir} could not be read.`,
+	[1215]: (head, key) => `${paint.sky(head)} is already taken on this bot, so ${paint.sky(key)} cannot nest under it. Pick another group name.`,
+	[1217]: (key, reason) => `${paint.sky(key)} ${reason} Write a group and a plugin name around one dot, like 'services.users'.`,
+	[1216]: (key) => `${paint.sky(key)} already holds a group of plugins. Attach this one under a name of its own.`,
 	[1208]: (key) => `Plugin key "${key}" is a channel the framework logs on. Pick another key.`,
 	[1209]: () => "The bot's application id resolves during startup. You read it before that. Read it inside a handler, inside a plugin's ready(), or after start() resolves.",
 	[1210]: (accessor, key) => `${accessor}.${key} has no value yet. ${accessor} fills during startup, and a read at the top of a file runs before that.`,
 	[1211]: (accessor) => `core.${accessor}.addTask() does not work here. This bot was built with createSeedcord() whose build never runs startup or shutdown. Your task would never run. Do the work inside your handler instead. To use startup and shutdown, run the bot on node with new Seedcord(config).start().`,
 	[1212]: (event) => `core.bus.emit('${event}') would reach your on() listeners and skip every Subscriber class. Call core.bus.publish('${event}', data) to run both.`,
-	[1301]: () => "Interaction middleware cannot specify event filters.",
-	[1302]: (commandName, existingScope, requestedScope) => `Command "${commandName}" is already registered as a "${existingScope}" command and cannot be re-registered as a "${requestedScope}" command.`,
-	[1303]: () => "RegisterCommand(\"global\") cannot have guilds specified.",
-	[1304]: () => "RegisterCommand(\"guild\") requires a non-empty guilds array.",
-	[1305]: () => "Middleware priority must be a finite number.",
-	[1306]: (className) => `${className} extends WebhookLog and needs a @WebhookUrl decorator naming its env var.`,
+	[1213]: (commandName) => `${paint.sky(commandName)} registers to the 'config' guilds while commands.guilds is empty.\nList the ids under commands.guilds, or pass them to @RegisterCommand('guild', [...]).`,
+	[1214]: (guildId) => `Discord refused the command deploy for guild ${paint.sky(guildId)}.\nCheck that the id is right, and that your bot is in that server.`,
+	[1301]: (commandName, existingCall, requestedCall) => `${paint.sky(commandName)} is registered twice, first with ${existingCall}, then with ${requestedCall}. Keep one.`,
+	[1302]: () => "RegisterCommand(\"global\") cannot have guilds specified.",
+	[1303]: () => "RegisterCommand(\"guild\") requires a non-empty guilds array.",
+	[1304]: () => "Middleware priority must be a finite number.",
+	[1305]: (className) => `${className} extends WebhookLog and needs a @WebhookUrl decorator naming its env var.`,
+	[1306]: (key) => `\`${key}\` was given an empty array. Drop the key to run the middleware on everything.`,
 	[1401]: (route, first, second) => `Two interaction handlers resolve to the same route \`${route}\`. Registered by ${first} and ${second}. Rename one.`,
-	[1402]: (name) => `Two different interaction middleware classes share the name \`${name}\`. Rename one so they do not collide.`,
+	[1402]: (name) => `Two different middleware classes share the name \`${name}\`. Rename one so they do not collide.`,
 	[1403]: (route, exportName, from) => `Route \`${route}\` loads \`${exportName}\` from ${from}, which exports no such name.`,
 	[1404]: (keys, exportName, from) => `Subscriber row for \`${keys}\` loads \`${exportName}\` from ${from}, which does not extend Subscriber.`,
 	[1405]: (route, from) => `Route \`${route}\` failed to import ${from}.`,
@@ -2244,13 +2268,15 @@ const messages = {
 	[1505]: (method, routeId) => `The interaction callback for ${paint.sky(`${method}()`)} returned no message. (route ${paint.mute(routeId)})`,
 	[1601]: (prefix) => `customId prefix ${JSON.stringify(prefix)} must be a non-empty string without a colon or control character.`,
 	[1602]: (field) => `customId field name ${JSON.stringify(field)} is integer-like, which JS reorders. Use a non-numeric name.`,
-	[1603]: (field) => `customId field ${JSON.stringify(field)} uses oneOf() with no choices.`,
+	[1603]: (field, method) => `customId field ${JSON.stringify(field)} uses ${method}() with no choices. Make the field nullable or provide at least one choice.`,
 	[1604]: (field, min, max) => `customId field ${JSON.stringify(field)} has min ${min} greater than max ${max}.`,
-	[1605]: (field, value) => `customId field ${JSON.stringify(field)} got value ${value} outside its allowed range.`,
+	[1605]: (field, expected, value) => `customId field ${JSON.stringify(field)} expects ${expected}, got ${value}.`,
 	[1606]: (length) => `Encoded customId is ${length} characters, Discord allows at most 100.`,
 	[1607]: (field) => `customId field ${JSON.stringify(field)} is already defined in this chain.`,
-	[1608]: (className) => `${className} is missing its route decorator (@ButtonRoute, @ModalRoute, or @SelectMenuRoute).`,
+	[1608]: (className) => `${className} is missing its route decorator. Add the one that matches its base, for example @ButtonRoute or @UserMenuRoute.`,
 	[1609]: (prefix) => `match() has no arm for the decoded route ${JSON.stringify(prefix)}.`,
+	[1620]: (prefix) => `customId ${JSON.stringify(prefix)} was minted under an older shape of this definition. Adding, removing, changing, or moving a field changes the layout hash.`,
+	[1621]: (detail) => `customId could not be decoded. ${detail}.`,
 	[1610]: (route) => `match() has no arm for the command route ${JSON.stringify(route)}.`,
 	[1611]: (field) => `match() has no arm for the focused field ${JSON.stringify(field)}.`,
 	[1612]: (event) => `match() has no arm for the event ${JSON.stringify(event)}.`,
@@ -2261,6 +2287,7 @@ const messages = {
 	[1617]: (customId, kind, getter) => getter ? `Modal field ${JSON.stringify(customId)} holds ${kind}. Read it with ${getter}().` : `Modal field ${JSON.stringify(customId)} holds ${kind}. No getter reads that kind.`,
 	[1618]: (customId) => `Modal field ${JSON.stringify(customId)} carries no selection. Build the component as required, or read it without the required argument.`,
 	[1619]: (customId, picked, allowed) => `Modal field ${JSON.stringify(customId)} picked a ${picked} channel. This read allows ${allowed}.`,
+	[1622]: (key) => `Nothing set \`${key}\` on this dispatch. Check that the middleware writing it is registered and that its filter covers this dispatch.`,
 	[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}.`,
@@ -2348,8 +2375,8 @@ function resolveMessage(code, args) {
 function formatErrorName(name, _identifier, code) {
 	return `${paint.coral.bold(name)}[${paint.mute(code)}]`;
 }
-const kIdentifier = Symbol.for("seedcord.errors.identifier");
-const CODED = Symbol.for("seedcord.errors.coded");
+const kIdentifier = Symbol.for("seedcord:errors:identifier");
+const CODED = Symbol.for("seedcord:errors:coded");
 function brand(prototype) {
 	Object.defineProperty(prototype, CODED, { value: true });
 }
@@ -2438,7 +2465,7 @@ function isSeedcordError(error, type, code) {
 
 //#endregion
 //#region src/cli/banner.ts
-function banner(version = "0.2.0") {
+function banner(version = "0.3.0") {
 	const wordmark = `${paint.flesh.bold("seed")}${paint.rind.bold("cord")}${paint.mute(" create")}`;
 	if (version === void 0) return wordmark;
 	return `${wordmark}${paint.pith(` • v${version}`)}`;