baff.js 0.0.0-stage → 0.1.0

package/dist/cjs/structures/interactions/CommandInteraction.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatInputCommandInteraction = exports.CommandInteractionOptions = void 0;
+const BaffError_js_1 = require("../../errors/BaffError.js");
+const BaseInteraction_js_1 = require("./BaseInteraction.js");
+class CommandInteractionOptions {
+    client;
+    serverId;
+    data;
+    subcommandGroup;
+    subcommand;
+    values;
+    constructor(client, serverId, options = []) {
+        this.client = client;
+        this.serverId = serverId;
+        let level = options;
+        let group = null;
+        let sub = null;
+        if (level[0]?.type === 'subcommand_group') {
+            group = level[0].name;
+            level = level[0].options ?? [];
+        }
+        if (level[0]?.type === 'subcommand') {
+            sub = level[0].name;
+            level = level[0].options ?? [];
+        }
+        this.data = level;
+        this.subcommandGroup = group;
+        this.subcommand = sub;
+        this.values = new Map(level.map((o) => [o.name, o]));
+    }
+    get(name, required = false) {
+        const option = this.values.get(name) ?? null;
+        if (!option && required)
+            throw new BaffError_js_1.BaffError('COMMAND_OPTION_MISSING', `Required option "${name}" was not provided.`);
+        return option;
+    }
+    getSubcommand(required = true) {
+        if (!this.subcommand && required)
+            throw new BaffError_js_1.BaffError('COMMAND_SUBCOMMAND_MISSING', 'This interaction has no subcommand.');
+        return this.subcommand;
+    }
+    getSubcommandGroup(required = false) {
+        if (!this.subcommandGroup && required)
+            throw new BaffError_js_1.BaffError('COMMAND_SUBCOMMAND_GROUP_MISSING', 'This interaction has no subcommand group.');
+        return this.subcommandGroup;
+    }
+    getString(name, required = false) {
+        return this.typed(name, 'string', required);
+    }
+    getInteger(name, required = false) {
+        return this.typed(name, 'integer', required);
+    }
+    getNumber(name, required = false) {
+        return this.typed(name, 'number', required);
+    }
+    getBoolean(name, required = false) {
+        return this.typed(name, 'boolean', required);
+    }
+    getUserId(name, required = false) {
+        return this.typed(name, 'user', required);
+    }
+    getRoleId(name, required = false) {
+        return this.typed(name, 'role', required);
+    }
+    getChannelId(name, required = false) {
+        return this.typed(name, 'channel', required);
+    }
+    getUser(name) {
+        const id = this.getUserId(name);
+        return id ? (this.client.users.cache.get(id) ?? null) : null;
+    }
+    async fetchUser(name) {
+        const id = this.getUserId(name);
+        return id ? this.client.users.fetch(id) : null;
+    }
+    getRole(name) {
+        const id = this.getRoleId(name);
+        return id && this.serverId ? (this.client.servers.cache.get(this.serverId)?.roles.cache.get(id) ?? null) : null;
+    }
+    getChannel(name) {
+        const id = this.getChannelId(name);
+        return id ? (this.client.channels.cache.get(id) ?? null) : null;
+    }
+    typed(name, type, required) {
+        const option = this.get(name, required);
+        if (!option)
+            return null;
+        if (option.type !== type)
+            throw new BaffError_js_1.BaffError('COMMAND_OPTION_TYPE', `Option "${name}" is a ${option.type}, not a ${type}.`);
+        return option.value ?? null;
+    }
+}
+exports.CommandInteractionOptions = CommandInteractionOptions;
+class ChatInputCommandInteraction extends BaseInteraction_js_1.BaseInteraction {
+    commandId;
+    commandName;
+    options;
+    constructor(client, raw) {
+        super(client, raw);
+        this.commandId = raw.data.id ?? '';
+        this.commandName = raw.data.name ?? '';
+        this.options = new CommandInteractionOptions(client, raw.serverId, raw.data.options);
+    }
+    get fullCommandName() {
+        return [this.commandName, this.options.subcommandGroup, this.options.subcommand].filter(Boolean).join(' ');
+    }
+}
+exports.ChatInputCommandInteraction = ChatInputCommandInteraction;

package/dist/cjs/structures/interactions/ComponentInteraction.d.ts

@@ -0,0 +1,44 @@
+import type { Client } from '../../client/Client.js';
+import type { APIInteraction } from '../../types.js';
+import { Collection } from '../../util/Collection.js';
+import type { Message } from '../Message.js';
+import type { User } from '../User.js';
+import { BaseInteraction } from './BaseInteraction.js';
+export declare class MessageComponentInteraction extends BaseInteraction {
+    readonly customId: string;
+    readonly componentType: number;
+    readonly commandName: string;
+    private readonly source;
+    constructor(client: Client, raw: APIInteraction);
+    get message(): Message;
+}
+export declare class ButtonInteraction extends MessageComponentInteraction {
+    readonly label: string | null;
+    constructor(client: Client, raw: APIInteraction);
+}
+export declare class SelectMenuInteraction extends MessageComponentInteraction {
+    readonly values: string[];
+    readonly users: Collection<string, User>;
+    readonly roles: Collection<string, {
+        id: string;
+        name: string;
+        color: string | null;
+    }>;
+    readonly channels: Collection<string, {
+        id: string;
+        name: string;
+        type: number;
+        parentId: string | null;
+    }>;
+    constructor(client: Client, raw: APIInteraction);
+}
+export declare class StringSelectMenuInteraction extends SelectMenuInteraction {
+}
+export declare class UserSelectMenuInteraction extends SelectMenuInteraction {
+}
+export declare class RoleSelectMenuInteraction extends SelectMenuInteraction {
+}
+export declare class MentionableSelectMenuInteraction extends SelectMenuInteraction {
+}
+export declare class ChannelSelectMenuInteraction extends SelectMenuInteraction {
+}

package/dist/cjs/structures/interactions/ComponentInteraction.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelSelectMenuInteraction = exports.MentionableSelectMenuInteraction = exports.RoleSelectMenuInteraction = exports.UserSelectMenuInteraction = exports.StringSelectMenuInteraction = exports.SelectMenuInteraction = exports.ButtonInteraction = exports.MessageComponentInteraction = void 0;
+const Collection_js_1 = require("../../util/Collection.js");
+const BaseInteraction_js_1 = require("./BaseInteraction.js");
+class MessageComponentInteraction extends BaseInteraction_js_1.BaseInteraction {
+    customId;
+    componentType;
+    commandName;
+    source;
+    constructor(client, raw) {
+        super(client, raw);
+        this.customId = raw.data.customId ?? '';
+        this.componentType = raw.data.componentType ?? 0;
+        this.commandName = raw.message?.interactionName ?? '';
+        const channel = client.channels._textChannel(raw.channelId, raw.serverId);
+        this.source = channel.messages._add({ serverId: raw.serverId, ...raw.message });
+    }
+    get message() {
+        return this.source;
+    }
+}
+exports.MessageComponentInteraction = MessageComponentInteraction;
+class ButtonInteraction extends MessageComponentInteraction {
+    label;
+    constructor(client, raw) {
+        super(client, raw);
+        this.label = raw.data.label ?? null;
+    }
+}
+exports.ButtonInteraction = ButtonInteraction;
+class SelectMenuInteraction extends MessageComponentInteraction {
+    values;
+    users = new Collection_js_1.Collection();
+    roles = new Collection_js_1.Collection();
+    channels = new Collection_js_1.Collection();
+    constructor(client, raw) {
+        super(client, raw);
+        this.values = raw.data.values ?? [];
+        const resolved = raw.data.resolved ?? {};
+        for (const [id, user] of Object.entries(resolved.users ?? {}))
+            this.users.set(id, client.users._add(user));
+        for (const [id, role] of Object.entries(resolved.roles ?? {}))
+            this.roles.set(id, role);
+        for (const [id, channel] of Object.entries(resolved.channels ?? {}))
+            this.channels.set(id, channel);
+    }
+}
+exports.SelectMenuInteraction = SelectMenuInteraction;
+class StringSelectMenuInteraction extends SelectMenuInteraction {
+}
+exports.StringSelectMenuInteraction = StringSelectMenuInteraction;
+class UserSelectMenuInteraction extends SelectMenuInteraction {
+}
+exports.UserSelectMenuInteraction = UserSelectMenuInteraction;
+class RoleSelectMenuInteraction extends SelectMenuInteraction {
+}
+exports.RoleSelectMenuInteraction = RoleSelectMenuInteraction;
+class MentionableSelectMenuInteraction extends SelectMenuInteraction {
+}
+exports.MentionableSelectMenuInteraction = MentionableSelectMenuInteraction;
+class ChannelSelectMenuInteraction extends SelectMenuInteraction {
+}
+exports.ChannelSelectMenuInteraction = ChannelSelectMenuInteraction;

package/dist/cjs/structures/interactions/ModalSubmitInteraction.d.ts

@@ -0,0 +1,29 @@
+import type { Client } from '../../client/Client.js';
+import type { APIInteraction } from '../../types.js';
+import { Collection } from '../../util/Collection.js';
+import type { Message } from '../Message.js';
+import { BaseInteraction } from './BaseInteraction.js';
+export declare class ModalSubmitFields {
+    readonly fields: Collection<string, {
+        customId: string;
+        value: string;
+    }>;
+    constructor(list: {
+        customId: string;
+        value: string;
+    }[]);
+    getField(customId: string): {
+        customId: string;
+        value: string;
+    };
+    getTextInputValue(customId: string): string;
+}
+export declare class ModalSubmitInteraction extends BaseInteraction {
+    readonly customId: string;
+    readonly fields: ModalSubmitFields;
+    readonly commandName: string;
+    private readonly source;
+    constructor(client: Client, raw: APIInteraction);
+    get message(): Message | null;
+    isFromMessage(): boolean;
+}

package/dist/cjs/structures/interactions/ModalSubmitInteraction.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModalSubmitInteraction = exports.ModalSubmitFields = void 0;
+const BaffError_js_1 = require("../../errors/BaffError.js");
+const Collection_js_1 = require("../../util/Collection.js");
+const BaseInteraction_js_1 = require("./BaseInteraction.js");
+class ModalSubmitFields {
+    fields;
+    constructor(list) {
+        this.fields = new Collection_js_1.Collection(list.map((f) => [f.customId, f]));
+    }
+    getField(customId) {
+        const field = this.fields.get(customId);
+        if (!field)
+            throw new BaffError_js_1.BaffError('MODAL_FIELD_MISSING', `The modal has no field "${customId}".`);
+        return field;
+    }
+    getTextInputValue(customId) {
+        return this.getField(customId).value;
+    }
+}
+exports.ModalSubmitFields = ModalSubmitFields;
+class ModalSubmitInteraction extends BaseInteraction_js_1.BaseInteraction {
+    customId;
+    fields;
+    commandName;
+    source;
+    constructor(client, raw) {
+        super(client, raw);
+        this.customId = raw.data.customId ?? '';
+        this.fields = new ModalSubmitFields(raw.data.fields ?? []);
+        this.commandName = raw.message?.interactionName ?? '';
+        this.source = raw.message ? client.channels._textChannel(raw.channelId, raw.serverId).messages._add({ serverId: raw.serverId, ...raw.message }) : null;
+    }
+    get message() {
+        return this.source;
+    }
+    isFromMessage() {
+        return this.source !== null;
+    }
+}
+exports.ModalSubmitInteraction = ModalSubmitInteraction;

package/dist/cjs/structures/interactions/createInteraction.d.ts

@@ -0,0 +1,4 @@
+import type { Client } from '../../client/Client.js';
+import type { APIInteraction } from '../../types.js';
+import type { BaseInteraction } from './BaseInteraction.js';
+export declare function createInteraction(client: Client, raw: APIInteraction): BaseInteraction;

package/dist/cjs/structures/interactions/createInteraction.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInteraction = createInteraction;
+const BaffError_js_1 = require("../../errors/BaffError.js");
+const CommandInteraction_js_1 = require("./CommandInteraction.js");
+const ComponentInteraction_js_1 = require("./ComponentInteraction.js");
+const ModalSubmitInteraction_js_1 = require("./ModalSubmitInteraction.js");
+function createInteraction(client, raw) {
+    switch (raw.type) {
+        case 'command':
+            return new CommandInteraction_js_1.ChatInputCommandInteraction(client, raw);
+        case 'modal_submit':
+            return new ModalSubmitInteraction_js_1.ModalSubmitInteraction(client, raw);
+        case 'component':
+            switch (raw.data.componentType) {
+                case 2:
+                    return new ComponentInteraction_js_1.ButtonInteraction(client, raw);
+                case 3:
+                    return new ComponentInteraction_js_1.StringSelectMenuInteraction(client, raw);
+                case 5:
+                    return new ComponentInteraction_js_1.UserSelectMenuInteraction(client, raw);
+                case 6:
+                    return new ComponentInteraction_js_1.RoleSelectMenuInteraction(client, raw);
+                case 7:
+                    return new ComponentInteraction_js_1.MentionableSelectMenuInteraction(client, raw);
+                case 8:
+                    return new ComponentInteraction_js_1.ChannelSelectMenuInteraction(client, raw);
+                default:
+                    return new ComponentInteraction_js_1.MessageComponentInteraction(client, raw);
+            }
+        default:
+            throw new BaffError_js_1.BaffError('UNKNOWN_INTERACTION', `Unknown interaction type "${String(raw.type)}".`);
+    }
+}

package/dist/cjs/types.d.ts

@@ -0,0 +1,369 @@
+export type Id = string;
+export interface APIUser {
+    id: Id;
+    username: string;
+    displayName?: string | null;
+    avatarUrl?: string | null;
+    bannerUrl?: string | null;
+    tag?: 'bot' | 'verified_bot' | 'official' | 'system' | 'staff' | null;
+    clanTag?: APIClanTag | null;
+    status?: string;
+    customStatus?: string | null;
+    deleted?: boolean;
+    avatarDecoration?: {
+        id: string;
+        url: string;
+        animated: boolean;
+    } | null;
+}
+export interface APIClanTag {
+    serverId: Id;
+    name: string;
+    badge: string;
+    color: number;
+}
+export interface APIEmbedMedia {
+    url: string;
+    width?: number;
+    height?: number;
+}
+export interface APIEmbed {
+    type?: string;
+    title?: string;
+    description?: string;
+    url?: string;
+    timestamp?: string;
+    color?: number;
+    footer?: {
+        text: string;
+        icon_url?: string;
+    };
+    image?: APIEmbedMedia;
+    thumbnail?: APIEmbedMedia;
+    video?: APIEmbedMedia;
+    provider?: {
+        name?: string;
+        url?: string;
+    };
+    author?: {
+        name: string;
+        url?: string;
+        icon_url?: string;
+    };
+    fields?: {
+        name: string;
+        value: string;
+        inline?: boolean;
+    }[];
+}
+export interface APIComponent {
+    type: number;
+    id?: number;
+    [key: string]: unknown;
+}
+export interface APIAttachment {
+    id: Id;
+    filename: string;
+    contentType: string;
+    size: number;
+    width?: number | null;
+    height?: number | null;
+    url: string;
+}
+export interface APIReaction {
+    emoji: string;
+    count: number;
+    me: boolean;
+}
+export interface APISticker {
+    id: Id;
+    name: string;
+    url?: string;
+    animated: boolean;
+    serverId?: Id;
+    deleted?: boolean;
+    description?: string;
+    emoji?: string | null;
+}
+export interface APIMessage {
+    id: Id;
+    channelId: Id;
+    serverId?: Id | null;
+    author: APIUser;
+    content: string;
+    createdAt: string;
+    editedAt: string | null;
+    type?: number;
+    attachments: APIAttachment[];
+    embeds: APIEmbed[];
+    components: APIComponent[];
+    flags: number;
+    reactions: APIReaction[];
+    mentions: Id[];
+    mentionRoles: Id[];
+    mentionEveryone: boolean;
+    reply?: {
+        id: Id;
+        author: APIUser;
+        content: string;
+        hasAttachments?: boolean;
+        forwarded?: boolean;
+    };
+    replyDeleted?: boolean;
+    pinned?: boolean;
+    crossposted?: boolean;
+    stickers?: APISticker[];
+    poll?: unknown;
+    forward?: unknown;
+    interaction?: {
+        user: APIUser;
+        name: string;
+    };
+    nonce?: string;
+    interactionName?: string;
+}
+export interface APIRole {
+    id: Id;
+    name: string;
+    color: string | null;
+    hoist: boolean;
+    position: number;
+    permissions: number | string;
+    badge?: string | null;
+    icon?: string | null;
+    botId?: Id | null;
+    booster?: boolean;
+}
+export type ChannelKind = 'category' | 'text' | 'announcement' | 'forum' | 'voice' | 'stage' | 'thread' | 'dm' | 'group_dm';
+export interface APIChannel {
+    id: Id;
+    name?: string;
+    kind?: ChannelKind;
+    type?: ChannelKind;
+    serverId?: Id | null;
+    position?: number;
+    parentId?: Id | null;
+    topic?: string | null;
+    slowmodeSecs?: number;
+    contentMode?: 'default' | 'spoiler' | 'age_restricted';
+    autoArchiveMinutes?: number | null;
+    archived?: boolean;
+    threadOwnerId?: Id | null;
+    threadStarterId?: Id | null;
+    threadLocked?: boolean;
+    messageCount?: number;
+    lastMessageId?: Id | null;
+    voiceStatus?: string | null;
+    availableTags?: {
+        id: Id;
+        name: string;
+        emoji: string | null;
+    }[];
+    appliedTags?: Id[];
+    requireTag?: boolean;
+    pinned?: boolean;
+    recipient?: APIUser;
+    recipients?: APIUser[];
+    ownerId?: Id | null;
+    iconUrl?: string | null;
+}
+export interface APIServerSummary {
+    id: Id;
+    name: string;
+    iconUrl: string | null;
+    types?: string[];
+    community?: boolean;
+    listed?: boolean;
+    bannerUrl?: string | null;
+    boostCount?: number;
+    boostTier?: number;
+}
+export interface APIServer extends APIServerSummary {
+    ownerId: Id;
+    channels: APIChannel[];
+    roles: APIRole[];
+    myRoles: Id[];
+    invitesPaused?: boolean;
+    systemChannelId?: Id | null;
+    systemFlags?: number;
+    defaultNotifications?: 'all' | 'mentions';
+    pending?: boolean;
+}
+export interface APIMember {
+    user: APIUser;
+    status?: string;
+    customStatus?: string | null;
+    isOwner?: boolean;
+    roles: Id[];
+    nick: string | null;
+    avatarUrl?: string | null;
+    bannerUrl?: string | null;
+    joinedAt?: string;
+    pending?: boolean;
+    timeoutUntil?: string | null;
+}
+export interface APIEmoji {
+    id: Id;
+    serverId: Id;
+    name: string;
+    animated: boolean;
+    url: string;
+    uploader?: string | null;
+}
+export interface APIInvite {
+    code: string;
+    maxAgeSecs?: number;
+    expiresAt?: string | null;
+    maxUses?: number;
+    uses?: number;
+    temporary?: boolean;
+    inviter?: {
+        id: Id;
+        username: string;
+        displayName?: string;
+    } | null;
+    vanity?: boolean;
+    server?: {
+        id: Id;
+        name: string;
+        iconUrl: string | null;
+        memberCount?: number;
+        onlineCount?: number;
+    };
+}
+export interface APIWebhook {
+    id: Id;
+    userId: Id;
+    name: string;
+    path: string;
+    createdBy?: string | null;
+    createdAt: string;
+}
+export interface APIBan {
+    user: APIUser;
+    reason: string | null;
+    createdAt: string;
+}
+export interface APIServerEvent {
+    id: Id;
+    serverId: Id;
+    creatorId: Id | null;
+    creator?: APIUser;
+    name: string;
+    description: string;
+    locationKind: 'voice' | 'external';
+    channelId: Id | null;
+    location: string | null;
+    startAt: string;
+    endAt: string | null;
+    coverUrl: string | null;
+    status: 'scheduled' | 'active' | 'completed' | 'canceled';
+    createdAt: string;
+    interestedCount: number;
+    interested?: boolean;
+}
+export interface APIAuditEntry {
+    id: Id;
+    action: string;
+    actorId: Id | null;
+    targetType: string;
+    targetId: Id | null;
+    targetName: string | null;
+    reason: string | null;
+    changes: {
+        key: string;
+        old: unknown;
+        new: unknown;
+    }[];
+    extra: Record<string, unknown>;
+    createdAt: string;
+}
+export interface APICommandOption {
+    name: string;
+    description: string;
+    type: string;
+    required?: boolean;
+    options?: APICommandOption[];
+}
+export interface APICommand {
+    id?: Id;
+    applicationId?: Id;
+    serverId?: Id | null;
+    kind?: 'slash' | 'prefix';
+    name: string;
+    description: string;
+    options?: APICommandOption[];
+    prefix?: string | null;
+}
+export interface APIInteractionOption {
+    name: string;
+    type: string;
+    value?: string | number | boolean;
+    options?: APIInteractionOption[];
+}
+export interface APIInteraction {
+    type: 'command' | 'component' | 'modal_submit' | 'ping';
+    id: Id;
+    token: string;
+    applicationId: Id;
+    channelId: Id;
+    serverId: Id | null;
+    user: APIUser & {
+        roles?: Id[];
+        permissions?: string;
+    };
+    appPermissions?: string;
+    message?: APIMessage;
+    data: {
+        id?: Id;
+        name?: string;
+        options?: APIInteractionOption[];
+        customId?: string;
+        componentType?: number;
+        label?: string;
+        values?: string[];
+        resolved?: {
+            users?: Record<string, APIUser>;
+            roles?: Record<string, {
+                id: Id;
+                name: string;
+                color: string | null;
+            }>;
+            channels?: Record<string, {
+                id: Id;
+                name: string;
+                type: number;
+                parentId: Id | null;
+            }>;
+        };
+        fields?: {
+            customId: string;
+            value: string;
+        }[];
+    };
+}
+export interface APIVoiceJoin {
+    url: string;
+    token: string;
+    canSpeak: boolean;
+    canVideo: boolean;
+    deafened: boolean;
+    suppress: boolean;
+    audioBitrate: number;
+    room: string;
+    identity: string;
+    serverId: Id | null;
+    channelId: Id;
+}
+export interface APIVoiceState {
+    userId: Id;
+    serverId: Id | null;
+    channelId: Id | null;
+    muted: boolean;
+    deafened: boolean;
+    selfVideo: boolean;
+    selfStream: boolean;
+    suppress: boolean;
+    requestToSpeakAt: string | null;
+    invitedToSpeak: boolean;
+}

package/dist/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });