lunibee 0.2.3 → 0.3.0

package/dist/structures/interactions.d.ts

@@ -1,3 +1,4 @@
+import { type APIEntitlement, type InteractionReplyOptions } from "@lunibee/types";
 import { User, type ResourceContext } from "./base.js";
 import { GuildMember } from "./resources.js";
 import { Message } from "./index.js";
@@ -11,35 +12,38 @@ export declare const InteractionEnum: {
 };
 /** One {@link InteractionEnum} value, usable as a type. */
 export type InteractionEnum = (typeof InteractionEnum)[keyof typeof InteractionEnum];
-export { InteractionResponseEnum, InteractionResponseType, } from "@lunibee/types";
+export { InteractionResponseEnum } from "@lunibee/types";
 /** Data shared by Discord interactions. */
 export interface InteractionData {
-    /** Interaction identifier. */ id: string;
-    /** Application identifier. */ application_id: string;
-    /** Interaction type. */ type: number;
-    /** Interaction token. */ token: string;
-    /** Gateway/API version. */ version?: number;
-    /** Guild identifier. */ guild_id?: string;
-    /** Channel identifier. */ channel_id?: string;
-    /** Interaction-specific data. */ data?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-/** Options for an interaction response message. */
-export interface InteractionReplyOptions {
-    /** Message content. */ content?: string;
-    /** Whether the response is ephemeral. */ ephemeral?: boolean;
-    /** Message components. */ components?: unknown[];
-    /** Message embeds. */ embeds?: unknown[];
-    /** Discord message flags. */ flags?: number;
-    /** On `reply()` / `update()`: return the created message (one request, no `fetchReply()`). */ withResponse?: boolean;
+    /** Interaction identifier. */
+    id: string;
+    /** Application identifier. */
+    application_id: string;
+    /** Interaction type. */
+    type: number;
+    /** Interaction token. */
+    token: string;
+    /** Gateway/API version. */
+    version?: number;
+    /** Guild identifier. */
+    guild_id?: string;
+    /** Channel identifier. */
+    channel_id?: string;
+    /** Interaction-specific data. */
+    data?: Record<string, unknown>;
     [key: string]: unknown;
 }
+export type { InteractionReplyOptions };
 /** Transport required by an interaction structure. */
 export interface InteractionClient {
-    /** Sends the initial interaction callback. @param id Interaction identifier. @param token Interaction token. @param response Callback payload. @returns Discord response. @throws {Error} When REST fails. */ postInteractionResponse(id: string, token: string, response: InteractionResponse): Promise<unknown>;
-    /** Edits the original interaction response. @param token Interaction token. @param data Message payload. @returns Discord response. @throws {Error} When REST fails. */ editInteractionReply(token: string, data: InteractionReplyOptions): Promise<unknown>;
-    /** Deletes the original interaction response. @param token Interaction token. @returns Promise fulfilled after deletion. @throws {Error} When REST fails. */ deleteInteractionReply(token: string): Promise<void>;
-    /** Sends a follow-up interaction webhook message. @param token Interaction token. @param data Message payload. @returns Discord response. @throws {Error} When REST fails. */ followUpInteraction(token: string, data: InteractionReplyOptions): Promise<unknown>;
+    /** Sends the initial interaction callback. @param id Interaction identifier. @param token Interaction token. @param response Callback payload. @returns Discord response. @throws {Error} When REST fails. */
+    postInteractionResponse(id: string, token: string, response: InteractionResponse): Promise<unknown>;
+    /** Edits the original interaction response. @param token Interaction token. @param data Message payload. @returns Discord response. @throws {Error} When REST fails. */
+    editInteractionReply(token: string, data: InteractionReplyOptions): Promise<unknown>;
+    /** Deletes the original interaction response. @param token Interaction token. @returns Promise fulfilled after deletion. @throws {Error} When REST fails. */
+    deleteInteractionReply(token: string): Promise<void>;
+    /** Sends a follow-up interaction webhook message. @param token Interaction token. @param data Message payload. @returns Discord response. @throws {Error} When REST fails. */
+    followUpInteraction(token: string, data: InteractionReplyOptions): Promise<unknown>;
     /** Reads, edits or deletes an interaction webhook message (`@original` or a follow-up ID). Optional; required for {@link Interaction.fetchReply}, {@link Interaction.editFollowUp} and {@link Interaction.deleteFollowUp}. */
     interactionWebhookMessage?(method: "GET" | "PATCH" | "DELETE", applicationId: string, token: string, messageId: string, data?: InteractionReplyOptions): Promise<unknown>;
     /** Lets structures built from an interaction (such as {@link Interaction.member}) act through the client. Optional. */
@@ -55,27 +59,45 @@ export declare class InteractionResponse {
     withResponse: boolean;
     /** Creates a response payload. @param type Discord callback type. @param data Optional callback data. @throws {TypeError} If type is not finite. */
     constructor(type: number, data?: InteractionReplyOptions);
-    /** Serializes the response for Discord. @returns Discord callback payload. */ toJSON(): {
+    /** Serializes the response for Discord. @returns Discord callback payload. */
+    toJSON(): {
         type: number;
         data?: InteractionReplyOptions;
     };
-    /** Creates an immediate message response. @param options Response message options. @returns Callback payload. */ static message(options: InteractionReplyOptions): InteractionResponse;
-    /** Creates a deferred channel response. @param ephemeral Whether the eventual response is ephemeral. @returns Callback payload. */ static defer(ephemeral?: boolean): InteractionResponse;
-    /** Creates a Pong response. @returns Callback payload. */ static pong(): InteractionResponse;
+    /** Creates an immediate message response. @param options Response message options. @returns Callback payload. */
+    static message(options: InteractionReplyOptions): InteractionResponse;
+    /** Creates a deferred channel response. @param ephemeral Whether the eventual response is ephemeral. @returns Callback payload. */
+    static defer(ephemeral?: boolean): InteractionResponse;
+    /** Creates a Pong response. @returns Callback payload. */
+    static pong(): InteractionResponse;
 }
 /** Base interaction structure. */
 export declare class Interaction<TData extends InteractionData = InteractionData> {
     #private;
-    /** Interaction identifier. */ readonly id: string;
-    /** Application identifier. */ readonly applicationId: string;
-    /** Interaction token. */ readonly token: string;
-    /** Guild identifier. */ readonly guildId?: string;
-    /** Channel identifier. */ readonly channelId?: string;
-    /** Interaction type. */ readonly type: number;
-    /** Raw interaction data. */ readonly data: TData;
-    /** Whether the initial response was sent. */ replied: boolean;
-    /** Whether the initial response was deferred. */ deferred: boolean;
-    /** Creates an interaction from a Gateway payload. @param client Interaction transport. @param data Gateway interaction payload. @throws {TypeError} If required identifiers are missing. */ constructor(client: InteractionClient, data: TData);
+    /** Interaction identifier. */
+    readonly id: string;
+    /** Application identifier. */
+    readonly applicationId: string;
+    /** Interaction token. */
+    readonly token: string;
+    /** Guild identifier. */
+    readonly guildId?: string;
+    /** Channel identifier. */
+    readonly channelId?: string;
+    /** Interaction type. */
+    readonly type: number;
+    /** Raw interaction data. */
+    readonly data: TData;
+    /** Whether the initial response was sent. */
+    replied: boolean;
+    /** Whether the initial response was deferred. */
+    deferred: boolean;
+    /** Creates an interaction from a Gateway payload. @param client Interaction transport. @param data Gateway interaction payload. @throws {TypeError} If required identifiers are missing. */
+    constructor(client: InteractionClient, data: TData);
+    /** The entitlements of the person (and guild) that ran this interaction: what they own from your SKUs. */
+    get entitlements(): readonly APIEntitlement[];
+    /** Whether the interaction carries an active entitlement for a SKU. */
+    hasEntitlement(skuId: string): boolean;
     /** Whether this interaction is any application command: slash or context menu. */
     isCommand(): this is CommandInteraction;
     /**
@@ -103,17 +125,28 @@ export declare class Interaction<TData extends InteractionData = InteractionData
         customId?: string;
         filter?: (interaction: ModalSubmitInteraction) => boolean | Promise<boolean>;
     }): Promise<ModalSubmitInteraction>;
-    /** Whether this interaction is a message component. @returns True for component interactions. */ isMessageComponent(): this is ComponentInteraction;
-    /** Whether this interaction is a modal submission. @returns True for modal submissions. */ isModalSubmit(): this is ModalSubmitInteraction;
-    /** Whether this interaction is autocomplete. @returns True for autocomplete interactions. */ isAutocomplete(): this is AutocompleteInteraction;
-    /** Whether this is a button interaction. */ isButton(): this is ComponentInteraction;
-    /** Whether this is a string select menu interaction. */ isStringSelectMenu(): this is ComponentInteraction;
-    /** Whether this is a user select menu interaction. */ isUserSelectMenu(): this is ComponentInteraction;
-    /** Whether this is a role select menu interaction. */ isRoleSelectMenu(): this is ComponentInteraction;
-    /** Whether this is a mentionable select menu interaction. */ isMentionableSelectMenu(): this is ComponentInteraction;
-    /** Whether this is a channel select menu interaction. */ isChannelSelectMenu(): this is ComponentInteraction;
-    /** Whether this is any select menu interaction. */ isAnySelectMenu(): this is ComponentInteraction;
-    /** Ensures the interaction has not already been acknowledged. @returns Nothing. @throws {Error} When already acknowledged. */ protected assertUnacknowledged(): void;
+    /** Whether this interaction is a message component. @returns True for component interactions. */
+    isMessageComponent(): this is ComponentInteraction;
+    /** Whether this interaction is a modal submission. @returns True for modal submissions. */
+    isModalSubmit(): this is ModalSubmitInteraction;
+    /** Whether this interaction is autocomplete. @returns True for autocomplete interactions. */
+    isAutocomplete(): this is AutocompleteInteraction;
+    /** Whether this is a button interaction. */
+    isButton(): this is ComponentInteraction;
+    /** Whether this is a string select menu interaction. */
+    isStringSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a user select menu interaction. */
+    isUserSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a role select menu interaction. */
+    isRoleSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a mentionable select menu interaction. */
+    isMentionableSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a channel select menu interaction. */
+    isChannelSelectMenu(): this is ComponentInteraction;
+    /** Whether this is any select menu interaction. */
+    isAnySelectMenu(): this is ComponentInteraction;
+    /** Ensures the interaction has not already been acknowledged. @returns Nothing. @throws {Error} When already acknowledged. */
+    protected assertUnacknowledged(): void;
     /**
      * Sends the initial response exactly once. The in-flight flag is set
      * before the request, so two concurrent calls cannot both send; it is
@@ -136,7 +169,8 @@ export declare class Interaction<TData extends InteractionData = InteractionData
     editFollowUp(messageId: string, options: InteractionReplyOptions | string): Promise<unknown>;
     /** Deletes a follow-up message. @param messageId Follow-up message ID. */
     deleteFollowUp(messageId: string): Promise<void>;
-    /** Ensures the interaction has been acknowledged. @returns Nothing. @throws {Error} When not acknowledged. */ protected assertAcknowledged(): void;
+    /** Ensures the interaction has been acknowledged. @returns Nothing. @throws {Error} When not acknowledged. */
+    protected assertAcknowledged(): void;
     /** Posts a raw interaction response callback. */
     protected postResponse(response: InteractionResponse): Promise<unknown>;
     /**
@@ -166,9 +200,12 @@ export declare class Interaction<TData extends InteractionData = InteractionData
         ephemeral?: boolean;
         withResponse?: boolean;
     }): Promise<void>;
-    /** Edits the original response. @param options Replacement message options. @returns Discord response. @throws {Error} When not acknowledged or REST fails. */ editReply(options: InteractionReplyOptions): Promise<unknown>;
-    /** Deletes the original response. @returns Promise fulfilled after deletion. @throws {Error} When not acknowledged or REST fails. */ deleteReply(): Promise<void>;
-    /** Sends a follow-up message using the interaction webhook. @param options Follow-up message options. @returns Discord response. @throws {Error} When REST fails. */ followUp(options: InteractionReplyOptions | string): Promise<unknown>;
+    /** Edits the original response. @param options Replacement message options. @returns Discord response. @throws {Error} When not acknowledged or REST fails. */
+    editReply(options: InteractionReplyOptions): Promise<unknown>;
+    /** Deletes the original response. @returns Promise fulfilled after deletion. @throws {Error} When not acknowledged or REST fails. */
+    deleteReply(): Promise<void>;
+    /** Sends a follow-up message using the interaction webhook. @param options Follow-up message options. @returns Discord response. @throws {Error} When REST fails. */
+    followUp(options: InteractionReplyOptions | string): Promise<unknown>;
     /**
      * Updates the message a component is on. With `withResponse: true` it
      * returns the updated {@link Message}.
@@ -194,7 +231,8 @@ export declare class Interaction<TData extends InteractionData = InteractionData
 export declare class CommandInteraction extends Interaction {
     /** Typed option resolver. Access slash command options with full type safety. */
     readonly options: CommandOptions;
-    /** Invoked command name. @returns Command name or an empty string. */ get commandName(): string;
+    /** Invoked command name. @returns Command name or an empty string. */
+    get commandName(): string;
     constructor(client: InteractionClient, data: InteractionData);
 }
 /** A user or message context-menu command, with what was right-clicked. */
@@ -263,13 +301,3 @@ export declare class AutocompleteInteraction extends Interaction {
  * @throws {TypeError} If required identifiers are missing.
  */
 export declare function createInteraction(client: InteractionClient, data: InteractionData): Interaction;
-/** @deprecated Use {@link InteractionEnum}. Removed in 0.3.0. */
-export declare const InteractionType: {
-    readonly Ping: 1;
-    readonly ApplicationCommand: 2;
-    readonly MessageComponent: 3;
-    readonly ApplicationCommandAutocomplete: 4;
-    readonly ModalSubmit: 5;
-};
-/** @deprecated Use {@link InteractionEnum}. Removed in 0.3.0. */
-export type InteractionType = InteractionEnum;

package/dist/structures/resources.d.ts

@@ -4,16 +4,26 @@ import type { ImageURLOptions, ResourceContext } from "./base.js";
 /** A Discord guild member. */
 export declare class GuildMember {
     #private;
-    /** User represented by the member. */ readonly user: User;
-    /** Guild containing the member. */ readonly guildId: string;
-    /** Nickname, if configured. */ nickname: string | null;
-    /** Role IDs assigned to the member. */ readonly roleIds: string[];
-    /** Whether the member is pending membership screening. */ pending: boolean;
-    /** Member join timestamp. */ joinedAt?: Date;
-    /** Member-specific avatar hash, if set. */ avatarHash: string | null;
-    /** When the member started boosting the guild. */ premiumSince: Date | null;
-    /** When the member's timeout expires (null if not timed out). */ timedOutUntil: Date | null;
-    /** Member flags bitfield. */ flags: number;
+    /** User represented by the member. */
+    readonly user: User;
+    /** Guild containing the member. */
+    readonly guildId: string;
+    /** Nickname, if configured. */
+    nickname: string | null;
+    /** Role IDs assigned to the member. */
+    readonly roleIds: string[];
+    /** Whether the member is pending membership screening. */
+    pending: boolean;
+    /** Member join timestamp. */
+    joinedAt?: Date;
+    /** Member-specific avatar hash, if set. */
+    avatarHash: string | null;
+    /** When the member started boosting the guild. */
+    premiumSince: Date | null;
+    /** When the member's timeout expires (null if not timed out). */
+    timedOutUntil: Date | null;
+    /** Member flags bitfield. */
+    flags: number;
     /** Creates a guild member from Discord data. @param data Discord guild-member payload. @throws {TypeError} If the guild ID is invalid. @throws {RangeError} If joined_at is invalid. */
     constructor(data: {
         user: {
@@ -76,16 +86,32 @@ export declare class GuildMember {
 }
 /** A Discord guild role. */
 export declare class Role extends BaseStructure {
-    /** Role name. */ name: string;
-    /** Role color as a 24-bit RGB integer. */ color: number;
-    /** Whether the role is hoisted. */ hoist: boolean;
-    /** Permission bitfield. */ permissions: PermissionsBitField;
-    /** Whether the role is managed by an integration. */ managed: boolean;
-    /** Whether the role is mentionable. */ mentionable: boolean;
-    /** Role position in the hierarchy. */ position: number;
-    /** Unicode emoji used as the role icon, if any. */ unicodeEmoji: string | null;
-    /** Hash of the role's custom icon image, if any. */ iconHash: string | null;
-    /** Role tags metadata (bot, premium subscriber, etc). */ tags: Record<string, unknown> | null;
+    /** Role name. */
+    name: string;
+    /** Role color as a 24-bit RGB integer. */
+    color: number;
+    /** Whether the role is hoisted. */
+    hoist: boolean;
+    /** Permission bitfield. */
+    permissions: PermissionsBitField;
+    /** Whether the role is managed by an integration. */
+    managed: boolean;
+    /** Whether the role is mentionable. */
+    mentionable: boolean;
+    /** Role position in the hierarchy. */
+    position: number;
+    /** Unicode emoji used as the role icon, if any. */
+    unicodeEmoji: string | null;
+    /** Hash of the role's custom icon image, if any. */
+    iconHash: string | null;
+    /** Gradient or holographic colours, when the role has more than a solid colour. */
+    colors: {
+        primary: number;
+        secondary: number | null;
+        tertiary: number | null;
+    } | null;
+    /** Role tags metadata (bot, premium subscriber, etc). */
+    tags: Record<string, unknown> | null;
     /** Creates a role from Discord data. @param data Discord role payload. */
     constructor(data: {
         id: string;
@@ -98,6 +124,11 @@ export declare class Role extends BaseStructure {
         position?: number;
         unicode_emoji?: string | null;
         icon?: string | null;
+        colors?: {
+            primary_color: number;
+            secondary_color: number | null;
+            tertiary_color: number | null;
+        };
         tags?: Record<string, unknown> | null;
     });
     /** Returns the role's color as a `#RRGGBB` hex string. Returns `#000000` for colorless roles. */
@@ -124,16 +155,26 @@ export declare class TextChannel extends Channel {
 }
 /** A Discord invite link and its metadata. */
 export declare class Invite {
-    /** Invite code (the unique part of the URL). */ readonly code: string;
-    /** Guild this invite belongs to, if any. */ readonly guildId: string | null;
-    /** Channel this invite points to, if any. */ readonly channelId: string | null;
-    /** User who created the invite, if available. */ readonly inviter: User | null;
-    /** Number of times the invite has been used. */ uses: number;
-    /** Maximum number of uses (0 = unlimited). */ maxUses: number;
-    /** Duration in seconds until the invite expires (0 = never). */ maxAge: number;
-    /** Whether the invite is temporary (kicks uninducted members on disconnect). */ temporary: boolean;
-    /** When the invite was created. */ readonly createdAt: Date | null;
-    /** When the invite expires, or null if it never expires. */ readonly expiresAt: Date | null;
+    /** Invite code (the unique part of the URL). */
+    readonly code: string;
+    /** Guild this invite belongs to, if any. */
+    readonly guildId: string | null;
+    /** Channel this invite points to, if any. */
+    readonly channelId: string | null;
+    /** User who created the invite, if available. */
+    readonly inviter: User | null;
+    /** Number of times the invite has been used. */
+    uses: number;
+    /** Maximum number of uses (0 = unlimited). */
+    maxUses: number;
+    /** Duration in seconds until the invite expires (0 = never). */
+    maxAge: number;
+    /** Whether the invite is temporary (kicks uninducted members on disconnect). */
+    temporary: boolean;
+    /** When the invite was created. */
+    readonly createdAt: Date | null;
+    /** When the invite expires, or null if it never expires. */
+    readonly expiresAt: Date | null;
     /** Creates an invite from Discord data. */
     constructor(data: {
         code: string;
@@ -175,13 +216,20 @@ export declare const WebhookEnum: {
 export type WebhookEnum = (typeof WebhookEnum)[keyof typeof WebhookEnum];
 /** A Discord webhook — an HTTP endpoint that can post messages to a channel. */
 export declare class Webhook extends BaseStructure {
-    /** Webhook type. */ readonly type: number;
-    /** Webhook display name. */ name: string | null;
-    /** Webhook avatar hash. */ avatarHash: string | null;
-    /** Channel this webhook posts to. */ readonly channelId: string | null;
-    /** Guild this webhook belongs to. */ readonly guildId: string | null;
-    /** Application that created this webhook, if any. */ readonly applicationId: string | null;
-    /** Webhook token (only present for incoming webhooks). */ readonly token: string | null;
+    /** Webhook type. */
+    readonly type: number;
+    /** Webhook display name. */
+    name: string | null;
+    /** Webhook avatar hash. */
+    avatarHash: string | null;
+    /** Channel this webhook posts to. */
+    readonly channelId: string | null;
+    /** Guild this webhook belongs to. */
+    readonly guildId: string | null;
+    /** Application that created this webhook, if any. */
+    readonly applicationId: string | null;
+    /** Webhook token (only present for incoming webhooks). */
+    readonly token: string | null;
     /** Creates a webhook from Discord data. */
     constructor(data: {
         id: string;
@@ -202,13 +250,20 @@ export declare class Webhook extends BaseStructure {
 }
 /** A Discord emoji. */
 export declare class Emoji extends BaseStructure {
-    /** Emoji name. */ name: string | null;
-    /** Roles allowed to use this emoji. */ roleIds: string[];
-    /** User that created this emoji. */ user: User | null;
-    /** Whether this emoji must be wrapped in colons. */ requireColons: boolean;
-    /** Whether this emoji is managed. */ managed: boolean;
-    /** Whether this emoji is animated. */ animated: boolean;
-    /** Whether this emoji can be used, may be false due to loss of Server Boosts. */ available: boolean;
+    /** Emoji name. */
+    name: string | null;
+    /** Roles allowed to use this emoji. */
+    roleIds: string[];
+    /** User that created this emoji. */
+    user: User | null;
+    /** Whether this emoji must be wrapped in colons. */
+    requireColons: boolean;
+    /** Whether this emoji is managed. */
+    managed: boolean;
+    /** Whether this emoji is animated. */
+    animated: boolean;
+    /** Whether this emoji can be used, may be false due to loss of Server Boosts. */
+    available: boolean;
     /** Creates an emoji from Discord data. */
     constructor(data: {
         id: string | null;
@@ -282,11 +337,3 @@ export declare class GuildOnboarding extends BaseStructure {
     mode: number;
     constructor(data: import("@lunibee/types").APIGuildOnboarding);
 }
-/** @deprecated Use {@link WebhookEnum}. Removed in 0.3.0. */
-export declare const WebhookType: {
-    readonly Incoming: 1;
-    readonly ChannelFollower: 2;
-    readonly Application: 3;
-};
-/** @deprecated Use {@link WebhookEnum}. Removed in 0.3.0. */
-export type WebhookType = WebhookEnum;

package/dist/structures/sticker.d.ts

@@ -0,0 +1,33 @@
+import { type APISticker, type APIStickerItem, type UserData } from "@lunibee/types";
+import { BaseStructure } from "./base.js";
+/** Where a sticker's image lives on Discord's CDN, by format. Lottie stickers are JSON, GIFs come from the media host. */
+export declare function stickerURL(id: string, format: number, options?: {
+    size?: number;
+}): string;
+/** A sticker: a guild's own, one from a Nitro pack, or a standard one. */
+export declare class Sticker extends BaseStructure {
+    readonly name: string;
+    readonly description: string | null;
+    /** Comma-separated autocomplete tags. */
+    readonly tags: string;
+    /** 1 standard (from a pack), 2 guild. */
+    readonly type: number;
+    /** 1 PNG, 2 APNG, 3 Lottie, 4 GIF. */
+    readonly formatType: number;
+    /** Whether the sticker can be used (guild stickers become unavailable when the boost level drops). */
+    readonly available: boolean;
+    readonly guildId: string | null;
+    readonly packId: string | null;
+    readonly sortValue: number | null;
+    /** Who uploaded it, for guild stickers. */
+    readonly user: UserData | null;
+    constructor(data: APISticker);
+    /** Whether the sticker moves: APNG, Lottie or GIF. */
+    get animated(): boolean;
+    /** The sticker's image URL (a `.json` file for Lottie). */
+    url(options?: {
+        size?: number;
+    }): string;
+    /** The sticker as a message carries it. */
+    toItem(): APIStickerItem;
+}

package/dist/types/channel-kind.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Channel kinds: a short name for what a channel is, in place of the numeric
+ * `type` Discord sends. Threads share one kind; `type` still tells the three
+ * apart.
+ */
+export declare const ChannelKinds: {
+    readonly text: readonly [0];
+    readonly dm: readonly [1];
+    readonly voice: readonly [2];
+    readonly "group-dm": readonly [3];
+    readonly category: readonly [4];
+    readonly announcement: readonly [5];
+    readonly thread: readonly [10, 11, 12];
+    readonly stage: readonly [13];
+    readonly directory: readonly [14];
+    readonly forum: readonly [15];
+    readonly media: readonly [16];
+};
+/** The name of a kind of channel, such as `"text"` or `"voice"`. */
+export type ChannelKind = keyof typeof ChannelKinds;
+/** A channel type Discord has no kind for yet. */
+export type UnknownChannelKind = "unknown";
+/** The kind of a Discord channel `type`, or `"unknown"` for a type this version does not know. */
+export declare function channelKindOf(type: number): ChannelKind | UnknownChannelKind;
+/** The Discord channel `type` numbers a kind covers (three for `"thread"`, one for the rest). */
+export declare function channelTypesOf(kind: ChannelKind): readonly number[];

package/dist/types/gateway.d.ts

@@ -80,12 +80,15 @@ export declare const Intents: {
     readonly guildMessagePolls: number;
     readonly directMessagePolls: number;
 };
-/** Gateway intent resolvable value (single bitfield, enum key, or array of bitfields/strings). */
-export type GatewayIntentResolvable = number | keyof typeof GatewayIntentBits | keyof typeof IntentBits | (number | keyof typeof GatewayIntentBits | keyof typeof IntentBits | string)[] | {
-    readonly bitfield: number;
-};
-/** Resolves any GatewayIntentResolvable into a raw bitfield integer. */
+/** Gateway intents: an array of intent bits or names, e.g. `[GatewayIntentBits.Guilds, "GuildMessages"]`. A single number, name or OR-ed bitfield is not accepted. */
+export type GatewayIntentResolvable = readonly (number | keyof typeof GatewayIntentBits | keyof typeof IntentBits | string)[];
+/**
+ * Resolves an array of intents into a raw bitfield integer.
+ * @throws {TypeError} If `intents` is not an array (an OR-ed number, a single name or a bitfield object).
+ */
 export declare function resolveGatewayIntents(intents: GatewayIntentResolvable): number;
+/** What `IntentsBitField` methods take: one intent or an array of them. Clients and gateways take only arrays. */
+type IntentsInput = GatewayIntentResolvable[number] | GatewayIntentResolvable;
 /**
  * Discord.js-familiar intent bitfield.
  * @example new IntentsBitField([IntentsBitField.Flags.Guilds, "GuildMessages"])
@@ -117,19 +120,19 @@ export declare class IntentsBitField {
     };
     /** Raw intent bitfield. */
     bitfield: number;
-    constructor(bits?: GatewayIntentResolvable);
+    constructor(bits?: IntentsInput);
     /** Whether every given intent is set. */
-    has(bits: GatewayIntentResolvable): boolean;
+    has(bits: IntentsInput): boolean;
     /** Whether any given intent is set. */
-    any(bits: GatewayIntentResolvable): boolean;
+    any(bits: IntentsInput): boolean;
     /** Adds intents in place. @returns This bitfield. */
-    add(...bits: GatewayIntentResolvable[]): this;
+    add(...bits: IntentsInput[]): this;
     /** Removes intents in place. @returns This bitfield. */
-    remove(...bits: GatewayIntentResolvable[]): this;
+    remove(...bits: IntentsInput[]): this;
     /** Names of the set intents. */
     toArray(): (keyof typeof GatewayIntentBits)[];
     /** Whether this equals another bitfield. */
-    equals(bits: GatewayIntentResolvable): boolean;
+    equals(bits: IntentsInput): boolean;
     valueOf(): number;
     toJSON(): number;
 }
@@ -138,7 +141,7 @@ export interface GatewayProperties {
     os?: string;
     browser?: string;
     device?: string;
-    [key: string]: unknown;
+    [key: string]: string | undefined;
 }
 /** Gateway presence activity. */
 export interface GatewayPresenceActivity {
@@ -159,6 +162,12 @@ export interface ClientOptions {
     token: string;
     intents: GatewayIntentResolvable;
     gateway?: GatewayOptions;
+    /**
+     * zlib-stream transport compression for the Gateway connection, about a
+     * tenth of the inbound bandwidth. Shorthand for `gateway: { compress }`,
+     * which wins when both are set. Off by default.
+     */
+    compress?: boolean;
     rest?: RESTOptions;
     /** Opt-in bounded per-channel message cache. Messages are not cached by default. */
     messageCache?: {
@@ -175,6 +184,8 @@ export interface ClientOptions {
         members?: boolean;
         roles?: boolean;
         emojis?: boolean;
+        /** Keep each member's latest presence (needs the `GuildPresences` intent). Off by default: it is a lot of data. */
+        presences?: boolean;
     };
     /**
      * Default `allowed_mentions` for every message the client sends (channel
@@ -209,3 +220,4 @@ export interface RESTOptions {
     retries?: number;
     baseURL?: string;
 }
+export {};