@fluxerjs/core 1.1.9 → 1.2.1

package/dist/chunk-BMAFJS7T.mjs

@@ -1,575 +0,0 @@
-import {
-  ErrorCodes,
-  FluxerError
-} from "./chunk-PU73YRKJ.mjs";
-import {
-  GuildMember
-} from "./chunk-5JEDVRKU.mjs";
-import {
-  CDN_URL
-} from "./chunk-HQMYRYMY.mjs";
-import {
-  Role
-} from "./chunk-2ZSMLDEI.mjs";
-import {
-  Base
-} from "./chunk-XNS4O6QJ.mjs";
-
-// src/structures/Guild.ts
-import {
-  parseRoleMention,
-  resolvePermissionsToBitfield
-} from "@fluxerjs/util";
-import { FluxerAPIError } from "@fluxerjs/rest";
-import { Collection as Collection2 } from "@fluxerjs/collection";
-
-// src/client/GuildMemberManager.ts
-import { Collection } from "@fluxerjs/collection";
-import { Routes } from "@fluxerjs/types";
-var GuildMemberManager = class extends Collection {
-  constructor(guild) {
-    super();
-    this.guild = guild;
-  }
-  /**
-   * The current bot user as a GuildMember in this guild.
-   * Returns null if the bot's member is not cached or client.user is null.
-   * Use fetchMe() to load the bot's member when not cached.
-   *
-   * @example
-   * const perms = guild.members.me?.permissions;
-   * if (perms?.has(PermissionFlags.BanMembers)) { ... }
-   */
-  get me() {
-    const userId = this.guild.client.user?.id;
-    return userId ? this.get(userId) ?? null : null;
-  }
-  /**
-   * Fetch the current bot user as a GuildMember in this guild.
-   * Caches the result in guild.members.
-   *
-   * @throws Error if client.user is null (client not ready)
-   * @example
-   * const me = await guild.members.fetchMe();
-   * console.log(me.displayName);
-   */
-  async fetchMe() {
-    const userId = this.guild.client.user?.id;
-    if (!userId) {
-      throw new Error("Cannot fetch me: client.user is null (client not ready)");
-    }
-    return this.guild.fetchMember(userId);
-  }
-  /**
-   * Fetch guild members with pagination. GET /guilds/{id}/members.
-   * @param options - limit (1-1000), after (user ID for pagination)
-   * @returns Array of GuildMember objects (cached in guild.members)
-   */
-  async fetch(options) {
-    const params = new URLSearchParams();
-    if (options?.limit != null) params.set("limit", String(options.limit));
-    if (options?.after) params.set("after", options.after);
-    const qs = params.toString();
-    const url = Routes.guildMembers(this.guild.id) + (qs ? `?${qs}` : "");
-    const data = await this.guild.client.rest.get(url, { auth: true });
-    const list = Array.isArray(data) ? data : data?.members ?? [];
-    const { GuildMember: GuildMember2 } = await import("./GuildMember-F5FZJOHD.mjs");
-    const members = [];
-    for (const m of list) {
-      const member = new GuildMember2(this.guild.client, { ...m, guild_id: this.guild.id }, this.guild);
-      this.set(member.id, member);
-      members.push(member);
-    }
-    return members;
-  }
-};
-
-// src/structures/Guild.ts
-import { Routes as Routes2 } 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;
-  channels = new Collection2();
-  roles = new Collection2();
-  /** @param data - API guild from GET /guilds/{id} or gateway GUILD_CREATE */
-  constructor(client, data) {
-    super();
-    this.client = client;
-    this.id = data.id;
-    this.members = new GuildMemberManager(this);
-    this.name = data.name;
-    this.icon = data.icon ?? null;
-    this.banner = data.banner ?? null;
-    this.ownerId = data.owner_id ?? data.ownerId ?? "";
-    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(Routes2.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(Routes2.guildMemberRole(this.id, userId, roleId));
-  }
-  /**
-   * Create a role in this guild.
-   * Requires Manage Roles permission.
-   * @param options - Role data (permissions accepts PermissionResolvable for convenience)
-   * @returns The created role
-   * @example
-   * const role = await guild.createRole({ name: 'Mod', permissions: ['KickMembers', 'BanMembers'] });
-   */
-  async createRole(options) {
-    const body = {};
-    if (options.name !== void 0) body.name = options.name;
-    if (options.permissions !== void 0) {
-      body.permissions = typeof options.permissions === "string" ? options.permissions : resolvePermissionsToBitfield(options.permissions);
-    }
-    if (options.color !== void 0) body.color = options.color;
-    if (options.hoist !== void 0) body.hoist = options.hoist;
-    if (options.mentionable !== void 0) body.mentionable = options.mentionable;
-    if (options.unicode_emoji !== void 0) body.unicode_emoji = options.unicode_emoji;
-    if (options.position !== void 0) body.position = options.position;
-    if (options.hoist_position !== void 0) body.hoist_position = options.hoist_position;
-    const data = await this.client.rest.post(Routes2.guildRoles(this.id), {
-      body: Object.keys(body).length ? body : void 0,
-      auth: true
-    });
-    const role = new Role(this.client, data, this.id);
-    this.roles.set(role.id, role);
-    return role;
-  }
-  /**
-   * Fetch all roles in this guild.
-   * @returns Array of Role objects (cached in guild.roles)
-   */
-  async fetchRoles() {
-    const data = await this.client.rest.get(
-      Routes2.guildRoles(this.id)
-    );
-    const list = Array.isArray(data) ? data : Object.values(data ?? {});
-    const roles = [];
-    for (const r of list) {
-      const role = new Role(this.client, r, this.id);
-      this.roles.set(role.id, role);
-      roles.push(role);
-    }
-    return roles;
-  }
-  /**
-   * Fetch a role by ID.
-   * @param roleId - The role ID to fetch
-   * @returns The role
-   * @throws FluxerError with ROLE_NOT_FOUND if role does not exist (404)
-   */
-  async fetchRole(roleId) {
-    try {
-      const data = await this.client.rest.get(Routes2.guildRole(this.id, roleId));
-      const role = new Role(this.client, data, this.id);
-      this.roles.set(role.id, role);
-      return role;
-    } catch (err) {
-      const statusCode = err instanceof FluxerAPIError ? err.statusCode : err?.statusCode;
-      if (statusCode === 404) {
-        throw new FluxerError(`Role ${roleId} not found in guild`, {
-          code: ErrorCodes.RoleNotFound,
-          cause: err
-        });
-      }
-      throw err instanceof FluxerError ? err : new FluxerError("Failed to fetch guild role", { cause: err });
-    }
-  }
-  /**
-   * 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(Routes2.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, delete_message_days (0–7), and ban_duration_seconds (temporary ban).
-   *   ban_duration_seconds: 0 = permanent, or use 3600, 43200, 86400, 259200, 432000, 604800, 1209600, 2592000.
-   * Requires Ban Members permission.
-   */
-  async ban(userId, options) {
-    const body = {};
-    if (options?.reason) body.reason = options.reason;
-    if (options?.delete_message_days != null)
-      body.delete_message_days = options.delete_message_days;
-    if (options?.ban_duration_seconds != null)
-      body.ban_duration_seconds = options.ban_duration_seconds;
-    await this.client.rest.put(Routes2.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-7CXLTPKY.mjs");
-    const data = await this.client.rest.get(Routes2.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(Routes2.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(Routes2.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(
-        Routes2.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 = Routes2.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-IWPKKMWD.mjs");
-    const data = await this.client.rest.get(Routes2.guildWebhooks(this.id));
-    const list = Array.isArray(data) ? data : Object.values(data ?? {});
-    return list.map((w) => new Webhook(this.client, w));
-  }
-  /**
-   * Create a channel in this guild.
-   * @param data - Channel data: type (0=text, 2=voice, 4=category, 5=link), name, and optional parent_id, topic, bitrate, user_limit, nsfw, permission_overwrites
-   * Requires Manage Channels permission.
-   */
-  async createChannel(data) {
-    const { Channel } = await import("./Channel-HK7VT35N.mjs");
-    const created = await this.client.rest.post(Routes2.guildChannels(this.id), {
-      body: data,
-      auth: true
-    });
-    const channel = Channel.from(this.client, created);
-    if (channel) {
-      this.client.channels.set(channel.id, channel);
-      this.channels.set(channel.id, channel);
-    }
-    return channel;
-  }
-  /**
-   * Fetch all channels in this guild.
-   * @returns Array of GuildChannel objects (cached in guild.channels and client.channels)
-   */
-  async fetchChannels() {
-    const { Channel } = await import("./Channel-HK7VT35N.mjs");
-    const data = await this.client.rest.get(Routes2.guildChannels(this.id));
-    const list = Array.isArray(data) ? data : Object.values(data ?? {});
-    const channels = [];
-    for (const ch of list) {
-      const channel = Channel.from(this.client, ch);
-      if (channel) {
-        this.client.channels.set(channel.id, channel);
-        this.channels.set(channel.id, channel);
-        channels.push(channel);
-      }
-    }
-    return channels;
-  }
-  /**
-   * Edit this guild. PATCH /guilds/{id}.
-   * Requires guild owner or Administrator.
-   */
-  async edit(options) {
-    const data = await this.client.rest.patch(Routes2.guild(this.id), {
-      body: options,
-      auth: true
-    });
-    this.name = data.name;
-    this.icon = data.icon ?? this.icon;
-    this.banner = data.banner ?? this.banner;
-    this.splash = data.splash ?? this.splash;
-    this.systemChannelId = data.system_channel_id ?? this.systemChannelId;
-    this.afkChannelId = data.afk_channel_id ?? this.afkChannelId;
-    this.afkTimeout = data.afk_timeout ?? this.afkTimeout;
-    this.verificationLevel = data.verification_level ?? this.verificationLevel;
-    this.mfaLevel = data.mfa_level ?? this.mfaLevel;
-    this.explicitContentFilter = data.explicit_content_filter ?? this.explicitContentFilter;
-    this.defaultMessageNotifications = data.default_message_notifications ?? this.defaultMessageNotifications;
-    this.features = data.features ?? this.features;
-    return this;
-  }
-  /**
-   * Delete this guild. POST /guilds/{id}/delete.
-   * Must be the guild owner.
-   */
-  async delete() {
-    await this.client.rest.post(Routes2.guildDelete(this.id), { auth: true });
-    this.client.guilds.delete(this.id);
-  }
-  /**
-   * Fetch vanity URL for this guild. GET /guilds/{id}/vanity-url.
-   * Requires Manage Guild permission.
-   */
-  async fetchVanityURL() {
-    return this.client.rest.get(Routes2.guildVanityUrl(this.id), { auth: true });
-  }
-  /**
-   * Transfer guild ownership to another user. POST /guilds/{id}/transfer-ownership.
-   * Must be the guild owner.
-   */
-  async transferOwnership(newOwnerId, password) {
-    await this.client.rest.post(Routes2.guildTransferOwnership(this.id), {
-      body: { new_owner_id: newOwnerId, ...password != null && { password } },
-      auth: true
-    });
-  }
-  /**
-   * Set text channel flexible names feature. PATCH /guilds/{id}/text-channel-flexible-names.
-   */
-  setTextChannelFlexibleNames(enabled) {
-    return this.client.rest.patch(Routes2.guildTextChannelFlexibleNames(this.id), {
-      body: { enabled },
-      auth: true
-    }).then(() => this);
-  }
-  /**
-   * Set detached banner feature. PATCH /guilds/{id}/detached-banner.
-   */
-  setDetachedBanner(enabled) {
-    return this.client.rest.patch(Routes2.guildDetachedBanner(this.id), {
-      body: { enabled },
-      auth: true
-    }).then(() => this);
-  }
-  /**
-   * Set disallow unclaimed accounts. PATCH /guilds/{id}/disallow-unclaimed-accounts.
-   */
-  setDisallowUnclaimedAccounts(enabled) {
-    return this.client.rest.patch(Routes2.guildDisallowUnclaimedAccounts(this.id), {
-      body: { enabled },
-      auth: true
-    }).then(() => this);
-  }
-  /**
-   * Update role positions. PATCH /guilds/{id}/roles.
-   * @param updates - Array of { id, position? }
-   */
-  async setRolePositions(updates) {
-    const data = await this.client.rest.patch(
-      Routes2.guildRoles(this.id),
-      { body: updates, auth: true }
-    );
-    const list = Array.isArray(data) ? data : Object.values(data ?? {});
-    for (const r of list) {
-      this.roles.set(r.id, new Role(this.client, r, this.id));
-    }
-    return list;
-  }
-  /**
-   * Update role hoist positions. PATCH /guilds/{id}/roles/hoist-positions.
-   */
-  async setRoleHoistPositions(updates) {
-    const data = await this.client.rest.patch(
-      Routes2.guildRolesHoistPositions(this.id),
-      { body: updates, auth: true }
-    );
-    const list = Array.isArray(data) ? data : Object.values(data ?? {});
-    for (const r of list) {
-      this.roles.set(r.id, new Role(this.client, r, this.id));
-    }
-    return list;
-  }
-  /**
-   * Reset role hoist positions. DELETE /guilds/{id}/roles/hoist-positions.
-   */
-  async resetRoleHoistPositions() {
-    const data = await this.client.rest.delete(
-      Routes2.guildRolesHoistPositions(this.id),
-      { auth: true }
-    );
-    const list = Array.isArray(data) ? data : Object.values(data ?? {});
-    for (const r of list) {
-      this.roles.set(r.id, new Role(this.client, r, this.id));
-    }
-    return list;
-  }
-  /**
-   * Update channel positions.
-   * @param updates - Array of { id, position?, parent_id?, lock_permissions? }
-   * Requires Manage Channels permission.
-   */
-  async setChannelPositions(updates) {
-    await this.client.rest.patch(Routes2.guildChannels(this.id), {
-      body: updates,
-      auth: true
-    });
-  }
-  /**
-   * Bulk create emojis. POST /guilds/{id}/emojis/bulk.
-   * @param emojis - Array of { name, image } (base64), 1-50 emojis
-   * @returns Array of created GuildEmoji objects
-   */
-  async createEmojisBulk(emojis) {
-    const { GuildEmoji } = await import("./GuildEmoji-SOGQ4C32.mjs");
-    const data = await this.client.rest.post(Routes2.guildEmojisBulk(this.id), {
-      body: { emojis },
-      auth: true
-    });
-    const list = Array.isArray(data) ? data : data?.emojis ?? [];
-    return list.map((e) => new GuildEmoji(this.client, { ...e, guild_id: this.id }, this.id));
-  }
-  /**
-   * Bulk create stickers. POST /guilds/{id}/stickers/bulk.
-   * @param stickers - Array of { name, image, description?, tags? }, 1-50 stickers
-   * @returns Array of created GuildSticker objects
-   */
-  async createStickersBulk(stickers) {
-    const { GuildSticker } = await import("./GuildSticker-3QYT6ZIY.mjs");
-    const data = await this.client.rest.post(Routes2.guildStickersBulk(this.id), {
-      body: { stickers },
-      auth: true
-    });
-    const list = Array.isArray(data) ? data : data?.stickers ?? [];
-    return list.map((s) => new GuildSticker(this.client, { ...s, guild_id: this.id }, this.id));
-  }
-};
-
-export {
-  GuildMemberManager,
-  Guild
-};