README
- ::newAPI::new
T
AuthMode
- ::create_messageChannelsAPI::create_message
- ::create_reactionChannelsAPI::create_reaction
- ::delete_messageChannelsAPI::delete_message
- ::delete_own_reactionChannelsAPI::delete_own_reaction
- ::edit_messageChannelsAPI::edit_message
- ::getChannelsAPI::get
- ::get_messageChannelsAPI::get_message
- ::get_messagesChannelsAPI::get_messages
- ::newChannelsAPI::new
- ::trigger_typing_indicatorChannelsAPI::trigger_typing_indicator
T
FetchResponse
- ::create_channelGuildsAPI::create_channel
- ::create_roleGuildsAPI::create_role
- ::deleteGuildsAPI::delete
- ::delete_roleGuildsAPI::delete_role
- ::editGuildsAPI::edit
- ::edit_roleGuildsAPI::edit_role
- ::getGuildsAPI::get
- ::get_channelsGuildsAPI::get_channels
- ::get_memberGuildsAPI::get_member
- ::get_membersGuildsAPI::get_members
- ::get_rolesGuildsAPI::get_roles
- ::newGuildsAPI::new
- ::delete_followup_messageInteractionsAPI::delete_followup_message
- ::delete_replyInteractionsAPI::delete_reply
- ::edit_followup_messageInteractionsAPI::edit_followup_message
- ::edit_replyInteractionsAPI::edit_reply
- ::follow_upInteractionsAPI::follow_up
- ::get_followup_messageInteractionsAPI::get_followup_message
- ::get_original_responseInteractionsAPI::get_original_response
- ::newInteractionsAPI::new
- ::replyInteractionsAPI::reply
T
PreparedRequest
T
RequestMethod
T
RequestOptions
- ::deleteRestClient::delete
- ::getRestClient::get
- ::newRestClient::new
- ::patchRestClient::patch
- ::postRestClient::post
- ::prepare_requestRestClient::prepare_request
- ::putRestClient::put
- ::requestRestClient::request
- ::with_tokenRestClient::with_token
T
RestError
T
RestOptions
- ::create_dmUsersAPI::create_dm
- ::editUsersAPI::edit
- ::getUsersAPI::get
- ::get_currentUsersAPI::get_current
- ::get_guildsUsersAPI::get_guilds
- ::newUsersAPI::new
- ::get_guild_voice_regionsVoiceAPI::get_guild_voice_regions
- ::get_voice_stateVoiceAPI::get_voice_state
- ::list_voice_regionsVoiceAPI::list_voice_regions
- ::modify_current_user_voice_stateVoiceAPI::modify_current_user_voice_state
- ::modify_user_voice_stateVoiceAPI::modify_user_voice_state
- ::newVoiceAPI::new
- ::delete_messageWebhooksAPI::delete_message
- ::edit_messageWebhooksAPI::edit_message
- ::executeWebhooksAPI::execute
- ::get_messageWebhooksAPI::get_message
- ::newWebhooksAPI::new
V
api_base
V
api_version
V
auth_mode_token
V
cdn_base
V
default_rest_headers
V
default_rest_options
V
default_timeout_ms
V
default_user_agent
V
encode_query
V
new_api
V
new_rest_client
V
request_method_get
V
request_options
V
rest_options
V
route_channel
V
route_channel_message
V
route_channel_message_own_reaction
V
route_channel_messages
V
route_channel_typing
V
route_guild
V
route_guild_channels
V
route_guild_member
V
route_guild_members
V
route_guild_regions
V
route_guild_role
V
route_guild_roles
V
route_guild_voice_state
V
route_interaction_callback
V
route_user
V
route_user_channels
V
route_user_guilds
V
route_voice_regions
V
route_webhook
V
route_webhook_message

discord

Discord REST API client for Cloudflare-style bots written in MoonBit

Download zip

Author

mizchi

Version

0.1.2

License

Apache-2.0

Repository

github.com/mizchi/discord.mbt

Last updated

6 months ago

Downloads

#discord

MoonBit implementation of the mizchi/discord-cf REST/API layer.

#Features

Discord API v10 REST client
API modules: channels, users, guilds, webhooks, interactions, voice
Configurable auth mode (Bot token, explicit token, no auth)
JS target fetch backend
mizchi/cloudflare integration (mizchi/discord/cfw)

#Quick Start

///|
test {
  let rest = new_rest_client(token="DISCORD_BOT_TOKEN")
  let api = new_api(rest)

  // Prepare and inspect request details before calling API
  let prepared = rest.prepare_request(
    request_method_get(),
    route_channel_messages("1234567890"),
    request_options(query=[("limit", "10")]),
  )

  inspect(
    prepared.url,
    content="https://discord.com/api/v10/channels/1234567890/messages?limit=10",
  )

  // API modules are available from new_api(rest)
  inspect(api.users.rest.options.timeout_ms, content="15000")
}

#Commands

just check
just test
just info

#Cloudflare Worker Integration

src/cfw exports get_discord_handler.

moon build src/cfw --target js
npx wrangler dev --config fixtures/wrangler.jsonc

Handler routes:

GET /health
GET /discord/send?channel_id=...&content=...
- if channel_id is omitted, DISCORD_CHANNEL_ID is used

Required environment variables:

DISCORD_TOKEN (required)
DISCORD_CHANNEL_ID (optional)

fixtures/cf-worker.js loads target/js/release/build/cfw/cfw.js and wires get_discord_handler() to Worker fetch.

API

source

pub struct API {
  channels : ChannelsAPI
  interactions : InteractionsAPI
  webhooks : WebhooksAPI
  users : UsersAPI
  guilds : GuildsAPI
  voice : VoiceAPI
}

API::new

source

fn API::new(rest : RestClient) -> API

AuthMode

source

pub enum AuthMode {
  UseClientToken
  UseToken(String)
  SkipAuth
} derive(Eq, Show)

ChannelsAPI

source

pub struct ChannelsAPI {
  rest : RestClient
}

ChannelsAPI::create_message

source

async fn ChannelsAPI::create_message(self : ChannelsAPI, channel_id : String, body : Json, auth_mode? : AuthMode) -> Result[Json, RestError]

ChannelsAPI::create_reaction

source

async fn ChannelsAPI::create_reaction(self : ChannelsAPI, channel_id : String, message_id : String, emoji : String) -> Result[Json, RestError]

ChannelsAPI::delete_message

source

async fn ChannelsAPI::delete_message(self : ChannelsAPI, channel_id : String, message_id : String) -> Result[Json, RestError]

ChannelsAPI::delete_own_reaction

source

async fn ChannelsAPI::delete_own_reaction(self : ChannelsAPI, channel_id : String, message_id : String, emoji : String) -> Result[Json, RestError]

ChannelsAPI::edit_message

source

async fn ChannelsAPI::edit_message(self : ChannelsAPI, channel_id : String, message_id : String, body : Json, auth_mode? : AuthMode) -> Result[Json, RestError]

ChannelsAPI::get

source

async fn ChannelsAPI::get(self : ChannelsAPI, channel_id : String) -> Result[Json, RestError]

ChannelsAPI::get_message

source

async fn ChannelsAPI::get_message(self : ChannelsAPI, channel_id : String, message_id : String) -> Result[Json, RestError]

ChannelsAPI::get_messages

source

async fn ChannelsAPI::get_messages(self : ChannelsAPI, channel_id : String, query? : Array[(String, String)]) -> Result[Json, RestError]

ChannelsAPI::new

source

fn ChannelsAPI::new(rest : RestClient) -> ChannelsAPI

ChannelsAPI::trigger_typing_indicator

source

async fn ChannelsAPI::trigger_typing_indicator(self : ChannelsAPI, channel_id : String) -> Result[Json, RestError]

FetchResponse

source

pub(all) struct FetchResponse {
  ok : Bool
  status : Int
  content_type : String?
  body : String
}

GuildsAPI

source

pub struct GuildsAPI {
  rest : RestClient
}

GuildsAPI::create_channel

source

async fn GuildsAPI::create_channel(self : GuildsAPI, guild_id : String, body : Json) -> Result[Json, RestError]

GuildsAPI::create_role

source

async fn GuildsAPI::create_role(self : GuildsAPI, guild_id : String, body : Json) -> Result[Json, RestError]

GuildsAPI::delete

source

async fn GuildsAPI::delete(self : GuildsAPI, guild_id : String) -> Result[Json, RestError]

GuildsAPI::delete_role

source

async fn GuildsAPI::delete_role(self : GuildsAPI, guild_id : String, role_id : String) -> Result[Json, RestError]

GuildsAPI::edit

source

async fn GuildsAPI::edit(self : GuildsAPI, guild_id : String, body : Json) -> Result[Json, RestError]

GuildsAPI::edit_role

source

async fn GuildsAPI::edit_role(self : GuildsAPI, guild_id : String, role_id : String, body : Json) -> Result[Json, RestError]

GuildsAPI::get

source

async fn GuildsAPI::get(self : GuildsAPI, guild_id : String) -> Result[Json, RestError]

GuildsAPI::get_channels

source

async fn GuildsAPI::get_channels(self : GuildsAPI, guild_id : String) -> Result[Json, RestError]

GuildsAPI::get_member

source

async fn GuildsAPI::get_member(self : GuildsAPI, guild_id : String, user_id : String) -> Result[Json, RestError]

GuildsAPI::get_members

source

async fn GuildsAPI::get_members(self : GuildsAPI, guild_id : String, query? : Array[(String, String)]) -> Result[Json, RestError]

GuildsAPI::get_roles

source

async fn GuildsAPI::get_roles(self : GuildsAPI, guild_id : String) -> Result[Json, RestError]

GuildsAPI::new

source

fn GuildsAPI::new(rest : RestClient) -> GuildsAPI

InteractionsAPI

source

pub struct InteractionsAPI {
  rest : RestClient
}

InteractionsAPI::delete_followup_message

source

async fn InteractionsAPI::delete_followup_message(self : InteractionsAPI, application_id : String, interaction_token : String, message_id : String) -> Result[Json, RestError]

InteractionsAPI::delete_reply

source

async fn InteractionsAPI::delete_reply(self : InteractionsAPI, application_id : String, interaction_token : String) -> Result[Json, RestError]

InteractionsAPI::edit_followup_message

source

async fn InteractionsAPI::edit_followup_message(self : InteractionsAPI, application_id : String, interaction_token : String, message_id : String, body : Json) -> Result[Json, RestError]

InteractionsAPI::edit_reply

source

async fn InteractionsAPI::edit_reply(self : InteractionsAPI, application_id : String, interaction_token : String, body : Json) -> Result[Json, RestError]

InteractionsAPI::follow_up

source

async fn InteractionsAPI::follow_up(self : InteractionsAPI, application_id : String, interaction_token : String, body : Json) -> Result[Json, RestError]

InteractionsAPI::get_followup_message

source

async fn InteractionsAPI::get_followup_message(self : InteractionsAPI, application_id : String, interaction_token : String, message_id : String) -> Result[Json, RestError]

InteractionsAPI::get_original_response

source

async fn InteractionsAPI::get_original_response(self : InteractionsAPI, application_id : String, interaction_token : String) -> Result[Json, RestError]

InteractionsAPI::new

source

fn InteractionsAPI::new(rest : RestClient) -> InteractionsAPI

InteractionsAPI::reply

source

async fn InteractionsAPI::reply(self : InteractionsAPI, interaction_id : String, interaction_token : String, body : Json, auth_mode? : AuthMode) -> Result[Json, RestError]

PreparedRequest

source

pub(all) struct PreparedRequest {
  meth : RequestMethod
  url : String
  headers : Map[String, String]
  body : String?
}

RequestMethod

source

pub enum RequestMethod {
  MethodGet
  MethodPost
  MethodPut
  MethodPatch
  MethodDelete
} derive(Eq, Show)

RequestOptions

source

pub struct RequestOptions {
  auth_mode : AuthMode
  body : Json?
  query : Array[(String, String)]
  headers : Map[String, String]
}

RestClient

source

pub struct RestClient {
  options : RestOptions
  token : String?
}

RestClient::delete

source

async fn RestClient::delete(self : RestClient, route : String, options? : RequestOptions) -> Result[Json, RestError]

RestClient::get

source

async fn RestClient::get(self : RestClient, route : String, options? : RequestOptions) -> Result[Json, RestError]

RestClient::new

source

fn RestClient::new(options? : RestOptions) -> RestClient

RestClient::patch

source

async fn RestClient::patch(self : RestClient, route : String, options? : RequestOptions) -> Result[Json, RestError]

RestClient::post

source

async fn RestClient::post(self : RestClient, route : String, options? : RequestOptions) -> Result[Json, RestError]

RestClient::prepare_request

source

fn RestClient::prepare_request(self : RestClient, meth : RequestMethod, route : String, options : RequestOptions) -> PreparedRequest

RestClient::put

source

async fn RestClient::put(self : RestClient, route : String, options? : RequestOptions) -> Result[Json, RestError]

RestClient::request

source

async fn RestClient::request(self : RestClient, meth : RequestMethod, route : String, options : RequestOptions) -> Result[Json, RestError]

RestClient::with_token

source

fn RestClient::with_token(self : RestClient, token : String) -> RestClient

RestError

source

pub enum RestError {
  Network(String)
  ApiError(Int, String)
  DecodeError(String)
} derive(Eq, Show)

RestOptions

source

pub struct RestOptions {
  api : String
  headers : Map[String, String]
  timeout_ms : Int
}

UsersAPI

source

pub struct UsersAPI {
  rest : RestClient
}

UsersAPI::create_dm

source

async fn UsersAPI::create_dm(self : UsersAPI, body : Json) -> Result[Json, RestError]

UsersAPI::edit

source

async fn UsersAPI::edit(self : UsersAPI, body : Json) -> Result[Json, RestError]

UsersAPI::get

source

async fn UsersAPI::get(self : UsersAPI, user_id : String) -> Result[Json, RestError]

UsersAPI::get_current

source

async fn UsersAPI::get_current(self : UsersAPI) -> Result[Json, RestError]

UsersAPI::get_guilds

source

async fn UsersAPI::get_guilds(self : UsersAPI, query? : Array[(String, String)]) -> Result[Json, RestError]

UsersAPI::new

source

fn UsersAPI::new(rest : RestClient) -> UsersAPI

VoiceAPI

source

pub struct VoiceAPI {
  rest : RestClient
}

VoiceAPI::get_guild_voice_regions

source

async fn VoiceAPI::get_guild_voice_regions(self : VoiceAPI, guild_id : String) -> Result[Json, RestError]

VoiceAPI::get_voice_state

source

async fn VoiceAPI::get_voice_state(self : VoiceAPI, guild_id : String, user_id : String) -> Result[Json, RestError]

VoiceAPI::list_voice_regions

source

async fn VoiceAPI::list_voice_regions(self : VoiceAPI) -> Result[Json, RestError]

VoiceAPI::modify_current_user_voice_state

source

async fn VoiceAPI::modify_current_user_voice_state(self : VoiceAPI, guild_id : String, channel_id : String, options? : Json) -> Result[Json, RestError]

VoiceAPI::modify_user_voice_state

source

async fn VoiceAPI::modify_user_voice_state(self : VoiceAPI, guild_id : String, user_id : String, channel_id : String, options? : Json) -> Result[Json, RestError]

VoiceAPI::new

source

fn VoiceAPI::new(rest : RestClient) -> VoiceAPI

WebhooksAPI

source

pub struct WebhooksAPI {
  rest : RestClient
}

WebhooksAPI::delete_message

source

async fn WebhooksAPI::delete_message(self : WebhooksAPI, id : String, token : String, message_id : String, thread_id? : String) -> Result[Json, RestError]

WebhooksAPI::edit_message

source

async fn WebhooksAPI::edit_message(self : WebhooksAPI, id : String, token : String, message_id : String, body : Json) -> Result[Json, RestError]

WebhooksAPI::execute

source

async fn WebhooksAPI::execute(self : WebhooksAPI, id : String, token : String, body : Json, wait? : Bool, thread_id? : String) -> Result[Json, RestError]

WebhooksAPI::get_message

source

async fn WebhooksAPI::get_message(self : WebhooksAPI, id : String, token : String, message_id : String, thread_id? : String) -> Result[Json, RestError]

WebhooksAPI::new

source

fn WebhooksAPI::new(rest : RestClient) -> WebhooksAPI

api_base

source

let api_base : String

api_version

source

let api_version : String

auth_mode_token

source

fn auth_mode_token(token : String) -> AuthMode

cdn_base

source

let cdn_base : String

default_rest_headers

source

fn default_rest_headers() -> Map[String, String]

default_rest_options

source

fn default_rest_options() -> RestOptions

default_timeout_ms

source

let default_timeout_ms : Int

default_user_agent

source

let default_user_agent : String

encode_query

source

fn encode_query(params : Array[(String, String)]) -> String

new_api

source

fn new_api(rest : RestClient) -> API

Create grouped API modules backed by a REST client.

new_rest_client

source

fn new_rest_client(token? : String, api? : String, timeout_ms? : Int) -> RestClient

Create a REST client configured for Discord API.

request_method_get

source

fn request_method_get() -> RequestMethod

request_options

source

fn request_options(auth_mode? : AuthMode, body? : Json, query? : Array[(String, String)], headers? : Map[String, String]) -> RequestOptions

rest_options

source

fn rest_options(api? : String, headers? : Map[String, String], timeout_ms? : Int) -> RestOptions

route_channel

source

fn route_channel(channel_id : String) -> String

route_channel_message

source

fn route_channel_message(channel_id : String, message_id : String) -> String

route_channel_message_own_reaction

source

fn route_channel_message_own_reaction(channel_id : String, message_id : String, emoji : String) -> String

route_channel_messages

source

fn route_channel_messages(channel_id : String) -> String

route_channel_typing

source

fn route_channel_typing(channel_id : String) -> String

route_guild

source

fn route_guild(guild_id : String) -> String

route_guild_channels

source

fn route_guild_channels(guild_id : String) -> String

route_guild_member

source

fn route_guild_member(guild_id : String, user_id : String) -> String

route_guild_members

source

fn route_guild_members(guild_id : String) -> String

route_guild_regions

source

fn route_guild_regions(guild_id : String) -> String

route_guild_role

source

fn route_guild_role(guild_id : String, role_id : String) -> String

route_guild_roles

source

fn route_guild_roles(guild_id : String) -> String

route_guild_voice_state

source

fn route_guild_voice_state(guild_id : String, user_id : String) -> String

route_interaction_callback

source

fn route_interaction_callback(interaction_id : String, interaction_token : String) -> String

route_user

source

fn route_user(user_id : String) -> String

route_user_channels

source

fn route_user_channels() -> String

route_user_guilds

source

fn route_user_guilds() -> String

route_voice_regions

source

fn route_voice_regions() -> String

route_webhook

source

fn route_webhook(id : String, token : String) -> String

route_webhook_message

source

fn route_webhook_message(id : String, token : String, message_id : String) -> String

Source Files

Site source Report issue Packages Build queue Skills Statistics

discord

#discord

#Features

#Quick Start

#Commands

#Cloudflare Worker Integration

#API

#API::new

#AuthMode

#ChannelsAPI

#ChannelsAPI::create_message

#ChannelsAPI::create_reaction

#ChannelsAPI::delete_message

#ChannelsAPI::delete_own_reaction

#ChannelsAPI::edit_message

#ChannelsAPI::get

#ChannelsAPI::get_message

#ChannelsAPI::get_messages

#ChannelsAPI::new

#ChannelsAPI::trigger_typing_indicator

#FetchResponse

#GuildsAPI

#GuildsAPI::create_channel

#GuildsAPI::create_role

#GuildsAPI::delete

#GuildsAPI::delete_role

#GuildsAPI::edit

#GuildsAPI::edit_role

#GuildsAPI::get

#GuildsAPI::get_channels

#GuildsAPI::get_member

#GuildsAPI::get_members

#GuildsAPI::get_roles

#GuildsAPI::new

#InteractionsAPI

#InteractionsAPI::delete_followup_message

#InteractionsAPI::delete_reply

#InteractionsAPI::edit_followup_message

#InteractionsAPI::edit_reply

#InteractionsAPI::follow_up

#InteractionsAPI::get_followup_message

#InteractionsAPI::get_original_response

#InteractionsAPI::new

#InteractionsAPI::reply

#PreparedRequest

#RequestMethod

#RequestOptions

#RestClient

#RestClient::delete

#RestClient::get

#RestClient::new

#RestClient::patch

#RestClient::post

#RestClient::prepare_request

#RestClient::put

#RestClient::request

#RestClient::with_token

#RestError

#RestOptions

#UsersAPI

#UsersAPI::create_dm

#UsersAPI::edit

#UsersAPI::get

#UsersAPI::get_current

#UsersAPI::get_guilds

#UsersAPI::new

#VoiceAPI

#VoiceAPI::get_guild_voice_regions

#VoiceAPI::get_voice_state

#VoiceAPI::list_voice_regions

#VoiceAPI::modify_current_user_voice_state

#VoiceAPI::modify_user_voice_state

#VoiceAPI::new

#WebhooksAPI

#WebhooksAPI::delete_message

#WebhooksAPI::edit_message

#WebhooksAPI::execute

#WebhooksAPI::get_message

#WebhooksAPI::new

#api_base

API

API::new

AuthMode

ChannelsAPI

ChannelsAPI::create_message

ChannelsAPI::create_reaction

ChannelsAPI::delete_message

ChannelsAPI::delete_own_reaction

ChannelsAPI::edit_message

ChannelsAPI::get

ChannelsAPI::get_message

ChannelsAPI::get_messages

ChannelsAPI::new

ChannelsAPI::trigger_typing_indicator

FetchResponse

GuildsAPI

GuildsAPI::create_channel

GuildsAPI::create_role

GuildsAPI::delete

GuildsAPI::delete_role

GuildsAPI::edit

GuildsAPI::edit_role

GuildsAPI::get

GuildsAPI::get_channels

GuildsAPI::get_member

GuildsAPI::get_members

GuildsAPI::get_roles

GuildsAPI::new

InteractionsAPI

InteractionsAPI::delete_followup_message

InteractionsAPI::delete_reply

InteractionsAPI::edit_followup_message

InteractionsAPI::edit_reply

InteractionsAPI::follow_up

InteractionsAPI::get_followup_message

InteractionsAPI::get_original_response

InteractionsAPI::new

InteractionsAPI::reply

PreparedRequest

RequestMethod

RequestOptions

RestClient

RestClient::delete

RestClient::get

RestClient::new

RestClient::patch

RestClient::post

RestClient::prepare_request

RestClient::put

RestClient::request

RestClient::with_token

RestError

RestOptions

UsersAPI

UsersAPI::create_dm

UsersAPI::edit

UsersAPI::get

UsersAPI::get_current

UsersAPI::get_guilds

UsersAPI::new

VoiceAPI

VoiceAPI::get_guild_voice_regions

VoiceAPI::get_voice_state

VoiceAPI::list_voice_regions

VoiceAPI::modify_current_user_voice_state

VoiceAPI::modify_user_voice_state

VoiceAPI::new

WebhooksAPI

WebhooksAPI::delete_message

WebhooksAPI::edit_message

WebhooksAPI::execute

WebhooksAPI::get_message

WebhooksAPI::new

api_base

api_version

auth_mode_token

cdn_base

default_rest_headers

default_rest_options

default_timeout_ms