@buape/carbon 0.5.0 → 0.6.0

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/utils.d.ts

@@ -4,9 +4,7 @@ export declare const splitCustomId: (customId: string) => [string, Record<string
 export declare const subtleCrypto: SubtleCrypto;
 export declare function valueToUint8Array(value: Uint8Array | ArrayBuffer | Buffer | string, format?: string): Uint8Array;
 export declare function concatUint8Arrays(arr1: Uint8Array, arr2: Uint8Array): Uint8Array;
-export declare const serializePayload: (payload: MessagePayload) => {
-    content: string;
-} | {
+export declare const serializePayload: (payload: MessagePayload, defaultEphemeral?: boolean) => {
     embeds: import("discord-api-types/v10").APIEmbed[] | undefined;
     components: import("discord-api-types/v10").APIActionRowComponent<import("discord-api-types/v10").APIActionRowComponentTypes>[] | undefined;
     content?: string;
@@ -17,5 +15,8 @@ export declare const serializePayload: (payload: MessagePayload) => {
     };
     flags?: number;
     tts?: boolean;
+} | {
+    content: string;
+    flags: number | undefined;
 };
 //# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,aAAa,aACf,MAAM,KACd,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUjC,CAAA;AAsBD,eAAO,MAAM,YAAY,cAAoB,CAAA;AAE7C,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,EACjD,MAAM,CAAC,EAAE,MAAM,GACb,UAAU,CA8BZ;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,GACd,UAAU,CAKZ;AAED,eAAO,MAAM,gBAAgB,YAAa,cAAc;;;;;;;aAhEZ,CAAC;aAG5C,CAAD;aAAoB,CAAC;;;;CAqEpB,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,aAAa,aACf,MAAM,KACd,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUjC,CAAA;AAsBD,eAAO,MAAM,YAAY,cAAoB,CAAA;AAE7C,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,EACjD,MAAM,CAAC,EAAE,MAAM,GACb,UAAU,CA4BZ;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,GACd,UAAU,CAKZ;AAED,eAAO,MAAM,gBAAgB,YACnB,cAAc;;;;;aA/DoB,CAAC;aAG5C,CAAD;aAAoB,CAAC;;;;;;;CA2EpB,CAAA"}

package/dist/src/utils.js

@@ -42,12 +42,9 @@ export function valueToUint8Array(value, format) {
         }
         return new TextEncoder().encode(value);
     }
-    try {
-        if (Buffer.isBuffer(value)) {
-            return new Uint8Array(value);
-        }
+    if (Buffer.isBuffer(value)) {
+        return new Uint8Array(value);
     }
-    catch (_) { }
     if (value instanceof ArrayBuffer) {
         return new Uint8Array(value);
     }
@@ -62,13 +59,18 @@ export function concatUint8Arrays(arr1, arr2) {
     merged.set(arr2, arr1.length);
     return merged;
 }
-export const serializePayload = (payload) => {
-    return typeof payload === "string"
-        ? { content: payload }
-        : {
-            ...payload,
-            embeds: payload.embeds?.map((embed) => embed.serialize()),
-            components: payload.components?.map((row) => row.serialize())
-        };
+export const serializePayload = (payload, defaultEphemeral = false) => {
+    if (typeof payload === "string") {
+        return { content: payload, flags: defaultEphemeral ? 64 : undefined };
+    }
+    const data = {
+        ...payload,
+        embeds: payload.embeds?.map((embed) => embed.serialize()),
+        components: payload.components?.map((row) => row.serialize())
+    };
+    if (defaultEphemeral) {
+        data.flags = 64;
+    }
+    return data;
 };
 //# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

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