@fluxerjs/core 1.0.6 → 1.0.8

package/dist/chunk-TJVZEILY.mjs

@@ -0,0 +1,120 @@
+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-BUEXP5SZ.mjs → chunk-ZGMM6IPQ.mjs}

@@ -13,6 +13,7 @@ var Webhook = class _Webhook extends Base {
   avatar;
   /** Present only when webhook was created via createWebhook(); not returned when fetching. */
   token;
+  /** @param data - API webhook from POST /channels/{id}/webhooks (has token) or GET /webhooks/{id} (no token) */
   constructor(client, data) {
     super();
     this.client = client;
@@ -33,7 +34,9 @@ var Webhook = class _Webhook extends Base {
    */
   async send(options) {
     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.");
+      throw new Error(
+        "Webhook token is required to send. The token is only returned when creating a webhook; fetched webhooks cannot send."
+      );
     }
     const body = typeof options === "string" ? { content: options } : options;
     await this.client.rest.post(Routes.webhookExecute(this.id, this.token), {
@@ -42,7 +45,10 @@ var Webhook = class _Webhook extends Base {
     });
   }
   /**
-   * Fetch a webhook by ID using bot auth. The returned webhook will not have a token (cannot send).
+   * 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));
@@ -50,7 +56,10 @@ var Webhook = class _Webhook extends Base {
   }
   /**
    * Create a Webhook instance from an ID and token (e.g. from a stored webhook URL).
-   * Useful when you have the token from a previous createWebhook() call.
+   * @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, {