@buape/carbon 0.7.0 → 0.9.0

package/dist/src/plugins/paginator/Paginator.js

@@ -0,0 +1,155 @@
+import { ButtonStyle } from "discord-api-types/v10";
+import { Button } from "../../classes/components/Button.js";
+import { Row } from "../../classes/components/Row.js";
+export class Paginator {
+    pages;
+    id;
+    currentPage = 0;
+    timeout = null;
+    timeoutDuration;
+    /**
+     * The user ID who is allowed to interact with the paginator
+     */
+    userId;
+    constructor(
+    /**
+     * The pages to display in the paginator, with no limit on the amount of pages
+     */
+    pages, { 
+    /**
+     * The client to use for the paginator
+     */
+    client, 
+    /**
+     * How long in milliseconds the paginator will wait before disabling the buttons
+     * @default 300000 (5 minutes)
+     */
+    timeoutDuration = 300000, 
+    /**
+     * The user ID who is allowed to interact with the paginator
+     */
+    userId }) {
+        if (pages.length === 0) {
+            throw new Error("Paginator must have at least one page");
+        }
+        this.pages = pages;
+        this.timeoutDuration = timeoutDuration;
+        this.userId = userId;
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).slice(2, 5);
+        this.id = `${timestamp}-${random}`;
+        client.paginators.push(this);
+        this.startTimeout();
+    }
+    startTimeout() {
+        if (this.timeout) {
+            clearTimeout(this.timeout);
+        }
+        this.timeout = setTimeout(() => {
+            this.disableButtons();
+        }, this.timeoutDuration);
+    }
+    disableButtons() {
+        const page = this.getCurrentPage();
+        if (!page.components)
+            return;
+        const row = this.createNavigationButtons();
+        for (const component of row.components) {
+            if ("disabled" in component) {
+                component.disabled = true;
+            }
+        }
+        const otherComponents = page.components.slice(0, -1);
+        page.components = [...otherComponents, row];
+    }
+    destroy() {
+        if (this.timeout) {
+            clearTimeout(this.timeout);
+            this.timeout = null;
+        }
+    }
+    getCurrentPage() {
+        const page = this.pages[this.currentPage];
+        if (!page)
+            throw new Error("Invalid page index");
+        return page;
+    }
+    async goToPage(pageIndex, interaction) {
+        if (pageIndex < 0 || pageIndex >= this.pages.length) {
+            return interaction.reply({
+                content: "Invalid page number"
+            });
+        }
+        this.currentPage = pageIndex;
+        this.startTimeout();
+        await interaction.update(this.getCurrentPageWithButtons());
+    }
+    createNavigationButtons(disabled = false) {
+        const backButton = new DirectionButton({
+            paginatorId: this.id,
+            goToPage: this.currentPage - 1,
+            disabled: disabled || this.currentPage === 0,
+            label: "Back"
+        });
+        const pageNumber = new (class extends Button {
+            label;
+            customId = "x-pageNumber";
+            style = ButtonStyle.Secondary;
+            disabled = true;
+            constructor(currentPage, totalPages) {
+                super();
+                this.label = `${currentPage + 1} / ${totalPages}`;
+            }
+            async run() { }
+        })(this.currentPage, this.pages.length);
+        const nextButton = new DirectionButton({
+            paginatorId: this.id,
+            goToPage: this.currentPage + 1,
+            disabled: disabled || this.currentPage === this.pages.length - 1,
+            label: "Next"
+        });
+        return new Row([backButton, pageNumber, nextButton]);
+    }
+    getCurrentPageWithButtons() {
+        const page = this.getCurrentPage();
+        return {
+            ...page,
+            components: [...(page.components || []), this.createNavigationButtons()]
+        };
+    }
+    getInitialPage() {
+        return this.getCurrentPageWithButtons();
+    }
+    /**
+     * Sends the paginator message using the provided interaction
+     * @param interaction The interaction to use for sending the message
+     */
+    async send(interaction) {
+        await interaction.reply(this.getInitialPage());
+    }
+}
+class DirectionButton extends Button {
+    label;
+    customId;
+    style = ButtonStyle.Secondary;
+    disabled = false;
+    constructor({ paginatorId, goToPage, disabled, label }) {
+        super();
+        this.customId = `paginator:paginatorId=${paginatorId};goToPage=${goToPage}`;
+        this.label = label;
+        this.disabled = disabled;
+    }
+    async run(interaction, data) {
+        const paginatorId = data.paginatorId;
+        const goToPage = Number.parseInt(`${data.goToPage}`);
+        const paginator = interaction.client.paginators.find((p) => p.id === paginatorId);
+        if (!paginator)
+            return interaction.reply({
+                content: `Paginator ${paginatorId} not found in memory`
+            });
+        if (paginator.userId && paginator.userId !== interaction.user?.id)
+            return interaction.acknowledge();
+        await paginator.goToPage(goToPage, interaction);
+    }
+}
+//# sourceMappingURL=Paginator.js.map

package/dist/src/plugins/paginator/Paginator.js.map

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

package/dist/src/plugins/paginator/index.d.ts

@@ -0,0 +1,8 @@
+declare module "../../classes/Client.js" {
+    interface Client {
+        paginators: Paginator[];
+    }
+}
+import { Paginator } from "./Paginator.js";
+export { Paginator };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/plugins/paginator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/paginator/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yBAAyB,CAAC;IACxC,UAAU,MAAM;QACf,UAAU,EAAE,SAAS,EAAE,CAAA;KACvB;CACD;AAGD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAO1C,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/dist/src/plugins/paginator/index.js

@@ -0,0 +1,8 @@
+import { Client } from "../../classes/Client.js";
+import { Paginator } from "./Paginator.js";
+Object.assign(Client.prototype, {
+    Paginator,
+    paginators: []
+});
+export { Paginator };
+//# sourceMappingURL=index.js.map

package/dist/src/plugins/paginator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/paginator/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;IAC/B,SAAS;IACT,UAAU,EAAE,EAAiB;CAC7B,CAAC,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/dist/src/plugins/sharding/ShardingPlugin.d.ts

@@ -0,0 +1,43 @@
+import type { APIGatewayBotInfo } from "discord-api-types/v10";
+import { Plugin } from "../../abstracts/Plugin.js";
+import type { Client } from "../../classes/Client.js";
+import { GatewayPlugin } from "../gateway/GatewayPlugin.js";
+import type { GatewayPluginOptions } from "../gateway/types.js";
+export interface ShardingPluginOptions extends Omit<GatewayPluginOptions, "shard"> {
+    /**
+     * If not provided, will use Discord's recommended amount
+     */
+    totalShards?: number;
+    /**
+     * Specific shard IDs to spawn, if not provided will spawn all shards
+     */
+    shardIds?: number[];
+    /**
+     * Maximum number of shards to spawn concurrently
+     */
+    maxConcurrency?: number;
+}
+export declare class ShardingPlugin extends Plugin {
+    readonly id = "sharding";
+    protected client?: Client;
+    readonly shards: Map<number, GatewayPlugin>;
+    readonly config: ShardingPluginOptions;
+    protected maxConcurrency: number;
+    protected spawnQueue: number[];
+    protected spawning: boolean;
+    protected gatewayInfo?: APIGatewayBotInfo;
+    customGatewayPlugin: typeof GatewayPlugin;
+    constructor(options: ShardingPluginOptions);
+    registerClient(client: Client): Promise<void>;
+    protected processSpawnQueue(): Promise<void>;
+    disconnect(): void;
+    /**
+     * Calculate which shard a guild belongs to
+     */
+    getShardForGuild(guildId: string): GatewayPlugin | undefined;
+    /**
+     * Discord's sharding formula
+     */
+    protected calculateShardId(guildId: string, totalShards: number): number;
+}
+//# sourceMappingURL=ShardingPlugin.d.ts.map

package/dist/src/plugins/sharding/ShardingPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShardingPlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/sharding/ShardingPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,MAAM,WAAW,qBAChB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAC3C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,qBAAa,cAAe,SAAQ,MAAM;IACzC,QAAQ,CAAC,EAAE,cAAa;IACxB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAY;IACvD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAA;IAChC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAK;IACnC,SAAS,CAAC,QAAQ,UAAQ;IAC1B,SAAS,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAEzC,mBAAmB,uBAAgB;gBAEvB,OAAO,EAAE,qBAAqB;IAM7B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cA0C1C,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD3C,UAAU,IAAI,IAAI;IAQzB;;OAEG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAQnE;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;CAMxE"}

package/dist/src/plugins/sharding/ShardingPlugin.js

@@ -0,0 +1,111 @@
+import { Plugin } from "../../abstracts/Plugin.js";
+import { GatewayPlugin } from "../gateway/GatewayPlugin.js";
+export class ShardingPlugin extends Plugin {
+    id = "sharding";
+    client;
+    shards = new Map();
+    config;
+    maxConcurrency;
+    spawnQueue = [];
+    spawning = false;
+    gatewayInfo;
+    customGatewayPlugin = GatewayPlugin;
+    constructor(options) {
+        super();
+        this.config = options;
+        this.maxConcurrency = options.maxConcurrency ?? 1;
+    }
+    async registerClient(client) {
+        this.client = client;
+        // If totalShards not provided, get recommended amount from Discord
+        if (!this.config.totalShards) {
+            try {
+                const response = await fetch("https://discord.com/api/v10/gateway/bot", {
+                    headers: {
+                        Authorization: `Bot ${client.options.token}`
+                    }
+                });
+                const gatewayInfo = (await response.json());
+                this.config.totalShards = gatewayInfo.shards;
+                if (!this.config.url) {
+                    this.config.url = gatewayInfo.url;
+                }
+                this.maxConcurrency = gatewayInfo.session_start_limit.max_concurrency;
+                this.gatewayInfo = gatewayInfo;
+            }
+            catch {
+                throw new Error("Failed to get recommended shard count from Discord");
+            }
+        }
+        const totalShards = this.config.totalShards;
+        if (!totalShards) {
+            throw new Error("Total shards must be specified or retrievable from Discord");
+        }
+        // Determine which shards to spawn
+        const shardsToSpawn = this.config.shardIds ?? Array.from({ length: totalShards }, (_, i) => i);
+        // Queue all shards for spawning
+        this.spawnQueue = [...shardsToSpawn];
+        await this.processSpawnQueue();
+    }
+    async processSpawnQueue() {
+        if (this.spawning || this.spawnQueue.length === 0)
+            return;
+        this.spawning = true;
+        const currentBatch = [];
+        // Process shards in batches based on maxConcurrency
+        while (currentBatch.length < this.maxConcurrency &&
+            this.spawnQueue.length > 0) {
+            const shardId = this.spawnQueue.shift();
+            if (shardId !== undefined) {
+                currentBatch.push(shardId);
+            }
+        }
+        const totalShards = this.config.totalShards;
+        if (!totalShards)
+            return;
+        // Spawn the current batch of shards
+        await Promise.all(currentBatch.map(async (shardId) => {
+            const shard = new this.customGatewayPlugin({
+                ...this.config,
+                shard: [shardId, totalShards]
+            }, this.gatewayInfo);
+            if (this.client) {
+                shard.registerClient(this.client);
+            }
+            this.shards.set(shardId, shard);
+        }));
+        this.spawning = false;
+        // Continue processing if there are more shards to spawn
+        if (this.spawnQueue.length > 0) {
+            // Add a delay between batches to prevent rate limiting
+            setTimeout(() => this.processSpawnQueue(), 5000);
+        }
+    }
+    disconnect() {
+        for (const shard of this.shards.values()) {
+            shard.disconnect();
+        }
+        this.shards.clear();
+        this.spawnQueue = [];
+    }
+    /**
+     * Calculate which shard a guild belongs to
+     */
+    getShardForGuild(guildId) {
+        const totalShards = this.config.totalShards;
+        if (!totalShards)
+            return undefined;
+        const shardId = this.calculateShardId(guildId, totalShards);
+        return this.shards.get(shardId);
+    }
+    /**
+     * Discord's sharding formula
+     */
+    calculateShardId(guildId, totalShards) {
+        if (!/^\d+$/.test(guildId)) {
+            throw new Error("Invalid guild ID");
+        }
+        return Number((BigInt(guildId) >> 22n) % BigInt(totalShards));
+    }
+}
+//# sourceMappingURL=ShardingPlugin.js.map

package/dist/src/plugins/sharding/ShardingPlugin.js.map

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

package/dist/src/plugins/sharding/index.d.ts

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

package/dist/src/plugins/sharding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/sharding/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA"}

package/dist/src/plugins/sharding/index.js

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

package/dist/src/plugins/sharding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/sharding/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA"}

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

@@ -1,7 +1,7 @@
 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";
+import type { IfPartial, MessagePayload } from "../types/index.js";
+import { Message } from "./Message.js";
 /**
  * Represents a DM between two users.
  */
@@ -14,6 +14,6 @@ export declare class DmChannel<IsPartial extends boolean = false> extends BaseCh
     /**
      * Send a message to the channel
      */
-    send(message: MessagePayload): Promise<void>;
+    send(message: MessagePayload): Promise<Message<false>>;
 }
 //# 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,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"}
+{"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;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC;;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;CAMlC"}

package/dist/src/structures/DmChannel.js

@@ -1,6 +1,7 @@
 import { Routes } from "discord-api-types/v10";
 import { BaseChannel } from "../abstracts/BaseChannel.js";
-import { serializePayload } from "../utils.js";
+import { serializePayload } from "../utils/index.js";
+import { Message } from "./Message.js";
 /**
  * Represents a DM between two users.
  */
@@ -17,9 +18,10 @@ export class DmChannel extends BaseChannel {
      * Send a message to the channel
      */
     async send(message) {
-        this.client.rest.post(Routes.channelMessages(this.id), {
+        const data = (await this.client.rest.post(Routes.channelMessages(this.id), {
             body: serializePayload(message)
-        });
+        }));
+        return new Message(this.client, data);
     }
 }
 //# sourceMappingURL=DmChannel.js.map

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,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"}
+{"version":3,"file":"DmChannel.js","sourceRoot":"","sources":["../../../src/structures/DmChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,MAAM,EACN,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC;;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,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAC1E,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC;SAC/B,CAAC,CAAe,CAAA;QACjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACtC,CAAC;CACD"}

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

@@ -1,6 +1,6 @@
 import { type APIGroupDMChannel, type ChannelType } from "discord-api-types/v10";
 import { BaseChannel } from "../abstracts/BaseChannel.js";
-import type { IfPartial } from "../utils.js";
+import type { IfPartial } from "../types/index.js";
 import { Message } from "./Message.js";
 import { User } from "./User.js";
 /**

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,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"}
+{"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,mBAAmB,CAAA;AAClD,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"}