@fluxerjs/core 1.1.7 → 1.1.8

package/dist/chunk-GIIJQKAV.mjs

@@ -0,0 +1,164 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// 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;
+  /** @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;
+  }
+  /**
+   * 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;
+  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;
+  }
+  /**
+   * 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-2MQESB7Z.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-2MQESB7Z.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` and/or `embeds`
+   */
+  async send(options) {
+    const body = typeof options === "string" ? { content: options } : options;
+    const { Message } = await import("./Message-O4CXWR57.mjs");
+    const data = await this.client.rest.post(Routes.channelMessages(this.id), { body });
+    return new Message(this.client, data);
+  }
+};
+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;
+  constructor(client, data) {
+    super(client, data);
+    this.lastMessageId = data.last_message_id ?? null;
+  }
+  /**
+   * Send a message to this DM channel.
+   * @param options - Text content or object with `content` and/or `embeds`
+   */
+  async send(options) {
+    const body = typeof options === "string" ? { content: options } : options;
+    const { Message } = await import("./Message-O4CXWR57.mjs");
+    const data = await this.client.rest.post(Routes.channelMessages(this.id), { body });
+    return new Message(this.client, data);
+  }
+};
+
+export {
+  Channel,
+  GuildChannel,
+  TextChannel,
+  CategoryChannel,
+  VoiceChannel,
+  LinkChannel,
+  DMChannel
+};

package/dist/chunk-GUNWHOQO.mjs

@@ -0,0 +1,42 @@
+import {
+  CDN_URL
+} from "./chunk-HQMYRYMY.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Guild.ts
+import { Collection } from "@fluxerjs/collection";
+var Guild = class extends Base {
+  client;
+  id;
+  name;
+  icon;
+  banner;
+  ownerId;
+  members = new Collection();
+  channels = new Collection();
+  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;
+  }
+  iconURL(options) {
+    if (!this.icon) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/icons/${this.id}/${this.icon}.png${size}`;
+  }
+  bannerURL(options) {
+    if (!this.banner) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/banners/${this.id}/${this.banner}.png${size}`;
+  }
+};
+
+export {
+  Guild
+};

package/dist/chunk-GWSLXZES.mjs

@@ -0,0 +1,263 @@
+import {
+  GuildMember
+} from "./chunk-EC4ES5VH.mjs";
+import {
+  CDN_URL
+} from "./chunk-HQMYRYMY.mjs";
+import {
+  Role
+} from "./chunk-DQ4TNBPG.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Guild.ts
+import { parseRoleMention } from "@fluxerjs/util";
+import { FluxerAPIError } from "@fluxerjs/rest";
+
+// src/errors/FluxerError.ts
+var FluxerError = class _FluxerError extends Error {
+  code;
+  constructor(message, options) {
+    super(message, options?.cause ? { cause: options.cause } : void 0);
+    this.name = "FluxerError";
+    this.code = options?.code;
+    Object.setPrototypeOf(this, _FluxerError.prototype);
+  }
+};
+
+// src/errors/ErrorCodes.ts
+var ErrorCodes = {
+  ClientNotReady: "CLIENT_NOT_READY",
+  InvalidToken: "INVALID_TOKEN",
+  AlreadyLoggedIn: "ALREADY_LOGGED_IN",
+  ChannelNotFound: "CHANNEL_NOT_FOUND",
+  MessageNotFound: "MESSAGE_NOT_FOUND",
+  GuildNotFound: "GUILD_NOT_FOUND",
+  MemberNotFound: "MEMBER_NOT_FOUND"
+};
+
+// src/structures/Guild.ts
+import { Collection } from "@fluxerjs/collection";
+import { Routes } from "@fluxerjs/types";
+var Guild = class extends Base {
+  client;
+  id;
+  name;
+  icon;
+  banner;
+  ownerId;
+  /** Invite splash image hash. Null if none. */
+  splash;
+  /** Custom vanity URL code (e.g. fluxer.gg/code). Null if none. */
+  vanityURLCode;
+  /** Enabled guild features. */
+  features;
+  verificationLevel;
+  defaultMessageNotifications;
+  explicitContentFilter;
+  /** AFK voice channel ID. Null if none. */
+  afkChannelId;
+  /** AFK timeout in seconds. */
+  afkTimeout;
+  /** System messages channel ID. Null if none. */
+  systemChannelId;
+  /** Rules/guidelines channel ID. Null if none. */
+  rulesChannelId;
+  nsfwLevel;
+  mfaLevel;
+  /** Banner image width. Optional. */
+  bannerWidth;
+  /** Banner image height. Optional. */
+  bannerHeight;
+  /** Splash image width. Optional. */
+  splashWidth;
+  /** Splash image height. Optional. */
+  splashHeight;
+  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;
+    this.splash = data.splash ?? null;
+    this.vanityURLCode = data.vanity_url_code ?? null;
+    this.features = data.features ?? [];
+    this.verificationLevel = data.verification_level ?? 0;
+    this.defaultMessageNotifications = data.default_message_notifications ?? 0;
+    this.explicitContentFilter = data.explicit_content_filter ?? 0;
+    this.afkChannelId = data.afk_channel_id ?? null;
+    this.afkTimeout = data.afk_timeout ?? 0;
+    this.systemChannelId = data.system_channel_id ?? null;
+    this.rulesChannelId = data.rules_channel_id ?? null;
+    this.nsfwLevel = data.nsfw_level ?? 0;
+    this.mfaLevel = data.mfa_level ?? 0;
+    this.bannerWidth = data.banner_width ?? null;
+    this.bannerHeight = data.banner_height ?? null;
+    this.splashWidth = data.splash_width ?? null;
+    this.splashHeight = data.splash_height ?? null;
+    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}`;
+  }
+  /** Get the guild splash (invite background) URL, or null if no splash. */
+  splashURL(options) {
+    if (!this.splash) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/splashes/${this.id}/${this.splash}.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;
+  }
+  /**
+   * Ban a user from this guild.
+   * @param userId - The user ID to ban
+   * @param options - Optional reason and delete_message_seconds (0–604800, 7 days max)
+   * Requires Ban Members permission.
+   */
+  async ban(userId, options) {
+    const body = {};
+    if (options?.reason) body.reason = options.reason;
+    if (options?.delete_message_seconds != null) body.delete_message_seconds = options.delete_message_seconds;
+    await this.client.rest.put(Routes.guildBan(this.id, userId), {
+      body: Object.keys(body).length ? body : void 0,
+      auth: true
+    });
+  }
+  /**
+   * Fetch guild bans. Requires Ban Members permission.
+   * @returns List of GuildBan objects
+   */
+  async fetchBans() {
+    const { GuildBan } = await import("./GuildBan-M4PA3HAA.mjs");
+    const data = await this.client.rest.get(Routes.guildBans(this.id));
+    const list = Array.isArray(data) ? data : data?.bans ?? [];
+    return list.map((b) => new GuildBan(this.client, { ...b, guild_id: this.id }, this.id));
+  }
+  /**
+   * Remove a ban (unban a user).
+   * @param userId - The user ID to unban
+   * Requires Ban Members permission.
+   */
+  async unban(userId) {
+    await this.client.rest.delete(Routes.guildBan(this.id, userId), { auth: true });
+  }
+  /**
+   * Kick a member from this guild.
+   * @param userId - The user ID to kick
+   * Requires Kick Members permission.
+   */
+  async kick(userId) {
+    await this.client.rest.delete(Routes.guildMember(this.id, userId), { auth: true });
+  }
+  /**
+   * Fetch a guild member by user ID.
+   * @param userId - The user ID of the member to fetch
+   * @returns The guild member
+   * @throws FluxerError with MEMBER_NOT_FOUND if user is not in the guild (404)
+   * @throws FluxerError with cause for permission denied (403) or other REST errors
+   */
+  async fetchMember(userId) {
+    try {
+      const data = await this.client.rest.get(
+        Routes.guildMember(this.id, userId)
+      );
+      const member = new GuildMember(this.client, { ...data, guild_id: this.id }, this);
+      this.members.set(member.id, member);
+      return member;
+    } catch (err) {
+      const statusCode = err instanceof FluxerAPIError ? err.statusCode : err?.statusCode;
+      if (statusCode === 404) {
+        throw new FluxerError(`Member ${userId} not found in guild`, {
+          code: ErrorCodes.MemberNotFound,
+          cause: err
+        });
+      }
+      throw err instanceof FluxerError ? err : new FluxerError("Failed to fetch guild member", { cause: err });
+    }
+  }
+  /**
+   * Fetch guild audit logs. Requires View Audit Log permission.
+   * @param options - Optional limit, before, after, user_id, action_type for filtering
+   */
+  async fetchAuditLogs(options) {
+    const params = new URLSearchParams();
+    if (options?.limit != null) params.set("limit", String(options.limit));
+    if (options?.before) params.set("before", options.before);
+    if (options?.after) params.set("after", options.after);
+    if (options?.userId) params.set("user_id", options.userId);
+    if (options?.actionType != null) params.set("action_type", String(options.actionType));
+    const qs = params.toString();
+    const url = Routes.guildAuditLogs(this.id) + (qs ? `?${qs}` : "");
+    return this.client.rest.get(url);
+  }
+  /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
+  async fetchWebhooks() {
+    const { Webhook } = await import("./Webhook-NPIXOCEH.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 {
+  FluxerError,
+  ErrorCodes,
+  Guild
+};

package/dist/chunk-H5KYMLLB.mjs

@@ -0,0 +1,14 @@
+import {
+  User
+} from "./chunk-MSMABD52.mjs";
+
+// src/client/ClientUser.ts
+var ClientUser = class extends User {
+  constructor(client, data) {
+    super(client, { ...data });
+  }
+};
+
+export {
+  ClientUser
+};

package/dist/chunk-HAUQAFOF.mjs

@@ -0,0 +1,97 @@
+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;
+  /** RGB avatar color (e.g. 7577782). Null if not set. */
+  avatarColor;
+  /** Public flags bitfield. Null if not set. */
+  flags;
+  /** Whether this is an official system user. */
+  system;
+  /** @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;
+    this.avatarColor = data.avatar_color ?? null;
+    this.flags = data.flags ?? data.public_flags ?? null;
+    this.system = !!data.system;
+  }
+  /** 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;
+    if (data.avatar_color !== void 0) this.avatarColor = data.avatar_color;
+    if (data.flags !== void 0) this.flags = data.flags;
+  }
+  /**
+   * 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-EZSBZJTJ.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-HBF5QEDH.mjs

@@ -0,0 +1,42 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/MessageReaction.ts
+var MessageReaction = class extends Base {
+  client;
+  messageId;
+  channelId;
+  guildId;
+  emoji;
+  /** Raw gateway payload for low-level access. */
+  _data;
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this._data = data;
+    this.messageId = data.message_id;
+    this.channelId = data.channel_id;
+    this.guildId = data.guild_id ?? null;
+    this.emoji = data.emoji;
+  }
+  /** Emoji as a string: unicode or "name:id" for custom. */
+  get emojiIdentifier() {
+    return this.emoji.id ? `${this.emoji.name}:${this.emoji.id}` : this.emoji.name;
+  }
+  /** Guild where this reaction was added. Resolved from cache; null for DMs or if not cached. */
+  get guild() {
+    return this.guildId ? this.client.guilds.get(this.guildId) ?? null : null;
+  }
+  /**
+   * Fetch the message this reaction belongs to.
+   * Use when you need to edit, delete, or otherwise interact with the message.
+   */
+  async fetchMessage() {
+    return this.client.channels.fetchMessage(this.channelId, this.messageId);
+  }
+};
+
+export {
+  MessageReaction
+};