@fluxerjs/core 1.1.7 → 1.1.8

package/dist/chunk-RTSLRXJC.mjs

@@ -0,0 +1,122 @@
+import {
+  CDN_URL
+} from "./chunk-HQMYRYMY.mjs";
+import {
+  GuildMember
+} from "./chunk-JVEOQFUX.mjs";
+import {
+  Role
+} from "./chunk-SQVCCSNN.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Guild.ts
+import { parseRoleMention } from "@fluxerjs/util";
+import { Collection } from "@fluxerjs/collection";
+import { Routes } from "@fluxerjs/types";
+var Guild = class extends Base {
+  client;
+  id;
+  name;
+  icon;
+  banner;
+  ownerId;
+  members = new Collection();
+  channels = new Collection();
+  roles = new Collection();
+  /** @param data - API guild from GET /guilds/{id} or gateway GUILD_CREATE */
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.name = data.name;
+    this.icon = data.icon ?? null;
+    this.banner = data.banner ?? null;
+    this.ownerId = data.owner_id;
+    for (const r of data.roles ?? []) {
+      this.roles.set(r.id, new Role(client, r, this.id));
+    }
+  }
+  /** Get the guild icon URL, or null if no icon. */
+  iconURL(options) {
+    if (!this.icon) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/icons/${this.id}/${this.icon}.png${size}`;
+  }
+  /** Get the guild banner URL, or null if no banner. */
+  bannerURL(options) {
+    if (!this.banner) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/banners/${this.id}/${this.banner}.png${size}`;
+  }
+  /**
+   * Add a role to a member by user ID. Does not require fetching the member first.
+   * @param userId - The user ID of the member
+   * @param roleId - The role ID to add (or use guild.resolveRoleId for mention/name resolution)
+   * Requires Manage Roles permission.
+   */
+  async addRoleToMember(userId, roleId) {
+    await this.client.rest.put(Routes.guildMemberRole(this.id, userId, roleId));
+  }
+  /**
+   * Remove a role from a member by user ID. Does not require fetching the member first.
+   * @param userId - The user ID of the member
+   * @param roleId - The role ID to remove
+   * Requires Manage Roles permission.
+   */
+  async removeRoleFromMember(userId, roleId) {
+    await this.client.rest.delete(Routes.guildMemberRole(this.id, userId, roleId));
+  }
+  /**
+   * Resolve a role ID from an argument (role mention, raw ID, or name).
+   * Fetches guild roles if name is provided.
+   * @param arg - Role mention (@role), role ID, or role name
+   * @returns The role ID, or null if not found
+   */
+  async resolveRoleId(arg) {
+    const parsed = parseRoleMention(arg);
+    if (parsed) return parsed;
+    if (/^\d{17,19}$/.test(arg.trim())) return arg.trim();
+    const cached = this.roles.find(
+      (r) => !!(r.name && r.name.toLowerCase() === arg.trim().toLowerCase())
+    );
+    if (cached) return cached.id;
+    const roles = await this.client.rest.get(Routes.guildRoles(this.id));
+    const list = Array.isArray(roles) ? roles : Object.values(roles ?? {});
+    const role = list.find(
+      (r) => !!(r.name && r.name.toLowerCase() === arg.trim().toLowerCase())
+    );
+    if (role) {
+      this.roles.set(role.id, new Role(this.client, role, this.id));
+      return role.id;
+    }
+    return null;
+  }
+  /**
+   * Fetch a guild member by user ID.
+   * @param userId - The user ID of the member to fetch
+   * @returns The guild member, or null if not found
+   */
+  async fetchMember(userId) {
+    try {
+      const data = await this.client.rest.get(
+        Routes.guildMember(this.id, userId)
+      );
+      return new GuildMember(this.client, { ...data, guild_id: this.id }, this);
+    } catch {
+      return null;
+    }
+  }
+  /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
+  async fetchWebhooks() {
+    const { Webhook } = await import("./Webhook-2MQESB7Z.mjs");
+    const data = await this.client.rest.get(Routes.guildWebhooks(this.id));
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    return list.map((w) => new Webhook(this.client, w));
+  }
+};
+
+export {
+  Guild
+};

package/dist/chunk-RWFKZ3DF.mjs

@@ -0,0 +1,413 @@
+import {
+  ErrorCodes,
+  FluxerError
+} from "./chunk-V6T5VMWD.mjs";
+import {
+  Events
+} from "./chunk-AH7KYH2Z.mjs";
+import {
+  buildSendBody
+} from "./chunk-PM2IUGNR.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/client/MessageManager.ts
+import { Routes } from "@fluxerjs/types";
+import { FluxerAPIError, RateLimitError } from "@fluxerjs/rest";
+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) {
+    try {
+      const { Message } = await import("./Message-OFIVTTAZ.mjs");
+      const data = await this.client.rest.get(
+        Routes.channelMessage(this.channelId, messageId)
+      );
+      return new Message(this.client, data);
+    } catch (err) {
+      if (err instanceof RateLimitError) throw err;
+      if (err instanceof FluxerAPIError && err.statusCode === 404) {
+        throw new FluxerError(`Message ${messageId} not found in channel ${this.channelId}`, {
+          code: ErrorCodes.MessageNotFound,
+          cause: err
+        });
+      }
+      throw err instanceof FluxerError ? err : new FluxerError(String(err), { cause: err });
+    }
+  }
+};
+
+// 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 as Routes2 } from "@fluxerjs/types";
+import { emitDeprecationWarning } from "@fluxerjs/util";
+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);
+  }
+  /**
+   * Bulk delete messages. Requires Manage Messages permission.
+   * @param messageIds - Array of message IDs to delete (2–100)
+   */
+  async bulkDeleteMessages(messageIds) {
+    await this.client.rest.post(Routes2.channelBulkDelete(this.id), {
+      body: { message_ids: messageIds },
+      auth: true
+    });
+  }
+  /**
+   * Send a typing indicator to the channel. Lasts ~10 seconds.
+   */
+  async sendTyping() {
+    await this.client.rest.post(Routes2.channelTyping(this.id), { auth: true });
+  }
+};
+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-RWDDYW2Q.mjs");
+    const data = await this.client.rest.post(Routes2.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-RWDDYW2Q.mjs");
+    const data = await this.client.rest.get(Routes2.channelWebhooks(this.id));
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    return list.map((w) => new Webhook(this.client, w));
+  }
+  /**
+   * Create an invite for this channel.
+   * @param options - max_uses (0–100), max_age (0–604800 seconds), unique, temporary
+   * Requires Create Instant Invite permission.
+   */
+  async createInvite(options) {
+    const { Invite } = await import("./Invite-UM5BU5A6.mjs");
+    const body = {};
+    if (options?.max_uses != null) body.max_uses = options.max_uses;
+    if (options?.max_age != null) body.max_age = options.max_age;
+    if (options?.unique != null) body.unique = options.unique;
+    if (options?.temporary != null) body.temporary = options.temporary;
+    const data = await this.client.rest.post(Routes2.channelInvites(this.id), {
+      body: Object.keys(body).length ? body : void 0,
+      auth: true
+    });
+    return new Invite(this.client, data);
+  }
+  /**
+   * Fetch invites for this channel.
+   * Requires Manage Channel permission.
+   */
+  async fetchInvites() {
+    const { Invite } = await import("./Invite-UM5BU5A6.mjs");
+    const data = await this.client.rest.get(Routes2.channelInvites(this.id));
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    return list.map((i) => new Invite(this.client, i));
+  }
+};
+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-OFIVTTAZ.mjs");
+    const postOptions = opts.files?.length ? { body, files: opts.files } : { body };
+    const data = await this.client.rest.post(Routes2.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-OFIVTTAZ.mjs");
+    const data = await this.client.rest.get(Routes2.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) {
+    emitDeprecationWarning(
+      "Channel.fetchMessage()",
+      "Use channel.messages.fetch(messageId) instead."
+    );
+    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-OFIVTTAZ.mjs");
+    const postOptions = opts.files?.length ? { body, files: opts.files } : { body };
+    const data = await this.client.rest.post(Routes2.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-OFIVTTAZ.mjs");
+    const data = await this.client.rest.get(Routes2.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) {
+    emitDeprecationWarning(
+      "Channel.fetchMessage()",
+      "Use channel.messages.fetch(messageId) instead."
+    );
+    return this.client.channels.fetchMessage(this.id, messageId);
+  }
+};
+
+export {
+  MessageManager,
+  MessageCollector,
+  Channel,
+  GuildChannel,
+  TextChannel,
+  CategoryChannel,
+  VoiceChannel,
+  LinkChannel,
+  DMChannel
+};

package/dist/chunk-RWZ3ORIM.mjs

@@ -0,0 +1,136 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Webhook.ts
+import { Routes } from "@fluxerjs/types";
+import { EmbedBuilder } from "@fluxerjs/builders";
+function buildWebhookBody(options) {
+  const body = typeof options === "string" ? { content: options } : { ...options };
+  if (body.embeds && Array.isArray(body.embeds) && body.embeds.length > 0) {
+    body.embeds = body.embeds.map(
+      (e) => e instanceof EmbedBuilder ? e.toJSON() : e
+    );
+  }
+  return body;
+}
+var Webhook = class _Webhook extends Base {
+  client;
+  id;
+  guildId;
+  channelId;
+  name;
+  avatar;
+  /** Present only when webhook was created via createWebhook(); not returned when fetching. */
+  token;
+  /** User who created the webhook. */
+  user;
+  /** @param data - API webhook from POST /channels/{id}/webhooks (has token) or GET /webhooks/{id} (no token) */
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.guildId = data.guild_id;
+    this.channelId = data.channel_id;
+    this.name = data.name ?? "Unknown";
+    this.avatar = data.avatar ?? null;
+    this.token = data.token ?? null;
+    this.user = client.getOrCreateUser(data.user);
+  }
+  /** Delete this webhook. Requires bot token with Manage Webhooks permission. */
+  async delete() {
+    await this.client.rest.delete(Routes.webhook(this.id), { auth: true });
+  }
+  /**
+   * Edit this webhook. With token: name and avatar only. Without token (bot auth): name, avatar, and channel_id.
+   * @param options - Fields to update (name, avatar, channel_id when using bot auth)
+   * @returns This webhook instance with updated fields
+   */
+  async edit(options) {
+    const body = {};
+    if (options.name !== void 0) body.name = options.name;
+    if (options.avatar !== void 0) body.avatar = options.avatar;
+    if ("channel_id" in options && options.channel_id !== void 0 && !this.token) {
+      body.channel_id = options.channel_id;
+    }
+    if (this.token) {
+      const data2 = await this.client.rest.patch(Routes.webhookExecute(this.id, this.token), {
+        body,
+        auth: false
+      });
+      const w2 = data2;
+      this.name = w2.name ?? this.name;
+      this.avatar = w2.avatar ?? null;
+      return this;
+    }
+    const data = await this.client.rest.patch(Routes.webhook(this.id), {
+      body,
+      auth: true
+    });
+    const w = data;
+    this.name = w.name ?? this.name;
+    this.avatar = w.avatar ?? null;
+    this.channelId = w.channel_id ?? this.channelId;
+    return this;
+  }
+  /**
+   * Send a message via this webhook. Requires the webhook token (only present when created, not when fetched).
+   * @param options - Text content or object with content, embeds (APIEmbed | EmbedBuilder), username, avatar_url, tts
+   * @param wait - If true, waits for the API and returns the created Message; otherwise returns void (204)
+   * @throws Error if token is not available
+   * @example
+   * await webhook.send('Hello!');
+   * await webhook.send({ embeds: [embed.toJSON()] });
+   * const msg = await webhook.send({ content: 'Hi' }, true);
+   */
+  async send(options, wait) {
+    if (!this.token) {
+      throw new Error(
+        "Webhook token is required to send. The token is only returned when creating a webhook; fetched webhooks cannot send."
+      );
+    }
+    const body = buildWebhookBody(options);
+    const route = Routes.webhookExecute(this.id, this.token) + (wait ? "?wait=true" : "");
+    const data = await this.client.rest.post(
+      route,
+      { body, auth: false }
+    );
+    if (wait && data) {
+      const { Message } = await import("./Message-ONWLVMU7.mjs");
+      return new Message(this.client, data);
+    }
+    return void 0;
+  }
+  /**
+   * Fetch a webhook by ID using bot auth.
+   * @param client - The client instance
+   * @param webhookId - The webhook ID
+   * @returns Webhook without token (cannot send)
+   */
+  static async fetch(client, webhookId) {
+    const data = await client.rest.get(Routes.webhook(webhookId));
+    return new _Webhook(client, data);
+  }
+  /**
+   * Create a Webhook instance from an ID and token (e.g. from a stored webhook URL).
+   * @param client - The client instance
+   * @param webhookId - The webhook ID
+   * @param token - The webhook token (from createWebhook or stored)
+   * @param options - Optional channelId, guildId, name for display
+   */
+  static fromToken(client, webhookId, token, options) {
+    return new _Webhook(client, {
+      id: webhookId,
+      guild_id: options?.guildId ?? "",
+      channel_id: options?.channelId ?? "",
+      name: options?.name ?? "Webhook",
+      avatar: null,
+      token,
+      user: { id: "", username: "webhook", discriminator: "0" }
+    });
+  }
+};
+
+export {
+  Webhook
+};