hischool.js 0.0.1

package/lib/esm/classes/MFA.js

@@ -0,0 +1,165 @@
+import { createStore } from "solid-js/store";
+/**
+ * Multi-Factor Authentication
+ */
+export class MFA {
+    #client;
+    #store;
+    /**
+     * Construct MFA helper
+     * @param client Client
+     * @param state State
+     */
+    constructor(client, state) {
+        this.#client = client;
+        this.#store = createStore(state);
+    }
+    /**
+     * Whether authenticator app is enabled
+     */
+    get authenticatorEnabled() {
+        return this.#store[0].totp_mfa;
+    }
+    /**
+     * Whether recovery codes are enabled
+     */
+    get recoveryEnabled() {
+        return this.#store[0].recovery_active;
+    }
+    /**
+     * Available MFA methods for generating tickets
+     */
+    get availableMethods() {
+        return this.authenticatorEnabled
+            ? this.recoveryEnabled
+                ? ["Totp", "Recovery"]
+                : ["Totp"]
+            : ["Password"];
+    }
+    /**
+     * Create an MFA ticket
+     * @param params
+     * @returns Token
+     */
+    createTicket(params) {
+        return this.#client.api
+            .put("/auth/mfa/ticket", params)
+            .then((ticket) => new MFATicket(this.#client, ticket, this.#store[1]));
+    }
+    /**
+     * Enable authenticator using token generated from secret found earlier
+     * @param token Token
+     */
+    async enableAuthenticator(token) {
+        await this.#client.api.put("/auth/mfa/totp", { totp_code: token });
+        this.#store[1]("totp_mfa", true);
+    }
+}
+/**
+ * MFA Ticket
+ */
+export class MFATicket {
+    #client;
+    #ticket;
+    #mutate;
+    #used = false;
+    /**
+     * Construct MFA Ticket
+     * @param client Client
+     * @param ticket Ticket
+     * @param mutate Mutate the store
+     */
+    constructor(client, ticket, mutate) {
+        this.#client = client;
+        this.#ticket = ticket;
+        this.#mutate = mutate;
+    }
+    /**
+     * Token
+     */
+    get token() {
+        return this.#ticket.token;
+    }
+    /**
+     * Use the ticket
+     */
+    #consume() {
+        if (this.#used)
+            throw "Already used this ticket!";
+        this.#used = true;
+    }
+    /**
+     * Fetch recovery codes
+     * @returns List of codes
+     */
+    fetchRecoveryCodes() {
+        this.#consume();
+        return this.#client.api.post("/auth/mfa/recovery", undefined, {
+            headers: {
+                "X-MFA-Ticket": this.token,
+            },
+        });
+    }
+    /**
+     * Generate new set of recovery codes
+     * @returns List of codes
+     */
+    async generateRecoveryCodes() {
+        this.#consume();
+        const codes = await this.#client.api.patch("/auth/mfa/recovery", undefined, {
+            headers: {
+                "X-MFA-Ticket": this.token,
+            },
+        });
+        this.#mutate("recovery_active", true);
+        return codes;
+    }
+    /**
+     * Generate new authenticator secret
+     * @returns Secret
+     */
+    generateAuthenticatorSecret() {
+        this.#consume();
+        return this.#client.api
+            .post("/auth/mfa/totp", undefined, {
+            headers: {
+                "X-MFA-Ticket": this.token,
+            },
+        })
+            .then((response) => response.secret);
+    }
+    /**
+     * Disable authenticator
+     */
+    async disableAuthenticator() {
+        this.#consume();
+        await this.#client.api.delete("/auth/mfa/totp", undefined, {
+            headers: {
+                "X-MFA-Ticket": this.token,
+            },
+        });
+        this.#mutate("totp_mfa", false);
+    }
+    /**
+     * Disable account
+     */
+    disableAccount() {
+        this.#consume();
+        return this.#client.api.post("/auth/account/disable", undefined, {
+            headers: {
+                "X-MFA-Ticket": this.token,
+            },
+        });
+    }
+    /**
+     * Delete account
+     */
+    deleteAccount() {
+        this.#consume();
+        return this.#client.api.post("/auth/account/delete", undefined, {
+            headers: {
+                "X-MFA-Ticket": this.token,
+            },
+        });
+    }
+}

package/lib/esm/classes/Message.d.ts

@@ -0,0 +1,484 @@
+import { MessageWebhook as ApiMessageWebhook, DataEditMessage, DataMessageSend } from "../api";
+import { MessageCollection } from "../collections/index.js";
+import { Client, File } from "../index.js";
+/**
+ * Message Class
+ */
+export declare class Message {
+    #private;
+    readonly id: string;
+    /**
+     * Construct Message
+     * @param collection Collection
+     * @param id Message Id
+     */
+    constructor(collection: MessageCollection, id: string);
+    /**
+     * Whether this object exists
+     */
+    get $exists(): boolean;
+    /**
+     * Time when this message was posted
+     */
+    get createdAt(): Date;
+    /**
+     * Absolute pathname to this message in the client
+     */
+    get path(): string;
+    /**
+     * URL to this message
+     */
+    get url(): string;
+    /**
+     * Nonce value
+     */
+    get nonce(): string | undefined;
+    /**
+     * Id of channel this message was sent in
+     */
+    get channelId(): string;
+    /**
+     * Channel this message was sent in
+     */
+    get channel(): import("./Channel").Channel | undefined;
+    /**
+     * Server this message was sent in
+     */
+    get server(): import("./Server").Server | undefined;
+    /**
+     * Member this message was sent by
+     */
+    get member(): import("./ServerMember").ServerMember | undefined;
+    /**
+     * Id of user or webhook this message was sent by
+     */
+    get authorId(): string | undefined;
+    /**
+     * User this message was sent by
+     */
+    get author(): import("./User").User | undefined;
+    /**
+     * Webhook information for this message
+     */
+    get webhook(): MessageWebhook;
+    /**
+     * Content
+     */
+    get content(): string;
+    /**
+     * System message content
+     */
+    get systemMessage(): import("./SystemMessage").SystemMessage | undefined;
+    /**
+     * Attachments
+     */
+    get attachments(): File[] | undefined;
+    /**
+     * Time at which this message was edited
+     */
+    get editedAt(): Date | undefined;
+    /**
+     * Embeds
+     */
+    get embeds(): import("./MessageEmbed").MessageEmbed[] | undefined;
+    /**
+     * IDs of users this message mentions
+     */
+    get mentionIds(): string[] | undefined;
+    /**
+     * Whether this message mentions us
+     */
+    get mentioned(): boolean | undefined;
+    /**
+     * IDs of messages this message replies to
+     */
+    get replyIds(): string[] | undefined;
+    /**
+     * Reactions
+     */
+    get reactions(): import("@solid-primitives/map").ReactiveMap<string, import("@solid-primitives/set").ReactiveSet<string>>;
+    /**
+     * Interactions
+     */
+    get interactions(): {
+        reactions?: string[] | null | undefined;
+        restrict_reactions?: boolean | undefined;
+    } | undefined;
+    /**
+     * Masquerade
+     */
+    get masquerade(): {
+        name?: string | null | undefined;
+        avatar?: string | null | undefined;
+        colour?: string | null | undefined;
+    } | undefined;
+    /**
+     * Flags
+     */
+    get flags(): number;
+    /**
+     * Get the username for this message
+     */
+    get username(): string | undefined;
+    /**
+     * Get the role colour for this message
+     */
+    get roleColour(): string | null | undefined;
+    /**
+     * Get the avatar URL for this message
+     */
+    get avatarURL(): string | undefined;
+    /**
+     * Get the animated avatar URL for this message
+     */
+    get animatedAvatarURL(): string | undefined;
+    /**
+     * Avatar URL from the masquerade
+     */
+    get masqueradeAvatarURL(): string | undefined;
+    /**
+     * Whether this message has suppressed desktop/push notifications
+     */
+    get isSuppressed(): boolean;
+    /**
+     * Edit a message
+     * @param data Message edit route data
+     */
+    edit(data: DataEditMessage): Promise<{
+        _id: string;
+        nonce?: string | null | undefined;
+        channel: string;
+        author: string;
+        user?: {
+            _id: string;
+            username: string;
+            discriminator: string;
+            display_name?: string | null | undefined;
+            avatar?: {
+                _id: string;
+                tag: string;
+                filename: string;
+                metadata: {
+                    type: "File";
+                } | {
+                    type: "Text";
+                } | {
+                    type: "Image";
+                    width: number;
+                    height: number;
+                } | {
+                    type: "Video";
+                    width: number;
+                    height: number;
+                } | {
+                    type: "Audio";
+                };
+                content_type: string;
+                size: number;
+                deleted?: boolean | null | undefined;
+                reported?: boolean | null | undefined;
+                message_id?: string | null | undefined;
+                user_id?: string | null | undefined;
+                server_id?: string | null | undefined;
+                object_id?: string | null | undefined;
+            } | null | undefined;
+            relations?: {
+                _id: string;
+                status: "Blocked" | "None" | "User" | "Friend" | "Outgoing" | "Incoming" | "BlockedOther";
+            }[] | undefined;
+            badges?: number | undefined;
+            status?: {
+                text?: string | null | undefined;
+                presence?: "Online" | "Idle" | "Focus" | "Busy" | "Invisible" | null | undefined;
+            } | null | undefined;
+            flags?: number | undefined;
+            privileged?: boolean | undefined;
+            bot?: {
+                owner: string;
+            } | null | undefined;
+            relationship: "Blocked" | "None" | "User" | "Friend" | "Outgoing" | "Incoming" | "BlockedOther";
+            online: boolean;
+        } | null | undefined;
+        member?: {
+            _id: {
+                server: string;
+                user: string;
+            };
+            joined_at: string;
+            nickname?: string | null | undefined;
+            avatar?: {
+                _id: string;
+                tag: string;
+                filename: string;
+                metadata: {
+                    type: "File";
+                } | {
+                    type: "Text";
+                } | {
+                    type: "Image";
+                    width: number;
+                    height: number;
+                } | {
+                    type: "Video";
+                    width: number;
+                    height: number;
+                } | {
+                    type: "Audio";
+                };
+                content_type: string;
+                size: number;
+                deleted?: boolean | null | undefined;
+                reported?: boolean | null | undefined;
+                message_id?: string | null | undefined;
+                user_id?: string | null | undefined;
+                server_id?: string | null | undefined;
+                object_id?: string | null | undefined;
+            } | null | undefined;
+            roles?: string[] | undefined;
+            timeout?: string | null | undefined;
+        } | null | undefined;
+        webhook?: {
+            name: string;
+            avatar?: string | null | undefined;
+        } | null | undefined;
+        content?: string | null | undefined;
+        system?: {
+            type: "text";
+            content: string;
+        } | {
+            type: "user_added";
+            id: string;
+            by: string;
+        } | {
+            type: "user_remove";
+            id: string;
+            by: string;
+        } | {
+            type: "user_joined";
+            id: string;
+        } | {
+            type: "user_left";
+            id: string;
+        } | {
+            type: "user_kicked";
+            id: string;
+        } | {
+            type: "user_banned";
+            id: string;
+        } | {
+            type: "channel_renamed";
+            name: string;
+            by: string;
+        } | {
+            type: "channel_description_changed";
+            by: string;
+        } | {
+            type: "channel_icon_changed";
+            by: string;
+        } | {
+            type: "channel_ownership_changed";
+            from: string;
+            to: string;
+        } | {
+            type: "message_pinned";
+            id: string;
+            by: string;
+        } | {
+            type: "message_unpinned";
+            id: string;
+            by: string;
+        } | null | undefined;
+        attachments?: {
+            _id: string;
+            tag: string;
+            filename: string;
+            metadata: {
+                type: "File";
+            } | {
+                type: "Text";
+            } | {
+                type: "Image";
+                width: number;
+                height: number;
+            } | {
+                type: "Video";
+                width: number;
+                height: number;
+            } | {
+                type: "Audio";
+            };
+            content_type: string;
+            size: number;
+            deleted?: boolean | null | undefined;
+            reported?: boolean | null | undefined;
+            message_id?: string | null | undefined;
+            user_id?: string | null | undefined;
+            server_id?: string | null | undefined;
+            object_id?: string | null | undefined;
+        }[] | null | undefined;
+        edited?: string | null | undefined;
+        embeds?: ({
+            type: "Website";
+            url?: string | null | undefined;
+            original_url?: string | null | undefined;
+            special?: {
+                type: "None";
+            } | {
+                type: "GIF";
+            } | {
+                type: "YouTube";
+                id: string;
+                timestamp?: string | null | undefined;
+            } | {
+                type: "Lightspeed";
+                content_type: "Channel";
+                id: string;
+            } | {
+                type: "Twitch";
+                content_type: "Video" | "Channel" | "Clip";
+                id: string;
+            } | {
+                type: "Spotify";
+                content_type: string;
+                id: string;
+            } | {
+                type: "Soundcloud";
+            } | {
+                type: "Bandcamp";
+                content_type: "Album" | "Track";
+                id: string;
+            } | {
+                type: "Streamable";
+                id: string;
+            } | null | undefined;
+            title?: string | null | undefined;
+            description?: string | null | undefined;
+            image?: {
+                url: string;
+                width: number;
+                height: number;
+                size: "Large" | "Preview";
+            } | null | undefined;
+            video?: {
+                url: string;
+                width: number;
+                height: number;
+            } | null | undefined;
+            site_name?: string | null | undefined;
+            icon_url?: string | null | undefined;
+            colour?: string | null | undefined;
+        } | {
+            type: "Image";
+            url: string;
+            width: number;
+            height: number;
+            size: "Large" | "Preview";
+        } | {
+            type: "Video";
+            url: string;
+            width: number;
+            height: number;
+        } | {
+            type: "Text";
+            icon_url?: string | null | undefined;
+            url?: string | null | undefined;
+            title?: string | null | undefined;
+            description?: string | null | undefined;
+            media?: {
+                _id: string;
+                tag: string;
+                filename: string;
+                metadata: {
+                    type: "File";
+                } | {
+                    type: "Text";
+                } | {
+                    type: "Image";
+                    width: number;
+                    height: number;
+                } | {
+                    type: "Video";
+                    width: number;
+                    height: number;
+                } | {
+                    type: "Audio";
+                };
+                content_type: string;
+                size: number;
+                deleted?: boolean | null | undefined;
+                reported?: boolean | null | undefined;
+                message_id?: string | null | undefined;
+                user_id?: string | null | undefined;
+                server_id?: string | null | undefined;
+                object_id?: string | null | undefined;
+            } | null | undefined;
+            colour?: string | null | undefined;
+        } | {
+            type: "None";
+        })[] | null | undefined;
+        mentions?: string[] | null | undefined;
+        replies?: string[] | null | undefined;
+        reactions?: {
+            [key: string]: string[];
+        } | undefined;
+        interactions?: {
+            reactions?: string[] | null | undefined;
+            restrict_reactions?: boolean | undefined;
+        } | undefined;
+        masquerade?: {
+            name?: string | null | undefined;
+            avatar?: string | null | undefined;
+            colour?: string | null | undefined;
+        } | null | undefined;
+        pinned?: boolean | null | undefined;
+        flags?: number | undefined;
+    }>;
+    /**
+     * Delete a message
+     */
+    delete(): Promise<undefined>;
+    /**
+     * Acknowledge this message as read
+     */
+    ack(): void;
+    /**
+     * Reply to Message
+     */
+    reply(data: string | (Omit<DataMessageSend, "nonce"> & {
+        nonce?: string;
+    }), mention?: boolean): Promise<Message> | undefined;
+    /**
+     * Clear all reactions from this message
+     */
+    clearReactions(): Promise<undefined>;
+    /**
+     * React to a message
+     * @param emoji Unicode or emoji ID
+     */
+    react(emoji: string): Promise<undefined>;
+    /**
+     * Un-react from a message
+     * @param emoji Unicode or emoji ID
+     */
+    unreact(emoji: string): Promise<undefined>;
+}
+/**
+ * Message Webhook Class
+ */
+export declare class MessageWebhook {
+    #private;
+    readonly id: string;
+    readonly name: string;
+    readonly avatar?: File;
+    /**
+     * Construct Message Webhook
+     * @param client Client
+     * @param webhook Webhook data
+     */
+    constructor(client: Client, webhook: ApiMessageWebhook, id: string);
+    /**
+     * Get the avatar URL for this message webhook
+     */
+    get avatarURL(): string;
+}
+//# sourceMappingURL=Message.d.ts.map

package/lib/esm/classes/Message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../../src/classes/Message.ts"],"names":[],"mappings":"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"}