carbon-proxy 0.14.0

package/README.md

@@ -0,0 +1,237 @@
+# Carbon Proxy
+
+<div align="center">
+<a href="https://github.com/stonev5/carbon"><img src="https://cdn.buape.com/carbon/wordmark.png" alt="Carbon Wordmark"></a>
+
+<img alt="Discord" src="https://img.shields.io/discord/1280628625904894072?style=for-the-badge">
+<img alt="NPM Version" src="https://img.shields.io/npm/v/carbon-proxy?style=for-the-badge">
+<img alt="NPM Downloads" src="https://img.shields.io/npm/dm/carbon-proxy?style=for-the-badge">
+</div>
+
+> Carbon 框架的代理增强版 - 支持通过 HTTP/SOCKS5 代理访问 Discord API
+
+这是基于 [@buape/carbon](https://github.com/buape/carbon) 的 fork 版本，增加了对代理的支持，方便在需要代理的环境中使用。
+
+## ✨ 新增特性
+
+本版本在原版基础上新增：
+
+- **🔒 HTTP 代理支持** - 通过 HTTP 代理访问 Discord API
+- **🧦 SOCKS5 代理支持** - 支持 SOCKS5 协议的代理
+- **⚙️ 灵活配置** - 支持环境变量和代码配置两种方式
+- **🌍 国际化友好** - 完美支持中国大陆等需要代理的地区
+
+## 原版特性
+
+Carbon 是一个功能完善的 Discord HTTP 框架，使用 TypeScript 构建，设计简洁易懂。
+
+- 完全兼容 Discord API
+- 灵活强大
+- 基于类的系统，易于复用
+- 支持多平台部署（Node.js、Cloudflare Workers、Bun、Next.js）
+
+## 📦 安装
+
+```bash
+npm install carbon-proxy
+# 或
+pnpm add carbon-proxy
+# 或
+yarn add carbon-proxy
+```
+
+## 🚀 快速开始
+
+### 基础用法（不带代理）
+
+```typescript
+import { Client } from "carbon-proxy"
+
+const client = new Client({
+  clientId: "your-client-id",
+  publicKey: "your-public-key",
+  token: "your-bot-token",
+  baseUrl: "http://localhost:3000"
+})
+
+client.startServer()
+```
+
+### 使用 HTTP 代理
+
+**方式一：环境变量（推荐）**
+
+```bash
+# 设置代理环境变量
+export HTTPS_PROXY="http://127.0.0.1:7891"
+export HTTP_PROXY="http://127.0.0.1:7891"
+
+# 或使用 Discord 专用代理变量
+export DISCORD_HTTP_PROXY="http://127.0.0.1:7891"
+
+# 运行你的 bot
+node dist/index.js
+```
+
+**方式二：代码配置**
+
+```typescript
+import { Client } from "carbon-proxy"
+
+const client = new Client({
+  clientId: "your-client-id",
+  publicKey: "your-public-key",
+  token: "your-bot-token",
+  baseUrl: "http://localhost:3000",
+  requestOptions: {
+    proxy: "http://127.0.0.1:7891"
+  }
+})
+
+client.startServer()
+```
+
+### 使用 SOCKS5 代理
+
+**环境变量方式：**
+
+```bash
+export ALL_PROXY="socks5://127.0.0.1:7892"
+node dist/index.js
+```
+
+**代码配置方式：**
+
+```typescript
+import { Client } from "carbon-proxy"
+
+const client = new Client({
+  clientId: "your-client-id",
+  publicKey: "your-public-key",
+  token: "your-bot-token",
+  baseUrl: "http://localhost:3000",
+  requestOptions: {
+    proxy: "socks5://127.0.0.1:7892"
+  }
+})
+
+client.startServer()
+```
+
+## 🔧 代理配置说明
+
+### 支持的代理格式
+
+- **HTTP 代理**: `http://host:port` 或 `http://user:pass@host:port`
+- **HTTPS 代理**: `https://host:port` 或 `https://user:pass@host:port`
+- **SOCKS 代理**: `socks://host:port`, `socks4://host:port`, `socks5://host:port`
+
+### 环境变量优先级
+
+按优先级从高到低：
+
+1. `DISCORD_HTTP_PROXY` - Discord 专用代理
+2. `HTTPS_PROXY` - HTTPS 请求代理
+3. `HTTP_PROXY` - HTTP 请求代理
+4. `ALL_PROXY` - 所有请求代理
+
+### 常用代理软件配置
+
+**Clash**
+```bash
+export HTTP_PROXY="http://127.0.0.1:7890"
+export HTTPS_PROXY="http://127.0.0.1:7890"
+```
+
+**V2Ray**
+```bash
+export HTTP_PROXY="http://127.0.0.1:10809"
+export HTTPS_PROXY="http://127.0.0.1:10809"
+```
+
+**Shadowsocks (需要 SOCKS5 支持)**
+```bash
+export ALL_PROXY="socks5://127.0.0.1:7891"
+```
+
+## 📖 完整示例
+
+```typescript
+import { Client, Intents } from "carbon-proxy"
+import { MyCommand } from "./commands/MyCommand"
+
+const client = new Client({
+  clientId: process.env.CLIENT_ID!,
+  publicKey: process.env.PUBLIC_KEY!,
+  token: process.env.TOKEN!,
+  baseUrl: "http://localhost:3000",
+  // 配置代理（可选，也可以用环境变量）
+  requestOptions: {
+    proxy: process.env.DISCORD_HTTP_PROXY
+  }
+})
+
+// 注册命令
+client.registerCommand(MyCommand)
+
+// 启动服务器
+client.startServer()
+```
+
+## 🧪 测试代理连接
+
+项目包含代理测试脚本，可以快速验证代理配置：
+
+```bash
+cd node_modules/carbon-proxy
+
+# 测试 HTTP 代理
+DISCORD_BOT_TOKEN="your_token" HTTPS_PROXY="http://127.0.0.1:7891" node test-proxy.mjs
+
+# 测试 SOCKS5 代理
+DISCORD_BOT_TOKEN="your_token" ALL_PROXY="socks5://127.0.0.1:7892" node test-proxy.mjs
+```
+
+## 🔍 故障排查
+
+### 代理连接失败
+
+1. **确认代理服务正在运行**
+   ```bash
+   curl -x http://127.0.0.1:7891 https://www.google.com
+   ```
+
+2. **检查代理格式**
+   - 确保使用正确的协议前缀：`http://`, `socks5://`
+   - 确保端口号正确
+
+3. **检查代理认证**
+   - 如果代理需要认证，使用格式：`http://username:password@host:port`
+
+### 请求超时
+
+- 增加请求超时时间（如果支持）
+- 检查代理服务器的网络连接
+- 尝试切换到不同的代理协议（HTTP → SOCKS5）
+
+## 📚 相关资源
+
+- [原版文档](https://carbon.buape.com/carbon)
+- [原版 Discord 社区](https://go.buape.com/carbon)
+- [Discord API 文档](https://discord.com/developers/docs/intro)
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 📄 许可证
+
+MIT License - 基于 [@buape/carbon](https://github.com/buape/carbon) 修改
+
+## 🙏 致谢
+
+感谢 [buape](https://github.com/buape) 开发了这么优秀的 Carbon 框架！
+
+---
+
+**注意**: 本版本是 fork 的增强版，主要用于需要代理的场景。如果你不需要代理功能，建议使用[原版](https://www.npmjs.com/package/@buape/carbon)。

package/dist/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "carbon-proxy",
+    "version": "0.14.0",
+    "type": "module",
+    "main": "./dist/src/index.js",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/stonev5/carbon.git"
+    },
+    "homepage": "https://github.com/stonev5/carbon#readme",
+    "exports": {
+        ".": {
+            "types": "./dist/src/index.d.ts",
+            "import": "./dist/src/index.js"
+        },
+        "./*": {
+            "types": "./dist/src/plugins/*/index.d.ts",
+            "import": "./dist/src/plugins/*/index.js"
+        },
+        "./adapters/*": {
+            "types": "./dist/src/adapters/*/index.d.ts",
+            "import": "./dist/src/adapters/*/index.js"
+        }
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc -w",
+        "docs": "typedoc"
+    },
+    "license": "MIT",
+    "dependencies": {
+        "@types/node": "^25.0.9",
+        "discord-api-types": "0.38.37",
+        "https-proxy-agent": "^7.0.5",
+        "socks-proxy-agent": "^8.0.0",
+        "undici": "^7.18.2",
+        "ws": "8.19.0"
+    },
+    "files": [
+        "dist",
+        "LICENSE"
+    ]
+}

package/dist/src/abstracts/AnySelectMenu.d.ts

@@ -0,0 +1,40 @@
+import type { APIChannelSelectComponent, APIMentionableSelectComponent, APIRoleSelectComponent, APISelectMenuComponent, APIStringSelectComponent, APIUserSelectComponent, ComponentType } from "discord-api-types/v10";
+import type { ComponentData } from "../types/index.js";
+import type { AnySelectMenuInteraction } from "./AnySelectMenuInteraction.js";
+import { BaseMessageInteractiveComponent } from "./BaseMessageInteractiveComponent.js";
+export type AnySelectMenuComponentType = ComponentType.ChannelSelect | ComponentType.RoleSelect | ComponentType.StringSelect | ComponentType.UserSelect | ComponentType.MentionableSelect;
+export declare abstract class AnySelectMenu extends BaseMessageInteractiveComponent {
+    abstract type: AnySelectMenuComponentType;
+    run(interaction: AnySelectMenuInteraction, data: ComponentData): unknown | Promise<unknown>;
+    minValues?: number;
+    maxValues?: number;
+    /**
+     * Not available in modals, will throw an error if used
+     */
+    disabled?: boolean;
+    placeholder?: string;
+    /**
+     * Defaults to true in modals, ignored in messages
+     */
+    required?: boolean;
+    serialize: () => APISelectMenuComponent;
+    abstract serializeOptions(): {
+        type: ComponentType.ChannelSelect;
+        channel_types: APIChannelSelectComponent["channel_types"];
+        default_values: APIChannelSelectComponent["default_values"];
+    } | {
+        type: ComponentType.StringSelect;
+        options: APIStringSelectComponent["options"];
+    } | {
+        type: ComponentType.RoleSelect;
+        default_values: APIRoleSelectComponent["default_values"];
+    } | {
+        type: ComponentType.UserSelect;
+        default_values: APIUserSelectComponent["default_values"];
+    } | {
+        type: ComponentType.MentionableSelect;
+        default_values: APIMentionableSelectComponent["default_values"];
+    };
+    serializeExtra(): Record<string, unknown>;
+}
+//# sourceMappingURL=AnySelectMenu.d.ts.map

package/dist/src/abstracts/AnySelectMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnySelectMenu.d.ts","sourceRoot":"","sources":["../../../src/abstracts/AnySelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AACtF,MAAM,MAAM,0BAA0B,GACnC,aAAa,CAAC,aAAa,GAC3B,aAAa,CAAC,UAAU,GACxB,aAAa,CAAC,YAAY,GAC1B,aAAa,CAAC,UAAU,GACxB,aAAa,CAAC,iBAAiB,CAAA;AAElC,8BAAsB,aAAc,SAAQ,+BAA+B;IAC1E,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAA;IACzC,GAAG,CACF,WAAW,EAAE,wBAAwB,EACrC,IAAI,EAAE,aAAa,GACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAO7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,SAAS,QAAO,sBAAsB,CAgBrC;IAED,QAAQ,CAAC,gBAAgB,IACtB;QACA,IAAI,EAAE,aAAa,CAAC,aAAa,CAAA;QACjC,aAAa,EAAE,yBAAyB,CAAC,eAAe,CAAC,CAAA;QACzD,cAAc,EAAE,yBAAyB,CAAC,gBAAgB,CAAC,CAAA;KAC1D,GACD;QACA,IAAI,EAAE,aAAa,CAAC,YAAY,CAAA;QAChC,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAA;KAC3C,GACD;QACA,IAAI,EAAE,aAAa,CAAC,UAAU,CAAA;QAC9B,cAAc,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAA;KACvD,GACD;QACA,IAAI,EAAE,aAAa,CAAC,UAAU,CAAA;QAC9B,cAAc,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAA;KACvD,GACD;QACA,IAAI,EAAE,aAAa,CAAC,iBAAiB,CAAA;QACrC,cAAc,EAAE,6BAA6B,CAAC,gBAAgB,CAAC,CAAA;KAC9D;IAEJ,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGzC"}

package/dist/src/abstracts/AnySelectMenu.js

@@ -0,0 +1,41 @@
+import { BaseMessageInteractiveComponent } from "./BaseMessageInteractiveComponent.js";
+export class AnySelectMenu extends BaseMessageInteractiveComponent {
+    run(interaction, data) {
+        // Random things to show the vars as used
+        typeof interaction === "string";
+        typeof data === "string";
+        return;
+    }
+    minValues;
+    maxValues;
+    /**
+     * Not available in modals, will throw an error if used
+     */
+    disabled;
+    placeholder;
+    /**
+     * Defaults to true in modals, ignored in messages
+     */
+    required;
+    serialize = () => {
+        const options = this.serializeOptions();
+        const extra = this.serializeExtra();
+        const data = {
+            ...options,
+            custom_id: this.customId,
+            placeholder: this.placeholder,
+            min_values: this.minValues,
+            max_values: this.maxValues,
+            required: this.required,
+            ...extra
+        };
+        if (this.disabled) {
+            data.disabled = true;
+        }
+        return data;
+    };
+    serializeExtra() {
+        return {};
+    }
+}
+//# sourceMappingURL=AnySelectMenu.js.map

package/dist/src/abstracts/AnySelectMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnySelectMenu.js","sourceRoot":"","sources":["../../../src/abstracts/AnySelectMenu.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AAQtF,MAAM,OAAgB,aAAc,SAAQ,+BAA+B;IAE1E,GAAG,CACF,WAAqC,EACrC,IAAmB;QAEnB,yCAAyC;QACzC,OAAO,WAAW,KAAK,QAAQ,CAAA;QAC/B,OAAO,IAAI,KAAK,QAAQ,CAAA;QACxB,OAAM;IACP,CAAC;IAED,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB;;OAEG;IACH,QAAQ,CAAU;IAClB,WAAW,CAAS;IACpB;;OAEG;IACH,QAAQ,CAAU;IAElB,SAAS,GAAG,GAA2B,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QACnC,MAAM,IAAI,GAA2B;YACpC,GAAG,OAAO;YACV,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,KAAK;SACR,CAAA;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACrB,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC,CAAA;IAyBD,cAAc;QACb,OAAO,EAAE,CAAA;IACV,CAAC;CACD"}

package/dist/src/abstracts/AnySelectMenuInteraction.d.ts

@@ -0,0 +1,12 @@
+import { type APIMessageComponentSelectMenuInteraction } from "discord-api-types/v10";
+import type { Client } from "../classes/Client.js";
+import { BaseComponentInteraction } from "./BaseComponentInteraction.js";
+import type { InteractionDefaults } from "./BaseInteraction.js";
+export declare abstract class AnySelectMenuInteraction extends BaseComponentInteraction {
+    constructor(client: Client, data: APIMessageComponentSelectMenuInteraction, defaults: InteractionDefaults);
+    /**
+     * The raw IDs of the selected options (either role/string/channel IDs or the IDs you provided in your options)
+     */
+    get values(): string[];
+}
+//# sourceMappingURL=AnySelectMenuInteraction.d.ts.map

package/dist/src/abstracts/AnySelectMenuInteraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnySelectMenuInteraction.d.ts","sourceRoot":"","sources":["../../../src/abstracts/AnySelectMenuInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,wCAAwC,EAG7C,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,8BAAsB,wBAAyB,SAAQ,wBAAwB;gBAE7E,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,wCAAwC,EAC9C,QAAQ,EAAE,mBAAmB;IAU9B;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;CACD"}

package/dist/src/abstracts/AnySelectMenuInteraction.js

@@ -0,0 +1,19 @@
+import { InteractionType } from "discord-api-types/v10";
+import { BaseComponentInteraction } from "./BaseComponentInteraction.js";
+export class AnySelectMenuInteraction extends BaseComponentInteraction {
+    constructor(client, data, defaults) {
+        super(client, data, defaults);
+        if (!data.data)
+            throw new Error("Invalid interaction data was used to create this class");
+        if (data.type !== InteractionType.MessageComponent) {
+            throw new Error("Invalid interaction type was used to create this class");
+        }
+    }
+    /**
+     * The raw IDs of the selected options (either role/string/channel IDs or the IDs you provided in your options)
+     */
+    get values() {
+        return this.rawData.data.values;
+    }
+}
+//# sourceMappingURL=AnySelectMenuInteraction.js.map

package/dist/src/abstracts/AnySelectMenuInteraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnySelectMenuInteraction.js","sourceRoot":"","sources":["../../../src/abstracts/AnySelectMenuInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,eAAe,EACf,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAGxE,MAAM,OAAgB,wBAAyB,SAAQ,wBAAwB;IAC9E,YACC,MAAc,EACd,IAA8C,EAC9C,QAA6B;QAE7B,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI;YACb,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAC1E,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,gBAAgB,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAC1E,CAAC;IACF,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACT,OAAQ,IAAI,CAAC,OAAO,CAAC,IAA4C,CAAC,MAAM,CAAA;IACzE,CAAC;CACD"}

package/dist/src/abstracts/Base.d.ts

@@ -0,0 +1,10 @@
+import type { Client } from "../classes/Client.js";
+/**
+ * The base class that all classes extend from
+ * @hidden
+ */
+export declare class Base {
+    client: Client;
+    constructor(client: Client);
+}
+//# sourceMappingURL=Base.d.ts.map

package/dist/src/abstracts/Base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../../src/abstracts/Base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;GAGG;AACH,qBAAa,IAAI;IAChB,MAAM,EAAE,MAAM,CAAA;gBACF,MAAM,EAAE,MAAM;CAG1B"}

package/dist/src/abstracts/Base.js

@@ -0,0 +1,11 @@
+/**
+ * The base class that all classes extend from
+ * @hidden
+ */
+export class Base {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+}
+//# sourceMappingURL=Base.js.map

package/dist/src/abstracts/Base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Base.js","sourceRoot":"","sources":["../../../src/abstracts/Base.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,IAAI;IAChB,MAAM,CAAQ;IACd,YAAY,MAAc;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACrB,CAAC;CACD"}

package/dist/src/abstracts/BaseChannel.d.ts

@@ -0,0 +1,60 @@
+import { type APIChannel, type ChannelFlags, type ChannelType } from "discord-api-types/v10";
+import type { Client } from "../classes/Client.js";
+import type { IfPartial } from "../types/index.js";
+import { Base } from "./Base.js";
+export declare abstract class BaseChannel<Type extends ChannelType, IsPartial extends boolean = false> extends Base {
+    constructor(client: Client, rawDataOrId: IsPartial extends true ? string : Extract<APIChannel, {
+        type: Type;
+    }>);
+    /**
+     * The raw data of the channel.
+     */
+    protected _rawData: Extract<APIChannel, {
+        type: Type;
+    }> | null;
+    protected setData(data: Extract<APIChannel, {
+        type: Type;
+    }>): void;
+    protected setField(field: keyof Extract<APIChannel, {
+        type: Type;
+    }>, value: unknown): void;
+    /**
+     * The raw Discord API data for this channel
+     */
+    get rawData(): Readonly<Extract<APIChannel, {
+        type: Type;
+    }>>;
+    /**
+     * The id of the channel.
+     */
+    readonly id: string;
+    /**
+     * Whether the channel is a partial channel (meaning it does not have all the data).
+     * If this is true, you should use {@link BaseChannel.fetch} to get the full data of the channel.
+     */
+    get partial(): IsPartial;
+    /**
+     * The type of the channel.
+     */
+    get type(): IfPartial<IsPartial, Type>;
+    /**
+     * The flags of the channel in a bitfield.
+     * @see https://discord.com/developers/docs/resources/channel#channel-object-channel-flags
+     */
+    get flags(): IfPartial<IsPartial, ChannelFlags | undefined>;
+    /**
+     * Fetches the channel from the API.
+     * @returns A Promise that resolves to a non-partial channel
+     */
+    fetch(): Promise<BaseChannel<Type, false>>;
+    /**
+     * Delete the channel
+     */
+    delete(): Promise<void>;
+    /**
+     * Returns the Discord mention format for this channel
+     * @returns The mention string in the format <#channelId>
+     */
+    toString(): string;
+}
+//# sourceMappingURL=BaseChannel.d.ts.map

package/dist/src/abstracts/BaseChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseChannel.d.ts","sourceRoot":"","sources":["../../../src/abstracts/BaseChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,8BAAsB,WAAW,CAChC,IAAI,SAAS,WAAW,EACxB,SAAS,SAAS,OAAO,GAAG,KAAK,CAChC,SAAQ,IAAI;gBAEZ,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,SAAS,SAAS,IAAI,GAChC,MAAM,GACN,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IAYvC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,GAAG,IAAI,CAAO;IACrE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IAI3D,SAAS,CAAC,QAAQ,CACjB,KAAK,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,EAChD,KAAK,EAAE,OAAO;IAOf;;OAEG;IACH,IAAI,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAM3D;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,IAAI,OAAO,IAAI,SAAS,CAEvB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAGrC;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,SAAS,CAAC,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC,CAG1D;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAWhD;;OAEG;IACG,MAAM;IAIZ;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAGlB"}

package/dist/src/abstracts/BaseChannel.js

@@ -0,0 +1,90 @@
+import { Routes } from "discord-api-types/v10";
+import { Base } from "./Base.js";
+export class BaseChannel extends Base {
+    constructor(client, rawDataOrId) {
+        super(client);
+        if (typeof rawDataOrId === "string") {
+            this.id = rawDataOrId;
+        }
+        else {
+            this._rawData = rawDataOrId;
+            this.id = rawDataOrId.id;
+            this.setData(rawDataOrId);
+        }
+    }
+    /**
+     * The raw data of the channel.
+     */
+    _rawData = null;
+    setData(data) {
+        if (!data)
+            throw new Error("Cannot set data without having data... smh");
+        this._rawData = data;
+    }
+    setField(field, value) {
+        if (!this._rawData)
+            throw new Error("Cannot set field without having data... smh");
+        this._rawData[field] = value;
+    }
+    /**
+     * The raw Discord API data for this channel
+     */
+    get rawData() {
+        if (!this._rawData)
+            throw new Error("Cannot access rawData on partial Channel. Use fetch() to populate data.");
+        return this._rawData;
+    }
+    /**
+     * The id of the channel.
+     */
+    id;
+    /**
+     * Whether the channel is a partial channel (meaning it does not have all the data).
+     * If this is true, you should use {@link BaseChannel.fetch} to get the full data of the channel.
+     */
+    get partial() {
+        return (this._rawData === null);
+    }
+    /**
+     * The type of the channel.
+     */
+    get type() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.type;
+    }
+    /**
+     * The flags of the channel in a bitfield.
+     * @see https://discord.com/developers/docs/resources/channel#channel-object-channel-flags
+     */
+    get flags() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.flags;
+    }
+    /**
+     * Fetches the channel from the API.
+     * @returns A Promise that resolves to a non-partial channel
+     */
+    async fetch() {
+        const newData = (await this.client.rest.get(Routes.channel(this.id)));
+        if (!newData)
+            throw new Error(`Channel ${this.id} not found`);
+        this.setData(newData);
+        return this;
+    }
+    /**
+     * Delete the channel
+     */
+    async delete() {
+        await this.client.rest.delete(Routes.channel(this.id));
+    }
+    /**
+     * Returns the Discord mention format for this channel
+     * @returns The mention string in the format <#channelId>
+     */
+    toString() {
+        return `<#${this.id}>`;
+    }
+}
+//# sourceMappingURL=BaseChannel.js.map

package/dist/src/abstracts/BaseChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseChannel.js","sourceRoot":"","sources":["../../../src/abstracts/BaseChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,MAAM,EACN,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,OAAgB,WAGpB,SAAQ,IAAI;IACb,YACC,MAAc,EACd,WAEsC;QAEtC,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,GAAG,WAAW,CAAA;QACtB,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,QAAQ,GAAG,WAAoB,CAAA;YACpC,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,EAAE,CAAA;YACxB,IAAI,CAAC,OAAO,CAAC,WAAoB,CAAC,CAAA;QACnC,CAAC;IACF,CAAC;IAED;;OAEG;IACO,QAAQ,GAA+C,IAAI,CAAA;IAC3D,OAAO,CAAC,IAAyC;QAC1D,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QACxE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;IACrB,CAAC;IACS,QAAQ,CACjB,KAAgD,EAChD,KAAc;QAEd,IAAI,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAC/D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,IAAI,KAAK,CACd,yEAAyE,CACzE,CAAA;QACF,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC;IAED;;OAEG;IACM,EAAE,CAAQ;IAEnB;;;OAGG;IACH,IAAI,OAAO;QACV,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAU,CAAA;IACzC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACR,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACV,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAC1C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CACvB,CAAwC,CAAA;QACzC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,YAAY,CAAC,CAAA;QAE7D,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAErB,OAAO,IAAgC,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACX,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IACvD,CAAC;IAED;;;OAGG;IACH,QAAQ;QACP,OAAO,KAAK,IAAI,CAAC,EAAE,GAAG,CAAA;IACvB,CAAC;CACD"}