@buape/carbon 0.4.2 → 0.6.0

package/dist/src/plugins/linked-roles/LinkedRoles.d.ts

@@ -0,0 +1,61 @@
+import { Plugin } from "../../abstracts/Plugin.js";
+import type { Client } from "../../classes/Client.js";
+import { type LinkedRolesOptions } from "./types.js";
+/**
+ * This class is the main class that is used for the linked roles feature of Carbon.
+ * It handles all the additional routes and oauth.
+ *
+ * @example
+ * ```ts
+ * import { createHandle, Client, ApplicationRoleConnectionMetadataType } from "@buape/carbon"
+ * import { LinkedRoles } from "@buape/carbon/linked-roles"
+ *
+ * const handle = createHandle((env) => {
+ *     const client = new Client({ ... }, [ ... ])
+ *     const linkedRoles = new LinkedRoles(client, {
+ *         metadata: [
+ *             {
+ *                 key: 'is_staff',
+ *                 name: 'Verified Staff',
+ *                 description: 'Whether the user is a verified staff member',
+ *                 type: ApplicationRoleConnectionMetadataType.BooleanEqual
+ *             }
+ *         ],
+ *         metadataCheckers: {
+ *             is_staff: async (userId) => {
+ *                 const allStaff = ["439223656200273932"]
+ *                 return allStaff.includes(userId)
+ *             }
+ *         }
+ *     })
+ *     return [client, linkedRoles]
+ * })
+ * ```
+ */
+export declare class LinkedRoles extends Plugin {
+    client: Client;
+    options: LinkedRolesOptions;
+    constructor(client: Client, options: LinkedRolesOptions);
+    private appendRoutes;
+    /**
+     * Handle a request to deploy the linked roles to Discord
+     * @returns A response
+     */
+    handleDeployRequest(): Promise<Response>;
+    /**
+     * Handle the verify user request
+     * @returns A response
+     */
+    handleUserVerificationRequest(): Promise<Response>;
+    /**
+     * Handle the verify user callback request
+     * @param req The request
+     * @returns A response
+     */
+    handleUserVerificationCallbackRequest(req: Request): Promise<Response>;
+    private getMetadataFromCheckers;
+    private getOAuthTokens;
+    private updateMetadata;
+    private setMetadata;
+}
+//# sourceMappingURL=LinkedRoles.d.ts.map

package/dist/src/plugins/linked-roles/LinkedRoles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkedRoles.d.ts","sourceRoot":"","sources":["../../../../src/plugins/linked-roles/LinkedRoles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAEN,KAAK,kBAAkB,EACvB,MAAM,YAAY,CAAA;AAenB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAY,SAAQ,MAAM;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,kBAAkB,CAAA;gBAEf,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;IAQvD,OAAO,CAAC,YAAY;IAsBpB;;;OAGG;IACU,mBAAmB;IAKhC;;;OAGG;IACU,6BAA6B;IAS1C;;;;OAIG;IACU,qCAAqC,CAAC,GAAG,EAAE,OAAO;YA4BjD,uBAAuB;YAiCvB,cAAc;YA4Bd,cAAc;YAuBd,WAAW;CAoBzB"}

package/dist/src/plugins/linked-roles/LinkedRoles.js

@@ -0,0 +1,196 @@
+import { Plugin } from "../../abstracts/Plugin.js";
+import { ApplicationRoleConnectionMetadataType } from "./types.js";
+// TODO: IMO, the metadata for this should be handled similarly to the client and its commands
+// That is passing an array of connection instances as the second argument to the constructor
+// That is, maybe, for another pr though
+// TODO: Improve the response messages
+/**
+ * This class is the main class that is used for the linked roles feature of Carbon.
+ * It handles all the additional routes and oauth.
+ *
+ * @example
+ * ```ts
+ * import { createHandle, Client, ApplicationRoleConnectionMetadataType } from "@buape/carbon"
+ * import { LinkedRoles } from "@buape/carbon/linked-roles"
+ *
+ * const handle = createHandle((env) => {
+ *     const client = new Client({ ... }, [ ... ])
+ *     const linkedRoles = new LinkedRoles(client, {
+ *         metadata: [
+ *             {
+ *                 key: 'is_staff',
+ *                 name: 'Verified Staff',
+ *                 description: 'Whether the user is a verified staff member',
+ *                 type: ApplicationRoleConnectionMetadataType.BooleanEqual
+ *             }
+ *         ],
+ *         metadataCheckers: {
+ *             is_staff: async (userId) => {
+ *                 const allStaff = ["439223656200273932"]
+ *                 return allStaff.includes(userId)
+ *             }
+ *         }
+ *     })
+ *     return [client, linkedRoles]
+ * })
+ * ```
+ */
+export class LinkedRoles extends Plugin {
+    client;
+    options;
+    constructor(client, options) {
+        super();
+        this.client = client;
+        this.options = { ...options };
+        this.appendRoutes();
+    }
+    appendRoutes() {
+        this.routes.push({
+            method: "GET",
+            path: "/linked-roles/deploy",
+            handler: this.handleDeployRequest.bind(this),
+            protected: true,
+            disabled: this.options.disableDeployRoute
+        });
+        this.routes.push({
+            method: "GET",
+            path: "/linked-roles/verify-user",
+            handler: this.handleUserVerificationRequest.bind(this),
+            disabled: this.options.disableVerifyUserRoute
+        });
+        this.routes.push({
+            method: "GET",
+            path: "/linked-roles/verify-user/callback",
+            handler: this.handleUserVerificationCallbackRequest.bind(this),
+            disabled: this.options.disableVerifyUserCallbackRoute
+        });
+    }
+    /**
+     * Handle a request to deploy the linked roles to Discord
+     * @returns A response
+     */
+    async handleDeployRequest() {
+        await this.setMetadata(this.options.metadata);
+        return new Response("OK", { status: 202 });
+    }
+    /**
+     * Handle the verify user request
+     * @returns A response
+     */
+    async handleUserVerificationRequest() {
+        return new Response("Found", {
+            status: 302,
+            headers: {
+                Location: `https://discord.com/oauth2/authorize?client_id=${this.client.options.clientId}&redirect_uri=${encodeURIComponent(`${this.client.options.baseUrl}/linked-roles/verify-user/callback`)}&response_type=code&scope=identify+role_connections.write&prompt=none`
+            }
+        });
+    }
+    /**
+     * Handle the verify user callback request
+     * @param req The request
+     * @returns A response
+     */
+    async handleUserVerificationCallbackRequest(req) {
+        const url = new URL(req.url);
+        const code = String(url.searchParams.get("code"));
+        const tokens = await this.getOAuthTokens(code);
+        const authData = await (await fetch("https://discord.com/api/v10/oauth2/@me", {
+            headers: {
+                Authorization: `Bearer ${tokens.access_token}`
+            }
+        })).json();
+        if (!authData.user)
+            return new Response("", {
+                status: 307,
+                headers: {
+                    Location: `${this.client.options.baseUrl}/connect`
+                }
+            });
+        const newMetadata = await this.getMetadataFromCheckers(authData.user.id);
+        await this.updateMetadata(authData.user?.id, newMetadata, tokens);
+        // IDEA: Maybe we can redirect to a success page instead of just a message
+        return new Response("You can now close this tab.");
+    }
+    async getMetadataFromCheckers(userId) {
+        const result = {};
+        for (const metadata of this.options.metadata) {
+            const checker = this.options.metadataCheckers[metadata.key];
+            if (!checker)
+                throw new Error(`You did not provide a checker for ${metadata.key}`);
+            const value = await checker(userId);
+            switch (metadata.type) {
+                case ApplicationRoleConnectionMetadataType.BooleanEqual:
+                case ApplicationRoleConnectionMetadataType.BooleanNotEqual:
+                    if (typeof value !== "boolean")
+                        throw new Error(`Expected boolean for ${metadata.key}`);
+                    break;
+                case ApplicationRoleConnectionMetadataType.DatetimeGreaterThanOrEqual:
+                case ApplicationRoleConnectionMetadataType.DatetimeLessThanOrEqual:
+                    if (typeof value !== "number")
+                        throw new Error(`Expected number for ${metadata.key}`);
+                    break;
+                case ApplicationRoleConnectionMetadataType.IntegerEqual:
+                case ApplicationRoleConnectionMetadataType.IntegerNotEqual:
+                case ApplicationRoleConnectionMetadataType.IntegerGreaterThanOrEqual:
+                case ApplicationRoleConnectionMetadataType.IntegerLessThanOrEqual:
+                    if (!(typeof value === "number" && Number.isSafeInteger(value)))
+                        throw new Error(`Expected integer for ${metadata.key}`);
+                    break;
+                default:
+                    throw new Error(`Unknown metadata type ${metadata.type}`);
+            }
+            result[metadata.key] = value;
+        }
+        return result;
+    }
+    async getOAuthTokens(code) {
+        const url = "https://discord.com/api/v10/oauth2/token";
+        const body = new URLSearchParams({
+            client_id: this.client.options.clientId,
+            client_secret: this.client.options.clientSecret,
+            grant_type: "authorization_code",
+            code,
+            redirect_uri: `${this.client.options.baseUrl}/linked-roles/verify-user/callback`
+        });
+        const response = await fetch(url, {
+            body,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded"
+            }
+        });
+        if (response.ok) {
+            const data = await response.json();
+            return data;
+        }
+        throw new Error(`Error fetching OAuth tokens: [${response.status}] ${JSON.stringify(await response.json())}`);
+    }
+    async updateMetadata(userId, metadata, tokens) {
+        const url = `https://discord.com/api/v10/users/@me/applications/${this.client.options.clientId}/role-connection`;
+        const response = await fetch(url, {
+            method: "PUT",
+            body: JSON.stringify({ metadata }),
+            headers: {
+                Authorization: `Bearer ${tokens.access_token}`,
+                "Content-Type": "application/json"
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Error pushing discord metadata for ${userId}: [${response.status}] ${JSON.stringify(await response.json())}`);
+        }
+    }
+    async setMetadata(data) {
+        const response = await fetch(`https://discord.com/api/v10/applications/${this.client.options.clientId}/role-connections/metadata`, {
+            method: "PUT",
+            body: JSON.stringify(data),
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bot ${this.client.options.token}`
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Error pushing discord metadata: [${response.status}] ${JSON.stringify(await response.json())}`);
+        }
+    }
+}
+//# sourceMappingURL=LinkedRoles.js.map

package/dist/src/plugins/linked-roles/LinkedRoles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkedRoles.js","sourceRoot":"","sources":["../../../../src/plugins/linked-roles/LinkedRoles.ts"],"names":[],"mappings":"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"}

package/dist/src/plugins/linked-roles/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./LinkedRoles.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/plugins/linked-roles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/linked-roles/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA"}

package/dist/src/plugins/linked-roles/index.js

@@ -0,0 +1,3 @@
+export * from "./LinkedRoles.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/plugins/linked-roles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/linked-roles/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA"}

package/dist/src/plugins/linked-roles/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The type of metadata that you can check for
+ */
+export declare enum ApplicationRoleConnectionMetadataType {
+    /**
+     * The metadata value (`integer`) is less than or equal to the guild's configured value (`integer`)
+     */
+    IntegerLessThanOrEqual = 1,
+    /**
+     * The metadata value (`integer`) is greater than or equal to the guild's configured value (`integer`)
+     */
+    IntegerGreaterThanOrEqual = 2,
+    /**
+     * The metadata value (`integer`) is equal to the guild's configured value (`integer`)
+     */
+    IntegerEqual = 3,
+    /**
+     * The metadata value (`integer`) is not equal to the guild's configured value (`integer`)
+     */
+    IntegerNotEqual = 4,
+    /**
+     * The metadata value (`ISO8601 string`) is less than or equal to the guild's configured value (`integer`; days before current date)
+     */
+    DatetimeLessThanOrEqual = 5,
+    /**
+     * The metadata value (`ISO8601 string`) is greater than or equal to the guild's configured value (`integer`; days before current date)
+     */
+    DatetimeGreaterThanOrEqual = 6,
+    /**
+     * The metadata value (`integer`) is equal to the guild's configured value (`integer`; `1`)
+     */
+    BooleanEqual = 7,
+    /**
+     * The metadata value (`integer`) is not equal to the guild's configured value (`integer`; `1`)
+     */
+    BooleanNotEqual = 8
+}
+/**
+ * The options for the linked roles package
+ */
+export type LinkedRolesOptions = {
+    /**
+     * The metadata that you want to check for, and that should show to the end-user on Discord.
+     */
+    metadata: LinkedRoleCriteria[];
+    /**
+     * The functions that you want to use to check the metadata.
+     * @remarks
+     * If you are checking a boolean, you should return `true` or `false`.
+     * If you are checking an integer, you should return a number that is safe to use as an integer.
+     * If you are checking a datetime, you should return a Date.now() timestamp.
+     */
+    metadataCheckers: {
+        [name: string]: (userId: string) => Promise<number | boolean>;
+    };
+    /**
+     * Whether the deploy route should be disabled.
+     * @default false
+     */
+    disableDeployRoute?: boolean;
+    /**
+     * Whether the connect route should be disabled.
+     * @default false
+     */
+    disableVerifyUserRoute?: boolean;
+    /**
+     * Whether the connect callback route should be disabled.
+     * @default false
+     */
+    disableVerifyUserCallbackRoute?: boolean;
+};
+/**
+ * The metadata that you want to check for, and that should show to the end-user on Discord.
+ * @remarks You can only have 5 metadata per application, and they apply across all guilds your app is in.
+ */
+export type LinkedRoleCriteria = {
+    /**
+     * The key of the metadata. This is only used on the code side, and is not seen by the end user.
+     */
+    key: string;
+    /**
+     * The type of metadata that you want to check for.
+     */
+    type: ApplicationRoleConnectionMetadataType;
+    /**
+     * The name of the metadata. This is what the end user will see.
+     */
+    name: string;
+    /**
+     * A description of the metadata.
+     */
+    description: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/plugins/linked-roles/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/linked-roles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,qCAAqC;IAChD;;OAEG;IACH,sBAAsB,IAAI;IAC1B;;OAEG;IACH,yBAAyB,IAAI;IAC7B;;OAEG;IACH,YAAY,IAAI;IAChB;;OAEG;IACH,eAAe,IAAI;IACnB;;OAEG;IACH,uBAAuB,IAAI;IAC3B;;OAEG;IACH,0BAA0B,IAAI;IAC9B;;OAEG;IACH,YAAY,IAAI;IAChB;;OAEG;IACH,eAAe,IAAI;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC;;OAEG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B;;;;;;OAMG;IACH,gBAAgB,EAAE;QACjB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,CAAA;KAC7D,CAAA;IACD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,IAAI,EAAE,qCAAqC,CAAA;IAC3C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA"}

package/dist/src/plugins/linked-roles/types.js

@@ -0,0 +1,39 @@
+/**
+ * The type of metadata that you can check for
+ */
+export var ApplicationRoleConnectionMetadataType;
+(function (ApplicationRoleConnectionMetadataType) {
+    /**
+     * The metadata value (`integer`) is less than or equal to the guild's configured value (`integer`)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["IntegerLessThanOrEqual"] = 1] = "IntegerLessThanOrEqual";
+    /**
+     * The metadata value (`integer`) is greater than or equal to the guild's configured value (`integer`)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["IntegerGreaterThanOrEqual"] = 2] = "IntegerGreaterThanOrEqual";
+    /**
+     * The metadata value (`integer`) is equal to the guild's configured value (`integer`)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["IntegerEqual"] = 3] = "IntegerEqual";
+    /**
+     * The metadata value (`integer`) is not equal to the guild's configured value (`integer`)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["IntegerNotEqual"] = 4] = "IntegerNotEqual";
+    /**
+     * The metadata value (`ISO8601 string`) is less than or equal to the guild's configured value (`integer`; days before current date)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["DatetimeLessThanOrEqual"] = 5] = "DatetimeLessThanOrEqual";
+    /**
+     * The metadata value (`ISO8601 string`) is greater than or equal to the guild's configured value (`integer`; days before current date)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["DatetimeGreaterThanOrEqual"] = 6] = "DatetimeGreaterThanOrEqual";
+    /**
+     * The metadata value (`integer`) is equal to the guild's configured value (`integer`; `1`)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["BooleanEqual"] = 7] = "BooleanEqual";
+    /**
+     * The metadata value (`integer`) is not equal to the guild's configured value (`integer`; `1`)
+     */
+    ApplicationRoleConnectionMetadataType[ApplicationRoleConnectionMetadataType["BooleanNotEqual"] = 8] = "BooleanNotEqual";
+})(ApplicationRoleConnectionMetadataType || (ApplicationRoleConnectionMetadataType = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/plugins/linked-roles/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/plugins/linked-roles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,qCAiCX;AAjCD,WAAY,qCAAqC;IAChD;;OAEG;IACH,qIAA0B,CAAA;IAC1B;;OAEG;IACH,2IAA6B,CAAA;IAC7B;;OAEG;IACH,iHAAgB,CAAA;IAChB;;OAEG;IACH,uHAAmB,CAAA;IACnB;;OAEG;IACH,uIAA2B,CAAA;IAC3B;;OAEG;IACH,6IAA8B,CAAA;IAC9B;;OAEG;IACH,iHAAgB,CAAA;IAChB;;OAEG;IACH,uHAAmB,CAAA;AACpB,CAAC,EAjCW,qCAAqC,KAArC,qCAAqC,QAiChD"}

package/dist/src/structures/DmChannel.d.ts

@@ -1,18 +1,19 @@
-import { type APIDMChannel, type APIMessage, ChannelType } from "discord-api-types/v10";
+import { type APIDMChannel, type ChannelType } from "discord-api-types/v10";
 import { BaseChannel } from "../abstracts/BaseChannel.js";
+import type { MessagePayload } from "../types.js";
+import { type IfPartial } from "../utils.js";
 /**
  * Represents a DM between two users.
  */
-export declare class DmChannel extends BaseChannel<ChannelType.DM> {
+export declare class DmChannel<IsPartial extends boolean = false> extends BaseChannel<ChannelType.DM, IsPartial> {
+    rawData: APIDMChannel | null;
     /**
      * The name of the channel. This is always null for DM channels.
      */
-    name?: null;
-    type: ChannelType.DM;
-    protected setSpecificData(data: APIDMChannel): void;
+    get name(): IfPartial<IsPartial, null>;
     /**
      * Send a message to the channel
      */
-    send(message: APIMessage): Promise<void>;
+    send(message: MessagePayload): Promise<void>;
 }
 //# sourceMappingURL=DmChannel.d.ts.map

package/dist/src/structures/DmChannel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DmChannel.d.ts","sourceRoot":"","sources":["../../../src/structures/DmChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,WAAW,EAEX,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;IACzD;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAO;IAClB,IAAI,EAAE,WAAW,CAAC,EAAE,CAAiB;IAErC,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,YAAY;IAI5C;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,UAAU;CAK9B"}
+{"version":3,"file":"DmChannel.d.ts","sourceRoot":"","sources":["../../../src/structures/DmChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,aAAa,CAAA;AAE9D;;GAEG;AACH,qBAAa,SAAS,CAAC,SAAS,SAAS,OAAO,GAAG,KAAK,CAAE,SAAQ,WAAW,CAC5E,WAAW,CAAC,EAAE,EACd,SAAS,CACT;IACQ,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IAEpC;;OAEG;IACH,IAAI,IAAI,IAAI,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAGrC;IAED;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc;CAKlC"}

package/dist/src/structures/DmChannel.js

@@ -1,5 +1,6 @@
-import { ChannelType, Routes } from "discord-api-types/v10";
+import { Routes } from "discord-api-types/v10";
 import { BaseChannel } from "../abstracts/BaseChannel.js";
+import { serializePayload } from "../utils.js";
 /**
  * Represents a DM between two users.
  */
@@ -7,17 +8,17 @@ export class DmChannel extends BaseChannel {
     /**
      * The name of the channel. This is always null for DM channels.
      */
-    name = null;
-    type = ChannelType.DM;
-    setSpecificData(data) {
-        this.name = data.name;
+    get name() {
+        if (!this.rawData)
+            return undefined;
+        return null;
     }
     /**
      * Send a message to the channel
      */
     async send(message) {
         this.client.rest.post(Routes.channelMessages(this.id), {
-            body: { ...message }
+            body: serializePayload(message)
         });
     }
 }

package/dist/src/structures/DmChannel.js.map

@@ -1 +1 @@
-{"version":3,"file":"DmChannel.js","sourceRoot":"","sources":["../../../src/structures/DmChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,WAAW,EACX,MAAM,EACN,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAA2B;IACzD;;OAEG;IACH,IAAI,GAAU,IAAI,CAAA;IAClB,IAAI,GAAmB,WAAW,CAAC,EAAE,CAAA;IAE3B,eAAe,CAAC,IAAkB;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAmB;QAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YACtD,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE;SACpB,CAAC,CAAA;IACH,CAAC;CACD"}
+{"version":3,"file":"DmChannel.js","sourceRoot":"","sources":["../../../src/structures/DmChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,MAAM,EACN,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,OAAO,EAAkB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9D;;GAEG;AACH,MAAM,OAAO,SAA6C,SAAQ,WAGjE;IAGA;;OAEG;IACH,IAAI,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAkB,CAAA;QAC5C,OAAO,IAAI,CAAA;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAuB;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YACtD,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC;SAC/B,CAAC,CAAA;IACH,CAAC;CACD"}

package/dist/src/structures/GroupDmChannel.d.ts

@@ -1,52 +1,52 @@
-import { type APIGroupDMChannel, ChannelType } from "discord-api-types/v10";
+import { type APIGroupDMChannel, type ChannelType } from "discord-api-types/v10";
 import { BaseChannel } from "../abstracts/BaseChannel.js";
+import type { IfPartial } from "../utils.js";
 import { Message } from "./Message.js";
 import { User } from "./User.js";
 /**
  * Represents a group DM channel.
  */
-export declare class GroupDmChannel extends BaseChannel<ChannelType.GroupDM> {
+export declare class GroupDmChannel<IsPartial extends boolean = false> extends BaseChannel<ChannelType.GroupDM, IsPartial> {
+    rawData: APIGroupDMChannel | null;
     /**
      * The name of the channel.
      */
-    name?: string | null;
+    get name(): IfPartial<IsPartial, string | null>;
     /**
      * The recipients of the channel.
      */
-    recipients?: User[];
-    type: ChannelType.GroupDM;
+    get recipients(): IfPartial<IsPartial, User<boolean>[]>;
     /**
      * The ID of the application that created the channel, if it was created by a bot.
      */
-    applicationId?: string | null;
+    get applicationId(): IfPartial<IsPartial, string | null>;
     /**
      * The icon hash of the channel.
      */
-    icon?: string | null;
+    get icon(): IfPartial<IsPartial, string | null>;
+    /**
+     * Get the URL of the channel's icon.
+     */
+    get iconUrl(): IfPartial<IsPartial, string | null>;
     /**
      * The ID of the user who created the channel.
      */
-    ownerId?: string | null;
+    get ownerId(): IfPartial<IsPartial, string | null>;
     /**
      * The ID of the last message sent in the channel.
      *
      * @remarks
      * This might not always resolve to a message. The ID still stays a part of the channel's data, even if the message is deleted.
      */
-    lastMessageId?: string | null;
+    get lastMessageId(): IfPartial<IsPartial, string | null>;
     /**
      * Whether the channel is managed by an Oauth2 application.
      */
-    managed?: boolean | null;
-    protected setSpecificData(data: APIGroupDMChannel): void;
-    /**
-     * Get the URL of the channel's icon.
-     */
-    get iconUrl(): string | null;
+    get managed(): IfPartial<IsPartial, boolean>;
     /**
      * Get the owner of the channel.
      */
-    get owner(): User;
+    get owner(): User<true>;
     /**
      * The last message sent in the channel.
      *
@@ -55,13 +55,11 @@ export declare class GroupDmChannel extends BaseChannel<ChannelType.GroupDM> {
      * This will always return a partial message, so you can use {@link Message.fetch} to get the full message data.
      *
      */
-    get lastMessage(): Message | null;
+    get lastMessage(): Message<true> | null;
     /**
      * Set the name of the channel
      * @param name The new name of the channel
      */
     setName(name: string): Promise<void>;
-    addRecipient(user: User | string): Promise<void>;
-    removeRecipient(user: User | string): Promise<void>;
 }
 //# sourceMappingURL=GroupDmChannel.d.ts.map

package/dist/src/structures/GroupDmChannel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GroupDmChannel.d.ts","sourceRoot":"","sources":["../../../src/structures/GroupDmChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EACtB,WAAW,EAEX,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC;IACnE;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,EAAE,CAAA;IACnB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAsB;IAC/C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAExB,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,iBAAiB;IAUjD;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAI3B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,CAGhB;IAED;;;;;;;OAOG;IACH,IAAI,WAAW,mBAMd;IAED;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM;IASpB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAiBhC,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;CAYzC"}
+{"version":3,"file":"GroupDmChannel.d.ts","sourceRoot":"","sources":["../../../src/structures/GroupDmChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEhB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;GAEG;AACH,qBAAa,cAAc,CAC1B,SAAS,SAAS,OAAO,GAAG,KAAK,CAChC,SAAQ,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5C,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAEzC;;OAEG;IACH,IAAI,IAAI,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAG9C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAItD;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAGvD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAG9C;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAIjD;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAGjD;IAED;;;;;OAKG;IACH,IAAI,aAAa,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAGvD;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAG3C;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAGtB;IAED;;;;;;;OAOG;IACH,IAAI,WAAW,yBAMd;IAED;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM;CA4B1B"}