@wolfstar/plugin-gateway 0.12.0 → 0.13.0-next-20261008155539

package/dist/esm/index.js

@@ -10781,6 +10781,13 @@ var Attachment = class extends Attachment$1 {
 		initStructure(this, data, relations);
 	}
 	/**
+	* The URL of the file, like discord.js's `Attachment#attachment`, so that an attachment can be resent with
+	* `AttachmentBuilder.from`.
+	*/
+	get attachment() {
+		return this.url;
+	}
+	/**
 	* The name of the file.
 	*/
 	get name() {
@@ -18088,6 +18095,164 @@ function resolveCache(options) {
 */
 const GatewayErrorCodes = Object.freeze(Object.fromEntries(Object.keys(GatewayErrorMessages).map((code) => [code, code])));
 
+//#endregion
+//#region src/structures/messages/AttachmentBuilder.ts
+const SpoilerPrefix = "SPOILER_";
+/**
+* Builds a file to send with a message, like discord.js's `AttachmentBuilder`. Pass it in the `files` of a message.
+*
+* @example
+* ```ts
+* const file = new AttachmentBuilder("./howl.ogg").setDescription("A howl").setSpoiler();
+* await channel.send({ content: "Awoo", files: [file] });
+* ```
+*/
+var AttachmentBuilder = class AttachmentBuilder {
+	/**
+	* The contents of the file: its data, a path on disk, a URL, a stream, or a blob.
+	*/
+	attachment;
+	/**
+	* The name of the file, `undefined` to infer it from a path or URL.
+	*/
+	name;
+	/**
+	* The description (alt text) of the file.
+	*/
+	description;
+	/**
+	* The title of the file.
+	*/
+	title;
+	/**
+	* The duration of a voice message, in seconds.
+	*/
+	duration;
+	/**
+	* The waveform of a voice message, base64-encoded.
+	*/
+	waveform;
+	/**
+	* Whether the file is a spoiler while it has no name to prefix with `SPOILER_`.
+	*/
+	pendingSpoiler = false;
+	/**
+	* @param attachment The contents of the file.
+	* @param data The name and description of the file.
+	*/
+	constructor(attachment, data = {}) {
+		this.attachment = attachment;
+		this.name = data.name;
+		this.description = data.description;
+	}
+	/**
+	* Whether the file is a spoiler: its name starts with `SPOILER_`.
+	*/
+	get spoiler() {
+		return this.name === void 0 ? this.pendingSpoiler : basename$1(this.name).startsWith(SpoilerPrefix);
+	}
+	/**
+	* Sets the description (alt text) of the file.
+	*
+	* @param description The description.
+	*/
+	setDescription(description) {
+		this.description = description;
+		return this;
+	}
+	/**
+	* Sets the contents of the file, and its name when given.
+	*
+	* @param attachment The contents of the file.
+	* @param name The name of the file, kept as is when omitted.
+	*/
+	setFile(attachment, name) {
+		this.attachment = attachment;
+		if (name !== void 0) this.setName(name);
+		return this;
+	}
+	/**
+	* Sets the name of the file.
+	*
+	* @param name The name of the file.
+	*/
+	setName(name) {
+		this.name = name;
+		if (this.pendingSpoiler) {
+			this.pendingSpoiler = false;
+			this.setSpoiler();
+		}
+		return this;
+	}
+	/**
+	* Marks the file as a spoiler, or not, by adding or removing the `SPOILER_` prefix of its name.
+	*
+	* @param spoiler Whether the file is a spoiler.
+	*/
+	setSpoiler(spoiler = true) {
+		if (this.name === void 0) this.pendingSpoiler = spoiler;
+		else if (!spoiler) while (this.name.startsWith(SpoilerPrefix)) this.name = this.name.slice(8);
+		else if (!this.name.startsWith(SpoilerPrefix)) this.name = `${SpoilerPrefix}${this.name}`;
+		return this;
+	}
+	/**
+	* Sets the title of the file.
+	*
+	* @param title The title.
+	*/
+	setTitle(title) {
+		this.title = title;
+		return this;
+	}
+	/**
+	* Sets the duration of a voice message.
+	*
+	* @param duration The duration, in seconds.
+	*/
+	setDuration(duration) {
+		this.duration = duration;
+		return this;
+	}
+	/**
+	* Sets the waveform of a voice message.
+	*
+	* @param waveform The waveform, base64-encoded.
+	*/
+	setWaveform(waveform) {
+		this.waveform = waveform;
+		return this;
+	}
+	/**
+	* The file as an {@link AttachmentPayload}.
+	*/
+	toJSON() {
+		const payload = { attachment: this.attachment };
+		if (this.name !== void 0) payload.name = this.name;
+		if (this.description !== void 0) payload.description = this.description;
+		if (this.title !== void 0) payload.title = this.title;
+		if (this.duration !== void 0) payload.duration = this.duration;
+		if (this.waveform !== void 0) payload.waveform = this.waveform;
+		if (this.name === void 0 && this.pendingSpoiler) payload.spoiler = true;
+		return payload;
+	}
+	/**
+	* Copies a file.
+	*
+	* @param other The builder, payload, or received attachment to copy.
+	*/
+	static from(other) {
+		const builder = new AttachmentBuilder(other.attachment, {
+			name: other.name ?? void 0,
+			description: other.description ?? void 0
+		});
+		if (other.title != null) builder.title = other.title;
+		if (other.duration != null) builder.duration = other.duration;
+		if (other.waveform != null) builder.waveform = other.waveform;
+		if (other.spoiler) builder.setSpoiler();
+		return builder;
+	}
+};
+
 //#endregion
 //#region src/util/decorators.ts
 /**
@@ -18169,5 +18334,5 @@ const DefaultSweeperSettings = Object.freeze({
 });
 
 //#endregion
-export { Action, ActionRow, ActionsManager, Activity, ActivityFlagsBitField, AnnouncementChannel, AnnouncementThreadChannel, AnonymousGuild, ApplicationFlagsBitField, AppliedTagsMixin, Attachment, AttachmentFlagsBitField, AutoModerationActionExecution, AutoModerationRule, AutoModerationRuleManager, BaseChannel, BaseChannelMixin, BaseInvite, BaseManager, BitField, CachedManager, CategoryChannel, CategoryChannelChildManager, Channel, ChannelFlagsBitField, ChannelManager, ChannelMessageManager, ChannelOwnerMixin, ChannelParentMixin, ChannelPermissionMixin, ChannelSelectMenuComponent, ChannelSlowmodeMixin, ChannelThreadManager, ChannelThreadsMixin, ChannelTopicMixin, ChannelWebhooksMixin, CheckboxComponent, CheckboxGroupComponent, ClientUser, CollectionCache, Colors, Component, ComponentMixin, ContainerComponent, DMChannel, DMChannelMixin, DataManager, DefaultSweeperSettings, DispatchAction, DispatchHandlers, DispatchQueue, DispatchStateCodecs, DispatchTimeoutError, Embed, Emoji, EntityStoreCache, EventGatewayListener, FileComponent, FileUploadComponent, ForumChannel, GatewayClient, GatewayError, GatewayErrorCodes, GatewayErrorMessages, GatewayEvents, GatewayRangeError, GatewaySessionStoreError, GatewayTypeError, GroupDMChannel, GroupDMInvite, GroupDMMixin, Guild, GuildAuditLogsEntry, GuildBan, GuildBanManager, GuildChannelFields, GuildChannelInfoTimeoutError, GuildChannelManager, GuildChannelMixin, GuildEmoji, GuildEmojiManager, GuildEmojiRoleManager, GuildIntegrationManager, GuildInvite, GuildInviteManager, GuildManager, GuildMember, GuildMemberFlagsBitField, GuildMemberManager, GuildMemberRoleManager, GuildMembersRateLimitError, GuildMembersTimeoutError, GuildOnboarding, GuildOnboardingPrompt, GuildOnboardingPromptOption, GuildPreview, GuildScheduledEvent, GuildScheduledEventManager, GuildSoundboardSoundManager, GuildSoundboardSoundsTimeoutError, GuildStickerManager, GuildTemplate, GuildTemplateManager, GuildTemplatesPattern, Integration, IntentsBitField, InteractiveButtonComponent, InviteGuild, InvitesPattern, LabelComponent, LinkButtonComponent, MediaChannel, MediaGalleryComponent, MediaGalleryItem, MentionableSelectMenuComponent, Message, MessageFlagsBitField, MessageManager, MessageMentions, MessagePayload, MessageReaction, Mixin, MultiDispatchAction, MultiDispatchHandlers, NullCache, NumberFlagsBitField, Partials, PermissionOverwriteManager, PermissionOverwrites, PermissionsBitField, Poll, PollAnswer, PollAnswerVoterManager, PremiumButtonComponent, Presence, PresenceManager, PrivateThreadChannel, PublicThreadChannel, RadioGroupComponent, ReactionEmoji, ReactionManager, ReactionUserManager, RegisterAsGatewayListener, RichPresenceAssets, Role, RoleFlagsBitField, RoleManager, RoleSelectMenuComponent, SectionComponent, SeparatorComponent, SoundboardSound, StageChannel, StageInstance, StageInstanceManager, Sticker, StickerPack, StringSelectMenuComponent, Structure, StructureMixin, SweepableEntityNames, Sweepers, SystemChannelFlagsBitField, TextChannel, TextChannelMixin, TextDisplayComponent, TextGuildChannelMixin, TextInputComponent, ThreadChannelMemberManager, ThreadChannelMixin, ThreadManager, ThreadMember, ThreadMemberManager, ThreadOnlyChannelMixin, ThumbnailComponent, Typing, UnfurledMediaItem, User, UserFlagsBitField, UserManager, UserSelectMenuComponent, VoiceChannel, VoiceChannelMixin, VoiceState, VoiceStateManager, Webhook, WebhookManager, WebhookMixin, WelcomeScreen, Widget, WidgetMember, basename, bindClient, cacheWithLimits, cleanCodeBlockContent, cleanContent, compareRolePositions, computeCachedPermissionsIn, computeCachedTargetPermissions, computeChannelPermissions, computeGuildPermissions, computePermissionsIn, computePositions, computeTargetPermissions, createChannel, createComponent, createInvite, discordSort, dispatchPartition, fillGuildId, findComponentByCustomId, findName, flatten, getGatewayClient, getSortableGroupTypes, initStructure, isDeepEqual, isThreadChannelType, kClient, kClone, kData, kPatch, kPatchRelations, kRelations, lazyRelation, makeError, makePlainError, moveElementInArray, parseEmoji, parseWebhookURL, requireGuild, requireMe, resolveBase64, resolveCode, resolveColor, resolveFile, resolveGuildTemplateCode, resolveId, resolveImage, resolveImageOption, resolveInviteCode, resolveOverwriteOptions, resolvePartialEmoji, resolveSKUId, sameOverwrites, snakeCase, snowflakeTimestamp, toAPIOverwrite, toChannelBody, toSnakeCase, transformAPIAuditLogChange, transformAPIAutoModerationAction, transformAPIAutoModerationRuleTriggerMetadata, transformAPIAvatarDecorationData, transformAPIChannelMention, transformAPIEmbedAsset, transformAPIEmbedAuthor, transformAPIEmbedFooter, transformAPIGuildDefaultReaction, transformAPIGuildForumTag, transformAPIGuildScheduledEventEntityMetadata, transformAPIGuildScheduledEventRecurrenceRule, transformAPIIncidentsData, transformAPIMessageActivity, transformAPIMessageCall, transformAPIMessageInteractionMetadata, transformAPIMessageReference, transformAPIMessageSharedClientTheme, transformAPIRoleSubscriptionData, transformAPIRoleTags, transformAPIUserPrimaryGuild, transformAutoModerationAction, transformAutoModerationRuleTriggerMetadata, transformCollectibles, transformGuildDefaultReaction, transformGuildForumTag, transformGuildScheduledEventRecurrenceRule, transformResolved, verifyString, withGuildId };
+export { Action, ActionRow, ActionsManager, Activity, ActivityFlagsBitField, AnnouncementChannel, AnnouncementThreadChannel, AnonymousGuild, ApplicationFlagsBitField, AppliedTagsMixin, Attachment, AttachmentBuilder, AttachmentFlagsBitField, AutoModerationActionExecution, AutoModerationRule, AutoModerationRuleManager, BaseChannel, BaseChannelMixin, BaseInvite, BaseManager, BitField, CachedManager, CategoryChannel, CategoryChannelChildManager, Channel, ChannelFlagsBitField, ChannelManager, ChannelMessageManager, ChannelOwnerMixin, ChannelParentMixin, ChannelPermissionMixin, ChannelSelectMenuComponent, ChannelSlowmodeMixin, ChannelThreadManager, ChannelThreadsMixin, ChannelTopicMixin, ChannelWebhooksMixin, CheckboxComponent, CheckboxGroupComponent, ClientUser, CollectionCache, Colors, Component, ComponentMixin, ContainerComponent, DMChannel, DMChannelMixin, DataManager, DefaultSweeperSettings, DispatchAction, DispatchHandlers, DispatchQueue, DispatchStateCodecs, DispatchTimeoutError, Embed, Emoji, EntityStoreCache, EventGatewayListener, FileComponent, FileUploadComponent, ForumChannel, GatewayClient, GatewayError, GatewayErrorCodes, GatewayErrorMessages, GatewayEvents, GatewayRangeError, GatewaySessionStoreError, GatewayTypeError, GroupDMChannel, GroupDMInvite, GroupDMMixin, Guild, GuildAuditLogsEntry, GuildBan, GuildBanManager, GuildChannelFields, GuildChannelInfoTimeoutError, GuildChannelManager, GuildChannelMixin, GuildEmoji, GuildEmojiManager, GuildEmojiRoleManager, GuildIntegrationManager, GuildInvite, GuildInviteManager, GuildManager, GuildMember, GuildMemberFlagsBitField, GuildMemberManager, GuildMemberRoleManager, GuildMembersRateLimitError, GuildMembersTimeoutError, GuildOnboarding, GuildOnboardingPrompt, GuildOnboardingPromptOption, GuildPreview, GuildScheduledEvent, GuildScheduledEventManager, GuildSoundboardSoundManager, GuildSoundboardSoundsTimeoutError, GuildStickerManager, GuildTemplate, GuildTemplateManager, GuildTemplatesPattern, Integration, IntentsBitField, InteractiveButtonComponent, InviteGuild, InvitesPattern, LabelComponent, LinkButtonComponent, MediaChannel, MediaGalleryComponent, MediaGalleryItem, MentionableSelectMenuComponent, Message, MessageFlagsBitField, MessageManager, MessageMentions, MessagePayload, MessageReaction, Mixin, MultiDispatchAction, MultiDispatchHandlers, NullCache, NumberFlagsBitField, Partials, PermissionOverwriteManager, PermissionOverwrites, PermissionsBitField, Poll, PollAnswer, PollAnswerVoterManager, PremiumButtonComponent, Presence, PresenceManager, PrivateThreadChannel, PublicThreadChannel, RadioGroupComponent, ReactionEmoji, ReactionManager, ReactionUserManager, RegisterAsGatewayListener, RichPresenceAssets, Role, RoleFlagsBitField, RoleManager, RoleSelectMenuComponent, SectionComponent, SeparatorComponent, SoundboardSound, StageChannel, StageInstance, StageInstanceManager, Sticker, StickerPack, StringSelectMenuComponent, Structure, StructureMixin, SweepableEntityNames, Sweepers, SystemChannelFlagsBitField, TextChannel, TextChannelMixin, TextDisplayComponent, TextGuildChannelMixin, TextInputComponent, ThreadChannelMemberManager, ThreadChannelMixin, ThreadManager, ThreadMember, ThreadMemberManager, ThreadOnlyChannelMixin, ThumbnailComponent, Typing, UnfurledMediaItem, User, UserFlagsBitField, UserManager, UserSelectMenuComponent, VoiceChannel, VoiceChannelMixin, VoiceState, VoiceStateManager, Webhook, WebhookManager, WebhookMixin, WelcomeScreen, Widget, WidgetMember, basename, bindClient, cacheWithLimits, cleanCodeBlockContent, cleanContent, compareRolePositions, computeCachedPermissionsIn, computeCachedTargetPermissions, computeChannelPermissions, computeGuildPermissions, computePermissionsIn, computePositions, computeTargetPermissions, createChannel, createComponent, createInvite, discordSort, dispatchPartition, fillGuildId, findComponentByCustomId, findName, flatten, getGatewayClient, getSortableGroupTypes, initStructure, isDeepEqual, isThreadChannelType, kClient, kClone, kData, kPatch, kPatchRelations, kRelations, lazyRelation, makeError, makePlainError, moveElementInArray, parseEmoji, parseWebhookURL, requireGuild, requireMe, resolveBase64, resolveCode, resolveColor, resolveFile, resolveGuildTemplateCode, resolveId, resolveImage, resolveImageOption, resolveInviteCode, resolveOverwriteOptions, resolvePartialEmoji, resolveSKUId, sameOverwrites, snakeCase, snowflakeTimestamp, toAPIOverwrite, toChannelBody, toSnakeCase, transformAPIAuditLogChange, transformAPIAutoModerationAction, transformAPIAutoModerationRuleTriggerMetadata, transformAPIAvatarDecorationData, transformAPIChannelMention, transformAPIEmbedAsset, transformAPIEmbedAuthor, transformAPIEmbedFooter, transformAPIGuildDefaultReaction, transformAPIGuildForumTag, transformAPIGuildScheduledEventEntityMetadata, transformAPIGuildScheduledEventRecurrenceRule, transformAPIIncidentsData, transformAPIMessageActivity, transformAPIMessageCall, transformAPIMessageInteractionMetadata, transformAPIMessageReference, transformAPIMessageSharedClientTheme, transformAPIRoleSubscriptionData, transformAPIRoleTags, transformAPIUserPrimaryGuild, transformAutoModerationAction, transformAutoModerationRuleTriggerMetadata, transformCollectibles, transformGuildDefaultReaction, transformGuildForumTag, transformGuildScheduledEventRecurrenceRule, transformResolved, verifyString, withGuildId };
 //# sourceMappingURL=index.js.map