@fluxerjs/core 1.0.2 → 1.0.5

package/dist/chunk-SW6KNICI.mjs

@@ -0,0 +1,52 @@
+import {
+  CDN_URL
+} from "./chunk-HQMYRYMY.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/User.ts
+var User = class extends Base {
+  client;
+  /** Snowflake ID. */
+  id;
+  /** Username. */
+  username;
+  /** Discriminator (legacy). */
+  discriminator;
+  /** Global display name, or null. */
+  globalName;
+  /** Avatar hash, or null. */
+  avatar;
+  /** Whether this user is a bot. */
+  bot;
+  /** @internal */
+  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;
+  }
+  /** CDN URL for the avatar. */
+  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}`;
+  }
+  /** Avatar URL or default avatar if none. */
+  displayAvatarURL(options) {
+    return this.avatarURL(options) ?? `${CDN_URL}/avatars/0/0.png`;
+  }
+  toString() {
+    return `<@${this.id}>`;
+  }
+};
+
+export {
+  User
+};

package/dist/chunk-XXCBJJZE.mjs

@@ -0,0 +1,88 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Channel.ts
+import { ChannelType, Routes } from "@fluxerjs/types";
+var Channel = class extends Base {
+  client;
+  id;
+  type;
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.type = data.type;
+  }
+  /** Create the appropriate channel instance from API data. */
+  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) return new LinkChannel(client, data);
+    return new GuildChannel(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;
+  }
+};
+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. */
+  async send(options) {
+    const body = typeof options === "string" ? { content: options } : options;
+    const { Message } = await import("./Message-PZUU7ZFR.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;
+  }
+};
+
+export {
+  Channel,
+  GuildChannel,
+  TextChannel,
+  CategoryChannel,
+  VoiceChannel,
+  LinkChannel
+};

package/dist/chunk-ZHRQQZ4X.mjs

@@ -0,0 +1,102 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Channel.ts
+import { ChannelType, Routes } from "@fluxerjs/types";
+var Channel = class extends Base {
+  client;
+  id;
+  type;
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.type = data.type;
+  }
+  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) return new LinkChannel(client, data);
+    return new GuildChannel(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. Returns the webhook with token (required for send()). */
+  async createWebhook(options) {
+    const { Webhook } = await import("./Webhook-2RHBXH7R.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. Returned webhooks do not include the token (cannot send). */
+  async fetchWebhooks() {
+    const { Webhook } = await import("./Webhook-2RHBXH7R.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;
+  }
+  async send(options) {
+    const body = typeof options === "string" ? { content: options } : options;
+    const { Message } = await import("./Message-23Z3RPCZ.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;
+  }
+};
+
+export {
+  Channel,
+  GuildChannel,
+  TextChannel,
+  CategoryChannel,
+  VoiceChannel,
+  LinkChannel
+};

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _fluxerjs_types from '@fluxerjs/types';
-import { APIUserPartial, APIMessageAttachment, APIMessage, APIEmbed, ChannelType, APIChannelPartial, APIChannel, APIGuild, APIGuildMember, GatewaySendPayload, Routes, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData } from '@fluxerjs/types';
+import { APIUserPartial, APIMessageAttachment, APIMessage, APIEmbed, APIWebhook, ChannelType, APIChannelPartial, APIChannel, APIGuild, APIGuildMember, GatewayPresenceUpdateData, GatewaySendPayload, Routes, GatewayMessageReactionAddDispatchData, GatewayMessageReactionRemoveDispatchData, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData } from '@fluxerjs/types';
 export { GatewayOpcodes, Routes } from '@fluxerjs/types';
 import { Collection } from '@fluxerjs/collection';
 import { EventEmitter } from 'events';
@@ -53,6 +53,51 @@ declare class Message extends Base {
     delete(): Promise<void>;
 }
 
+interface WebhookSendOptions {
+    content?: string;
+    embeds?: Array<Record<string, unknown>>;
+    username?: string;
+    avatar_url?: string;
+    tts?: boolean;
+}
+/**
+ * Represents a Discord/Fluxer webhook. Supports creating, fetching, sending, and deleting.
+ * The token is only available when the webhook was created; fetched webhooks cannot send messages.
+ */
+declare class Webhook extends Base {
+    readonly client: Client;
+    readonly id: string;
+    readonly guildId: string;
+    readonly channelId: string;
+    name: string;
+    avatar: string | null;
+    /** Present only when webhook was created via createWebhook(); not returned when fetching. */
+    readonly token: string | null;
+    constructor(client: Client, data: APIWebhook & {
+        token?: string | null;
+    });
+    /** Delete this webhook. Requires bot token with Manage Webhooks permission. */
+    delete(): Promise<void>;
+    /**
+     * Send a message via this webhook. Requires the webhook token (only present when created, not when fetched).
+     * @throws Error if token is not available
+     */
+    send(options: string | WebhookSendOptions): Promise<void>;
+    /**
+     * Fetch a webhook by ID using bot auth. The returned webhook will not have a token (cannot send).
+     */
+    static fetch(client: Client, webhookId: string): Promise<Webhook>;
+    /**
+     * 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.
+     */
+    static fromToken(client: Client, webhookId: string, token: string, options?: {
+        channelId?: string;
+        guildId?: string;
+        name?: string;
+    }): Webhook;
+}
+
 declare abstract class Channel extends Base {
     readonly client: Client;
     readonly id: string;
@@ -66,6 +111,13 @@ declare class GuildChannel extends Channel {
     position?: number;
     parentId: string | null;
     constructor(client: Client, data: APIChannel);
+    /** Create a webhook in this channel. Returns the webhook with token (required for send()). */
+    createWebhook(options: {
+        name: string;
+        avatar?: string | null;
+    }): Promise<Webhook>;
+    /** Fetch all webhooks in this channel. Returned webhooks do not include the token (cannot send). */
+    fetchWebhooks(): Promise<Webhook[]>;
 }
 declare class TextChannel extends GuildChannel {
     topic?: string | null;
@@ -107,6 +159,8 @@ declare class Guild extends Base {
     bannerURL(options?: {
         size?: number;
     }): string | null;
+    /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
+    fetchWebhooks(): Promise<Webhook[]>;
 }
 
 declare class GuildMember extends Base {
@@ -127,6 +181,8 @@ declare class GuildMember extends Base {
 interface ClientOptions {
     rest?: Partial<ConstructorParameters<typeof REST>[0]>;
     intents?: number;
+    /** Initial presence (status, custom_status, etc.) sent on identify. Can also update via PresenceUpdate after connect. */
+    presence?: GatewayPresenceUpdateData;
     /** Optional WebSocket constructor (e.g. `require('ws')` in Node for compatibility) */
     WebSocket?: new (url: string) => {
         send(data: string | ArrayBufferLike): void;
@@ -147,6 +203,10 @@ declare const Events: {
     readonly MessageCreate: "messageCreate";
     readonly MessageUpdate: "messageUpdate";
     readonly MessageDelete: "messageDelete";
+    readonly MessageReactionAdd: "messageReactionAdd";
+    readonly MessageReactionRemove: "messageReactionRemove";
+    readonly MessageReactionRemoveAll: "messageReactionRemoveAll";
+    readonly MessageReactionRemoveEmoji: "messageReactionRemoveEmoji";
     readonly InteractionCreate: "interactionCreate";
     readonly GuildCreate: "guildCreate";
     readonly GuildUpdate: "guildUpdate";
@@ -172,6 +232,10 @@ interface ClientEvents {
         id: string;
         channelId: string;
     }];
+    [Events.MessageReactionAdd]: [data: GatewayMessageReactionAddDispatchData];
+    [Events.MessageReactionRemove]: [data: GatewayMessageReactionRemoveDispatchData];
+    [Events.MessageReactionRemoveAll]: [data: GatewayMessageReactionRemoveAllDispatchData];
+    [Events.MessageReactionRemoveEmoji]: [data: GatewayMessageReactionRemoveEmojiDispatchData];
     [Events.InteractionCreate]: [interaction: _fluxerjs_types.APIApplicationCommandInteraction];
     [Events.GuildCreate]: [guild: Guild];
     [Events.GuildUpdate]: [oldGuild: Guild, newGuild: Guild];
@@ -225,4 +289,4 @@ declare const ErrorCodes: {
     readonly InvalidToken: "INVALID_TOKEN";
 };
 
-export { Base, CategoryChannel, Channel, Client, type ClientEvents, ClientUser, ErrorCodes, Events, FluxerError, Guild, GuildChannel, GuildMember, LinkChannel, Message, TextChannel, User, VoiceChannel };
+export { Base, CategoryChannel, Channel, Client, type ClientEvents, ClientUser, ErrorCodes, Events, FluxerError, Guild, GuildChannel, GuildMember, LinkChannel, Message, TextChannel, User, VoiceChannel, Webhook, type WebhookSendOptions };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _fluxerjs_types from '@fluxerjs/types';
-import { APIUserPartial, APIMessageAttachment, APIMessage, APIEmbed, ChannelType, APIChannelPartial, APIChannel, APIGuild, APIGuildMember, GatewaySendPayload, Routes, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData } from '@fluxerjs/types';
+import { APIUserPartial, APIMessageAttachment, APIMessage, APIEmbed, APIWebhook, ChannelType, APIChannelPartial, APIChannel, APIGuild, APIGuildMember, GatewayPresenceUpdateData, GatewaySendPayload, Routes, GatewayMessageReactionAddDispatchData, GatewayMessageReactionRemoveDispatchData, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData } from '@fluxerjs/types';
 export { GatewayOpcodes, Routes } from '@fluxerjs/types';
 import { Collection } from '@fluxerjs/collection';
 import { EventEmitter } from 'events';
@@ -53,6 +53,51 @@ declare class Message extends Base {
     delete(): Promise<void>;
 }
 
+interface WebhookSendOptions {
+    content?: string;
+    embeds?: Array<Record<string, unknown>>;
+    username?: string;
+    avatar_url?: string;
+    tts?: boolean;
+}
+/**
+ * Represents a Discord/Fluxer webhook. Supports creating, fetching, sending, and deleting.
+ * The token is only available when the webhook was created; fetched webhooks cannot send messages.
+ */
+declare class Webhook extends Base {
+    readonly client: Client;
+    readonly id: string;
+    readonly guildId: string;
+    readonly channelId: string;
+    name: string;
+    avatar: string | null;
+    /** Present only when webhook was created via createWebhook(); not returned when fetching. */
+    readonly token: string | null;
+    constructor(client: Client, data: APIWebhook & {
+        token?: string | null;
+    });
+    /** Delete this webhook. Requires bot token with Manage Webhooks permission. */
+    delete(): Promise<void>;
+    /**
+     * Send a message via this webhook. Requires the webhook token (only present when created, not when fetched).
+     * @throws Error if token is not available
+     */
+    send(options: string | WebhookSendOptions): Promise<void>;
+    /**
+     * Fetch a webhook by ID using bot auth. The returned webhook will not have a token (cannot send).
+     */
+    static fetch(client: Client, webhookId: string): Promise<Webhook>;
+    /**
+     * 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.
+     */
+    static fromToken(client: Client, webhookId: string, token: string, options?: {
+        channelId?: string;
+        guildId?: string;
+        name?: string;
+    }): Webhook;
+}
+
 declare abstract class Channel extends Base {
     readonly client: Client;
     readonly id: string;
@@ -66,6 +111,13 @@ declare class GuildChannel extends Channel {
     position?: number;
     parentId: string | null;
     constructor(client: Client, data: APIChannel);
+    /** Create a webhook in this channel. Returns the webhook with token (required for send()). */
+    createWebhook(options: {
+        name: string;
+        avatar?: string | null;
+    }): Promise<Webhook>;
+    /** Fetch all webhooks in this channel. Returned webhooks do not include the token (cannot send). */
+    fetchWebhooks(): Promise<Webhook[]>;
 }
 declare class TextChannel extends GuildChannel {
     topic?: string | null;
@@ -107,6 +159,8 @@ declare class Guild extends Base {
     bannerURL(options?: {
         size?: number;
     }): string | null;
+    /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
+    fetchWebhooks(): Promise<Webhook[]>;
 }
 
 declare class GuildMember extends Base {
@@ -127,6 +181,8 @@ declare class GuildMember extends Base {
 interface ClientOptions {
     rest?: Partial<ConstructorParameters<typeof REST>[0]>;
     intents?: number;
+    /** Initial presence (status, custom_status, etc.) sent on identify. Can also update via PresenceUpdate after connect. */
+    presence?: GatewayPresenceUpdateData;
     /** Optional WebSocket constructor (e.g. `require('ws')` in Node for compatibility) */
     WebSocket?: new (url: string) => {
         send(data: string | ArrayBufferLike): void;
@@ -147,6 +203,10 @@ declare const Events: {
     readonly MessageCreate: "messageCreate";
     readonly MessageUpdate: "messageUpdate";
     readonly MessageDelete: "messageDelete";
+    readonly MessageReactionAdd: "messageReactionAdd";
+    readonly MessageReactionRemove: "messageReactionRemove";
+    readonly MessageReactionRemoveAll: "messageReactionRemoveAll";
+    readonly MessageReactionRemoveEmoji: "messageReactionRemoveEmoji";
     readonly InteractionCreate: "interactionCreate";
     readonly GuildCreate: "guildCreate";
     readonly GuildUpdate: "guildUpdate";
@@ -172,6 +232,10 @@ interface ClientEvents {
         id: string;
         channelId: string;
     }];
+    [Events.MessageReactionAdd]: [data: GatewayMessageReactionAddDispatchData];
+    [Events.MessageReactionRemove]: [data: GatewayMessageReactionRemoveDispatchData];
+    [Events.MessageReactionRemoveAll]: [data: GatewayMessageReactionRemoveAllDispatchData];
+    [Events.MessageReactionRemoveEmoji]: [data: GatewayMessageReactionRemoveEmojiDispatchData];
     [Events.InteractionCreate]: [interaction: _fluxerjs_types.APIApplicationCommandInteraction];
     [Events.GuildCreate]: [guild: Guild];
     [Events.GuildUpdate]: [oldGuild: Guild, newGuild: Guild];
@@ -225,4 +289,4 @@ declare const ErrorCodes: {
     readonly InvalidToken: "INVALID_TOKEN";
 };
 
-export { Base, CategoryChannel, Channel, Client, type ClientEvents, ClientUser, ErrorCodes, Events, FluxerError, Guild, GuildChannel, GuildMember, LinkChannel, Message, TextChannel, User, VoiceChannel };
+export { Base, CategoryChannel, Channel, Client, type ClientEvents, ClientUser, ErrorCodes, Events, FluxerError, Guild, GuildChannel, GuildMember, LinkChannel, Message, TextChannel, User, VoiceChannel, Webhook, type WebhookSendOptions };