@fluxerjs/core 1.1.7 → 1.1.9

package/dist/chunk-BUIHWKTK.mjs

@@ -0,0 +1,132 @@
+import {
+  buildSendBody
+} from "./chunk-PM2IUGNR.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Webhook.ts
+import { Routes } from "@fluxerjs/types";
+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, username, avatar_url, tts, files, attachments
+   * @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()] });
+   * await webhook.send({ content: 'File attached', files: [{ name: 'data.txt', data: buffer }] });
+   * 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 opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    if (opts.username !== void 0) body.username = opts.username;
+    if (opts.avatar_url !== void 0) body.avatar_url = opts.avatar_url;
+    if (opts.tts !== void 0) body.tts = opts.tts;
+    const route = Routes.webhookExecute(this.id, this.token) + (wait ? "?wait=true" : "");
+    const postOptions = opts.files?.length ? { body, files: opts.files, auth: false } : { body, auth: false };
+    const data = await this.client.rest.post(route, postOptions);
+    if (wait && data) {
+      const { Message } = await import("./Message-ZL2PJPQA.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
+};

package/dist/chunk-BYTAODAO.mjs

@@ -0,0 +1,70 @@
+import {
+  GuildMember
+} from "./chunk-LVMFPATK.mjs";
+import {
+  CDN_URL
+} from "./chunk-DLROMCIJ.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// 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;
+  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;
+  }
+  /** 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}`;
+  }
+  /**
+   * 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-AG6QFM2I.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-CEABHTAF.mjs

@@ -0,0 +1,43 @@
+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.
+   * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
+   */
+  async fetchMessage() {
+    return this.client.channels.fetchMessage(this.channelId, this.messageId);
+  }
+};
+
+export {
+  MessageReaction
+};

package/dist/chunk-CJLJBBFO.mjs

@@ -0,0 +1,54 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/GuildEmoji.ts
+import { Routes } from "@fluxerjs/types";
+var GuildEmoji = class extends Base {
+  client;
+  id;
+  guildId;
+  name;
+  animated;
+  /** @param data - API emoji from GET /guilds/{id}/emojis or guild emoji events */
+  constructor(client, data, guildId) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.guildId = data.guild_id ?? guildId;
+    this.name = data.name;
+    this.animated = data.animated ?? false;
+  }
+  /** CDN URL for this emoji image. */
+  get url() {
+    const base = this.client.getCDNBase();
+    const ext = this.animated ? "gif" : "png";
+    return `${base}/emojis/${this.id}.${ext}`;
+  }
+  /** Emoji identifier for use in reactions: `name:id` */
+  get identifier() {
+    return `${this.name}:${this.id}`;
+  }
+  /** Delete this emoji. Requires Manage Emojis and Stickers permission. */
+  async delete() {
+    await this.client.rest.delete(Routes.guildEmoji(this.guildId, this.id), {
+      auth: true
+    });
+  }
+  /**
+   * Edit this emoji's name.
+   * Requires Manage Emojis and Stickers permission.
+   */
+  async edit(options) {
+    const data = await this.client.rest.patch(Routes.guildEmoji(this.guildId, this.id), {
+      body: options,
+      auth: true
+    });
+    this.name = data.name;
+    return this;
+  }
+};
+
+export {
+  GuildEmoji
+};

package/dist/chunk-CJVQNARM.mjs

@@ -0,0 +1,145 @@
+import {
+  buildSendBody
+} from "./chunk-PM2IUGNR.mjs";
+import {
+  cdnAvatarURL
+} from "./chunk-X6K3ZD62.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Webhook.ts
+import { Routes } from "@fluxerjs/types";
+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);
+  }
+  /**
+   * Get the URL for this webhook's avatar.
+   * Returns null if the webhook has no custom avatar.
+   */
+  avatarURL(options) {
+    return cdnAvatarURL(this.id, this.avatar, options);
+  }
+  /** 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, username, avatar_url, tts, files, attachments
+   * @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()] });
+   * await webhook.send({ content: 'File attached', files: [{ name: 'data.txt', data: buffer }] });
+   * 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 opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    if (opts.username !== void 0) body.username = opts.username;
+    if (opts.avatar_url !== void 0) body.avatar_url = opts.avatar_url;
+    if (opts.tts !== void 0) body.tts = opts.tts;
+    const route = Routes.webhookExecute(this.id, this.token) + (wait ? "?wait=true" : "");
+    const postOptions = opts.files?.length ? { body, files: opts.files, auth: false } : { body, auth: false };
+    const data = await this.client.rest.post(
+      route,
+      postOptions
+    );
+    if (wait && data) {
+      const { Message } = await import("./Message-OFIVTTAZ.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
+};

package/dist/chunk-CNCPVNXS.mjs

@@ -0,0 +1,160 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Webhook.ts
+import { Routes } from "@fluxerjs/types";
+import { EmbedBuilder } from "@fluxerjs/builders";
+function buildWebhookBody(options) {
+  const opts = typeof options === "string" ? { content: options } : options;
+  const result = {};
+  if (opts.content !== void 0) result.content = opts.content;
+  if (opts.embeds && Array.isArray(opts.embeds) && opts.embeds.length > 0) {
+    result.embeds = opts.embeds.map(
+      (e) => e instanceof EmbedBuilder ? e.toJSON() : e
+    );
+  }
+  if (opts.username !== void 0) result.username = opts.username;
+  if (opts.avatar_url !== void 0) result.avatar_url = opts.avatar_url;
+  if (opts.tts !== void 0) result.tts = opts.tts;
+  return result;
+}
+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, username, avatar_url, tts, files, attachments
+   * @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()] });
+   * await webhook.send({ content: 'File attached', files: [{ name: 'data.txt', data: buffer }] });
+   * 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 opts = typeof options === "string" ? { content: options } : options;
+    const body = buildWebhookBody(options);
+    if (opts.files?.length) {
+      body.attachments = opts.attachments ?? opts.files.map((f, i) => ({
+        id: i,
+        filename: f.filename ?? f.name
+      }));
+      delete body.files;
+      const route2 = Routes.webhookExecute(this.id, this.token) + (wait ? "?wait=true" : "");
+      const data2 = await this.client.rest.post(route2, {
+        body,
+        files: opts.files,
+        auth: false
+      });
+      if (wait && data2) {
+        const { Message } = await import("./Message-F4SCFNF5.mjs");
+        return new Message(this.client, data2);
+      }
+      return void 0;
+    }
+    delete body.files;
+    delete body.attachments;
+    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-F4SCFNF5.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
+};