DiscordHono

import { DiscordHono } from 'discord-hono'

const app = new DiscordHono()
app.command('ping', c => c.res('Pong!!'))

export default app

.command()

const commands = [
  makeSlashCommand('ping', 'response Pong'),
  makeSlashCommand('image', 'response Image'),
]
const app = new DiscordHono()
  .command('ping', c => c.res('Pong!!'))
  .command('image', c => c.res('Image!!'))

The first argument of Command() must match the first argument of .command().
The second argument of the matched .command() is executed.

Specifying '' as the first argument functions as a catch-all pattern.

.component()

const app = new DiscordHono()
  .command('components', c =>
    c.res({
      content: 'No button clicked yet',
      components: [
        makeActionRow([
          makeButton('button-1', 'Button'),
          makeButton('button-2', 'Second'),
        ]),
      ],
    }),
  )
  .component('button-1', c => c.update().res('Button clicked'))
  .component('button-2', c => c.update().res('Second clicked'))

The first argument of the component element makeButton() must match the first argument of .component().
The second argument of the matched .component() is executed.

Specifying '' as the first argument functions as a catch-all pattern.

.autocomplete()

const commands = [
  makeSlashCommand('hello', 'command').options([
    makeStringOption('option', 'selector').autocomplete(true).required(true),
  ]),
]
const app = new DiscordHono().autocomplete(
  'hello',
  c =>
    c.resAutocomplete([
      { name: 'world', value: 'world!!!' },
      { name: 'hi', value: 'hi!' },
    ]),
  c => c.res(c.var.option),
)

Add .autocomplete(true) to makeStringOption() of the command.
The first argument of makeSlashCommand() must match the first argument of .autocomplete().
The second argument of the matched .autocomplete() is the handler for choice generation, and the third argument is the handler for execution.

The third argument of .autocomplete() is the same as the second argument of .command().

.modal()

const app = new DiscordHono()
  .command('modal', c =>
    c.resModal(
      makeModal('modal-1', 'モーダル タイトル', [
        makeLabel('テキスト', makeTextInput('text-1', 'テキスト'))
        makeLabel('2つ目', makeTextInput('text-2', '2つ目'))
      ])
    ),
  )
  .modal('modal-1', c => c.res('Modal submitted'))

The first argument of makeModal() must match the first argument of .modal().
The second argument of the matched .modal() is executed.

Specifying '' as the first argument functions as a catch-all pattern.

.cron()

const app = new DiscordHono()
  .cron('0 0 * * *', async c => {
    await c.rest('POST', $channels$_$messages, ['CHANNEL_ID'], {
      content: 'Daily Post',
    })
  })
  .cron('', async c => {
    await c.rest('POST', $channels$_$messages, ['CHANNEL_ID'], {
      content: 'Other Cron Triggers Post',
    })
  })

wrangler.toml

name = "example"
main = "src/index.ts"
compatibility_date = "2024-02-08"
[triggers]
crons = [ "0 * * * *", "0 0 * * *" ]

The first argument of .cron() must match the toml file crons.
The second argument of the matched .cron() is executed.

Specifying '' as the first argument functions as a catch-all pattern.

.fetch()

Please refer to here.
We try to be as similar as possible to Hono’s fetch().

.scheduled()

If you use export default app, .scheduled() is included.

Init Options

verify

If it’s a Cloudflare environment, there’s no need to use it.

discord-interactions

import { verifyKey } from 'discord-interactions'
const app = new DiscordHono({ verify: verifyKey })

discord-verify

import { verify, PlatformAlgorithm } from 'discord-verify'
const app = new DiscordHono({
  verify: (...args) =>
    verify(...args, crypto.webcrypto.subtle, PlatformAlgorithm.OldNode),
})

discordEnv

If it’s an environment variable similar to Example, there’s no need to use it.
Use it when you save the environment variable with a different name or when it’s an environment other than Cloudflare.

const app = new DiscordHono({
  discordEnv: env => ({
    APPLICATION_ID: env.DISCORD_APPLICATION_ID,
    PUBLIC_KEY: env.DISCORD_PUBLIC_KEY,
    TOKEN: env.DISCORD_TOKEN,
  }),
})