baff.js 0.0.0-stage → 0.1.1

package/dist/cjs/structures/ServerAssets.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Invite = exports.Sticker = exports.Emoji = void 0;
+const BaffError_js_1 = require("../errors/BaffError.js");
+const Routes_js_1 = require("../rest/Routes.js");
+const formatters_js_1 = require("../util/formatters.js");
+const Base_js_1 = require("./Base.js");
+class Emoji extends Base_js_1.Identified {
+    id;
+    serverId;
+    name;
+    animated;
+    url;
+    uploader;
+    constructor(client, data) {
+        super(client);
+        this.id = data.id;
+        this.serverId = data.serverId;
+        this.name = data.name;
+        this.animated = data.animated;
+        this.url = data.url;
+        this.uploader = data.uploader ?? null;
+    }
+    get identifier() {
+        return `${this.animated ? 'a:' : ''}${this.name}:${this.id}`;
+    }
+    async setName(name) {
+        const data = await this.client.rest.patch(Routes_js_1.Routes.serverEmoji(this.serverId, this.id), { body: { name } });
+        this.name = data.name;
+        return this;
+    }
+    delete() {
+        return this.client.rest.delete(Routes_js_1.Routes.serverEmoji(this.serverId, this.id));
+    }
+    toString() {
+        return (0, formatters_js_1.formatEmoji)(this.id, this.name, this.animated);
+    }
+}
+exports.Emoji = Emoji;
+class Sticker extends Base_js_1.Identified {
+    id;
+    serverId;
+    name;
+    description;
+    emoji;
+    animated;
+    url;
+    constructor(client, data, serverId) {
+        super(client);
+        this.id = data.id;
+        this.serverId = data.serverId ?? serverId ?? null;
+        this.name = data.name;
+        this.description = data.description ?? '';
+        this.emoji = data.emoji ?? null;
+        this.animated = data.animated;
+        this.url = data.url ?? null;
+    }
+    async edit(data) {
+        const updated = await this.client.rest.patch(Routes_js_1.Routes.serverSticker(this.serverId, this.id), { body: data });
+        Object.assign(this, { name: updated.name, description: updated.description ?? this.description, emoji: updated.emoji ?? null });
+        return this;
+    }
+    delete() {
+        return this.client.rest.delete(Routes_js_1.Routes.serverSticker(this.serverId, this.id));
+    }
+}
+exports.Sticker = Sticker;
+class Invite extends Base_js_1.Base {
+    serverId;
+    code;
+    maxAgeSecs;
+    maxUses;
+    uses;
+    temporary;
+    expiresAt;
+    inviterId;
+    vanity;
+    server;
+    constructor(client, data, serverId = data.server?.id ?? null) {
+        super(client);
+        this.serverId = serverId;
+        this.code = data.code;
+        this.maxAgeSecs = data.maxAgeSecs ?? null;
+        this.maxUses = data.maxUses ?? null;
+        this.uses = data.uses ?? 0;
+        this.temporary = data.temporary ?? false;
+        this.expiresAt = data.expiresAt ? new Date(data.expiresAt) : null;
+        this.inviterId = data.inviter?.id ?? null;
+        this.vanity = data.vanity ?? false;
+        this.server = data.server;
+    }
+    get url() {
+        return `${this.client.appUrl}/invite/${this.code}`;
+    }
+    async delete() {
+        if (!this.serverId)
+            throw new BaffError_js_1.BaffError('INVITE_HAS_NO_SERVER', 'This invite has no server to delete it from.');
+        await this.client.rest.delete(Routes_js_1.Routes.serverInvite(this.serverId, this.code));
+    }
+    toString() {
+        return this.url;
+    }
+}
+exports.Invite = Invite;

package/dist/cjs/structures/ServerMember.d.ts

@@ -0,0 +1,47 @@
+import type { Client } from '../client/Client.js';
+import type { MessageOptions } from '../builders/messagePayload.js';
+import type { APIMember } from '../types.js';
+import { Collection } from '../util/Collection.js';
+import { PermissionsBitField } from '../util/Permissions.js';
+import { Base } from './Base.js';
+import type { Message } from './Message.js';
+import type { Role } from './Role.js';
+import type { Server } from './Server.js';
+import type { User } from './User.js';
+export declare class MemberRoleManager {
+    private readonly member;
+    constructor(member: ServerMember);
+    get cache(): Collection<string, Role>;
+    get highest(): Role | undefined;
+    add(role: string | Role): Promise<ServerMember>;
+    remove(role: string | Role): Promise<ServerMember>;
+}
+export declare class ServerMember extends Base {
+    readonly serverId: string;
+    readonly user: User;
+    roleIds: string[];
+    nick: string | null;
+    avatarUrl: string | null;
+    bannerUrl: string | null;
+    joinedAt: Date | null;
+    pending: boolean;
+    timeoutUntil: Date | null;
+    readonly roles: MemberRoleManager;
+    constructor(client: Client, serverId: string, user: User, data: Partial<APIMember>);
+    _clone(): this;
+    _patch(data: Partial<APIMember>): this;
+    get id(): string;
+    get server(): Server | null;
+    get displayName(): string;
+    get isOwner(): boolean;
+    get timedOut(): boolean;
+    get permissions(): PermissionsBitField;
+    kick(reason?: string): Promise<void>;
+    ban(options?: {
+        reason?: string;
+    }): Promise<void>;
+    timeout(durationMs: number | null, reason?: string): Promise<ServerMember>;
+    setNickname(nick: string | null): Promise<ServerMember>;
+    send(options: string | MessageOptions): Promise<Message>;
+    toString(): string;
+}

package/dist/cjs/structures/ServerMember.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerMember = exports.MemberRoleManager = void 0;
+const Routes_js_1 = require("../rest/Routes.js");
+const Collection_js_1 = require("../util/Collection.js");
+const Permissions_js_1 = require("../util/Permissions.js");
+const formatters_js_1 = require("../util/formatters.js");
+const Base_js_1 = require("./Base.js");
+class MemberRoleManager {
+    member;
+    constructor(member) {
+        this.member = member;
+    }
+    get cache() {
+        const roles = this.member.server?.roles.cache;
+        const out = new Collection_js_1.Collection();
+        if (!roles)
+            return out;
+        for (const id of [this.member.server.id, ...this.member.roleIds]) {
+            const role = roles.get(id);
+            if (role)
+                out.set(id, role);
+        }
+        return out;
+    }
+    get highest() {
+        return this.cache.sort((a, b) => b.position - a.position).first();
+    }
+    async add(role) {
+        const id = typeof role === 'string' ? role : role.id;
+        await this.member.client.rest.put(Routes_js_1.Routes.memberRole(this.member.serverId, this.member.id, id));
+        if (!this.member.roleIds.includes(id))
+            this.member.roleIds.push(id);
+        return this.member;
+    }
+    async remove(role) {
+        const id = typeof role === 'string' ? role : role.id;
+        await this.member.client.rest.delete(Routes_js_1.Routes.memberRole(this.member.serverId, this.member.id, id));
+        this.member.roleIds = this.member.roleIds.filter((r) => r !== id);
+        return this.member;
+    }
+}
+exports.MemberRoleManager = MemberRoleManager;
+class ServerMember extends Base_js_1.Base {
+    serverId;
+    user;
+    roleIds = [];
+    nick = null;
+    avatarUrl = null;
+    bannerUrl = null;
+    joinedAt = null;
+    pending = false;
+    timeoutUntil = null;
+    roles = new MemberRoleManager(this);
+    constructor(client, serverId, user, data) {
+        super(client);
+        this.serverId = serverId;
+        this.user = user;
+        this._patch(data);
+    }
+    _clone() {
+        const copy = super._clone();
+        copy.roles = new MemberRoleManager(copy);
+        copy.roleIds = [...this.roleIds];
+        return copy;
+    }
+    _patch(data) {
+        if (data.roles !== undefined)
+            this.roleIds = [...data.roles];
+        if (data.nick !== undefined)
+            this.nick = data.nick;
+        if (data.avatarUrl !== undefined)
+            this.avatarUrl = data.avatarUrl ?? null;
+        if (data.bannerUrl !== undefined)
+            this.bannerUrl = data.bannerUrl ?? null;
+        if (data.joinedAt !== undefined)
+            this.joinedAt = new Date(data.joinedAt);
+        if (data.pending !== undefined)
+            this.pending = data.pending;
+        if (data.timeoutUntil !== undefined)
+            this.timeoutUntil = data.timeoutUntil ? new Date(data.timeoutUntil) : null;
+        return this;
+    }
+    get id() {
+        return this.user.id;
+    }
+    get server() {
+        return this.client.servers.cache.get(this.serverId) ?? null;
+    }
+    get displayName() {
+        return this.nick ?? this.user.displayName;
+    }
+    get isOwner() {
+        return this.server?.ownerId === this.id;
+    }
+    get timedOut() {
+        return this.timeoutUntil !== null && this.timeoutUntil.getTime() > Date.now();
+    }
+    get permissions() {
+        if (this.isOwner)
+            return Permissions_js_1.PermissionsBitField.All;
+        const bits = this.roles.cache.reduce((acc, role) => acc | role.permissions.bitfield, 0n);
+        const all = new Permissions_js_1.PermissionsBitField(bits);
+        if (all.has(Permissions_js_1.PermissionFlagsBits.Administrator, false))
+            return Permissions_js_1.PermissionsBitField.All;
+        return this.timedOut ? new Permissions_js_1.PermissionsBitField(Permissions_js_1.PermissionFlagsBits.ViewChannel) : all;
+    }
+    kick(reason) {
+        return this.client.rest.delete(Routes_js_1.Routes.serverMember(this.serverId, this.id), { body: reason ? { reason } : undefined });
+    }
+    ban(options = {}) {
+        return this.client.rest.put(Routes_js_1.Routes.serverBan(this.serverId, this.id), { body: options });
+    }
+    async timeout(durationMs, reason) {
+        if (durationMs === null) {
+            await this.client.rest.delete(Routes_js_1.Routes.memberTimeout(this.serverId, this.id));
+            this.timeoutUntil = null;
+            return this;
+        }
+        const res = await this.client.rest.put(Routes_js_1.Routes.memberTimeout(this.serverId, this.id), {
+            body: { durationSecs: Math.round(durationMs / 1000), reason }
+        });
+        this.timeoutUntil = new Date(res.timeoutUntil);
+        return this;
+    }
+    async setNickname(nick) {
+        await this.client.rest.patch(Routes_js_1.Routes.serverMember(this.serverId, this.id), { body: { nick } });
+        this.nick = nick || null;
+        return this;
+    }
+    send(options) {
+        return this.user.send(options);
+    }
+    toString() {
+        return (0, formatters_js_1.userMention)(this.id);
+    }
+}
+exports.ServerMember = ServerMember;

package/dist/cjs/structures/User.d.ts

@@ -0,0 +1,35 @@
+import type { Client } from '../client/Client.js';
+import type { MessageOptions } from '../builders/messagePayload.js';
+import type { APIUser } from '../types.js';
+import { Identified } from './Base.js';
+import type { DMChannel } from './channels/DMChannel.js';
+import type { Message } from './Message.js';
+export declare class User extends Identified {
+    readonly id: string;
+    username: string;
+    displayName: string;
+    avatarUrl: string | null;
+    bannerUrl: string | null;
+    tag: APIUser['tag'];
+    clanTag: APIUser['clanTag'];
+    status: string | null;
+    customStatus: string | null;
+    deleted: boolean;
+    constructor(client: Client, data: APIUser);
+    _patch(data: Partial<APIUser>): this;
+    get bot(): boolean;
+    get system(): boolean;
+    createDM(): Promise<DMChannel>;
+    send(options: string | MessageOptions): Promise<Message>;
+    fetchProfile(serverId?: string): Promise<Record<string, unknown>>;
+    toString(): string;
+}
+export declare class ClientUser extends User {
+    get bot(): boolean;
+    setPresence(presence: {
+        status?: 'online' | 'idle' | 'dnd' | 'invisible';
+        customStatus?: string | null;
+    }): Promise<void>;
+    setStatus(status: 'online' | 'idle' | 'dnd' | 'invisible'): Promise<void>;
+    setCustomStatus(customStatus: string | null): Promise<void>;
+}

package/dist/cjs/structures/User.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientUser = exports.User = void 0;
+const Routes_js_1 = require("../rest/Routes.js");
+const formatters_js_1 = require("../util/formatters.js");
+const Base_js_1 = require("./Base.js");
+class User extends Base_js_1.Identified {
+    id;
+    username;
+    displayName;
+    avatarUrl = null;
+    bannerUrl = null;
+    tag = null;
+    clanTag = null;
+    status = null;
+    customStatus = null;
+    deleted = false;
+    constructor(client, data) {
+        super(client);
+        this.id = data.id;
+        this.username = data.username;
+        this.displayName = data.displayName || data.username;
+        this._patch(data);
+    }
+    _patch(data) {
+        if (data.username !== undefined)
+            this.username = data.username;
+        if (data.displayName !== undefined)
+            this.displayName = data.displayName || this.username;
+        if (data.avatarUrl !== undefined)
+            this.avatarUrl = data.avatarUrl;
+        if (data.bannerUrl !== undefined)
+            this.bannerUrl = data.bannerUrl;
+        if (data.tag !== undefined)
+            this.tag = data.tag;
+        if (data.clanTag !== undefined)
+            this.clanTag = data.clanTag;
+        if (data.status !== undefined)
+            this.status = data.status;
+        if (data.customStatus !== undefined)
+            this.customStatus = data.customStatus;
+        if (data.deleted !== undefined)
+            this.deleted = data.deleted;
+        return this;
+    }
+    get bot() {
+        return this.tag === 'bot' || this.tag === 'verified_bot';
+    }
+    get system() {
+        return this.tag === 'system';
+    }
+    async createDM() {
+        const data = await this.client.rest.post(Routes_js_1.Routes.dms(), { body: { recipientId: this.id } });
+        return this.client.channels._addDM(data);
+    }
+    async send(options) {
+        return (await this.createDM()).send(options);
+    }
+    async fetchProfile(serverId) {
+        const profile = await this.client.rest.get(Routes_js_1.Routes.userProfile(this.id), { query: { serverId } });
+        this._patch(profile.user);
+        return profile;
+    }
+    toString() {
+        return (0, formatters_js_1.userMention)(this.id);
+    }
+}
+exports.User = User;
+class ClientUser extends User {
+    get bot() {
+        return true;
+    }
+    async setPresence(presence) {
+        await this.client.rest.patch(Routes_js_1.Routes.presence(), { body: presence });
+        if (presence.status)
+            this.status = presence.status;
+        if (presence.customStatus !== undefined)
+            this.customStatus = presence.customStatus;
+    }
+    setStatus(status) {
+        return this.setPresence({ status });
+    }
+    setCustomStatus(customStatus) {
+        return this.setPresence({ customStatus });
+    }
+}
+exports.ClientUser = ClientUser;

package/dist/cjs/structures/Webhook.d.ts

@@ -0,0 +1,30 @@
+import type { Client } from '../client/Client.js';
+import { type MessageOptions } from '../builders/messagePayload.js';
+import { type RESTOptions } from '../rest/REST.js';
+import type { APIWebhook } from '../types.js';
+import { Identified } from './Base.js';
+export type WebhookMessageOptions = Pick<MessageOptions, 'content' | 'embeds' | 'components' | 'flags'>;
+export declare class Webhook extends Identified {
+    readonly channelId: string;
+    readonly id: string;
+    readonly userId: string;
+    readonly token: string;
+    readonly path: string;
+    name: string;
+    constructor(client: Client, data: APIWebhook, channelId: string);
+    get url(): string;
+    send(options: string | WebhookMessageOptions): Promise<void>;
+    edit(name: string): Promise<Webhook>;
+    delete(): Promise<void>;
+}
+export declare class WebhookClient {
+    readonly id: string;
+    readonly token: string;
+    private readonly rest;
+    constructor(target: string | {
+        id: string;
+        token: string;
+        api?: string;
+    }, options?: Omit<RESTOptions, 'token' | 'api'>);
+    send(options: string | WebhookMessageOptions): Promise<void>;
+}

package/dist/cjs/structures/Webhook.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookClient = exports.Webhook = void 0;
+const messagePayload_js_1 = require("../builders/messagePayload.js");
+const BaffError_js_1 = require("../errors/BaffError.js");
+const REST_js_1 = require("../rest/REST.js");
+const Routes_js_1 = require("../rest/Routes.js");
+const Base_js_1 = require("./Base.js");
+class Webhook extends Base_js_1.Identified {
+    channelId;
+    id;
+    userId;
+    token;
+    path;
+    name;
+    constructor(client, data, channelId) {
+        super(client);
+        this.channelId = channelId;
+        this.id = data.id;
+        this.userId = data.userId;
+        this.name = data.name;
+        this.path = data.path;
+        this.token = data.path.split('/').filter(Boolean).at(-1) ?? '';
+    }
+    get url() {
+        return `${this.client.appUrl}${this.path}`;
+    }
+    async send(options) {
+        await send(this.client.rest, this.id, this.token, options);
+    }
+    async edit(name) {
+        await this.client.rest.patch(Routes_js_1.Routes.webhook(this.id), { body: { name } });
+        this.name = name;
+        return this;
+    }
+    delete() {
+        return this.client.rest.delete(Routes_js_1.Routes.webhook(this.id));
+    }
+}
+exports.Webhook = Webhook;
+async function send(rest, id, token, options) {
+    const { body } = (0, messagePayload_js_1.resolveMessage)(options);
+    await rest.post(Routes_js_1.Routes.webhookExecute(id, token), { body, auth: false });
+}
+class WebhookClient {
+    id;
+    token;
+    rest;
+    constructor(target, options = {}) {
+        let api;
+        if (typeof target === 'string') {
+            const match = /^(https?:\/\/.+?)\/api\/webhooks\/(\d+)\/([^/?#]+)/.exec(target);
+            if (!match)
+                throw new BaffError_js_1.BaffError('INVALID_WEBHOOK_URL', 'Expected a URL like https://baff.gg/api/webhooks/<id>/<token>.');
+            api = `${match[1]}/api`;
+            this.id = match[2];
+            this.token = match[3];
+        }
+        else {
+            ({ id: this.id, token: this.token, api } = target);
+        }
+        this.rest = new REST_js_1.REST({ ...options, api });
+    }
+    send(options) {
+        return send(this.rest, this.id, this.token, options);
+    }
+}
+exports.WebhookClient = WebhookClient;

package/dist/cjs/structures/channels/BaseChannel.d.ts

@@ -0,0 +1,49 @@
+import type { Client } from '../../client/Client.js';
+import type { APIChannel, ChannelKind } from '../../types.js';
+import { Identified } from '../Base.js';
+import type { Server } from '../Server.js';
+import type { CategoryChannel, ForumChannel, ServerChannel, ThreadChannel, VoiceChannel } from './ServerChannels.js';
+import type { DMChannel } from './DMChannel.js';
+import type { TextBasedChannel } from './TextBasedChannel.js';
+export interface ChannelEditData {
+    name?: string;
+    topic?: string | null;
+    slowmodeSecs?: number;
+    contentMode?: 'default' | 'spoiler' | 'age_restricted';
+    parentId?: string | null;
+    kind?: 'text' | 'announcement';
+    autoArchiveMinutes?: number;
+    archived?: boolean;
+    locked?: boolean;
+    availableTags?: {
+        id?: string;
+        name: string;
+        emoji?: string | null;
+    }[];
+    requireTag?: boolean;
+    defaultSortOrder?: 'activity' | 'created';
+}
+export declare class BaseChannel extends Identified {
+    readonly id: string;
+    kind: ChannelKind;
+    name: string | null;
+    serverId: string | null;
+    parentId: string | null;
+    position: number;
+    constructor(client: Client, data: APIChannel);
+    _patch(data: Partial<APIChannel>): this;
+    get server(): Server | null;
+    get parent(): CategoryChannel | null;
+    get url(): string;
+    isTextBased(): this is TextBasedChannel;
+    isVoiceBased(): this is VoiceChannel;
+    isThread(): this is ThreadChannel;
+    isDM(): this is DMChannel;
+    isForum(): this is ForumChannel;
+    isCategory(): this is CategoryChannel;
+    inServer(): this is ServerChannel;
+    edit(data: ChannelEditData): Promise<this>;
+    setName(name: string): Promise<this>;
+    delete(): Promise<void>;
+    toString(): string;
+}

package/dist/cjs/structures/channels/BaseChannel.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseChannel = void 0;
+const Routes_js_1 = require("../../rest/Routes.js");
+const formatters_js_1 = require("../../util/formatters.js");
+const Base_js_1 = require("../Base.js");
+class BaseChannel extends Base_js_1.Identified {
+    id;
+    kind;
+    name = null;
+    serverId = null;
+    parentId = null;
+    position = 0;
+    constructor(client, data) {
+        super(client);
+        this.id = data.id;
+        this.kind = (data.kind ?? data.type ?? 'text');
+    }
+    _patch(data) {
+        if (data.kind ?? data.type)
+            this.kind = (data.kind ?? data.type);
+        if (data.name !== undefined)
+            this.name = data.name;
+        if (data.serverId !== undefined)
+            this.serverId = data.serverId;
+        if (data.parentId !== undefined)
+            this.parentId = data.parentId;
+        if (data.position !== undefined)
+            this.position = data.position;
+        return this;
+    }
+    get server() {
+        return this.serverId ? (this.client.servers.cache.get(this.serverId) ?? null) : null;
+    }
+    get parent() {
+        const parent = this.parentId ? this.client.channels.cache.get(this.parentId) : undefined;
+        return parent?.isCategory() ? parent : null;
+    }
+    get url() {
+        const base = this.client.appUrl;
+        return this.serverId ? `${base}/channels/${this.serverId}/${this.id}` : `${base}/channels/@me/${this.id}`;
+    }
+    isTextBased() {
+        return ['text', 'announcement', 'stage', 'thread', 'dm', 'group_dm'].includes(this.kind);
+    }
+    isVoiceBased() {
+        return this.kind === 'voice';
+    }
+    isThread() {
+        return this.kind === 'thread';
+    }
+    isDM() {
+        return this.kind === 'dm' || this.kind === 'group_dm';
+    }
+    isForum() {
+        return this.kind === 'forum';
+    }
+    isCategory() {
+        return this.kind === 'category';
+    }
+    inServer() {
+        return this.serverId !== null;
+    }
+    async edit(data) {
+        const updated = await this.client.rest.patch(Routes_js_1.Routes.channel(this.id), { body: data });
+        if (updated && typeof updated === 'object' && updated.id === this.id)
+            this._patch(updated);
+        return this;
+    }
+    setName(name) {
+        return this.edit({ name });
+    }
+    async delete() {
+        await this.client.rest.delete(Routes_js_1.Routes.channel(this.id));
+        this.client.channels._remove(this.id);
+    }
+    toString() {
+        return (0, formatters_js_1.channelMention)(this.id);
+    }
+}
+exports.BaseChannel = BaseChannel;

package/dist/cjs/structures/channels/DMChannel.d.ts

@@ -0,0 +1,9 @@
+import type { APIChannel } from '../../types.js';
+import type { User } from '../User.js';
+import { TextBasedChannel } from './TextBasedChannel.js';
+export declare class DMChannel extends TextBasedChannel {
+    recipients: User[];
+    _patch(data: Partial<APIChannel>): this;
+    get recipient(): User | null;
+    get url(): string;
+}

package/dist/cjs/structures/channels/DMChannel.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DMChannel = void 0;
+const TextBasedChannel_js_1 = require("./TextBasedChannel.js");
+class DMChannel extends TextBasedChannel_js_1.TextBasedChannel {
+    recipients = [];
+    _patch(data) {
+        super._patch(data);
+        const people = data.recipients ?? (data.recipient ? [data.recipient] : undefined);
+        if (people)
+            this.recipients = people.map((p) => this.client.users._add(p));
+        return this;
+    }
+    get recipient() {
+        return this.recipients[0] ?? null;
+    }
+    get url() {
+        return `${this.client.appUrl}/channels/@me/${this.id}`;
+    }
+}
+exports.DMChannel = DMChannel;