elynn-baileys 1.0.1

package/lib/Discord/structures/VoiceState.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module VoiceState */
+const Base_1 = __importDefault(require("./Base"));
+const Errors_1 = require("../util/Errors");
+/** Represents a guild member's voice state. */
+class VoiceState extends Base_1.default {
+    _cachedChannel;
+    _cachedGuild;
+    _cachedMember;
+    _cachedUser;
+    /** The ID of the channel the user is connected to. */
+    channelID;
+    /** If the associated member is deafened. */
+    deaf;
+    /** The ID of the guild this voice state is a part of. */
+    guildID;
+    /** If the associated member is muted. */
+    mute;
+    /** The time at which the associated member requested to speak. */
+    requestToSpeakTimestamp;
+    /** If the associated member is self deafened. */
+    selfDeaf;
+    /** If the associated member is self muted. */
+    selfMute;
+    /** If the associated member is streaming. */
+    selfStream;
+    /** If the associated member is has their camera on. */
+    selfVideo;
+    /** The id of the associated member's voice session. */
+    sessionID;
+    /** If the associated member is suppressed. */
+    suppress;
+    /** The ID of the user associated with this voice state. */
+    userID;
+    constructor(data, client) {
+        super(data.user_id, client);
+        this.channelID = data.channel_id;
+        this.deaf = false;
+        this.guildID = data.guild_id;
+        this.mute = false;
+        this.requestToSpeakTimestamp = null;
+        this.selfDeaf = false;
+        this.selfMute = false;
+        this.selfStream = false;
+        this.selfVideo = false;
+        this.suppress = false;
+        this.userID = this.id;
+        this.update(data);
+    }
+    update(data) {
+        if (data.channel_id !== undefined) {
+            this.channelID = data.channel_id;
+            this._cachedChannel = null;
+        }
+        if (data.deaf !== undefined) {
+            this.deaf = data.deaf;
+        }
+        if (data.guild_id !== undefined) {
+            this.guildID = data.guild_id;
+        }
+        if (data.member !== undefined) {
+            this._cachedMember = this.client.util.updateMember(data.guild_id, this.id, data.member);
+        }
+        if (data.mute !== undefined) {
+            this.mute = data.mute;
+        }
+        if (data.request_to_speak_timestamp !== undefined) {
+            this.requestToSpeakTimestamp = data.request_to_speak_timestamp === null ? null : new Date(data.request_to_speak_timestamp);
+        }
+        if (data.self_deaf !== undefined) {
+            this.selfDeaf = data.self_deaf;
+        }
+        if (data.self_mute !== undefined) {
+            this.selfMute = data.self_mute;
+        }
+        if (data.self_stream !== undefined) {
+            this.selfStream = data.self_stream;
+        }
+        if (data.self_video !== undefined) {
+            this.selfVideo = data.self_video;
+        }
+        if (data.suppress !== undefined) {
+            this.suppress = data.suppress;
+        }
+        if (data.user_id !== undefined) {
+            this.userID = data.user_id;
+        }
+    }
+    /** The channel the user is connected to. */
+    get channel() {
+        if (this.channelID !== null) {
+            return this._cachedChannel ??= this.client.getChannel(this.channelID);
+        }
+        return (this._cachedChannel ??= null);
+    }
+    /** The guild this voice state is a part of. This will throw an error if the guild is not cached. */
+    get guild() {
+        this._cachedGuild ??= this.client.guilds.get(this.guildID);
+        if (!this._cachedGuild) {
+            if (this.client.options.restMode) {
+                throw new Errors_1.UncachedError(`${this.constructor.name}#guild is not present when rest mode is enabled.`);
+            }
+            if (!this.client.shards.connected) {
+                throw new Errors_1.UncachedError(`${this.constructor.name}#guild is not present without a gateway connection.`);
+            }
+            throw new Errors_1.UncachedError(`${this.constructor.name}#guild is not present.`);
+        }
+        return this._cachedGuild;
+    }
+    /** The member associated with this voice state. */
+    get member() {
+        return this._cachedMember ?? (this._cachedMember = this["_cachedGuild"]?.members.get(this.userID));
+    }
+    /** TThe user associated with this voice state. */
+    get user() {
+        return this._cachedUser ?? (this._cachedUser = this.client.users.get(this.userID));
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            channelID: this.channelID,
+            deaf: this.deaf,
+            guildID: this.guildID ?? undefined,
+            member: this.member?.toJSON(),
+            mute: this.mute,
+            requestToSpeakTimestamp: this.requestToSpeakTimestamp ? this.requestToSpeakTimestamp.getTime() : null,
+            selfDeaf: this.selfDeaf,
+            selfMute: this.selfMute,
+            selfStream: this.selfStream,
+            selfVideo: this.selfVideo,
+            sessionID: this.sessionID,
+            suppress: this.suppress,
+            user: this.user?.toJSON()
+        };
+    }
+}
+exports.default = VoiceState;

package/lib/Discord/structures/Webhook.cjs

@@ -0,0 +1,240 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module Webhook */
+const Base_1 = __importDefault(require("./Base.cjs"));
+const Constants_1 = require("../Constants.cjs");
+const Routes = __importStar(require("../util/Routes.cjs"));
+const Errors_1 = require("../util/Errors.cjs");
+/** Represents a webhook. */
+class Webhook extends Base_1.default {
+    _cachedChannel;
+    _cachedGuild;
+    /** The application associated with this webhook. */
+    application;
+    /** The ID of the application associated with this webhook. */
+    applicationID;
+    /** The hash of this webhook's avatar. */
+    avatar;
+    /** The ID of the channel this webhook is for, if applicable. */
+    channelID;
+    /** The id of the guild this webhook is in, if applicable. */
+    guildID;
+    /** The username of this webhook, if any. */
+    name;
+    /** The source channel for this webhook (channel follower only). */
+    sourceChannel;
+    /** The source guild for this webhook (channel follower only). */
+    sourceGuild;
+    /** The token for this webhook (not present for webhooks created by other applications) */
+    token;
+    /** The [type](https://discord.com/developers/docs/resources/webhook#webhook-object-webhook-types) of this webhook. */
+    type;
+    /** The user that created this webhook. */
+    user;
+    constructor(data, client) {
+        super(data.id, client);
+        this.application = (!client["_application"] || data.application_id === null) ? null : (client.application.id === data.application_id ? client.application : undefined);
+        this.applicationID = data.application_id;
+        this.avatar = data.avatar ?? null;
+        this.channelID = data.channel_id;
+        this.guildID = data.guild_id ?? null;
+        this.name = data.name;
+        this.sourceChannel = data.source_channel;
+        this.sourceGuild = data.source_guild;
+        this.token = data.token;
+        this.type = data.type;
+        this.user = data.user === undefined ? null : client.users.update(data.user);
+    }
+    /** The channel this webhook is for, if applicable. */
+    get channel() {
+        if (this.channelID !== null && this._cachedChannel !== null) {
+            return this._cachedChannel ?? (this._cachedChannel = this.client.getChannel(this.channelID));
+        }
+        return this._cachedChannel === null ? this._cachedChannel : (this._cachedChannel = null);
+    }
+    /** The guild this webhook is for, if applicable. This will throw an error if the guild is not cached. */
+    get guild() {
+        if (this.guildID !== null && this._cachedGuild !== null) {
+            this._cachedGuild ??= this.client.guilds.get(this.guildID);
+            if (!this._cachedGuild) {
+                if (this.client.options.restMode) {
+                    throw new Errors_1.UncachedError(`${this.constructor.name}#guild is not present when rest mode is enabled.`);
+                }
+                if (!this.client.shards.connected) {
+                    throw new Errors_1.UncachedError(`${this.constructor.name}#guild is not present without a gateway connection.`);
+                }
+                throw new Errors_1.UncachedError(`${this.constructor.name}#guild is not present.`);
+            }
+            return this._cachedGuild;
+        }
+        return this._cachedGuild === null ? this._cachedGuild : (this._cachedGuild = null);
+    }
+    get url() {
+        return `${Constants_1.API_URL}${Routes.WEBHOOK(this.id, this.token)}`;
+    }
+    /**
+     * The url of this webhook's avatar.
+     * @param format The format the url should be.
+     * @param size The dimensions of the image.
+     */
+    avatarURL(format, size) {
+        return this.avatar === null ? null : this.client.util.formatImage(Routes.USER_AVATAR(this.id, this.avatar), format, size);
+    }
+    /**
+     * Delete this webhook (requires a bot user, see `deleteToken`).
+     * @param reason The reason for deleting this webhook.
+     */
+    async delete(reason) {
+        return this.client.rest.webhooks.delete(this.id, reason);
+    }
+    /**
+     * Delete a message from this webhook.
+     * @param messageID The ID of the message.
+     * @param options The options for deleting the message.
+     * @param token The token for the webhook, if not already present.
+     */
+    async deleteMessage(messageID, options, token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.deleteMessage(this.id, t, messageID, options);
+    }
+    /**
+     * Delete this webhook via its token.
+     * @param token The token for the webhook, if not already present.
+     */
+    async deleteToken(token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.deleteToken(this.id, t);
+    }
+    /**
+     * Edit this webhook (requires a bot user, see `editToken`).
+     * @param options The options for editing the webhook.
+     */
+    async edit(options) {
+        return this.client.rest.webhooks.edit(this.id, options);
+    }
+    /**
+     * Edit a webhook message.
+     * @param messageID The ID of the message to edit.
+     * @param token The token of the webhook.
+     * @param options The options for editing the message.
+     */
+    async editMessage(messageID, options, token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.editMessage(this.id, t, messageID, options);
+    }
+    /**
+     * Edit a webhook via its token.
+     * @param options The options for editing the webhook.
+     * @param token The token for the webhook, if not already present.
+     */
+    async editToken(options, token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.editToken(this.id, t, options);
+    }
+    async execute(options, token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.execute(this.id, t, options);
+    }
+    async executeGithub(options, token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.executeGithub(this.id, t, options);
+    }
+    async executeSlack(options, token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.executeSlack(this.id, t, options);
+    }
+    /**
+     * Get a webhook message.
+     * @param messageID The ID of the message.
+     * @param threadID The ID of the thread the message is in.
+     * @param token The token for the webhook, if not already present.
+     */
+    async getMessage(messageID, threadID, token) {
+        const t = this.token ?? token;
+        if (!t) {
+            throw new TypeError("Token is not present on webhook, and was not provided in options.");
+        }
+        return this.client.rest.webhooks.getMessage(this.id, t, messageID, threadID);
+    }
+    /**
+     * The url of this webhook's `sourceGuild` icon (only present on channel follower webhooks).
+     * @param format The format the url should be.
+     * @param size The dimensions of the image.
+     */
+    sourceGuildIconURL(format, size) {
+        return this.sourceGuild?.icon ? this.client.util.formatImage(Routes.GUILD_ICON(this.id, this.sourceGuild?.icon), format, size) : null;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            applicationID: this.applicationID,
+            avatar: this.avatar,
+            channelID: this.channelID ?? null,
+            guildID: this.guildID,
+            name: this.name,
+            sourceChannel: this.sourceChannel,
+            sourceGuild: this.sourceGuild,
+            token: this.token,
+            type: this.type,
+            user: this.user?.toJSON()
+        };
+    }
+}
+exports.default = Webhook;

package/lib/Discord/structures/Webhook.d.ts

@@ -0,0 +1,126 @@
+/** @module Webhook */
+import Base from "./Base";
+import type User from "./User";
+import type Message from "./Message";
+import type Guild from "./Guild";
+import type ClientApplication from "./ClientApplication";
+import type * as Types from "../types/namespaced";
+import type Client from "../Client";
+import { type ImageFormat, type WebhookTypes } from "../Constants";
+/** Represents a webhook. */
+export default class Webhook extends Base {
+    private _cachedChannel?;
+    private _cachedGuild?;
+    /** The application associated with this webhook. */
+    application?: ClientApplication | null;
+    /** The ID of the application associated with this webhook. */
+    applicationID: string | null;
+    /** The hash of this webhook's avatar. */
+    avatar: string | null;
+    /** The ID of the channel this webhook is for, if applicable. */
+    channelID: string | null;
+    /** The id of the guild this webhook is in, if applicable. */
+    guildID: string | null;
+    /** The username of this webhook, if any. */
+    name: string | null;
+    /** The source channel for this webhook (channel follower only). */
+    sourceChannel?: Pick<Types.Channels.RawChannel, "id" | "name">;
+    /** The source guild for this webhook (channel follower only). */
+    sourceGuild?: Pick<Types.Guilds.RawGuild, "id" | "name" | "icon">;
+    /** The token for this webhook (not present for webhooks created by other applications) */
+    token?: string;
+    /** The [type](https://discord.com/developers/docs/resources/webhook#webhook-object-webhook-types) of this webhook. */
+    type: WebhookTypes;
+    /** The user that created this webhook. */
+    user: User | null;
+    constructor(data: Types.Webhooks.RawWebhook, client: Client);
+    /** The channel this webhook is for, if applicable. */
+    get channel(): Types.Channels.AnyTextableGuildChannel | null | undefined;
+    /** The guild this webhook is for, if applicable. This will throw an error if the guild is not cached. */
+    get guild(): Guild | null;
+    get url(): string;
+    /**
+     * The url of this webhook's avatar.
+     * @param format The format the url should be.
+     * @param size The dimensions of the image.
+     */
+    avatarURL(format?: ImageFormat, size?: number): string | null;
+    /**
+     * Delete this webhook (requires a bot user, see `deleteToken`).
+     * @param reason The reason for deleting this webhook.
+     */
+    delete(reason?: string): Promise<void>;
+    /**
+     * Delete a message from this webhook.
+     * @param messageID The ID of the message.
+     * @param options The options for deleting the message.
+     * @param token The token for the webhook, if not already present.
+     */
+    deleteMessage(messageID: string, options?: Types.Webhooks.DeleteWebhookMessageOptions, token?: string): Promise<void>;
+    /**
+     * Delete this webhook via its token.
+     * @param token The token for the webhook, if not already present.
+     */
+    deleteToken(token?: string): Promise<void>;
+    /**
+     * Edit this webhook (requires a bot user, see `editToken`).
+     * @param options The options for editing the webhook.
+     */
+    edit(options: Types.Webhooks.EditWebhookOptions): Promise<Webhook>;
+    /**
+     * Edit a webhook message.
+     * @param messageID The ID of the message to edit.
+     * @param token The token of the webhook.
+     * @param options The options for editing the message.
+     */
+    editMessage<T extends Types.Channels.AnyTextableGuildChannel = Types.Channels.AnyTextableGuildChannel>(messageID: string, options: Types.Webhooks.EditWebhookMessageOptions, token?: string): Promise<Message<T>>;
+    /**
+     * Edit a webhook via its token.
+     * @param options The options for editing the webhook.
+     * @param token The token for the webhook, if not already present.
+     */
+    editToken(options: Types.Webhooks.EditWebhookOptions, token?: string): Promise<Webhook>;
+    /**
+     * Execute the webhook.
+     * @param options The options for executing the webhook.
+     * @param token The token for the webhook, if not already present.
+     */
+    execute<T extends Types.Channels.AnyTextableGuildChannel>(options: Types.Webhooks.ExecuteWebhookWaitOptions, token?: string): Promise<Message<T>>;
+    execute(options: Types.Webhooks.ExecuteWebhookOptions, token?: string): Promise<void>;
+    /**
+     * Execute this webhook as GitHub compatible.
+     * @param options The options to send. See GitHub's documentation for more information.
+     * @param token The token for the webhook, if not already present.
+     */
+    executeGithub(options: Record<string, unknown> & {
+        wait: false;
+    }, token?: string): Promise<void>;
+    executeGithub<T extends Types.Channels.AnyTextableGuildChannel>(options: Record<string, unknown> & {
+        wait?: true;
+    }, token?: string): Promise<Message<T>>;
+    /**
+     * Execute this webhook as slack compatible.
+     * @param options The options to send. See [Slack's Documentation](https://api.slack.com/incoming-webhooks) for more information.
+     * @param token The token for the webhook, if not already present.
+     */
+    executeSlack(options: Record<string, unknown> & {
+        wait: false;
+    }, token?: string): Promise<void>;
+    executeSlack<T extends Types.Channels.AnyTextableGuildChannel>(options: Record<string, unknown> & {
+        wait?: true;
+    }, token?: string): Promise<Message<T>>;
+    /**
+     * Get a webhook message.
+     * @param messageID The ID of the message.
+     * @param threadID The ID of the thread the message is in.
+     * @param token The token for the webhook, if not already present.
+     */
+    getMessage<T extends Types.Channels.AnyTextableGuildChannel>(messageID: string, threadID?: string, token?: string): Promise<Message<T>>;
+    /**
+     * The url of this webhook's `sourceGuild` icon (only present on channel follower webhooks).
+     * @param format The format the url should be.
+     * @param size The dimensions of the image.
+     */
+    sourceGuildIconURL(format?: ImageFormat, size?: number): string | null;
+    toJSON(): Types.JSON.JSONWebhook;
+}