@fluxerjs/core 1.1.7 → 1.1.8

package/dist/chunk-ZVFZIZM2.mjs

@@ -0,0 +1,150 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Message.ts
+import { Collection } from "@fluxerjs/collection";
+import { Routes } from "@fluxerjs/types";
+import { EmbedBuilder } from "@fluxerjs/builders";
+var Message = class _Message extends Base {
+  client;
+  id;
+  channelId;
+  guildId;
+  author;
+  content;
+  createdAt;
+  editedAt;
+  pinned;
+  attachments;
+  channel;
+  /** @param data - API message from POST/PATCH /channels/{id}/messages or gateway MESSAGE_CREATE */
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.channelId = data.channel_id;
+    this.guildId = data.guild_id ?? null;
+    this.author = client.getOrCreateUser(data.author);
+    this.content = data.content;
+    this.createdAt = new Date(data.timestamp);
+    this.editedAt = data.edited_timestamp ? new Date(data.edited_timestamp) : null;
+    this.pinned = data.pinned;
+    this.attachments = new Collection();
+    for (const a of data.attachments ?? []) this.attachments.set(a.id, a);
+  }
+  /**
+   * Send a message to this channel without replying. Use when you want a standalone message.
+   * @param options - Text content or object with content and/or embeds
+   * @example
+   * await message.send('Pong!');
+   * await message.send({ embeds: [embed.toJSON()] });
+   */
+  async send(options) {
+    const body = typeof options === "string" ? { content: options } : options;
+    const data = await this.client.rest.post(Routes.channelMessages(this.channelId), { body });
+    return new _Message(this.client, data);
+  }
+  /**
+   * Send a message to a specific channel. Use for logging, forwarding, or sending to another channel in the guild.
+   * @param channelId - Snowflake of the target channel (e.g. log channel ID)
+   * @param options - Text content or object with content and/or embeds
+   * @example
+   * await message.sendTo(logChannelId, 'User ' + message.author.username + ' said: ' + message.content);
+   * await message.sendTo(announceChannelId, { embeds: [embed.toJSON()] });
+   */
+  async sendTo(channelId, options) {
+    return this.client.channels.send(channelId, options);
+  }
+  /**
+   * Reply to this message.
+   * @param options - Text content or object with content and/or embeds
+   */
+  async reply(options) {
+    const body = typeof options === "string" ? {
+      content: options,
+      message_reference: {
+        channel_id: this.channelId,
+        message_id: this.id,
+        guild_id: this.guildId ?? void 0
+      }
+    } : {
+      ...options,
+      message_reference: {
+        channel_id: this.channelId,
+        message_id: this.id,
+        guild_id: this.guildId ?? void 0
+      }
+    };
+    const data = await this.client.rest.post(Routes.channelMessages(this.channelId), { body });
+    return new _Message(this.client, data);
+  }
+  /**
+   * Edit this message. Only the author (or admins) can edit.
+   * @param options - New content and/or embeds
+   */
+  async edit(options) {
+    const body = {};
+    if (options.content !== void 0) body.content = options.content;
+    if (options.embeds?.length) {
+      body.embeds = options.embeds.map((e) => e instanceof EmbedBuilder ? e.toJSON() : e);
+    }
+    const data = await this.client.rest.patch(Routes.channelMessage(this.channelId, this.id), {
+      body
+    });
+    return new _Message(this.client, data);
+  }
+  /** Delete this message. */
+  async delete() {
+    await this.client.rest.delete(Routes.channelMessage(this.channelId, this.id));
+  }
+  /**
+   * Format emoji for reaction API: unicode string or "name:id" for custom.
+   * For string resolution (e.g. :name:), use client.resolveEmoji; Message methods resolve automatically when guildId is available.
+   */
+  static formatEmoji(emoji) {
+    if (typeof emoji === "string") return emoji;
+    return `${emoji.name}:${emoji.id}`;
+  }
+  resolveEmojiForReaction(emoji) {
+    return this.client.resolveEmoji(emoji, this.guildId);
+  }
+  /**
+   * Add a reaction to this message (as the bot).
+   * @param emoji - Unicode emoji, custom `{ name, id }`, `:name:`, `name:id`, or `<:name:id>`
+   */
+  async react(emoji) {
+    const emojiStr = await this.resolveEmojiForReaction(emoji);
+    const route = `${Routes.channelMessageReaction(this.channelId, this.id, emojiStr)}/@me`;
+    await this.client.rest.put(route);
+  }
+  /**
+   * Remove the bot's reaction, or a specific user's reaction if userId is provided.
+   * @param emoji - Unicode emoji, custom `{ name, id }`, `:name:`, `name:id`, or `<:name:id>`
+   * @param userId - If provided, removes that user's reaction (requires moderator permissions)
+   */
+  async removeReaction(emoji, userId) {
+    const emojiStr = await this.resolveEmojiForReaction(emoji);
+    const route = `${Routes.channelMessageReaction(this.channelId, this.id, emojiStr)}/${userId ?? "@me"}`;
+    await this.client.rest.delete(route);
+  }
+  /**
+   * Remove all reactions from this message.
+   * Requires moderator permissions.
+   */
+  async removeAllReactions() {
+    await this.client.rest.delete(Routes.channelMessageReactions(this.channelId, this.id));
+  }
+  /**
+   * Remove all reactions of a specific emoji from this message.
+   * @param emoji - Unicode emoji, custom `{ name, id }`, `:name:`, `name:id`, or `<:name:id>`. Requires moderator permissions.
+   */
+  async removeReactionEmoji(emoji) {
+    const emojiStr = await this.resolveEmojiForReaction(emoji);
+    await this.client.rest.delete(Routes.channelMessageReaction(this.channelId, this.id, emojiStr));
+  }
+};
+
+export {
+  Message
+};

package/dist/index.d.mts

@@ -716,7 +716,7 @@ declare class User extends Base {
         size?: number;
         extension?: string;
     }): string | null;
-    /** Get the avatar URL, or the default avatar if none set. */
+    /** Get the avatar URL, or the default avatar if none set (Fluxer: fluxerstatic.com). */
     displayAvatarURL(options?: {
         size?: number;
         extension?: string;
@@ -1267,6 +1267,10 @@ interface PartialMessage {
     id: string;
     channelId: string;
     channel?: Channel | null;
+    /** Message content, when provided by the gateway (e.g. Fluxer). */
+    content?: string | null;
+    /** Author user ID, when provided by the gateway (e.g. Fluxer). */
+    authorId?: string | null;
 }
 
 /**
@@ -1578,6 +1582,7 @@ declare class Client extends EventEmitter {
      * Resolve an emoji argument to the API format (unicode or "name:id").
      * Supports: <:name:id>, :name:, name:id, { name, id }, unicode.
      * When id is missing (e.g. :name:), fetches guild emojis if guildId provided.
+     * When reacting in a guild channel, custom emojis must be from that guild.
      * @param emoji - Emoji string or object
      * @param guildId - Guild ID for resolving custom emoji by name (required when id is missing)
      * @returns API-formatted string for reactions
@@ -1587,6 +1592,12 @@ declare class Client extends EventEmitter {
         id?: string;
         animated?: boolean;
     }, guildId?: string | null): Promise<string>;
+    /**
+     * Asserts that a custom emoji (by id) belongs to the given guild.
+     * Used when reacting in guild channels to reject emojis from other servers.
+     * @throws FluxerError with EMOJI_NOT_IN_GUILD if the emoji is not in the guild
+     */
+    private assertEmojiInGuild;
     /**
      * Fetch instance info (API URL, gateway URL, features). GET /instance.
      * Does not require authentication.
@@ -1658,8 +1669,14 @@ declare const ErrorCodes: {
     readonly GuildNotFound: "GUILD_NOT_FOUND";
     readonly MemberNotFound: "MEMBER_NOT_FOUND";
     readonly RoleNotFound: "ROLE_NOT_FOUND";
+    readonly EmojiNotInGuild: "EMOJI_NOT_IN_GUILD";
 };
 
+/** User Content CDN (avatars, icons, banners, emojis, attachments). */
+declare const CDN_URL = "https://fluxerusercontent.com";
+/** Static Assets CDN (default avatars). Use fluxerstatic.com for default avatars per Fluxer API. */
+declare const STATIC_CDN_URL = "https://fluxerstatic.com";
+
 interface CdnUrlOptions {
     size?: number;
     extension?: string;
@@ -1716,9 +1733,10 @@ declare function cdnMemberAvatarURL(guildId: string, userId: string, avatarHash:
 declare function cdnMemberBannerURL(guildId: string, userId: string, bannerHash: string | null, options?: CdnUrlOptions): string | null;
 /**
  * Get the default avatar URL (used when user has no custom avatar).
- * @param discriminatorIndex - Optional index 0-4 for default avatar variant
+ * Fluxer uses fluxerstatic.com with index = userId % 6 (six default avatar variants).
+ * @param userIdOrIndex - User ID (snowflake string) to derive index, or explicit index 0-5
  * @returns The default avatar URL
  */
-declare function cdnDefaultAvatarURL(discriminatorIndex?: number): string;
+declare function cdnDefaultAvatarURL(userIdOrIndex: string | number): string;
 
-export { Base, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };
+export { Base, CDN_URL, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, STATIC_CDN_URL, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };

package/dist/index.d.ts

@@ -716,7 +716,7 @@ declare class User extends Base {
         size?: number;
         extension?: string;
     }): string | null;
-    /** Get the avatar URL, or the default avatar if none set. */
+    /** Get the avatar URL, or the default avatar if none set (Fluxer: fluxerstatic.com). */
     displayAvatarURL(options?: {
         size?: number;
         extension?: string;
@@ -1267,6 +1267,10 @@ interface PartialMessage {
     id: string;
     channelId: string;
     channel?: Channel | null;
+    /** Message content, when provided by the gateway (e.g. Fluxer). */
+    content?: string | null;
+    /** Author user ID, when provided by the gateway (e.g. Fluxer). */
+    authorId?: string | null;
 }
 
 /**
@@ -1578,6 +1582,7 @@ declare class Client extends EventEmitter {
      * Resolve an emoji argument to the API format (unicode or "name:id").
      * Supports: <:name:id>, :name:, name:id, { name, id }, unicode.
      * When id is missing (e.g. :name:), fetches guild emojis if guildId provided.
+     * When reacting in a guild channel, custom emojis must be from that guild.
      * @param emoji - Emoji string or object
      * @param guildId - Guild ID for resolving custom emoji by name (required when id is missing)
      * @returns API-formatted string for reactions
@@ -1587,6 +1592,12 @@ declare class Client extends EventEmitter {
         id?: string;
         animated?: boolean;
     }, guildId?: string | null): Promise<string>;
+    /**
+     * Asserts that a custom emoji (by id) belongs to the given guild.
+     * Used when reacting in guild channels to reject emojis from other servers.
+     * @throws FluxerError with EMOJI_NOT_IN_GUILD if the emoji is not in the guild
+     */
+    private assertEmojiInGuild;
     /**
      * Fetch instance info (API URL, gateway URL, features). GET /instance.
      * Does not require authentication.
@@ -1658,8 +1669,14 @@ declare const ErrorCodes: {
     readonly GuildNotFound: "GUILD_NOT_FOUND";
     readonly MemberNotFound: "MEMBER_NOT_FOUND";
     readonly RoleNotFound: "ROLE_NOT_FOUND";
+    readonly EmojiNotInGuild: "EMOJI_NOT_IN_GUILD";
 };
 
+/** User Content CDN (avatars, icons, banners, emojis, attachments). */
+declare const CDN_URL = "https://fluxerusercontent.com";
+/** Static Assets CDN (default avatars). Use fluxerstatic.com for default avatars per Fluxer API. */
+declare const STATIC_CDN_URL = "https://fluxerstatic.com";
+
 interface CdnUrlOptions {
     size?: number;
     extension?: string;
@@ -1716,9 +1733,10 @@ declare function cdnMemberAvatarURL(guildId: string, userId: string, avatarHash:
 declare function cdnMemberBannerURL(guildId: string, userId: string, bannerHash: string | null, options?: CdnUrlOptions): string | null;
 /**
  * Get the default avatar URL (used when user has no custom avatar).
- * @param discriminatorIndex - Optional index 0-4 for default avatar variant
+ * Fluxer uses fluxerstatic.com with index = userId % 6 (six default avatar variants).
+ * @param userIdOrIndex - User ID (snowflake string) to derive index, or explicit index 0-5
  * @returns The default avatar URL
  */
-declare function cdnDefaultAvatarURL(discriminatorIndex?: number): string;
+declare function cdnDefaultAvatarURL(userIdOrIndex: string | number): string;
 
-export { Base, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };
+export { Base, CDN_URL, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, STATIC_CDN_URL, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };

package/dist/index.js

@@ -50,7 +50,8 @@ var init_ErrorCodes = __esm({
       MessageNotFound: "MESSAGE_NOT_FOUND",
       GuildNotFound: "GUILD_NOT_FOUND",
       MemberNotFound: "MEMBER_NOT_FOUND",
-      RoleNotFound: "ROLE_NOT_FOUND"
+      RoleNotFound: "ROLE_NOT_FOUND",
+      EmojiNotInGuild: "EMOJI_NOT_IN_GUILD"
     };
   }
 });
@@ -600,11 +601,12 @@ var init_MessageCollector = __esm({
 });
 
 // src/util/Constants.ts
-var CDN_URL;
+var CDN_URL, STATIC_CDN_URL;
 var init_Constants = __esm({
   "src/util/Constants.ts"() {
     "use strict";
     CDN_URL = "https://fluxerusercontent.com";
+    STATIC_CDN_URL = "https://fluxerstatic.com";
   }
 });
 
@@ -624,7 +626,7 @@ function cdnAvatarURL(userId, avatarHash, options) {
   return `${CDN_URL}/avatars/${userId}/${avatarHash}.${ext}${size}`;
 }
 function cdnDisplayAvatarURL(userId, avatarHash, options) {
-  return cdnAvatarURL(userId, avatarHash, options) ?? `${CDN_URL}/avatars/0/0.png`;
+  return cdnAvatarURL(userId, avatarHash, options) ?? cdnDefaultAvatarURL(userId);
 }
 function cdnBannerURL(resourceId, bannerHash, options) {
   if (!bannerHash) return null;
@@ -644,9 +646,9 @@ function cdnMemberBannerURL(guildId, userId, bannerHash, options) {
   const size = appendSize(options);
   return `${CDN_URL}/guilds/${guildId}/users/${userId}/banners/${bannerHash}.${ext}${size}`;
 }
-function cdnDefaultAvatarURL(discriminatorIndex) {
-  const index = discriminatorIndex != null ? discriminatorIndex % 5 : 0;
-  return `${CDN_URL}/avatars/0/${index}.png`;
+function cdnDefaultAvatarURL(userIdOrIndex) {
+  const index = typeof userIdOrIndex === "string" ? Number(BigInt(userIdOrIndex) % 6n) : Math.abs(Math.floor(userIdOrIndex) % 6);
+  return `${STATIC_CDN_URL}/avatars/${index}.png`;
 }
 var init_cdn = __esm({
   "src/util/cdn.ts"() {
@@ -2327,6 +2329,7 @@ var init_User = __esm({
     init_Base();
     import_types16 = require("@fluxerjs/types");
     init_Constants();
+    init_cdn();
     User = class extends Base {
       client;
       id;
@@ -2379,9 +2382,9 @@ var init_User = __esm({
         const size = options?.size ? `?size=${options.size}` : "";
         return `${CDN_URL}/avatars/${this.id}/${this.avatar}.${ext}${size}`;
       }
-      /** Get the avatar URL, or the default avatar if none set. */
+      /** Get the avatar URL, or the default avatar if none set (Fluxer: fluxerstatic.com). */
       displayAvatarURL(options) {
-        return this.avatarURL(options) ?? `${CDN_URL}/avatars/0/0.png`;
+        return this.avatarURL(options) ?? cdnDefaultAvatarURL(this.id);
       }
       /**
        * Get the URL for this user's banner.
@@ -2535,6 +2538,7 @@ var index_exports = {};
 __export(index_exports, {
   AttachmentBuilder: () => import_builders3.AttachmentBuilder,
   Base: () => Base,
+  CDN_URL: () => CDN_URL,
   CategoryChannel: () => CategoryChannel,
   Channel: () => Channel,
   ChannelManager: () => ChannelManager,
@@ -2566,6 +2570,7 @@ __export(index_exports, {
   ReactionCollector: () => ReactionCollector,
   Role: () => Role,
   Routes: () => import_types21.Routes,
+  STATIC_CDN_URL: () => STATIC_CDN_URL,
   TextChannel: () => TextChannel,
   User: () => User,
   UserFlagsBitField: () => import_util9.UserFlagsBitField,
@@ -2843,7 +2848,9 @@ handlers.set("MESSAGE_DELETE", async (client, d) => {
   client.emit(Events.MessageDelete, {
     id: data.id,
     channelId: data.channel_id,
-    channel
+    channel,
+    content: data.content ?? null,
+    authorId: data.author_id ?? null
   });
 });
 handlers.set("MESSAGE_REACTION_ADD", async (client, d) => {
@@ -3161,20 +3168,31 @@ var Client = class extends import_events3.EventEmitter {
    * Resolve an emoji argument to the API format (unicode or "name:id").
    * Supports: <:name:id>, :name:, name:id, { name, id }, unicode.
    * When id is missing (e.g. :name:), fetches guild emojis if guildId provided.
+   * When reacting in a guild channel, custom emojis must be from that guild.
    * @param emoji - Emoji string or object
    * @param guildId - Guild ID for resolving custom emoji by name (required when id is missing)
    * @returns API-formatted string for reactions
    */
   async resolveEmoji(emoji, guildId) {
     if (typeof emoji === "object" && emoji.id) {
+      if (guildId) {
+        await this.assertEmojiInGuild(emoji.id, guildId);
+      }
       return (0, import_util7.formatEmoji)({ name: emoji.name, id: emoji.id, animated: emoji.animated });
     }
     const parsed = (0, import_util7.parseEmoji)(
       typeof emoji === "string" ? emoji : emoji.id ? `:${emoji.name}:` : emoji.name
     );
     if (!parsed) throw new Error("Invalid emoji");
-    if (parsed.id) return (0, import_util7.formatEmoji)(parsed);
+    if (parsed.id) {
+      if (guildId) {
+        await this.assertEmojiInGuild(parsed.id, guildId);
+      }
+      return (0, import_util7.formatEmoji)(parsed);
+    }
     if (!/^\w+$/.test(parsed.name)) return encodeURIComponent(parsed.name);
+    const unicodeFromShortcode = (0, import_util7.getUnicodeFromShortcode)(parsed.name);
+    if (unicodeFromShortcode) return encodeURIComponent(unicodeFromShortcode);
     if (guildId) {
       const emojis = await this.rest.get(import_types20.Routes.guildEmojis(guildId));
       const list = Array.isArray(emojis) ? emojis : Object.values(emojis ?? {});
@@ -3191,6 +3209,21 @@ var Client = class extends import_events3.EventEmitter {
     }
     return encodeURIComponent(parsed.name);
   }
+  /**
+   * Asserts that a custom emoji (by id) belongs to the given guild.
+   * Used when reacting in guild channels to reject emojis from other servers.
+   * @throws FluxerError with EMOJI_NOT_IN_GUILD if the emoji is not in the guild
+   */
+  async assertEmojiInGuild(emojiId, guildId) {
+    const emojis = await this.rest.get(import_types20.Routes.guildEmojis(guildId));
+    const list = Array.isArray(emojis) ? emojis : Object.values(emojis ?? {});
+    const found = list.some((e) => e.id === emojiId);
+    if (!found) {
+      throw new FluxerError("Custom emoji is from another server. Use an emoji from this server.", {
+        code: ErrorCodes.EmojiNotInGuild
+      });
+    }
+  }
   /**
    * Fetch instance info (API URL, gateway URL, features). GET /instance.
    * Does not require authentication.
@@ -3380,11 +3413,13 @@ var import_builders3 = require("@fluxerjs/builders");
 var import_types21 = require("@fluxerjs/types");
 var import_util8 = require("@fluxerjs/util");
 var import_util9 = require("@fluxerjs/util");
+init_Constants();
 init_cdn();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AttachmentBuilder,
   Base,
+  CDN_URL,
   CategoryChannel,
   Channel,
   ChannelManager,
@@ -3416,6 +3451,7 @@ init_cdn();
   ReactionCollector,
   Role,
   Routes,
+  STATIC_CDN_URL,
   TextChannel,
   User,
   UserFlagsBitField,