Honocord

Class: Honocord

Defined in: Honocord.ts:86

Constructors

Constructor

new Honocord(__namedParameters?): Honocord

Defined in: Honocord.ts:138

Parameters

__namedParameters?

HonocordOptions = {}

Returns

Honocord

Methods

clearMiddleware()

clearMiddleware(): this

Defined in: Honocord.ts:769

Clears all registered middleware functions.

Returns

this

The Honocord instance for chaining.

---

getApp()

getApp(options?): Hono<{ Variables: BaseVariables; }, BlankSchema, "/">

Defined in: Honocord.ts:608

Returns a Hono App instance with the interaction handler mounted at the root path and a GET Handler for all paths, which returns a simple Health response.

Parameters

options?

HonocordAppOptions = {}

Returns

Hono<{ Variables: BaseVariables; }, BlankSchema, "/">

Example

import { Honocord } from "honocord";

const honoCord = new Honocord();

export default honoCord.getApp();
// Supports both "/" and "/interactions" for the interactions handler, if any are loaded
// And `/webhook` for the webhook handler if any are loaded

---

interactionsHandler()

interactionsHandler(c): Promise<Response & TypedResponse<"Bad request signature.", 401, "text"> | Response & TypedResponse<"No interaction found.", 400, "text"> | JSONRespondReturn<{ }, 202> | Response & TypedResponse<"Internal server error.", 500, "text"> | JSONRespondReturn<{ type: InteractionResponseType; }, ContentfulStatusCode> | undefined>

Defined in: Honocord.ts:551

Returns a Hono handler for POST Requests handling Discord interactions.

Parameters

c

BaseInteractionContext

Returns

Promise<Response & TypedResponse<"Bad request signature.", 401, "text"> | Response & TypedResponse<"No interaction found.", 400, "text"> | JSONRespondReturn<{ }, 202> | Response & TypedResponse<"Internal server error.", 500, "text"> | JSONRespondReturn<{ type: InteractionResponseType; }, ContentfulStatusCode> | undefined>

Example

import { Hono } from "hono";
import { Honocord } from "honocord";

const app = new Hono();
const bot = new Honocord();

app.get("/", (c) => c.text("🔥 Honocord is running!"));
app.post("/interactions", bot.interactionsHandler);

export default app;

---

loadHandlers()

loadHandlers(…handlers): void

Defined in: Honocord.ts:150

Registers handlers for interactions.

Parameters

handlers

…FlatOrNestedArray<AnyHandler>

Array of CommandHandler, ComponentHandler, or ModalHandler instances

For an example of usage, see the Example Repository.

Returns

void

---

use()

use<Context>(…middleware): this

Defined in: Honocord.ts:660

Registers a middleware function to process interaction contexts.

Middleware receives the Hono context and a next callback:

• Access/modify context variables via c.get() and c.set()
• Access the interaction object via c.var.command, c.var.component, c.var.modal, or c.var.autocomplete
• Access environment bindings via c.env
• Call await next() to continue to the next middleware or handler

The context is passed by reference, so all modifications persist through the middleware chain and into handlers.

Type Parameters

Context

Context extends BaseInteractionContext = BaseInteractionContext

Parameters

middleware

…MiddlewareFunction<Context>[]

The middleware function(s) to register.

Returns

this

The Honocord instance for chaining.

Example

bot.use(async (c, next) => {
  // Set custom data in context
  c.set('startTime', Date.now());

  // Continue to next middleware/handler
  // you can also return next() directly if no post-processing is needed
  await next();

  // Code here runs after the handler completes
  console.log('Duration:', Date.now() - c.get('startTime'));
});

---

webhookHandler()

webhookHandler(c): Promise<any>

Defined in: Honocord.ts:684

Returns a Hono handler for POST requests handling Discord webhook events.

On Cloudflare Workers, webhook events are processed asynchronously using waitUntil, allowing immediate response to Discord while extending the worker’s lifetime to complete processing.

Parameters

c

Context

Returns

Promise<any>

Example

import { Hono } from "hono";
import { Honocord } from "honocord";

const app = new Hono();
const bot = new Honocord();

app.post("/webhook", bot.webhookHandler);

export default app;

---

withCache()

withCache<TheEnv>(factory): this

Defined in: Honocord.ts:746

Registers a cache adapter factory for use throughout the bot. The factory receives the request environment and returns a BaseCacheAdapter instance.

On Cloudflare Workers, use DurableObjectCacheAdapter. On self-hosted environments, use MemoryCacheAdapter, MongoCacheAdapter, or RedisAdapter.

Type Parameters

TheEnv

TheEnv = any

Parameters

factory

(env) => BaseCacheAdapter

A function that receives the environment and returns a cache adapter.

Returns

this

The Honocord instance for chaining.

Example

// Cloudflare Workers
bot.withCache((env) => new DurableObjectCacheAdapter(env.MY_CACHE));

// Self-hosted (pre-initialized)
const cache = new MongoCacheAdapter(process.env.MONGO_URI!);
await cache.connect();
bot.withCache(() => cache);