create-seedcord 0.1.2 → 0.2.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-BLQ8_el7.mjs
+//#region ../../packages/errors/dist/SeedcordError-DnV6q4mB.mjs
 /**
 * All Seedcord error codes.
 */
@@ -1939,6 +1939,12 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["ConfigMissingEnv"] = 1005] = "ConfigMissingEnv";
 	/** An environment variable is present and fails validation. */
 	SeedcordErrorCode[SeedcordErrorCode["ConfigInvalidEnv"] = 1006] = "ConfigInvalidEnv";
+	/** A command usable in a guild is registered without the `Guilds` intent that caches guilds. */
+	SeedcordErrorCode[SeedcordErrorCode["MissingGuildsIntent"] = 1007] = "MissingGuildsIntent";
+	/** The running Node version is below the range seedcord declares in `engines`. */
+	SeedcordErrorCode[SeedcordErrorCode["UnsupportedNodeVersion"] = 1008] = "UnsupportedNodeVersion";
+	/** `DISCORD_BOT_TOKEN` passed its shape check and carries no readable application id. */
+	SeedcordErrorCode[SeedcordErrorCode["ConfigTokenUnreadable"] = 1009] = "ConfigTokenUnreadable";
 	/** Attempted to add lifecycle tasks after startup already completed. */
 	SeedcordErrorCode[SeedcordErrorCode["LifecycleAddAfterCompletion"] = 1101] = "LifecycleAddAfterCompletion";
 	/** Attempted to add lifecycle tasks while startup is still running. */
@@ -1969,10 +1975,14 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["CoreDirectoryUnreadable"] = 1207] = "CoreDirectoryUnreadable";
 	/** A plugin was attached under a key the framework logs on. */
 	SeedcordErrorCode[SeedcordErrorCode["CorePluginReservedChannel"] = 1208] = "CorePluginReservedChannel";
-	/** A command deploy ran before the client resolved its application. */
+	/** The application id was read before startup resolved it. */
 	SeedcordErrorCode[SeedcordErrorCode["CoreApplicationUnavailable"] = 1209] = "CoreApplicationUnavailable";
 	/** A generated accessor was read before startup resolved its values. */
 	SeedcordErrorCode[SeedcordErrorCode["CoreAccessorUnresolved"] = 1210] = "CoreAccessorUnresolved";
+	/** A startup or shutdown task was added to a core built by `createSeedcord`. */
+	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 attempted to re-register an existing command scope. */
@@ -2033,6 +2043,16 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["EventMiddlewareNameUnavailable"] = 1613] = "EventMiddlewareNameUnavailable";
 	/** An autocomplete payload carried no focused option. */
 	SeedcordErrorCode[SeedcordErrorCode["AutocompleteNoFocusedOption"] = 1614] = "AutocompleteNoFocusedOption";
+	/** A context menu handler's match() has no arm for the command name that fired. */
+	SeedcordErrorCode[SeedcordErrorCode["ContextMenuMatchArmMissing"] = 1615] = "ContextMenuMatchArmMissing";
+	/** No field in the submitted modal carries the requested custom id. */
+	SeedcordErrorCode[SeedcordErrorCode["ModalFieldNotFound"] = 1616] = "ModalFieldNotFound";
+	/** A modal field getter was called on a field of another kind. */
+	SeedcordErrorCode[SeedcordErrorCode["ModalFieldWrongKind"] = 1617] = "ModalFieldWrongKind";
+	/** Nothing was picked in a modal field read as required. */
+	SeedcordErrorCode[SeedcordErrorCode["ModalFieldEmpty"] = 1618] = "ModalFieldEmpty";
+	/** A channel select field picked a channel outside the types getSelectedChannels() allows. */
+	SeedcordErrorCode[SeedcordErrorCode["ModalFieldChannelType"] = 1619] = "ModalFieldChannelType";
 	/** 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. */
@@ -2051,6 +2071,8 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["PluginOptionsRejected"] = 2001] = "PluginOptionsRejected";
 	/** Two or more plugins threw while disposing. */
 	SeedcordErrorCode[SeedcordErrorCode["PluginDisposeFailures"] = 2002] = "PluginDisposeFailures";
+	/** A plugin declared a lifecycle timeout that is not a positive, finite number of milliseconds. */
+	SeedcordErrorCode[SeedcordErrorCode["PluginInvalidLifecycleTimeout"] = 2003] = "PluginInvalidLifecycleTimeout";
 	/** Mongoose service class is missing the `@RegisterMongooseService` decorator. */
 	SeedcordErrorCode[SeedcordErrorCode["PluginMongooseServiceDecoratorMissing"] = 2101] = "PluginMongooseServiceDecoratorMissing";
 	/** Mongoose client failed to establish a connection. */
@@ -2139,6 +2161,8 @@ let SeedcordErrorCode = /* @__PURE__ */ function(SeedcordErrorCode) {
 	SeedcordErrorCode[SeedcordErrorCode["CliTunnelUnreachable"] = 3125] = "CliTunnelUnreachable";
 	/** A config field is present with the wrong shape. */
 	SeedcordErrorCode[SeedcordErrorCode["CliConfigInvalidField"] = 3126] = "CliConfigInvalidField";
+	/** A class carrying `@RegisterCommand` threw while codegen constructed it. */
+	SeedcordErrorCode[SeedcordErrorCode["CliCodegenCommandConstructorThrew"] = 3127] = "CliCodegenCommandConstructorThrew";
 	/** A create prompt was cancelled (Ctrl-C), and nothing has been written yet. */
 	SeedcordErrorCode[SeedcordErrorCode["CreateCancelled"] = 3201] = "CreateCancelled";
 	/** A flag supplied an answer for a question the earlier answers skip. */
@@ -2180,6 +2204,9 @@ const messages = {
 	[1002]: (envKey) => `${envKey} is not a well-formed Discord webhook url.`,
 	[1003]: (envKey) => `The webhook behind ${envKey} does not exist on Discord.`,
 	[1001]: (count, failures) => `Could not resolve ${count} configured emoji${count === 1 ? "" : "s"} at startup.\n${failures}`,
+	[1009]: () => "DISCORD_BOT_TOKEN carries no readable application id. Discord builds the first part of a bot token from that id, so a token failing here is truncated or mistyped. Copy it again from your application's Bot page.",
+	[1007]: (commands) => `Add GatewayIntentBits.Guilds to clientOptions.intents. Without it discord.js doesn't cache any guild, so interaction.guild is null inside these commands: ${commands}.`,
+	[1008]: (required, running) => `seedcord requires Node ${required} and this process runs ${running}. Upgrade Node before starting the bot.`,
 	[1101]: () => "Cannot add tasks after startup sequence has already completed.",
 	[1102]: () => "Cannot add tasks while startup sequence is in progress.",
 	[1103]: () => "Cannot remove tasks while startup sequence is in progress.",
@@ -2195,8 +2222,10 @@ const messages = {
 	[1206]: (file) => `${file} threw while importing.`,
 	[1207]: (dir) => `${dir} could not be read.`,
 	[1208]: (key) => `Plugin key "${key}" is a channel the framework logs on. Pick another key.`,
-	[1209]: () => "The bot's application id could not be resolved.",
+	[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.",
@@ -2225,8 +2254,13 @@ const messages = {
 	[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)}.`,
+	[1615]: (name) => `match() has no arm for the context menu command ${JSON.stringify(name)}.`,
 	[1613]: () => `this.eventName is only available on middleware the controller constructed with a fired event name.`,
 	[1614]: () => `Autocomplete payload has no focused option.`,
+	[1616]: (customId) => `The submitted modal carries no field with the custom id ${JSON.stringify(customId)}. Check it against the id you gave the component when you built the modal.`,
+	[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}.`,
 	[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}.`,
@@ -2236,6 +2270,7 @@ const messages = {
 	[1902]: () => "Color must be within the range 0 to 16777215 (0xffffff).",
 	[2001]: (pluginName, reason) => `${pluginName} rejected its options, ${reason.replace(/\.$/, "")}.`,
 	[2002]: (count) => `${count} plugins failed to dispose.`,
+	[2003]: (pluginName, field, declared) => `${pluginName} declared lifecycle ${field}.timeout as ${declared}. Pass a positive number of milliseconds, or omit it for the default.`,
 	[2101]: (className) => `Missing @RegisterMongooseService on ${className}.`,
 	[2102]: (databaseName) => databaseName ? `Could not connect to MongoDB (${databaseName}).` : "Could not connect to MongoDB.",
 	[2103]: () => "Failed to disconnect from MongoDB cleanly during shutdown.",
@@ -2269,6 +2304,7 @@ const messages = {
 	[3113]: (targetPath, reason) => `Failed to write bootstrap file at ${targetPath}: ${reason}`,
 	[3114]: (route, firstFile, secondFile) => `Two commands resolve to the same slash route \`${route}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,
 	[3115]: (dir, reason) => `Could not read the commands directory ${dir} during codegen. ${reason}`,
+	[3127]: (name, file, reason) => `${name} threw while codegen constructed it. Fix its constructor in ${file}. ${reason}`,
 	[3116]: (kind, name, firstFile, secondFile) => `Two ${kind} context-menu commands share the name \`${name}\`. Defined in ${firstFile} and ${secondFile}. Rename one.`,
 	[3117]: (reason) => `Could not resolve the application from the bot token. ${reason}`,
 	[3118]: () => "No guilds given. Pass --guild <ids...> or --all-guilds. Global commands are never touched.",
@@ -2402,7 +2438,7 @@ function isSeedcordError(error, type, code) {
 
 //#endregion
 //#region src/cli/banner.ts
-function banner(version = "0.1.2") {
+function banner(version = "0.2.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}`)}`;
@@ -2414,10 +2450,10 @@ const ENV_NAME = "DISCORD_BOT_TOKEN";
 /** @internal */
 function validateDiscordToken(raw) {
 	if (raw === null || raw === void 0) throw new SeedcordError(1005, [ENV_NAME]);
-	if (typeof raw !== "string") throw new SeedcordError(1006, [ENV_NAME]);
+	if (typeof raw !== "string") throw new SeedcordTypeError(1006, [ENV_NAME]);
 	const value = raw.trim();
 	if (value === "") throw new SeedcordError(1005, [ENV_NAME]);
-	if (!/^[A-Za-z\d_-]{24,}\.[A-Za-z\d_-]{6,}\.[A-Za-z\d_-]{27,}$/.test(value)) throw new SeedcordError(1006, [ENV_NAME]);
+	if (!/^[A-Za-z\d_-]{24,}\.[A-Za-z\d_-]{6,}\.[A-Za-z\d_-]{27,}$/.test(value)) throw new SeedcordTypeError(1006, [ENV_NAME]);
 	return value;
 }
 
@@ -11058,6 +11094,7 @@ const DEV_PACKAGES = [
 	"@seedcord/eslint-config",
 	"@seedcord/tsconfig",
 	"@types/node",
+	"jiti",
 	"prettier",
 	"seedcord",
 	"typescript@~6.0"