#discord.mbt

Status: experimental, pre-1.0. APIs may change between releases.

#Prerequisites

#Install

moon update
moon add gaato/discord

#Quickstart

///|
struct QuickstartEchoArgs {
  text : String
  times : Int
}

///|
async fn run_echo_bot(token : String) -> Unit {
  let args : @discord.Args[QuickstartEchoArgs] = @discord.Args::map2(
    @discord.arg_string(name="text", description="What to echo"),
    @discord.arg_int(
      name="times",
      description="How many times (1-5)",
      min=1,
      max=5,
    ).with_default(1L),
    (text, times) => { text, times: times.to_int(), },
  )
  let echo = @discord.slash(
    name="echo",
    description="Echo your text back",
    args~,
    handler=Immediate((_ctx, value) => {
      @discord.CommandReply::message(
        content=Array::make(value.times, value.text).join("\n"),
      )
    }),
  )
  let app = @discord.App()
  app.command(echo)
  let bot = @discord.Bot(app, token~)
  bot.on(@discord.Events::ready(), (_ctx, ready) => {
    println("ready as \{ready.user.username}")
  })
  bot.run()
}

#Packages

#Examples

• slash_echo: minimal typed Gateway bot.
• kitchen_sink: subcommands, autocomplete, context menus, components, and modals.
• ping_gateway: low-level Gateway and REST use.
• low_level: manual Framework and Shard wiring.
• workers_echo: Cloudflare Workers adapter.
• interactions_http: native signed-interactions HTTP server.
• plugin_demo: a stateful feedback feature installed as a separate package.
• voice_player: join a voice channel and play an Ogg/Opus file.
• voice_recorder: record a user's voice to an Ogg/Opus file.

#App core and executors

• Bot(app, token~) connects to the gateway and routes InteractionCreate events through the App.
• app.serve(group, token~) creates an InteractionEndpoint for an HTTP adapter.

#Gateway executor

bot.on(@discord.Events::message_create(), (ctx, event) => {
  let message = event.message
  println("\{message.author.username}: \{message.content}")
})

///|
let bot = @discord.Bot(app, token~, shards=Auto)

#Voice (experimental)

#Synchronization and failures

#HTTP interactions (experimental)

///|
async fn handle_http_interaction(
  app : @discord.App,
  group : @async.TaskGroup[Unit],
  token : String,
  body : Json,
) -> Json? {
  app.serve(group, token~).handle(body)
}

#Typed models

let id : @model.MessageId = @model.Id::parse("175928847299117063")
println(id.timestamp_ms()) // 1462015105796

#REST without the gateway

let client = @dhttp.Client(token)
let message = client.create_message(channel_id, content="hello")
client.create_message(channel_id, content="with reply", reply_to=message.id)
|> ignore

client.guild_ref(guild_id).emoji_ref(emoji_id).edit(name="renamed") |> ignore

• an opt-in, gateway-driven in-memory cache — events and intents;
• pure helpers for permissions, mentions, timestamps, and CDN URLs — models and utilities;
• structured REST, gateway, and dispatch telemetry — middleware;
• a feature-installer convention for structuring larger bots — structuring bots;
• the interaction router, response gates, and no-network handler testing under App — the framework layer.

#Development

moon check --target native --deny-warn
moon check --target js --deny-warn
moon test --target native --release   # debug native builds need a working tcc setup
moon test --target js --release
moon fmt
moon -C template fmt --check
moon -C tools/package_graph fmt --check
moon info --target native             # regenerate pkg.generated.mbti (API review signal)

moon ide doc "@discord"
moon ide doc "@http.Client::create_message"
moon ide doc "@model.Message"
moon ide doc "@util.channel_permissions"

#License

#discord.mbt

Status: experimental, pre-1.0. APIs may change between releases.

#Prerequisites

#Install

moon update
moon add gaato/discord

#Quickstart

///|
struct QuickstartEchoArgs {
  text : String
  times : Int
}

///|
async fn run_echo_bot(token : String) -> Unit {
  let args : @discord.Args[QuickstartEchoArgs] = @discord.Args::map2(
    @discord.arg_string(name="text", description="What to echo"),
    @discord.arg_int(
      name="times",
      description="How many times (1-5)",
      min=1,
      max=5,
    ).with_default(1L),
    (text, times) => { text, times: times.to_int(), },
  )
  let echo = @discord.slash(
    name="echo",
    description="Echo your text back",
    args~,
    handler=Immediate((_ctx, value) => {
      @discord.CommandReply::message(
        content=Array::make(value.times, value.text).join("\n"),
      )
    }),
  )
  let app = @discord.App()
  app.command(echo)
  let bot = @discord.Bot(app, token~)
  bot.on(@discord.Events::ready(), (_ctx, ready) => {
    println("ready as \{ready.user.username}")
  })
  bot.run()
}

#Packages

#Examples

• slash_echo: minimal typed Gateway bot.
• kitchen_sink: subcommands, autocomplete, context menus, components, and modals.
• ping_gateway: low-level Gateway and REST use.
• low_level: manual Framework and Shard wiring.
• workers_echo: Cloudflare Workers adapter.
• interactions_http: native signed-interactions HTTP server.
• plugin_demo: a stateful feedback feature installed as a separate package.
• voice_player: join a voice channel and play an Ogg/Opus file.
• voice_recorder: record a user's voice to an Ogg/Opus file.

#App core and executors

• Bot(app, token~) connects to the gateway and routes InteractionCreate events through the App.
• app.serve(group, token~) creates an InteractionEndpoint for an HTTP adapter.

#Gateway executor

bot.on(@discord.Events::message_create(), (ctx, event) => {
  let message = event.message
  println("\{message.author.username}: \{message.content}")
})

///|
let bot = @discord.Bot(app, token~, shards=Auto)

#Voice (experimental)

#Synchronization and failures

#HTTP interactions (experimental)

///|
async fn handle_http_interaction(
  app : @discord.App,
  group : @async.TaskGroup[Unit],
  token : String,
  body : Json,
) -> Json? {
  app.serve(group, token~).handle(body)
}

#Typed models

let id : @model.MessageId = @model.Id::parse("175928847299117063")
println(id.timestamp_ms()) // 1462015105796

#REST without the gateway

let client = @dhttp.Client(token)
let message = client.create_message(channel_id, content="hello")
client.create_message(channel_id, content="with reply", reply_to=message.id)
|> ignore

client.guild_ref(guild_id).emoji_ref(emoji_id).edit(name="renamed") |> ignore

• an opt-in, gateway-driven in-memory cache — events and intents;
• pure helpers for permissions, mentions, timestamps, and CDN URLs — models and utilities;
• structured REST, gateway, and dispatch telemetry — middleware;
• a feature-installer convention for structuring larger bots — structuring bots;
• the interaction router, response gates, and no-network handler testing under App — the framework layer.

#Development

moon check --target native --deny-warn
moon check --target js --deny-warn
moon test --target native --release   # debug native builds need a working tcc setup
moon test --target js --release
moon fmt
moon -C template fmt --check
moon -C tools/package_graph fmt --check
moon info --target native             # regenerate pkg.generated.mbti (API review signal)

moon ide doc "@discord"
moon ide doc "@http.Client::create_message"
moon ide doc "@model.Message"
moon ide doc "@util.channel_permissions"

#License