@seedcord/gateway 0.1.0-next.6 → 0.1.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { AnyCustomId, AutocompletableNames, BaseReplySender, ChoiceValueOf, EntryFor, FocusedField, GateFitsWith, HasComponentDefs, MatchArms, ModalLike, PageCursor, SingleParams, SlashOptions as SlashOptions$1 } from "@seedcord/core/internal";
 import { ArraySource as ArraySource$1, AutocompleteOptions, BaseHandler, Bus, ContextMenuKind, CoreBase, CursorSource as CursorSource$1, DispatchContext, Gate, GateContextBase, GateNoticeOptions, GuildPermissionsContext, Initializeable, Notice, PaginatorBase, PaginatorConfig, PermissionNoticeOverrides, PermissionScope, RepliableHandler as RepliableHandler$1, RequiredOf, SelectMenuKind, SlashOptionRegistry, Subscriber as Subscriber$1, SubscriptionKey, WebhookLog as WebhookLog$1 } from "@seedcord/core";
 import { Logger } from "@seedcord/logger";
-import { APIInteractionGuildMember, APIModalInteractionResponseCallbackData, AnySelectMenuInteraction, ApplicationCommandOptionChoiceData, ApplicationCommandType, ApplicationEmoji, AutocompleteInteraction, BooleanCache, ButtonInteraction, ButtonStyle, CacheType, CacheTypeReducer, ChannelSelectMenuInteraction, ChatInputCommandInteraction, Client, ClientEvents, ClientOptions, CommandInteractionOption, ContextMenuCommandInteraction, Events, Guild, GuildEmoji, GuildMember, Interaction, MentionableSelectMenuInteraction, Message, MessageContextMenuCommandInteraction, ModalSubmitInteraction, Role, RoleSelectMenuInteraction, StringSelectMenuInteraction, TextChannel, User, UserContextMenuCommandInteraction, UserSelectMenuInteraction } from "discord.js";
+import { APIInteractionGuildMember, APIModalInteractionResponseCallbackData, AnySelectMenuInteraction, ApplicationCommandOptionChoiceData, ApplicationCommandType, ApplicationEmoji, AutocompleteInteraction, BaseMessageOptions, BooleanCache, ButtonInteraction, ButtonStyle, CacheType, CacheTypeReducer, ChannelSelectMenuInteraction, ChatInputCommandInteraction, Client, ClientEvents, ClientOptions, CommandInteractionOption, ContextMenuCommandInteraction, Events, Guild, GuildEmoji, GuildMember, Interaction, MentionableSelectMenuInteraction, Message, MessageContextMenuCommandInteraction, ModalSubmitInteraction, Role, RoleSelectMenuInteraction, StringSelectMenuInteraction, TextChannel, User, UserContextMenuCommandInteraction, UserSelectMenuInteraction } from "discord.js";
 import { Plugin as Plugin$1, PluginLifecycleSpec, PluginOptions, PluginOptions as PluginOptions$1 } from "@seedcord/core/plugin";
 import { CoordinatedShutdown, CoordinatedStartup, Pluggable } from "@seedcord/core/node/internal";
 import { SeedcordBrand, SeedcordInstance } from "@seedcord/types/internal";
@@ -131,6 +131,28 @@ interface Core extends CoreBase {
   readonly config: GatewayConfig;
 }
 //#endregion
+//#region src/interfaces/ReplyResponse.d.ts
+/**
+ * Every file form discord.js accepts in a message's `files` field: `AttachmentBuilder`, `Attachment`, a
+ * `Buffer`, a node `Stream`, a path or URL string, and an `{ attachment, name }` payload.
+ */
+type GatewayFile = NonNullable<BaseMessageOptions['files']>[number];
+/**
+ * A reply that may attach files in any form discord.js accepts, on top of the portable `ReplyFile`. The
+ * reply verbs already take this, so name it only to type a variable or a helper's return. A `Notice`
+ * render or a paginator page returns the plain `ReplyResponse`, which takes a `ReplyFile` alone.
+ *
+ * @example
+ * ```ts
+ * // any discord.js file form
+ * await this.reply({
+ *     components: [container],
+ *     files: [new AttachmentBuilder(createReadStream('./report.pdf'), { name: 'report.pdf' })]
+ * });
+ * ```
+ */
+type GatewayReplyResponse = ReplyResponse<GatewayFile>;
+//#endregion
 //#region src/handlers/interactionTypes.d.ts
 type ValidInteractionTypes = ChatInputCommandInteraction | ButtonInteraction | ModalSubmitInteraction | AutocompleteInteraction | AnySelectMenuInteraction | ContextMenuCommandInteraction;
 type ValidNonInteractionKeys = Exclude<keyof ClientEvents, Events.InteractionCreate>;
@@ -550,16 +572,16 @@ type SentMessage = Message;
  * Writes interaction responses through the discord.js interaction. Construction is internal to the repliable
  * handler bases and the dispatcher.
  */
-declare class ReplySender extends BaseReplySender<SentMessage> {
+declare class ReplySender extends BaseReplySender<SentMessage, GatewayFile> {
   private readonly interaction;
   constructor(interaction: Repliables, routeId: string, bus?: Bus);
-  protected writeReply(response: ReplyResponse | string, opts?: SendOpts): Promise<SentMessage | undefined>;
+  protected writeReply(response: GatewayReplyResponse | string, opts?: SendOpts): Promise<SentMessage | undefined>;
   protected writeDefer(opts?: DeferOpts): Promise<void>;
   protected writeDeferUpdate(): Promise<void>;
-  protected writeUpdate(response: ReplyResponse | string): Promise<SentMessage | undefined>;
-  protected writeFollowUp(response: ReplyResponse | string, opts?: SendOpts): Promise<SentMessage>;
-  protected writeEditOriginal(response: ReplyResponse | string): Promise<SentMessage>;
-  protected writeEditTarget(targetId: string, response: ReplyResponse | string): Promise<SentMessage>;
+  protected writeUpdate(response: GatewayReplyResponse | string): Promise<SentMessage | undefined>;
+  protected writeFollowUp(response: GatewayReplyResponse | string, opts?: SendOpts): Promise<SentMessage>;
+  protected writeEditOriginal(response: GatewayReplyResponse | string): Promise<SentMessage>;
+  protected writeEditTarget(targetId: string, response: GatewayReplyResponse | string): Promise<SentMessage>;
   protected writeDeleteOriginal(): Promise<void>;
   protected writeDeleteTarget(targetId: string): Promise<void>;
   protected writeModal(data: APIModalInteractionResponseCallbackData): Promise<void>;
@@ -582,7 +604,7 @@ declare class ReplySender extends BaseReplySender<SentMessage> {
  *
  * @typeParam Event - The repliable interaction type this handler processes
  */
-declare abstract class RepliableHandler<Event extends Repliables> extends RepliableHandler$1<Event, Core, SentMessage, ReplySender> {
+declare abstract class RepliableHandler<Event extends Repliables> extends RepliableHandler$1<Event, Core, SentMessage, GatewayFile, ReplySender> {
   /** @internal */
   getEvent(): Event;
   protected buildSender(event: Event, core: Core, routeId: string): ReplySender;
@@ -872,7 +894,7 @@ declare abstract class ComponentHandler<Event extends ComponentInteraction, Defs
   /** @internal */
   readonly __componentDefs?: Defs;
   /** Rewrite the source message this component interaction came from. */
-  protected update(response: ReplyResponse | string): Promise<SentMessage>;
+  protected update(response: GatewayReplyResponse | string): Promise<SentMessage>;
   /** Acknowledge the component without changing the source message. */
   protected deferUpdate(): Promise<void>;
   private decoded?;
@@ -971,7 +993,7 @@ declare abstract class ModalHandler<Defs extends readonly AnyCustomId[], Cache e
   /** @internal */
   readonly __component?: 'modal';
   /** Rewrite the message this modal was opened from. Throws when a command opened the modal. */
-  protected update(response: ReplyResponse | string): Promise<SentMessage>;
+  protected update(response: GatewayReplyResponse | string): Promise<SentMessage>;
   /** Acknowledge the submit without changing the source message. Throws when a command opened the modal. */
   protected deferUpdate(): Promise<void>;
   private ensureSourceMessage;
@@ -1504,5 +1526,5 @@ declare class Seedcord extends Pluggable<'gateway', 'server'> implements Core, S
 /** Package version */
 declare const version: string;
 //#endregion
-export { ArraySource, AssignRoleNoticeOverrides, AutocompleteHandler, ButtonHandler, type CheckPermissionOptions, type ConfirmOptions, ContextMenuHandler, type Core, CursorSource, type DefaultConfirmOptions, Emojis, type EventGateContext, EventHandler, EventMiddleware, type EventSpec, type EventsConfig, type GateContext, Gated, type GatewayBotConfig, type GatewayConfig, type GatewayPluginOptions, HasPermsToAssignOptions, IgnoreBots, type InjectedEmojiMap, type InteractionGateContext, InteractionHandler, InteractionMiddleware, Middleware, type MiddlewareOptions, MiddlewareType, ModalHandler, Nsfw, type PageContext, Paginator, Plugin, type PluginLifecycleSpec, type PluginOptions, RegisterEvent, type RegisterEventOptions, RepliableHandler, type Repliables, Seedcord, SelectMenuHandler, SlashHandler, type SlashOptions, Subscriber, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, WebhookLog, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
+export { ArraySource, AssignRoleNoticeOverrides, AutocompleteHandler, ButtonHandler, type CheckPermissionOptions, type ConfirmOptions, ContextMenuHandler, type Core, CursorSource, type DefaultConfirmOptions, Emojis, type EventGateContext, EventHandler, EventMiddleware, type EventSpec, type EventsConfig, type GateContext, Gated, type GatewayBotConfig, type GatewayConfig, type GatewayFile, type GatewayPluginOptions, type GatewayReplyResponse, HasPermsToAssignOptions, IgnoreBots, type InjectedEmojiMap, type InteractionGateContext, InteractionHandler, InteractionMiddleware, Middleware, type MiddlewareOptions, MiddlewareType, ModalHandler, Nsfw, type PageContext, Paginator, Plugin, type PluginLifecycleSpec, type PluginOptions, RegisterEvent, type RegisterEventOptions, RepliableHandler, type Repliables, Seedcord, SelectMenuHandler, SlashHandler, type SlashOptions, Subscriber, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, WebhookLog, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -531,6 +531,18 @@ var InteractionMiddleware = class extends BaseHandler$1 {
 
 //#endregion
 //#region src/bot/ReplySender.ts
+function isReplyFile(file) {
+	return typeof file === "object" && "data" in file && ArrayBuffer.isView(file.data);
+}
+function toDjsFile(file) {
+	if (!isReplyFile(file)) return file;
+	return {
+		attachment: Buffer.from(file.data),
+		name: file.name,
+		...file.description !== void 0 && { description: file.description },
+		...file.title !== void 0 && { title: file.title }
+	};
+}
 function seedState(interaction) {
 	if (interaction.deferred && interaction.ephemeral === null) return "deferred-update";
 	if (interaction.replied) return "replied";
@@ -613,7 +625,7 @@ var ReplySender = class extends BaseReplySender {
 			components: reply.components,
 			flags,
 			...reply.allowedMentions && { allowedMentions: reply.allowedMentions },
-			...reply.files && { files: [...reply.files] }
+			...reply.files && { files: reply.files.map(toDjsFile) }
 		};
 	}
 	editOptions(response) {
@@ -622,7 +634,7 @@ var ReplySender = class extends BaseReplySender {
 			components: reply.components,
 			flags: MessageFlags.IsComponentsV2,
 			...reply.allowedMentions && { allowedMentions: reply.allowedMentions },
-			...reply.files && { files: [...reply.files] }
+			...reply.files && { files: reply.files.map(toDjsFile) }
 		};
 	}
 	updateOptions(response) {
@@ -631,7 +643,7 @@ var ReplySender = class extends BaseReplySender {
 			components: reply.components,
 			flags: MessageFlags.IsComponentsV2,
 			...reply.allowedMentions && { allowedMentions: reply.allowedMentions },
-			...reply.files && { files: [...reply.files] }
+			...reply.files && { files: reply.files.map(toDjsFile) }
 		};
 	}
 	createdMessage(result) {
@@ -2351,7 +2363,7 @@ __decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordTok
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.0-next.6";
+const version = "0.1.0";
 
 //#endregion
 //#region src/Seedcord.ts