@seedcord/gateway 0.1.1 → 0.1.2

package/dist/index.cjs

@@ -284,12 +284,6 @@ const emojiStorage = (0, _seedcord_core_internal.accessorStore)();
 * A read before that throws.
 */
 const Emojis = (0, _seedcord_core_internal.guardedAccessor)("Emojis", emojiStorage);
-/**
-* Loads and injects emojis based on bot configuration. A guild emoji requires the Guilds intent in the client
-* options.
-*
-* @internal
-*/
 var EmojiInjector = class {
 	core;
 	logger = new _seedcord_logger.Logger("Emojis", { channel: "bot" });
@@ -453,12 +447,6 @@ function hasPermsToAssign(roleOrOptions) {
 //#endregion
 //#region src/bot/confirm/reserved.ts
 const RESERVED_CONFIRM_PREFIX = "__seedcord_confirm";
-/**
-* The reserved confirm/cancel codec. It has no route, so the dispatcher ignores its clicks and only the
-* in-process collector reads them. Do not mint a real component from it.
-*
-* @internal
-*/
 const CONFIRM_DEF = new _seedcord_core.CustomId(RESERVED_CONFIRM_PREFIX).oneOf("choice", ["confirm", "cancel"]);
 
 //#endregion
@@ -525,7 +513,6 @@ async function getConfirmation(handler, prompt, options) {
 * gate hook.
 */
 var BaseHandler = class extends _seedcord_core.BaseHandler {
-	/** @internal */
 	getEvent() {
 		return this.event;
 	}
@@ -567,10 +554,7 @@ function seedState(interaction) {
 	if (interaction.deferred) return "deferred-reply";
 	return "unacked";
 }
-/**
-* Writes interaction responses through the discord.js interaction. Construction is internal to the repliable
-* handler bases and the dispatcher.
-*/
+/** Writes interaction responses through discord.js. The repliable handler bases and the dispatcher construct it. */
 var ReplySender = class extends _seedcord_core_internal.BaseReplySender {
 	interaction;
 	constructor(interaction, routeId, bus) {
@@ -716,13 +700,6 @@ var InteractionHandler = class extends RepliableHandler {
 
 //#endregion
 //#region src/bot/utilities/miscellaneous/slashRouteOf.ts
-/**
-* Computes the dispatch route for a chat-input or autocomplete interaction. The controller and
-* `seedcord codegen` both assemble route keys through the same {@link buildSlashRoute}, so a dispatched
-* interaction and a generated registry key always match.
-*
-* @internal
-*/
 function slashRouteOf(interaction) {
 	const group = interaction.options.getSubcommandGroup(false) ?? void 0;
 	const subcommand = interaction.options.getSubcommand(false) ?? void 0;
@@ -874,8 +851,8 @@ var AutocompleteHandler = class extends BaseHandler {
 		return focused;
 	}
 	/**
-	* Run the arm for the focused field. An autocomplete always dispatches by which field is focused, so
-	* match is how you read it. There is no single-field shortcut the way slash/component handlers have one.
+	* Run the arm for the focused field. Because an autocomplete always dispatches by which field is
+	* focused, match is how you read it. There is no single-field shortcut the way slash/component handlers have one.
 	*
 	* Provide one arm per autocompletable field across the registered commands, keyed by field name. Each
 	* arm receives the focused partial value and a `respond` typed to that field's choice value. The
@@ -958,7 +935,7 @@ var ComponentHandler = class extends InteractionHandler {
 	* Reading this decodes `this.event.customId` once (cached after the first read) and throws
 	* `StaleCustomId` or `InvalidCustomId` when the wire no longer matches the current shape, which the
 	* controller boundary turns into a reply. On a handler registered for several routes this is
-	* `never`, so use {@link match} instead.
+	* `never`. Use {@link match} instead.
 	*/
 	get params() {
 		return this.route.params;
@@ -966,7 +943,7 @@ var ComponentHandler = class extends InteractionHandler {
 	/**
 	* Run the arm for whichever route the component was minted from. Use this only when the handler is
 	* registered for several routes. A single-route handler reads `this.params` directly. On a multi-route
-	* handler `this.params` is `never`, so match is the only way to read the decoded params.
+	* handler `this.params` is `never`, leaving match as the only way to read the decoded params.
 	*
 	* Provide one arm per registered route, keyed by its prefix, and each arm receives that route's own
 	* decoded params. The arms cover every registered route prefix, checked at compile time, and a prefix
@@ -1370,14 +1347,6 @@ function eventGateContext(eventName, args, core) {
 //#endregion
 //#region src/miscellaneous/extractErrorResponse.ts
 const logger$2 = new _seedcord_logger.Logger("ErrorsHandling", { channel: "errors" });
-/**
-* Processes an error into a user-facing reply and routes its report.
-*
-* A {@link Notice} always renders its own reply. A reporting denial (`report: true`) additionally
-* publishes `handledException` on the interaction path. A raw, non-denial throw publishes
-* `unknownException` and renders the configured `defaultError` (or a generic {@link Fault}). One uuid is
-* threaded into both the reply and the bus payload.
-*/
 function extractErrorResponse(error, core, origin) {
 	const uuid = node_crypto.randomUUID();
 	const developerUsername = core.config.notifications?.developerUsername;
@@ -1518,13 +1487,6 @@ function interactionKind(interaction) {
 //#endregion
 //#region src/bot/handleEventFault.ts
 const logger$1 = new _seedcord_logger.Logger("Faults", { channel: "errors" });
-/**
-* The event controller boundary. Reports a throw from an event handler and never replies, since a
-* generic event has no reply target. A {@link Silence} or a non-reporting {@link Notice} stops quietly, a
-* reporting denial or a raw error publishes a fault with a best-effort actor derived from the args.
-*
-* @internal
-*/
 function handleEventFault(caught, eventName, handlerName, args, core) {
 	if (caught instanceof _seedcord_core.Silence) {
 		if (caught.reason !== void 0 && (core.config.errors?.logSilences ?? true)) logger$1.debug(`Silence: ${caught.reason}`);
@@ -1553,9 +1515,7 @@ function handleEventFault(caught, eventName, handlerName, args, core) {
 //#endregion
 //#region src/bot/controllers/EventDispatcher.ts
 /**
-* Scans event handler directories, attaches one client listener per registered event, and runs the
-* handlers for each fire. Interactions route through InteractionDispatcher. Multiple handlers can
-* point to one event.
+* Interactions route through InteractionDispatcher.
 *
 * @internal
 */
@@ -1643,7 +1603,7 @@ var EventDispatcher = class {
 			}
 		});
 	}
-	/** @internal For use in dev mode */
+	/** @internal */
 	async onHmr(event) {
 		await this.hmrHandler?.handle(event);
 	}
@@ -1781,9 +1741,6 @@ var EventDispatcher = class {
 
 //#endregion
 //#region src/bot/defaults/UnhandledRepliable.ts
-/**
-* @internal Default handler for unhandled repliable interactions.
-*/
 var UnhandledRepliable = class extends InteractionHandler {
 	async execute() {
 		await this.reply("Feature not implemented yet.");
@@ -1792,9 +1749,6 @@ var UnhandledRepliable = class extends InteractionHandler {
 
 //#endregion
 //#region src/bot/defaults/UnhandledAutocomplete.ts
-/**
-* @internal Default handler for an autocomplete with no registered handler.
-*/
 var UnhandledAutocomplete = class extends AutocompleteHandler {
 	async execute() {
 		await this.respond([]);
@@ -1818,14 +1772,6 @@ const HARMLESS_API_CODES = /* @__PURE__ */ new Set([
 //#endregion
 //#region src/bot/handleInteractionFault.ts
 const logger = new _seedcord_logger.Logger("Faults", { channel: "errors" });
-/**
-* The interaction controller boundary. Sorts a throw from any handler-lifecycle phase into the right
-* user reply plus the right bus event. When a handler is built its sender is passed in, so the boundary
-* sends from the current ack state. A middleware or pre-construction throw arrives with no sender, so the
-* boundary builds one from the interaction flags.
-*
-* @internal
-*/
 async function handleInteractionFault(caught, interaction, core, routeId, sender) {
 	if (caught instanceof _seedcord_core.Silence) {
 		if (caught.reason !== void 0 && (core.config.errors?.logSilences ?? true)) logger.debug(`Silence: ${caught.reason}`);
@@ -1880,12 +1826,6 @@ async function sendGuarded(sender, response, ephemeral) {
 
 //#endregion
 //#region src/bot/controllers/InteractionDispatcher.ts
-/**
-* Scans handler directories, routes each interaction to its registered handler, and runs the handler.
-* One handler per interaction.
-*
-* @internal
-*/
 var InteractionDispatcher = class {
 	core;
 	logger = new _seedcord_logger.Logger("Interactions", { channel: "interactions" });
@@ -2066,7 +2006,6 @@ var InteractionDispatcher = class {
 			from
 		});
 	}
-	/** @internal For use in dev mode */
 	async onHmr(event) {
 		await this.hmrHandler?.handle(event);
 	}
@@ -2370,7 +2309,7 @@ __decorate([(0, envapt_legacy.Envapt)("DISCORD_BOT_TOKEN", { converter: (raw) =>
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.1";
+const version = "0.1.2";
 
 //#endregion
 //#region src/Seedcord.ts
@@ -2471,6 +2410,7 @@ var Seedcord = class Seedcord extends _seedcord_core_node_internal.Pluggable {
 //#endregion
 exports.ArraySource = ArraySource;
 exports.AutocompleteHandler = AutocompleteHandler;
+exports.BaseHandler = BaseHandler;
 exports.ButtonHandler = ButtonHandler;
 exports.ContextMenuHandler = ContextMenuHandler;
 exports.CursorSource = CursorSource;