@fluxerjs/core 1.1.6 → 1.1.8

package/dist/chunk-NYEWIYVQ.mjs

@@ -0,0 +1,86 @@
+import {
+  CDN_URL
+} from "./chunk-HQMYRYMY.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/User.ts
+import { Routes } from "@fluxerjs/types";
+var User = class extends Base {
+  client;
+  id;
+  username;
+  discriminator;
+  globalName;
+  avatar;
+  bot;
+  /** @param data - API user from message author, GET /users/{id}, or GET /users/@me */
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.username = data.username;
+    this.discriminator = data.discriminator;
+    this.globalName = data.global_name ?? null;
+    this.avatar = data.avatar ?? null;
+    this.bot = !!data.bot;
+  }
+  /** Update mutable fields from fresh API data. Used by getOrCreateUser cache. */
+  _patch(data) {
+    this.username = data.username;
+    this.discriminator = data.discriminator;
+    this.globalName = data.global_name ?? null;
+    this.avatar = data.avatar ?? null;
+  }
+  /**
+   * Get the URL for this user's avatar.
+   * @param options - Optional `size` and `extension` (default: `png`)
+   */
+  avatarURL(options) {
+    if (!this.avatar) return null;
+    const ext = options?.extension ?? "png";
+    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. */
+  displayAvatarURL(options) {
+    return this.avatarURL(options) ?? `${CDN_URL}/avatars/0/0.png`;
+  }
+  /** Returns a mention string (e.g. `<@123456>`). */
+  toString() {
+    return `<@${this.id}>`;
+  }
+  /**
+   * Create or get a DM channel with this user.
+   * Returns the DM channel; use {@link DMChannel.send} to send messages.
+   */
+  async createDM() {
+    const { DMChannel: DMChannelClass } = await import("./Channel-UHN4IOM5.mjs");
+    const data = await this.client.rest.post(Routes.userMeChannels(), {
+      body: { recipient_id: this.id },
+      auth: true
+    });
+    return new DMChannelClass(this.client, data);
+  }
+  /**
+   * Send a DM to this user.
+   * Convenience method that creates the DM channel and sends the message.
+   */
+  async send(options) {
+    const dm = await this.createDM();
+    return dm.send(options);
+  }
+};
+
+// src/client/ClientUser.ts
+var ClientUser = class extends User {
+  constructor(client, data) {
+    super(client, { ...data });
+  }
+};
+
+export {
+  User,
+  ClientUser
+};

package/dist/chunk-NZJJ7FRK.mjs

@@ -0,0 +1,339 @@
+import {
+  Events
+} from "./chunk-AH7KYH2Z.mjs";
+import {
+  buildSendBody
+} from "./chunk-PM2IUGNR.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/client/MessageManager.ts
+var MessageManager = class {
+  constructor(client, channelId) {
+    this.client = client;
+    this.channelId = channelId;
+  }
+  /**
+   * Fetch a message by ID from this channel.
+   * @param messageId - Snowflake of the message
+   * @returns The message
+   * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
+   */
+  async fetch(messageId) {
+    return this.client.channels.fetchMessage(this.channelId, messageId);
+  }
+};
+
+// src/util/MessageCollector.ts
+import { EventEmitter } from "events";
+import { Collection } from "@fluxerjs/collection";
+var MessageCollector = class extends EventEmitter {
+  client;
+  channelId;
+  options;
+  collected = new Collection();
+  _timeout = null;
+  _ended = false;
+  _listener;
+  constructor(client, channelId, options = {}) {
+    super();
+    this.client = client;
+    this.channelId = channelId;
+    this.options = {
+      filter: options.filter ?? (() => true),
+      time: options.time ?? 0,
+      max: options.max ?? 0
+    };
+    this._listener = (message) => {
+      if (this._ended || message.channelId !== this.channelId) return;
+      if (!this.options.filter(message)) return;
+      this.collected.set(message.id, message);
+      this.emit("collect", message);
+      if (this.options.max > 0 && this.collected.size >= this.options.max) {
+        this.stop("limit");
+      }
+    };
+    this.client.on(Events.MessageCreate, this._listener);
+    if (this.options.time > 0) {
+      this._timeout = setTimeout(() => this.stop("time"), this.options.time);
+    }
+  }
+  stop(reason = "user") {
+    if (this._ended) return;
+    this._ended = true;
+    this.client.off(Events.MessageCreate, this._listener);
+    if (this._timeout) {
+      clearTimeout(this._timeout);
+      this._timeout = null;
+    }
+    this.emit("end", this.collected, reason);
+  }
+  on(event, listener) {
+    return super.on(event, listener);
+  }
+  emit(event, ...args) {
+    return super.emit(event, ...args);
+  }
+};
+
+// src/structures/Channel.ts
+import { ChannelType, Routes } from "@fluxerjs/types";
+var Channel = class _Channel extends Base {
+  /** Whether this channel has a send method (TextChannel, DMChannel). */
+  isSendable() {
+    return "send" in this;
+  }
+  /** Whether this channel is a DM or Group DM. */
+  isDM() {
+    return this.type === ChannelType.DM || this.type === ChannelType.GroupDM;
+  }
+  /** Whether this channel is voice-based (VoiceChannel). */
+  isVoice() {
+    return "bitrate" in this;
+  }
+  /** Create a DM channel from API data (type DM or GroupDM). */
+  static createDM(client, data) {
+    return new DMChannel(client, data);
+  }
+  client;
+  id;
+  type;
+  /** Channel name. Guild channels and Group DMs have names; 1:1 DMs are typically null. */
+  name;
+  /** Channel icon hash (Group DMs). Null if none. */
+  icon;
+  /** ISO timestamp when the last message was pinned. Null if never pinned. */
+  lastPinTimestamp;
+  /** @param data - API channel from GET /channels/{id} or GET /guilds/{id}/channels */
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.type = data.type;
+    this.name = data.name ?? null;
+    this.icon = data.icon ?? null;
+    this.lastPinTimestamp = data.last_pin_timestamp ?? null;
+  }
+  /**
+   * Create the appropriate channel subclass from API data.
+   * @param client - The client instance
+   * @param data - Channel data from the API
+   */
+  static from(client, data) {
+    const type = data.type ?? 0;
+    if (type === ChannelType.GuildText) return new TextChannel(client, data);
+    if (type === ChannelType.GuildCategory) return new CategoryChannel(client, data);
+    if (type === ChannelType.GuildVoice) return new VoiceChannel(client, data);
+    if (type === ChannelType.GuildLink || type === ChannelType.GuildLinkExtended)
+      return new LinkChannel(client, data);
+    return new GuildChannel(client, data);
+  }
+  /**
+   * Create a channel from API data, including DM and GroupDM.
+   * Used by ChannelManager.fetch() for GET /channels/{id}.
+   */
+  static fromOrCreate(client, data) {
+    const type = data.type ?? 0;
+    if (type === ChannelType.DM || type === ChannelType.GroupDM)
+      return _Channel.createDM(client, data);
+    return _Channel.from(client, data);
+  }
+};
+var GuildChannel = class extends Channel {
+  guildId;
+  name;
+  position;
+  parentId;
+  /** Permission overwrites for roles and members. */
+  permissionOverwrites;
+  constructor(client, data) {
+    super(client, data);
+    this.guildId = data.guild_id ?? "";
+    this.name = data.name ?? null;
+    this.position = data.position;
+    this.parentId = data.parent_id ?? null;
+    this.permissionOverwrites = data.permission_overwrites ?? [];
+  }
+  /**
+   * Create a webhook in this channel.
+   * @param options - Webhook name and optional avatar URL
+   * @returns The webhook with token (required for send()). Requires Manage Webhooks permission.
+   */
+  async createWebhook(options) {
+    const { Webhook } = await import("./Webhook-NPIXOCEH.mjs");
+    const data = await this.client.rest.post(Routes.channelWebhooks(this.id), {
+      body: options,
+      auth: true
+    });
+    return new Webhook(this.client, data);
+  }
+  /**
+   * Fetch all webhooks in this channel.
+   * @returns Webhooks (includes token when listing from channel; can send via send())
+   */
+  async fetchWebhooks() {
+    const { Webhook } = await import("./Webhook-NPIXOCEH.mjs");
+    const data = await this.client.rest.get(Routes.channelWebhooks(this.id));
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    return list.map((w) => new Webhook(this.client, w));
+  }
+};
+var TextChannel = class extends GuildChannel {
+  topic;
+  nsfw;
+  rateLimitPerUser;
+  lastMessageId;
+  constructor(client, data) {
+    super(client, data);
+    this.topic = data.topic ?? null;
+    this.nsfw = data.nsfw ?? false;
+    this.rateLimitPerUser = data.rate_limit_per_user ?? 0;
+    this.lastMessageId = data.last_message_id ?? null;
+  }
+  /**
+   * Send a message to this channel.
+   * @param options - Text content or object with content, embeds, and/or files
+   */
+  async send(options) {
+    const opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    const { Message } = await import("./Message-C4A23STA.mjs");
+    const postOptions = opts.files?.length ? { body, files: opts.files } : { body };
+    const data = await this.client.rest.post(Routes.channelMessages(this.id), postOptions);
+    return new Message(this.client, data);
+  }
+  /** Message manager for this channel. Use channel.messages.fetch(messageId). */
+  get messages() {
+    return new MessageManager(this.client, this.id);
+  }
+  /**
+   * Create a message collector for this channel.
+   * Collects messages matching the filter until time expires or max is reached.
+   * @param options - Filter, time (ms), and max count
+   * @example
+   * const collector = channel.createMessageCollector({ filter: m => m.author.id === userId, time: 10000 });
+   * collector.on('collect', m => console.log(m.content));
+   * collector.on('end', (collected, reason) => { ... });
+   */
+  createMessageCollector(options) {
+    return new MessageCollector(this.client, this.id, options);
+  }
+  /**
+   * Fetch pinned messages in this channel.
+   * @returns Pinned messages
+   */
+  async fetchPinnedMessages() {
+    const { Message } = await import("./Message-C4A23STA.mjs");
+    const data = await this.client.rest.get(Routes.channelPins(this.id));
+    const list = Array.isArray(data) ? data : data?.items ?? [];
+    return list.map((item) => {
+      const msg = typeof item === "object" && item && "message" in item ? item.message : item;
+      return new Message(this.client, msg);
+    });
+  }
+  /**
+   * Fetch a message by ID from this channel.
+   * @param messageId - Snowflake of the message
+   * @returns The message, or null if not found
+   * @deprecated Use channel.messages.fetch(messageId) instead.
+   */
+  async fetchMessage(messageId) {
+    return this.client.channels.fetchMessage(this.id, messageId);
+  }
+};
+var CategoryChannel = class extends GuildChannel {
+};
+var VoiceChannel = class extends GuildChannel {
+  bitrate;
+  userLimit;
+  rtcRegion;
+  constructor(client, data) {
+    super(client, data);
+    this.bitrate = data.bitrate ?? null;
+    this.userLimit = data.user_limit ?? null;
+    this.rtcRegion = data.rtc_region ?? null;
+  }
+};
+var LinkChannel = class extends GuildChannel {
+  url;
+  constructor(client, data) {
+    super(client, data);
+    this.url = data.url ?? null;
+  }
+};
+var DMChannel = class extends Channel {
+  lastMessageId;
+  /** Group DM creator ID. Null for 1:1 DMs. */
+  ownerId;
+  /** Group DM recipients as User objects. Empty for 1:1 DMs. */
+  recipients;
+  /** Group DM member display names (userId -> nickname). */
+  nicks;
+  constructor(client, data) {
+    super(client, data);
+    this.lastMessageId = data.last_message_id ?? null;
+    this.ownerId = data.owner_id ?? null;
+    this.recipients = (data.recipients ?? []).map(
+      (u) => client.getOrCreateUser(u)
+    );
+    this.nicks = data.nicks ?? {};
+  }
+  /**
+   * Send a message to this DM channel.
+   * @param options - Text content or object with content, embeds, and/or files
+   */
+  async send(options) {
+    const opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    const { Message } = await import("./Message-C4A23STA.mjs");
+    const postOptions = opts.files?.length ? { body, files: opts.files } : { body };
+    const data = await this.client.rest.post(Routes.channelMessages(this.id), postOptions);
+    return new Message(this.client, data);
+  }
+  /** Message manager for this channel. Use channel.messages.fetch(messageId). */
+  get messages() {
+    return new MessageManager(this.client, this.id);
+  }
+  /**
+   * Create a message collector for this DM channel.
+   * @param options - Filter, time (ms), and max count
+   */
+  createMessageCollector(options) {
+    return new MessageCollector(this.client, this.id, options);
+  }
+  /**
+   * Fetch pinned messages in this DM channel.
+   * @returns Pinned messages
+   */
+  async fetchPinnedMessages() {
+    const { Message } = await import("./Message-C4A23STA.mjs");
+    const data = await this.client.rest.get(Routes.channelPins(this.id));
+    const list = Array.isArray(data) ? data : data?.items ?? [];
+    return list.map((item) => {
+      const msg = typeof item === "object" && item && "message" in item ? item.message : item;
+      return new Message(this.client, msg);
+    });
+  }
+  /**
+   * Fetch a message by ID from this DM channel.
+   * @param messageId - Snowflake of the message
+   * @returns The message, or null if not found
+   * @deprecated Use channel.messages.fetch(messageId) instead.
+   */
+  async fetchMessage(messageId) {
+    return this.client.channels.fetchMessage(this.id, messageId);
+  }
+};
+
+export {
+  MessageManager,
+  MessageCollector,
+  Channel,
+  GuildChannel,
+  TextChannel,
+  CategoryChannel,
+  VoiceChannel,
+  LinkChannel,
+  DMChannel
+};

package/dist/chunk-O77KTDMH.mjs

@@ -0,0 +1,44 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Role.ts
+var Role = class extends Base {
+  client;
+  id;
+  guildId;
+  name;
+  color;
+  position;
+  permissions;
+  hoist;
+  mentionable;
+  unicodeEmoji;
+  /** Separately sorted position for hoisted roles. Null if not set. */
+  hoistPosition;
+  /** @param client - The client instance */
+  /** @param data - API role from GET /guilds/{id}/roles or gateway role events */
+  /** @param guildId - The guild this role belongs to */
+  constructor(client, data, guildId) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.guildId = guildId;
+    this.name = data.name;
+    this.color = data.color;
+    this.position = data.position;
+    this.permissions = data.permissions;
+    this.hoist = !!data.hoist;
+    this.mentionable = !!data.mentionable;
+    this.unicodeEmoji = data.unicode_emoji ?? null;
+    this.hoistPosition = data.hoist_position ?? null;
+  }
+  /** Returns a mention string (e.g. `<@&123456>`). */
+  toString() {
+    return `<@&${this.id}>`;
+  }
+};
+
+export {
+  Role
+};

package/dist/chunk-OALSL7C2.mjs

@@ -0,0 +1,212 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Message.ts
+import { Collection } from "@fluxerjs/collection";
+import { MessageType, 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;
+  type;
+  flags;
+  mentionEveryone;
+  tts;
+  embeds;
+  stickers;
+  reactions;
+  messageReference;
+  messageSnapshots;
+  call;
+  referencedMessage;
+  /** Webhook ID if this message was sent via webhook. Null otherwise. */
+  webhookId;
+  /** Users mentioned in this message. */
+  mentions;
+  /** Role IDs mentioned in this message. */
+  mentionRoles;
+  /** Client-side nonce for acknowledgment. Null if not provided. */
+  nonce;
+  /** Channel where this message was sent. Resolved from cache; null if not cached (e.g. DM channel not in cache). */
+  get channel() {
+    return this.client.channels.get(this.channelId) ?? null;
+  }
+  /** Guild where this message was sent. Resolved from cache; null for DMs or if not cached. */
+  get guild() {
+    return this.guildId ? this.client.guilds.get(this.guildId) ?? null : null;
+  }
+  /** @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);
+    this.type = data.type ?? MessageType.Default;
+    this.flags = data.flags ?? 0;
+    this.mentionEveryone = data.mention_everyone ?? false;
+    this.tts = data.tts ?? false;
+    this.embeds = data.embeds ?? [];
+    this.stickers = data.stickers ?? [];
+    this.reactions = data.reactions ?? [];
+    this.messageReference = data.message_reference ?? null;
+    this.messageSnapshots = data.message_snapshots ?? [];
+    this.call = data.call ?? null;
+    this.referencedMessage = data.referenced_message ? new _Message(client, data.referenced_message) : null;
+    this.webhookId = data.webhook_id ?? null;
+    this.mentions = (data.mentions ?? []).map((u) => client.getOrCreateUser(u));
+    this.mentionRoles = data.mention_roles ?? [];
+    this.nonce = data.nonce ?? null;
+  }
+  /**
+   * 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);
+  }
+  /**
+   * Re-fetch this message from the API to get the latest content, embeds, reactions, etc.
+   * Use when you have a stale Message (e.g. from an old event or cache) and need fresh data.
+   * @returns The updated message, or null if deleted or not found
+   * @example
+   * const updated = await message.fetch();
+   * if (updated) console.log('Latest content:', updated.content);
+   */
+  async fetch() {
+    return this.client.channels.fetchMessage(this.channelId, this.id);
+  }
+  /** Delete this message. */
+  async delete() {
+    await this.client.rest.delete(Routes.channelMessage(this.channelId, this.id));
+  }
+  /** Pin this message to the channel. Requires Manage Messages permission. */
+  async pin() {
+    await this.client.rest.put(Routes.channelPinMessage(this.channelId, this.id));
+    this.pinned = true;
+  }
+  /** Unpin this message from the channel. Requires Manage Messages permission. */
+  async unpin() {
+    await this.client.rest.delete(Routes.channelPinMessage(this.channelId, this.id));
+    this.pinned = false;
+  }
+  /**
+   * 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
+};