lunibee 0.1.6 → 0.1.8

package/dist/structures/audit-log.d.ts

@@ -0,0 +1,26 @@
+import { BaseStructure } from "./base.js";
+import type { APIAuditLog, APIAuditLogEntry, APIAuditLogChange, APIAuditLogOptions } from "@lunibee/types";
+/** Represents a single entry in a Discord audit log. */
+export declare class AuditLogEntry extends BaseStructure {
+    /** The ID of the affected entity. */
+    readonly targetId: string | null;
+    /** The ID of the user who made the changes. */
+    readonly userId: string | null;
+    /** The action type of this entry. */
+    readonly actionType: number;
+    /** The changes made to the target. */
+    readonly changes: APIAuditLogChange[];
+    /** Additional info for certain action types. */
+    readonly options: APIAuditLogOptions | null;
+    /** The reason for the change, if any. */
+    readonly reason: string | null;
+    /** Creates an audit log entry. */
+    constructor(data: APIAuditLogEntry);
+}
+/** Represents a Discord audit log. */
+export declare class AuditLog {
+    /** The entries in the audit log. */
+    readonly entries: Map<string, AuditLogEntry>;
+    /** Creates an audit log. */
+    constructor(data: APIAuditLog);
+}

package/dist/structures/base.d.ts

@@ -25,12 +25,18 @@ export interface ResourceContext {
     pinMessage?(channelId: string, messageId: string): Promise<void>;
     unpinMessage?(channelId: string, messageId: string): Promise<void>;
 }
+export declare const CDN_BASE = "https://cdn.discordapp.com";
 /** Options for CDN image URLs. */
 export interface ImageURLOptions {
     extension?: "png" | "jpg" | "webp" | "gif" | "jpeg";
     size?: 16 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096;
     forceStatic?: boolean;
 }
+/** Builds a Discord CDN asset URL from a directory path and asset hash, applying
+ * animated-hash (`a_`) gif detection, extension and size options. Shared by all
+ * hash-backed asset accessors (user/member/role/webhook) to avoid duplicating the logic.
+ * @param path CDN directory path, e.g. `/role-icons/{id}`. @param hash Asset hash. @param options Image URL options. */
+export declare function cdnURL(path: string, hash: string, options?: ImageURLOptions): string;
 export declare class User extends BaseStructure {
     username: string;
     globalName: string | null;
@@ -83,6 +89,14 @@ export declare class Channel extends BaseStructure {
     delete(): Promise<void>;
     /** Updates this channel using the same resource operation as edit. @param options Channel fields to change. @returns The updated channel. @throws {Error} If the channel is not attached to a client. */
     update(options: Record<string, unknown>): Promise<Channel>;
+    /** Whether this is a thread (announcement, public or private). */
+    isThread(): boolean;
+    /** Whether messages can be sent in this channel (text, DM, announcement, voice, stage, threads). */
+    isTextBased(): boolean;
+    /** Whether this is a voice or stage channel. */
+    isVoiceBased(): boolean;
+    /** Whether this is a direct-message channel (DM or group DM). */
+    isDMBased(): boolean;
     /** Returns the Discord channel mention string. Used automatically in template literals. */
     toString(): string;
 }
@@ -104,6 +118,20 @@ export declare class Guild extends BaseStructure {
     vanityUrlCode: string | null;
     nsfwLevel: number;
     discoverySplash: string | null;
+    /** ID of the rules channel for Community guilds. */
+    rulesChannelId: string | null;
+    /** ID of the system messages channel. */
+    systemChannelId: string | null;
+    /** Bitfield of system channel flags. */
+    systemChannelFlags: number;
+    /** Maximum number of members the guild can have. */
+    maxMembers: number;
+    /** Required MFA level for administrators. */
+    mfaLevel: number;
+    /** Explicit content filter level. */
+    explicitContentFilter: number;
+    /** Default notification level for new members. */
+    defaultMessageNotifications: number;
     constructor(data: import("@lunibee/types").APIGuild);
     /** Returns the guild icon URL, or null if no icon is set. */
     iconURL(options?: ImageURLOptions): string | null;
@@ -113,10 +141,22 @@ export declare class Guild extends BaseStructure {
     bannerURL(options?: ImageURLOptions): string | null;
     /** Returns the guild discovery splash URL, or null if none. */
     discoverySplashURL(options?: ImageURLOptions): string | null;
+    /** Returns a widget image URL for the guild.
+     * @param style Widget style: shield (default), banner1, banner2, banner3, banner4.
+     */
+    widgetImageURL(style?: "shield" | "banner1" | "banner2" | "banner3" | "banner4"): string;
     /** Whether the guild has a given feature flag. @param feature Feature string, e.g. "COMMUNITY". */
     hasFeature(feature: string): boolean;
     /** Whether the guild is a Community server. */
     get isCommunity(): boolean;
+    /** Whether the guild is an official Discord Partner. */
+    get isPartnered(): boolean;
+    /** Whether the guild is verified by Discord. */
+    get isVerified(): boolean;
+    /** Whether the guild has any active boost subscriptions. */
+    get isBoosted(): boolean;
+    /** Alias for premiumTier — the guild's current Nitro boost level (0–3). */
+    get boostLevel(): number;
     /** Whether the guild has a vanity URL. */
     get hasVanityUrl(): boolean;
     /** Returns the guild's vanity invite URL, or null if none. */

package/dist/structures/channels.d.ts

@@ -0,0 +1,56 @@
+import { Channel, User, type ResourceContext } from "./base.js";
+import { TextChannel } from "./resources.js";
+import type { APIChannel, APIForumTag, APIPartialEmoji, APIThreadMetadata } from "@lunibee/types";
+/** A guild announcement (news) channel. */
+export declare class NewsChannel extends TextChannel {
+}
+/** A direct-message or group DM channel. */
+export declare class DMChannel extends Channel {
+    /** Users in the conversation. */ readonly recipients: User[];
+    /** Owner of a group DM. */ readonly ownerId: string | null;
+    constructor(data: APIChannel, context?: ResourceContext);
+}
+/** A guild voice channel. */
+export declare class VoiceChannel extends Channel {
+    /** Bitrate in bits per second. */ bitrate: number;
+    /** User limit (0 = unlimited). */ userLimit: number;
+    /** Voice region override, or null for automatic. */ rtcRegion: string | null;
+    /** Camera video quality mode. */ videoQualityMode: number;
+    constructor(data: APIChannel, context?: ResourceContext);
+}
+/** A guild stage channel. */
+export declare class StageChannel extends VoiceChannel {
+}
+/** A guild category. */
+export declare class CategoryChannel extends Channel {
+}
+/** A thread (announcement, public or private). */
+export declare class ThreadChannel extends Channel {
+    /** User who created the thread. */ readonly ownerId: string | null;
+    /** Approximate message count. */ messageCount: number;
+    /** Approximate member count (stops counting at 50). */ memberCount: number;
+    /** Thread metadata. */ metadata: APIThreadMetadata | null;
+    constructor(data: APIChannel, context?: ResourceContext);
+    /** Whether the thread is archived. */
+    get archived(): boolean;
+    /** Whether the thread is locked. */
+    get locked(): boolean;
+    /** Minutes of inactivity before the thread auto-archives. */
+    get autoArchiveDuration(): number | null;
+}
+/** A guild forum channel. */
+export declare class ForumChannel extends Channel {
+    /** Tags that threads can apply. */ availableTags: APIForumTag[];
+    /** Default reaction for new threads. */ defaultReactionEmoji: APIPartialEmoji | null;
+    /** Default slowmode for new threads. */ defaultThreadRateLimitPerUser: number;
+    /** Default auto-archive duration for new threads. */ defaultAutoArchiveDuration: number | null;
+    constructor(data: APIChannel, context?: ResourceContext);
+}
+/** A guild media channel. */
+export declare class MediaChannel extends ForumChannel {
+}
+/**
+ * Builds the most specific channel class for a payload's `type`, falling back
+ * to {@link Channel} for types without a dedicated class.
+ */
+export declare function createChannel(data: APIChannel, context?: ResourceContext): Channel;

package/dist/structures/index.d.ts

@@ -27,6 +27,12 @@ export declare class Message extends BaseStructure {
     constructor(data: import("@lunibee/types").APIMessage, context?: ResourceContext);
     /** Whether embeds are suppressed on this message. */
     get embedsSuppressed(): boolean;
+    /** Unix timestamp (ms) at which the message was created — discord.js parity.
+     * Derived from the message `timestamp`, which itself falls back to the id snowflake. */
+    get createdTimestamp(): number;
+    /** Date at which the message was created — discord.js parity. Overrides the
+     * snowflake-only `BaseStructure.createdAt` to honour the message `timestamp`. */
+    get createdAt(): Date;
     /** Edits this message. @param options Message fields to change. @returns The updated message. @throws {Error} If the message is not attached to a client. */
     edit(options: Record<string, unknown> & {
         content?: string;
@@ -53,7 +59,30 @@ export declare class Message extends BaseStructure {
     pin(): Promise<void>;
     /** Unpins this message. @returns A promise fulfilled when the message is unpinned. @throws {Error} If pin operations are unavailable. */
     unpin(): Promise<void>;
+    /** Whether this message was sent ephemerally (only visible to the recipient). */
+    get isEphemeral(): boolean;
+    /** Whether this message is currently pinned in its channel. */
+    get isPinned(): boolean;
+    /** Whether this is a system-generated message (join, boost, etc). Mirrors
+     * discord.js: a message is "system" unless its type is one of the user-authored
+     * types — Default (0), Reply (19), ChatInputCommand (20) or ContextMenuCommand (23). */
+    get isSystemMessage(): boolean;
+    /** Whether this message was crossposted from an announcement channel. */
+    get isCrosspost(): boolean;
+    /** Whether this message has file attachments. */
+    get hasAttachments(): boolean;
+    /** Whether this message contains embeds. */
+    get hasEmbeds(): boolean;
+    /** Whether this message contains interactive components. */
+    get hasComponents(): boolean;
+    /** Edits this message to suppress its embeds. @returns The updated message. */
+    suppressEmbeds(): Promise<Message>;
+    /** Returns a plain-object snapshot of all message fields. */
+    toJSON(): Record<string, unknown>;
 }
-export { GuildMember, Role, TextChannel } from "./resources.js";
+export { GuildMember, Role, TextChannel, Invite, Webhook, WebhookType, Emoji, AutoModerationRule, WelcomeScreenChannel, GuildWelcomeScreen, OnboardingPromptOption, OnboardingPrompt, GuildOnboarding, } from "./resources.js";
+export { NewsChannel, DMChannel, VoiceChannel, StageChannel, CategoryChannel, ThreadChannel, ForumChannel, MediaChannel, createChannel, } from "./channels.js";
 export * from "./interactions.js";
 export { Embed } from "./embed.js";
+export { AuditLog, AuditLogEntry } from "./audit-log.js";
+export { PermissionsBitField } from "@lunibee/core";