@seedcord/core 0.1.3 → 0.2.0-next.0

package/README.md

@@ -1,12 +1,42 @@
-<p align="center">
+<div align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://cdn.seedcord.org/assets/wordmark-dark.webp" />
     <img src="https://cdn.seedcord.org/assets/wordmark-light.webp" alt="seedcord" width="440" />
   </picture>
-</p>
+</div>
 
-# @seedcord/core
+<div align="center">
+  <h3>The whole Discord bot, wired and typed</h3>
+  <a href="https://seedcord.org">Website</a> ·
+  <a href="https://guide.seedcord.org">Guide</a> ·
+  <a href="https://docs.seedcord.org">Reference</a> ·
+  <a href="https://discord.gg/DzFxY58WXf">Discord</a>
+</div>
 
-Transport-agnostic core for Seedcord bots
+<br />
 
-Part of the [seedcord](https://github.com/seedcord/seedcord) framework. Until a major v1.0.0 release, expect breaking changes in minor versions.
+<div align="center">
+
+[![npm](https://img.shields.io/npm/v/@seedcord/core?style=flat-square&logo=npm&logoColor=c8341f&label=&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/@seedcord/core) [![node](https://img.shields.io/node/v/@seedcord/core?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![license](https://img.shields.io/npm/l/@seedcord/core?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)
+
+</div>
+
+## About
+
+`@seedcord/core` is the foundational code both seedcord transports share. Command and context-menu injection, the interaction route decorators, the handler bases, gates, the startup and shutdown phases, and the plugin base all live here.
+
+Nothing in it opens a connection to Discord. `@seedcord/gateway` and `@seedcord/http` each bind their own transport into these pieces.
+
+Until v1.0.0, minor versions can break.
+
+## Installation
+
+Your transport already re-exports all of this.
+
+Install it directly when you are writing a plugin against the framework:
+
+```sh
+pnpm add @seedcord/core
+```
+
+`@seedcord/core/plugin` holds the base a plugin extends.

package/dist/{subscribers-nEpbJj3Z.mjs → Bus-DcuUtOEL.mjs}

@@ -1,15 +1,313 @@
-import { h as WebhookUrlMetadataKey, i as BuilderComponent, m as SubscribeMetadataKey, r as sendFlags, t as PublishDefault } from "./publishDefault-BCrMG9T8.mjs";
 import "reflect-metadata";
-import { Logger, paint } from "@seedcord/logger";
-import { Routes, SeparatorSpacingSize } from "discord-api-types/v10";
-import { SeedcordErrorCode } from "@seedcord/errors";
-import { SeedcordError } from "@seedcord/errors/internal";
+import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "@discordjs/builders";
+import { SeedcordErrorCode, paint } from "@seedcord/errors";
+import { Logger } from "@seedcord/logger";
+import { ApplicationCommandType, InteractionContextType, MessageFlags, Routes, SeparatorSpacingSize } from "discord-api-types/v10";
+import { SeedcordError, SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
 import { filterCirculars, stripAnsi, timestampFromSnowflake } from "@seedcord/utils";
 import { TypedEventEmitter } from "@seedcord/event-emitter";
-import chalk from "chalk";
 import { Converters, Envapter } from "envapt";
 import { DiscordAPIError, REST } from "@discordjs/rest";
 
+//#region src/commands/contextMenuLeaves.ts
+/**
+* dedupes names across builders, since the same builder repeats once per guild.
+* a user and a message command can share a name.
+*
+* @internal
+*/
+function contextMenuLeaves(commands) {
+	const user = /* @__PURE__ */ new Set();
+	const message = /* @__PURE__ */ new Set();
+	for (const command of commands) {
+		if (!(command instanceof ContextMenuCommandBuilder)) continue;
+		if (command.type === ApplicationCommandType.User) user.add(command.name);
+		else message.add(command.name);
+	}
+	return {
+		user,
+		message
+	};
+}
+
+//#endregion
+//#region src/metadataKeys.ts
+let InteractionRoutes = /* @__PURE__ */ function(InteractionRoutes) {
+	InteractionRoutes["Slash"] = "slash";
+	InteractionRoutes["Button"] = "button";
+	InteractionRoutes["Modal"] = "modal";
+	InteractionRoutes["StringMenu"] = "stringMenu";
+	InteractionRoutes["UserMenu"] = "userMenu";
+	InteractionRoutes["RoleMenu"] = "roleMenu";
+	InteractionRoutes["ChannelMenu"] = "channelMenu";
+	InteractionRoutes["MentionableMenu"] = "mentionableMenu";
+	InteractionRoutes["MessageContextMenu"] = "messageContextMenu";
+	InteractionRoutes["UserContextMenu"] = "userContextMenu";
+	InteractionRoutes["Autocomplete"] = "autocomplete";
+	return InteractionRoutes;
+}({});
+const InteractionMetadataKey = Symbol("seedcord:interaction:metadata");
+const InteractionRouteKeys = {
+	["slash"]: Symbol("seedcord:interaction:slash"),
+	["button"]: Symbol("seedcord:interaction:button"),
+	["modal"]: Symbol("seedcord:interaction:modal"),
+	["stringMenu"]: Symbol("seedcord:interaction:stringMenu"),
+	["userMenu"]: Symbol("seedcord:interaction:userMenu"),
+	["roleMenu"]: Symbol("seedcord:interaction:roleMenu"),
+	["channelMenu"]: Symbol("seedcord:interaction:channelMenu"),
+	["mentionableMenu"]: Symbol("seedcord:interaction:mentionableMenu"),
+	["messageContextMenu"]: Symbol("seedcord:interaction:messageContextMenu"),
+	["userContextMenu"]: Symbol("seedcord:interaction:userContextMenu"),
+	["autocomplete"]: Symbol("seedcord:interaction:autocomplete")
+};
+const MiddlewareMetadataKey = Symbol("seedcord:middleware:metadata");
+const EventMetadataKey = Symbol("seedcord:event:metadata");
+const CommandMetadataKey = Symbol("seedcord:command:metadata");
+const GatedMetadataKey = Symbol("seedcord:gated:metadata");
+const SubscribeMetadataKey = Symbol("seedcord:subscribe:metadata");
+const WebhookUrlMetadataKey = Symbol("seedcord:webhookUrl:metadata");
+
+//#endregion
+//#region src/components/botColorHolder.ts
+const DEFAULT_COLOR = "Default";
+let current = DEFAULT_COLOR;
+function setBotColor(color) {
+	current = color ?? DEFAULT_COLOR;
+}
+function getBotColor() {
+	return current;
+}
+
+//#endregion
+//#region src/components/builderTypes.ts
+/**
+* Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.
+*
+* @internal
+*/
+const BuilderTypes = {
+	command: SlashCommandBuilder,
+	context_menu: ContextMenuCommandBuilder,
+	subcommand: SlashCommandSubcommandBuilder,
+	group: SlashCommandSubcommandGroupBuilder,
+	embed: EmbedBuilder,
+	modal: ModalBuilder,
+	label: LabelBuilder,
+	text_input: TextInputBuilder,
+	file_upload: FileUploadBuilder,
+	checkbox: CheckboxBuilder,
+	checkbox_group: CheckboxGroupBuilder,
+	checkbox_group_option: CheckboxGroupOptionBuilder,
+	radio_group: RadioGroupBuilder,
+	radio_group_option: RadioGroupOptionBuilder,
+	button: ButtonBuilder,
+	menu_string: StringSelectMenuBuilder,
+	menu_option_string: StringSelectMenuOptionBuilder,
+	menu_user: UserSelectMenuBuilder,
+	menu_channel: ChannelSelectMenuBuilder,
+	menu_mentionable: MentionableSelectMenuBuilder,
+	menu_role: RoleSelectMenuBuilder,
+	container: ContainerBuilder,
+	text_display: TextDisplayBuilder,
+	file: FileBuilder,
+	media: MediaGalleryBuilder,
+	section: SectionBuilder,
+	separator: SeparatorBuilder
+};
+/**
+* Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons
+*
+* @internal
+*/
+const RowTypes = {
+	button: ActionRowBuilder,
+	menu_string: ActionRowBuilder,
+	menu_user: ActionRowBuilder,
+	menu_channel: ActionRowBuilder,
+	menu_mentionable: ActionRowBuilder,
+	menu_role: ActionRowBuilder
+};
+
+//#endregion
+//#region src/components/colors.ts
+const Colors = {
+	Aqua: 1752220,
+	Blue: 3447003,
+	Blurple: 5793266,
+	DarkAqua: 1146986,
+	DarkBlue: 2123412,
+	DarkButNotBlack: 2895667,
+	DarkerGrey: 8359053,
+	DarkGold: 12745742,
+	DarkGreen: 2067276,
+	DarkGrey: 9936031,
+	DarkNavy: 2899536,
+	DarkOrange: 11027200,
+	DarkPurple: 7419530,
+	DarkRed: 10038562,
+	DarkVividPink: 11342935,
+	Default: 0,
+	Fuchsia: 15418782,
+	Gold: 15844367,
+	Green: 5763719,
+	Grey: 9807270,
+	Greyple: 10070709,
+	LightGrey: 12370112,
+	LuminousVividPink: 15277667,
+	Navy: 3426654,
+	NotQuiteBlack: 2303786,
+	Orange: 15105570,
+	Purple: 10181046,
+	Red: 15548997,
+	White: 16777215,
+	Yellow: 16705372
+};
+
+//#endregion
+//#region src/components/resolveColor.ts
+const MAX_COLOR = 16777215;
+const RED_SHIFT = 16;
+const GREEN_SHIFT = 8;
+const palette = Colors;
+/**
+* Resolves a {@link BotColor} to the integer Discord expects.
+*
+* Ported from discord.js (Apache-2.0), `resolveColor` in src/util/Util.js.
+*/
+function resolveColor(color) {
+	let resolved;
+	if (typeof color === "string") {
+		if (color === "Random") return Math.floor(Math.random() * 16777216);
+		if (color === "Default") return 0;
+		if (/^#?[\da-f]{6}$/i.test(color)) return Number.parseInt(color.replace("#", ""), 16);
+		resolved = palette[color];
+	} else if (typeof color === "number") resolved = color;
+	else resolved = (color[0] << RED_SHIFT) + (color[1] << GREEN_SHIFT) + color[2];
+	if (resolved === void 0 || !Number.isSafeInteger(resolved)) throw new SeedcordTypeError(SeedcordErrorCode.ColorUnresolvable, [JSON.stringify(color)]);
+	if (resolved < 0 || resolved > MAX_COLOR) throw new SeedcordRangeError(SeedcordErrorCode.ColorOutOfRange);
+	return resolved;
+}
+
+//#endregion
+//#region src/components/Component.ts
+/** @internal */
+var BaseComponent = class {
+	_component;
+	constructor(ComponentClass) {
+		this._component = new ComponentClass();
+	}
+	/**
+	* The wrapped builder, for calling Discord.js methods like setTitle() and setDescription() inside a subclass.
+	*
+	* @example this.instance.setTitle('My Modal')
+	*/
+	get instance() {
+		return this._component;
+	}
+};
+/**
+* Base class for Discord.js builder components
+*
+* Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with
+* Seedcord-specific defaults and helper methods.
+*
+* @typeParam BuilderKey - The type of Discord.js builder being wrapped
+*/
+var BuilderComponent = class extends BaseComponent {
+	type;
+	colorApplied = false;
+	constructor(type) {
+		const ComponentClass = BuilderTypes[type];
+		super(ComponentClass);
+		this.type = type;
+		if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) this.instance.setContexts(InteractionContextType.Guild);
+	}
+	get component() {
+		this.applyBotColor();
+		return this.instance;
+	}
+	applyBotColor() {
+		if (this.colorApplied) return;
+		this.colorApplied = true;
+		const color = getBotColor();
+		if (this.instance instanceof EmbedBuilder) {
+			if (this.instance.data.color === void 0) this.instance.setColor(resolveColor(color));
+		} else if (this.instance instanceof ContainerBuilder) {
+			const accent = this.instance.data.accent_color;
+			if (accent === null || accent === void 0) this.instance.setAccentColor(color === "Default" ? void 0 : resolveColor(color));
+		}
+	}
+};
+/**
+* Base class for Discord action row components
+*
+* Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.
+*
+* @typeParam RowKey - The Discord.js action row type being wrapped
+*/
+var RowComponent = class extends BaseComponent {
+	type;
+	constructor(type) {
+		const ComponentClass = RowTypes[type];
+		super(ComponentClass);
+		this.type = type;
+	}
+	get component() {
+		return this.instance;
+	}
+};
+
+//#endregion
+//#region src/reply/flags.ts
+function sendFlags(opts) {
+	let flags = MessageFlags.IsComponentsV2;
+	if (opts?.ephemeral ?? true) flags |= MessageFlags.Ephemeral;
+	if (opts?.silent) flags |= MessageFlags.SuppressNotifications;
+	return flags;
+}
+function deferFlags(opts) {
+	return opts?.ephemeral ?? true ? MessageFlags.Ephemeral : 0;
+}
+
+//#endregion
+//#region src/subscribers/ReportThrottle.ts
+var ReportThrottle = class ReportThrottle {
+	windowMs;
+	now;
+	static perCore = /* @__PURE__ */ new WeakMap();
+	static for(core) {
+		let throttle = ReportThrottle.perCore.get(core);
+		if (!throttle) {
+			throttle = new ReportThrottle();
+			ReportThrottle.perCore.set(core, throttle);
+		}
+		return throttle;
+	}
+	windows = /* @__PURE__ */ new Map();
+	constructor(windowMs = 6e4, now = () => Date.now()) {
+		this.windowMs = windowMs;
+		this.now = now;
+	}
+	take(key) {
+		const window = this.windows.get(key);
+		if (window && this.now() - window.lastSentAt < this.windowMs) {
+			window.suppressedSinceSend += 1;
+			return null;
+		}
+		const suppressed = window?.suppressedSinceSend ?? 0;
+		this.windows.set(key, {
+			lastSentAt: this.now(),
+			suppressedSinceSend: 0
+		});
+		return suppressed;
+	}
+	restore(key, suppressed) {
+		const window = this.windows.get(key);
+		if (window) window.suppressedSinceSend += suppressed + 1;
+	}
+};
+
+//#endregion
 //#region src/subscribers/Subscriber.ts
 /**
 * Abstract base class for handling application subscribers.
@@ -51,17 +349,43 @@ function jsonAttachment(name, description, data) {
 		data: new TextEncoder().encode(JSON.stringify(content, void 0, 2))
 	};
 }
-function neutralizeFences(text) {
+function breakBackticks(text) {
 	return text.replaceAll("```", "`​`​`");
 }
-function errorReport(error) {
-	let report = error.stack ?? `${error.name}: ${error.message}`;
-	if (Error.isError(error.cause)) {
-		const cause = error.cause.stack ?? `${error.cause.name}: ${error.cause.message}`;
-		report += `\n\nCaused by:\n${cause}`;
+const REPORT_BUDGET = 1800;
+function body(value) {
+	const raw = Error.isError(value) ? value.stack ?? `${value.name}: ${value.message}` : String(value);
+	return breakBackticks(stripAnsi(raw));
+}
+function clamp(text, budget) {
+	if (text.length <= budget) return text;
+	return budget > 0 ? `${text.slice(0, budget - 1)}…` : "";
+}
+function omittedLine(count) {
+	return `\n\nand ${count} more failure${count === 1 ? "" : "s"}`;
+}
+function memberReport(members, budget) {
+	const room = Math.max(budget - omittedLine(members.length).length, 0);
+	const share = Math.floor(room / members.length);
+	let report = "";
+	let shown = 0;
+	for (const [index, member] of members.entries()) {
+		const heading = `\n\nFailure ${index + 1} of ${members.length}:\n`;
+		const entry = heading + clamp(body(member), Math.max(share - heading.length, 0));
+		if (report.length + entry.length > room) break;
+		report += entry;
+		shown++;
 	}
-	const stripped = neutralizeFences(stripAnsi(report));
-	return stripped.length > 1800 ? `${stripped.slice(0, 1799)}…` : stripped;
+	const hidden = members.length - shown;
+	return hidden > 0 ? report + omittedLine(hidden) : report;
+}
+function errorReport(error) {
+	let head = body(error);
+	if (Error.isError(error.cause)) head += `\n\nCaused by:\n${body(error.cause)}`;
+	const members = error instanceof AggregateError ? error.errors : [];
+	if (members.length === 0) return clamp(head, REPORT_BUDGET);
+	const report = clamp(head, REPORT_BUDGET - omittedLine(members.length).length);
+	return report + memberReport(members, REPORT_BUDGET - report.length);
 }
 var WebhookSeparator = class extends BuilderComponent {
 	constructor() {
@@ -91,7 +415,7 @@ var WebhookSender = class {
 		}
 	}
 	async send(options) {
-		const { flags, username, components, files } = options;
+		const { flags, username, avatarUrl, components, files } = options;
 		await this.rest.post(this.route, {
 			auth: false,
 			query: new URLSearchParams({
@@ -101,6 +425,7 @@ var WebhookSender = class {
 			body: {
 				flags,
 				username,
+				...avatarUrl && { avatar_url: avatarUrl },
 				components: components.map((component) => component.toJSON()),
 				...files?.length && { attachments: files.map((file, id) => ({
 					id,
@@ -130,22 +455,37 @@ var WebhookSender = class {
 */
 var WebhookLog = class WebhookLog extends Subscriber {
 	static senders = /* @__PURE__ */ new Map();
+	/**
+	* Events sharing this key collapse into one card per minute. Return `null` to send every event.
+	*/
+	throttleKey() {
+		return null;
+	}
 	async execute() {
 		const url = WebhookLog.urlOf(WebhookLog.envKeyOf(this.constructor));
 		if (url === null) {
-			this.logger.warn(`${chalk.bold(this.constructor.name)} has no webhook url set, this reporter is disabled`);
+			this.logger.warn(`${paint.sky.bold(this.constructor.name)} has no webhook url set, this reporter is disabled`);
+			return;
+		}
+		const key = this.throttleKey();
+		const throttle = ReportThrottle.for(this.core);
+		const suppressed = key === null ? 0 : throttle.take(key);
+		if (suppressed === null) {
+			this.logger.debug(`counted a repeat into the next ${paint.sky.bold(this.constructor.name)} card`);
 			return;
 		}
-		const { username, components, files } = await this.report();
 		try {
+			const { username, avatarUrl, components, files } = await this.report(suppressed);
 			await WebhookLog.senderFor(url).send({
 				flags: sendFlags({ ephemeral: false }),
 				username: username ?? this.constructor.name,
+				avatarUrl,
 				components,
 				files
 			});
 		} catch (error) {
-			this.logger.error("Failed to send webhook report", error);
+			if (key !== null) throttle.restore(key, suppressed);
+			this.logger.error("Webhook report failed", error);
 		}
 	}
 	/** @internal */
@@ -249,20 +589,28 @@ function __decorate(decorators, target, key, desc) {
 //#endregion
 //#region src/subscribers/default/HandledException.ts
 let HandledException = class HandledException extends WebhookLog {
-	report() {
+	throttleKey() {
+		return `handledException:${this.data.routeId}:${this.data.denial.name}`;
+	}
+	report(suppressed) {
 		return {
 			username: "Handled Exception",
-			components: [new HandledExceptionContainer(this.data).component],
+			components: [new HandledExceptionContainer(this.data, suppressed).component],
 			files: [jsonAttachment("source.json", "The raw source the fault came from", this.data.source.raw)]
 		};
 	}
 };
 HandledException = __decorate([Subscribe("handledException"), WebhookUrl("HANDLED_EXCEPTION_WEBHOOK_URL")], HandledException);
 var HandledExceptionContainer = class extends BuilderComponent {
-	constructor(data) {
+	constructor(data, suppressed) {
 		super("container");
 		const { denial, uuid, source } = data;
-		this.instance.addTextDisplayComponents((text) => text.setContent(faultSummary(denial, source))).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent(`### UUID \`${uuid}\`\n\`\`\`${neutralizeFences(causeStack(denial))}\`\`\``)).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent("### Source")).addFileComponents((file) => file.setURL("attachment://source.json"));
+		this.instance.addTextDisplayComponents((text) => text.setContent(faultSummary(denial, source))).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent(`### UUID \`${uuid}\`\n\`\`\`${breakBackticks(causeStack(denial))}\`\`\``)).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent("### Source")).addFileComponents((file) => file.setURL("attachment://source.json"));
+		this.addSuppressedCount(suppressed);
+	}
+	addSuppressedCount(suppressed) {
+		if (suppressed === 0) return;
+		this.instance.addTextDisplayComponents((text) => text.setContent(`-# ${suppressed} more of these since the last report`));
 	}
 };
 function faultSummary(denial, source) {
@@ -286,23 +634,34 @@ function causeStack(denial) {
 //#endregion
 //#region src/subscribers/default/UnknownException.ts
 let UnknownException = class UnknownException extends WebhookLog {
-	report() {
+	throttleKey() {
+		return `unknownException:${this.data.routeId}:${nameOf(this.data.error)}`;
+	}
+	report(suppressed) {
 		const { metadata } = this.data;
 		return {
 			username: "Unknown Exception",
-			components: [new UnhandledErrorContainer(this.data).component],
+			components: [new UnhandledErrorContainer(this.data, suppressed).component],
 			files: metadata ? [jsonAttachment("metadata.json", "Metadata associated with the error", metadata)] : void 0
 		};
 	}
 };
 UnknownException = __decorate([Subscribe("unknownException"), WebhookUrl("UNKNOWN_EXCEPTION_WEBHOOK_URL")], UnknownException);
+function nameOf(error) {
+	return error.name === "Error" ? error.constructor.name : error.name;
+}
 var UnhandledErrorContainer = class extends BuilderComponent {
-	constructor(data) {
+	constructor(data, suppressed) {
 		super("container");
 		const { uuid, error, guild, user, metadata } = data;
 		this.instance.addTextDisplayComponents((text) => text.setContent(`### An unknown exception was thrown\n**Guild ID:** \`${guild?.id ?? "Not used in a guild"}\`\n**Guild Name:** ${guild?.name ?? "Not used in a guild"}\n**User ID:** \`${user?.id ?? "Missing user info"}\`\n**Username:** ${user?.username ?? "Missing user info"}\n`)).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent(`### UUID \`${uuid}\`\n\`\`\`${errorReport(error)}\`\`\``));
 		this.addTimestampsIfAvailable(error);
 		this.addMetadataIfAvailable(metadata);
+		this.addSuppressedCount(suppressed);
+	}
+	addSuppressedCount(suppressed) {
+		if (suppressed === 0) return;
+		this.instance.addTextDisplayComponents((text) => text.setContent(`-# ${suppressed} more of these since the last report`));
 	}
 	addTimestampsIfAvailable(error) {
 		if (!(error instanceof DiscordAPIError)) return;
@@ -321,16 +680,23 @@ var UnhandledErrorContainer = class extends BuilderComponent {
 	}
 };
 
+//#endregion
+//#region src/subscribers/publishDefault.ts
+/** @internal PublishableKey excludes this key so publish() never emits it externally. */
+const PublishDefault = Symbol("seedcord.publishDefault");
+
 //#endregion
 //#region src/subscribers/Bus.ts
+const loggerSlot = Symbol("seedcord:bus:logger");
 /**
 * Registers and dispatches subscribers. Subscribers run on a programmatic or framework publish.
 * Accessed via `core.bus`. Do not construct it directly.
 */
 var Bus = class extends TypedEventEmitter {
 	core;
-	/** @internal */
 	logger = new Logger("Subscribers", { channel: "subscribers" });
+	/** @internal */
+	[loggerSlot] = this.logger;
 	subscribersMap = /* @__PURE__ */ new Map();
 	executedOnce = /* @__PURE__ */ new Set();
 	webhookProbes = /* @__PURE__ */ new Map();
@@ -374,7 +740,7 @@ var Bus = class extends TypedEventEmitter {
 		await Promise.all([...this.webhookProbes].map(async ([url, envKeys]) => {
 			const result = await WebhookLog.senderFor(url).verify();
 			if (result === "missing") missing.push(...envKeys);
-			else if (result === "unreachable") this.logger.warn(`could not verify webhook at ${paint.sky.bold(envKeys.join(", "))}`);
+			else if (result === "unreachable") this.logger.warn(`could not verify webhook at ${envKeys.map((key) => paint.amber.bold(key)).join(", ")}`);
 		}));
 		if (missing.length > 0) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookNotFound, [missing.join(", ")]);
 	}
@@ -383,7 +749,7 @@ var Bus = class extends TypedEventEmitter {
 		const envKey = WebhookLog.envKeyOf(ctor);
 		const url = WebhookLog.urlOf(envKey);
 		if (url === null) {
-			this.logger.warn(`${chalk.bold(ctor.name)} disabled, ${paint.sky.bold(envKey)} is not set`);
+			this.logger.warn(`${paint.sky.bold(ctor.name)} disabled, ${paint.amber.bold(envKey)} is not set`);
 			return false;
 		}
 		const envKeys = this.webhookProbes.get(url) ?? [];
@@ -442,7 +808,7 @@ var Bus = class extends TypedEventEmitter {
 			name = Ctor.name;
 			await new Ctor(data, this.core).execute();
 		} catch (err) {
-			this.logger.error(`Error in subscriber ${String(subscriberName)} handler ${paint.sky.bold(name)}:`, err);
+			this.logger.error(`Error in subscriber ${paint.mute(String(subscriberName))} handler ${paint.sky.bold(name)}:`, err);
 		}
 	}
 };
@@ -456,7 +822,11 @@ function registrationFor(ctor) {
 		ctor
 	};
 }
+/** @internal */
+function busLoggerOf(bus) {
+	return bus[loggerSlot];
+}
 
 //#endregion
-export { WebhookLog as a, Subscribe as i, registrationFor as n, Subscriber as o, WebhookUrl as r, Bus as t };
-//# sourceMappingURL=subscribers-nEpbJj3Z.mjs.map
+export { WebhookUrlMetadataKey as C, SubscribeMetadataKey as S, GatedMetadataKey as _, WebhookUrl as a, InteractionRoutes as b, Subscriber as c, sendFlags as d, BuilderComponent as f, EventMetadataKey as g, CommandMetadataKey as h, PublishDefault as i, ReportThrottle as l, setBotColor as m, busLoggerOf as n, Subscribe as o, RowComponent as p, registrationFor as r, WebhookLog as s, Bus as t, deferFlags as u, InteractionMetadataKey as v, contextMenuLeaves as w, MiddlewareMetadataKey as x, InteractionRouteKeys as y };
+//# sourceMappingURL=Bus-DcuUtOEL.mjs.map