@yaebal/keyboard

pnpm add @yaebal/keyboard

import { Bot } from "@yaebal/core";
import { InlineKeyboard } from "@yaebal/keyboard";

const bot = new Bot(process.env.BOT_TOKEN!);

bot.command("menu", (ctx) => {
  const kb = new InlineKeyboard()
    .text("ban", "action:ban")
    .text("warn", "action:warn")
    .row()
    .url("view profile", "https://t.me/username")
    .build();

  return ctx.reply("choose an action:", { reply_markup: kb });
});

import { Keyboard } from "@yaebal/keyboard";

bot.command("start", (ctx) => {
  const kb = new Keyboard()
    .text("yes")
    .text("no")
    .row()
    .requestContact("share phone")
    .resized()
    .oneTime()
    .build();

  return ctx.reply("ready?", { reply_markup: kb });
});

const kb = new InlineKeyboard()
  .webApp("open app", "https://yaebal.mom")
  .row()
  .switchInline("share", "my query")
  .row()
  .login("log in", "https://example.com/auth")
  .copyText("copy code", "ABC-123")
  .build();

// style()/icon() modify the button that was just added — call them right after it
const kb = new InlineKeyboard()
  .text("delete", "action:delete")
  .style("danger")
  .text("confirm", "action:confirm")
  .style("success")
  .build();

// or pass a third `deco` argument to decorate the button inline — an object,
// or a "<customEmojiId>:<style>" string shorthand:
const inline = new InlineKeyboard()
  .text("delete", "action:delete", { style: "danger", icon: "5368324170671202286" })
  .text("confirm", "action:confirm", "success")           // bare style
  .text("star", "action:star", "5368324170671202286")     // bare custom-emoji id
  .text("pin", "action:pin", "5368324170671202286:primary") // both
  .build();

import { Keyboard } from "@yaebal/keyboard";

// requestId is echoed back on the *Shared update so you can tell buttons apart —
// it only needs to be unique within this keyboard.
const kb = new Keyboard()
  .requestUsers("pick a user", 1, { max_quantity: 1, user_is_bot: false })
  .row()
  .requestChat("pick a channel", 2, /* isChannel */ true, { request_title: true })
  .row()
  .requestManagedBot("create a bot for me", 3, { suggested_name: "My Shop Bot" })
  .resized()
  .build();

bot.on("message", (ctx) => {
  if (ctx.message.users_shared?.request_id === 1) {
    // ctx.message.users_shared.users
  }
});

// managed bots: created bot info arrives both ways
bot.on("managed_bot", (ctx) => {
  // ctx.bot — the newly created/updated bot's User
});

import { Keyboard } from "@yaebal/keyboard";

// hide whatever reply keyboard is currently shown
await ctx.reply("ok", { reply_markup: Keyboard.remove() });

// open a reply input, as if the user tapped "reply" on this message
await ctx.reply("what's your name?", {
  reply_markup: Keyboard.forceReply({ input_field_placeholder: "your name" }),
});

const products = await getProducts();

// static, instance-free builders (InlineKeyboard.text/url/webApp,
// Keyboard.text/requestUsers/requestChat/requestManagedBot) return a raw button —
// add() appends any number of them at once.
const kb = new InlineKeyboard()
  .columns(2) // auto-wraps into rows of 2 — no manual .row() bookkeeping
  .add(...products.map((p) => InlineKeyboard.text(p.name, `buy:${p.id}`)))
  .build();

// InlineKeyboard/Keyboard implement toJSON(), so Api's JSON.stringify(reply_markup)
// picks it up automatically — .build() is optional here
await ctx.reply("pick one", {
  reply_markup: new InlineKeyboard().text("ok", "ok"),
});