@xbibzlibrary/telebibz 0.4.5 → 3.1.1

package/examples/01-quickstart.js

@@ -0,0 +1,13 @@
+// examples/01-quickstart.js — bot jalan dalam 6 baris kode.
+//   BOT_TOKEN=123:abc node examples/01-quickstart.js
+'use strict';
+
+const { TeleBibz } = require('..');
+
+const bot = new TeleBibz(process.env.BOT_TOKEN);
+
+bot.cmd('start', (ctx) => ctx.reply(`Halo ${ctx.from.first_name}! Aku hidup 🎉`));
+bot.hears(/halo|hai/i, (ctx) => ctx.reply('Halo juga! 👋'));
+bot.hears('ping', (ctx) => ctx.reply('pong 🏓'));
+
+bot.launch();

package/examples/02-menu-tombol.js

@@ -0,0 +1,22 @@
+// examples/02-menu-tombol.js — inline keyboard berwarna + ikon animated.
+'use strict';
+
+const { TeleBibz, btn, url, kb } = require('..');
+
+const bot = new TeleBibz(process.env.BOT_TOKEN);
+
+bot.cmd('menu', (ctx) =>
+  ctx.reply('Pilih menu:', kb([
+    [btn('💎 Premium', 'premium', 'primary'), btn('📞 Bantuan', 'bantuan')],
+    [url('🌐 Website', 'https://example.com', 'success')],
+    [btn('❌ Tutup', 'tutup', 'danger')],
+  ])));
+
+bot.action('premium', async (ctx) => {
+  await ctx.answerCallbackQuery('Menuju halaman premium…');
+  await ctx.reply('💎 Daftar paket premium…');
+});
+bot.action('bantuan', (ctx) => ctx.answerCallbackQuery({ text: 'Hubungi @admin ya!', show_alert: true }));
+bot.action('tutup', (ctx) => ctx.deleteMessage().catch(() => {}));
+
+bot.launch();

package/examples/03-wizard.js

@@ -0,0 +1,58 @@
+// examples/03-wizard.js — form pendaftaran tanya-jawab + TOMBOL + mode edit/delete.
+//   BOT_TOKEN=123:abc node examples/03-wizard.js
+'use strict';
+
+const { TeleBibz } = require('..');
+
+const bot = new TeleBibz(process.env.BOT_TOKEN);
+
+bot.wizard('daftar', {
+  // mode tampilan pertanyaan:
+  //   'send'   → tiap pertanyaan jadi pesan baru (default)
+  //   'edit'   → SATU pesan diedit terus dari awal sampai akhir
+  //   'delete' → pesan lama dihapus dulu, baru tanya berikutnya
+  mode: 'edit',
+
+  steps: [
+    { key: 'nama', ask: '1️⃣ Siapa nama lengkapmu?' },
+
+    {
+      // TOMBOL reply keyboard — user tinggal ketuk, tak perlu mengetik
+      key: 'jk',
+      ask: '2️⃣ Jenis kelamin?',
+      buttons: ['👨 Laki-laki', '👩 Perempuan'],
+      onlyButtons: true, // tolak ketikan bebas
+    },
+
+    {
+      // TOMBOL inline (callback) — nilai bisa beda dari label,
+      // dan pesan langsung diedit ke langkah berikutnya
+      key: 'domisili',
+      ask: '3️⃣ Domisili pulau mana?',
+      inline: true,
+      onlyButtons: true,
+      buttons: [
+        [{ text: '🌋 Jawa', value: 'jawa' }, { text: '🌴 Sumatera', value: 'sumatera' }],
+        [{ text: '🏝️ Lainnya', value: 'lainnya' }],
+      ],
+    },
+
+    {
+      key: 'umur',
+      ask: '4️⃣ Umur berapa? (ketik "batal" untuk berhenti)',
+      parse: (t) => parseInt(t, 10),
+      validate: (n) => (Number.isFinite(n) && n > 0 && n < 120 ? null : 'Umur tidak valid — ketik angka saja ya:'),
+    },
+  ],
+
+  // cleanup bawaan: pesan tanya terakhir otomatis dibereskan,
+  // reply keyboard otomatis disingkirkan (nonaktif: removeKeyboard: false)
+  done: async (ans, ctx) => {
+    await ctx.reply(
+      `✅ Terdaftar!\nNama     : ${ans.nama}\nJK       : ${ans.jk}\nDomisili : ${ans.domisili}\nUmur     : ${ans.umur}`,
+    );
+  },
+  onCancel: (ctx) => ctx.reply('👋 Pendaftaran dibatalkan.'),
+});
+
+bot.launch();

package/examples/04-broadcast.js

@@ -0,0 +1,25 @@
+// examples/04-broadcast.js — blast pesan ke banyak chat tanpa kena limit.
+'use strict';
+
+const { TeleBibz, kb, url } = require('..');
+
+const bot = new TeleBibz(process.env.BOT_TOKEN);
+const subscribers = new Set(); // produksi: simpan di DB
+
+bot.cmd('start', (ctx) => {
+  subscribers.add(ctx.chat.id);
+  ctx.reply('Kamu terdaftar! Admin bisa /blast untuk info ke semua.');
+});
+
+bot.cmd('blast', async (ctx) => {
+  if (String(ctx.from.id) !== process.env.ADMIN_ID) return ctx.reply('Khusus admin.');
+  const teks = ctx.message.text.replace(/^\/blast\s*/i, '').trim();
+  if (!teks) return ctx.reply('Pakai: /blast isi pesannya');
+
+  const proses = await ctx.reply(`Mengirim ke ${subscribers.size} chat…`);
+  const hasil = await bot.broadcast([...subscribers], { text: teks, ...kb([[url('Info', 'https://example.com')]]) });
+  await ctx.reply(`Selesai ✅ terkirim ${hasil.terkirim}, gagal ${hasil.gagal}`);
+  await ctx.api.deleteMessage(ctx.chat.id, proses.message_id).catch(() => {});
+});
+
+bot.launch();

package/examples/05-kirim-file.js

@@ -0,0 +1,19 @@
+// examples/05-kirim-file.js — kirim foto dari URL & dokumen dari Buffer.
+'use strict';
+
+const { TeleBibz, InputFile } = require('..');
+
+const bot = new TeleBibz(process.env.BOT_TOKEN);
+
+bot.cmd('kucing', async (ctx) => {
+  const r = await fetch('https://cataas.com/cat');
+  const buf = Buffer.from(await r.arrayBuffer());
+  await ctx.replyWithPhoto(new InputFile(buf, 'kucing.jpg'), { caption: 'Meong 🐱' });
+});
+
+bot.cmd('laporan', async (ctx) => {
+  const data = Buffer.from(`Laporan ${new Date().toISOString()}\nHalo dunia!`);
+  await ctx.replyWithDocument(new InputFile(data, 'laporan.txt'));
+});
+
+bot.launch();

package/examples/06-menu.js

@@ -0,0 +1,35 @@
+// examples/06-menu.js — Menu inline ala @grammyjs/menu dengan submenu.
+'use strict';
+
+const { TeleBibz, MenuContainer } = require('..');
+
+const bot = new TeleBibz(process.env.BOT_TOKEN);
+const mc = new MenuContainer();
+
+const utama = mc.create('utama');
+const setelan = mc.create('setelan');
+
+const state = { notif: true };
+
+utama
+  .text('⚙️  Setelan', async (ctx) => {
+    await ctx.editMessageReplyMarkup({ reply_markup: await setelan.render(ctx) });
+    await ctx.answerCallbackQuery();
+  })
+  .row()
+  .url('📚 Dokumentasi', 'https://github.com/XbibzOfficial777/telebibz');
+
+setelan
+  .text('🔔 Toggle Notif', async (ctx) => {
+    state.notif = !state.notif;
+    await ctx.answerCallbackQuery({ text: `Notif ${state.notif ? 'ON ✅' : 'OFF ❌'}` });
+  })
+  .back('◀️ Kembali', 'utama');
+
+bot.use(mc);
+
+bot.cmd('menu', async (ctx) => {
+  await ctx.reply('Pilih menu:', { reply_markup: await utama.render(ctx) });
+});
+
+bot.launch();

package/examples/07-inline-query.js

@@ -0,0 +1,18 @@
+// examples/07-inline-query.js — mode inline: ketik @botkamu apa saja di chat apa pun.
+'use strict';
+
+const { TeleBibz, iq } = require('..');
+
+const bot = new TeleBibz(process.env.BOT_TOKEN);
+
+bot.inlineQuery('*', async (ctx) => {
+  const q = (ctx.inline_query.query || '').trim();
+  const hasil = [
+    iq.article('echo', `Echo: ${q || '…'}`, { message_text: q || 'ketik sesuatu setelah @botkamu' }),
+    iq.article('caps', 'HURUF BESAR', { message_text: (q || 'HALO').toUpperCase() }),
+    iq.article('terbalik', 'Balik teks', { message_text: [...(q || 'halo')].reverse().join('') }),
+  ];
+  await ctx.answerInlineQuery(hasil, { cache_time: 0, is_personal: true });
+});
+
+bot.launch();

package/index.d.ts

@@ -0,0 +1,106 @@
+// index.d.ts — tipe ringkas untuk autocompletion editor (autocorrect).
+// v3: tipe longgar (JS-first) — parity grammY.
+type Context = any; type Bot = any;
+
+declare module '@xbibzlibrary/telebibz' {
+  type Color = 'danger' | 'success' | 'primary';
+  type Handler = (ctx: Context) => unknown;
+
+  type WizardMode = 'send' | 'edit' | 'delete';
+  type WizardButton = string | { text: string; value?: unknown };
+  interface WizardStep {
+    key: string;
+    ask: string | ((ctx: Context) => string | Promise<string>);
+    parse?: (text: string, ctx: Context) => unknown | Promise<unknown>;
+    validate?: (value: unknown, ctx: Context) => string | null | Promise<string | null>;
+    opts?: Record<string, unknown>;
+    /** Tombol pilihan: ['A','B'] | [{text,value}] | baris eksplisit [['A'],['B','C']]. */
+    buttons?: Array<WizardButton | WizardButton[]>;
+    /** true → tombol inline (callback), default reply keyboard. */
+    inline?: boolean;
+    /** true/string → tolak ketikan bebas, wajib pilih tombol. */
+    onlyButtons?: boolean | string;
+    /** Override mode tampilan per langkah. */
+    mode?: WizardMode;
+    /** Reply keyboard sekali pakai. */
+    oneTime?: boolean;
+  }
+  interface WizardDef {
+    steps: WizardStep[];
+    done: (answers: Record<string, unknown>, ctx: Context) => unknown;
+    cancelWords?: string[];
+    onCancel?: (ctx: Context) => unknown;
+    /** 'send' (default) | 'edit' satu pesan | 'delete' tanya-hapus per langkah. */
+    mode?: WizardMode;
+    /** Hapus pesan tanya terakhir saat wizard selesai (default: true bila mode 'delete'). */
+    cleanup?: boolean;
+    /** Singkirkan reply keyboard saat selesai (default: true bila tombol reply pernah dipakai). */
+    removeKeyboard?: boolean;
+  }
+
+  interface TeleBibzOpts {
+    allowedUpdates?: string[];
+    onError?: (err: unknown, ctx?: Context) => unknown;
+    silent?: boolean;
+    dropPending?: boolean;
+    session?: { initial?: () => unknown; getKey?: (ctx: Context) => string | undefined; storage?: unknown };
+    transport?: (method: string, payload?: object) => Promise<unknown>;
+  }
+
+  class TeleBibz {
+    constructor(token: string, opts?: TeleBibzOpts);
+    api: any;
+    botInfo: any;
+    use(...mw: any[]): this;
+    cmd(names: string | string[], ...mw: Handler[]): this;
+    hears(match: string | RegExp, ...mw: Handler[]): this;
+    action(trigs: string | RegExp | string[], ...mw: Handler[]): this;
+    on(filter: string | string[], ...mw: Handler[]): this;
+    start(replies: string | Handler): this;
+    wizard(id: string, def: WizardDef, bindCommand?: boolean): this;
+    wizardStart(ctx: Context, id: string): Promise<unknown>;
+    wizardActive(ctx: Context): boolean;
+    wizardCancel(ctx: Context): Promise<boolean>;
+    wizardEdit(ctx: Context, text: string, extra?: object): Promise<unknown>;
+    wizardDelete(ctx: Context): Promise<boolean>;
+    broadcast(ids: Array<number | string>, pesan: any, opts?: { delay?: number }): Promise<{ terkirim: number; gagal: number; errors: Array<{ chatId: any; pesan: string }> }>;
+    launch(opts?: Record<string, unknown>): Promise<this>;
+    handleUpdate(update: any): Promise<void>;
+    webhook(...args: any[]): any;
+    stop(): Promise<void>;
+  }
+
+  function btn(text: string, callbackData: string | number, style?: Color, iconId?: string): any;
+  function url(text: string, link: string, style?: Color, iconId?: string): any;
+  function webApp(text: string, link: string, iconId?: string): any;
+  function copy(text: string, value: string, iconId?: string): any;
+  function kb(rows: any[][]): { reply_markup: { inline_keyboard: any[][] } };
+  namespace kb {
+    function markup(rows: any[][]): { inline_keyboard: any[][] };
+    function confirm(yesData: string, noData: string, labelYes?: string, labelNo?: string): any;
+  }
+
+  const wizard: {
+    define: (id: string, def: WizardDef) => string;
+    start: (ctx: Context, id: string) => Promise<unknown>;
+    active: (ctx: Context) => boolean;
+    cancel: (ctx: Context) => Promise<boolean>;
+    editAsk: (ctx: Context, text: string, extra?: object) => Promise<unknown>;
+    deleteAsk: (ctx: Context) => Promise<boolean>;
+    KEY: string;
+  };
+
+  function humanize(err: unknown): { pesan: string; saran: string | null; method?: string; code?: number };
+  const log: { info: Function; ok: Function; warn: Function; error: Function; banner: Function };
+  const say: { html: (text: string, extra?: object) => object };
+
+  class File { constructor(src: any, filename?: string, type?: string); src: any; filename: string; data(): Promise<Buffer>; }
+  const InputFile: typeof File;
+  const InlineKeyboard: any;
+  const Keyboard: any;
+  class ApiError extends Error { description: string; error_code?: number; method?: string; payload?: any; }
+  const Composer: any; const BotError: any; const session: any; const Api: any;
+}
+
+import { Menu as _M } from './lib/menus';
+export {};

package/index.js

@@ -0,0 +1,44 @@
+// index.js — pintu masuk @xbibzlibrary/telebibz.
+// v3: set fitur production-grade setara grammY (lihat README -> FEATURE MATRIX).
+'use strict';
+
+const { TeleBibz } = require('./lib/telebibz');
+const { ApiError, createTransport } = require('./lib/net');
+const { File, InputFile, InputMediaBuilder } = require('./lib/file');
+const { btn, url, webApp, copy, kb, InlineKeyboard, Keyboard } = require('./lib/keyboard');
+const wizard = require('./lib/wizard');
+const { humanize } = require('./lib/errors');
+const log = require('./lib/logger');
+const { session } = require('./lib/session');
+const { Composer, BotError } = require('./lib/composer');
+const { makeApi } = require('./lib/api');
+const { Context } = require('./lib/context');
+const { broadcast } = require('./lib/broadcast');
+const { autoRetry, throttler, limiter } = require('./lib/ratelimit');
+const { matchInlineQuery, iq } = require('./lib/inline-query');
+const { Menu, MenuContainer } = require('./lib/menus');
+
+const say = {
+  html: (text, extra = {}) => ({ ...extra, text, parse_mode: 'HTML' }),
+};
+
+module.exports = {
+  // kelas utama
+  TeleBibz, Context, Composer, BotError, session,
+  // wizard (form percakapan + tombol + edit/delete)
+  wizard,
+  // keyboard & menu
+  btn, url, webApp, copy, kb, InlineKeyboard, Keyboard, Menu, MenuContainer,
+  // percakapan
+  wizard,
+  // file & media
+  File, InputFile, InputMediaBuilder,
+  // api & transport
+  makeApi, createTransport, ApiError,
+  // anti-spam & keandalan
+  autoRetry, throttler, limiter, broadcast,
+  // inline mode
+  matchInlineQuery, iq,
+  // util
+  humanize, log, say,
+};

package/lib/api.js

@@ -0,0 +1,154 @@
+// lib/api.js — akses penuh Bot API: ~60 shortcut + PROXY untuk SEGALA metode +
+// transformer pipeline (api.config.use) gaya grammY + download file.
+'use strict';
+
+const { createTransport } = require('./net');
+
+class ApiConfig {
+  constructor() { this.transformers = []; }
+  /** Sisipkan transformer: (prev, method, payload) => result */
+  use(t) { this.transformers.push(t); return this; }
+}
+
+class ApiBase {
+  constructor(token, transport) {
+    this.token = token;
+    this.config = new ApiConfig();
+    this._base = transport || createTransport(token, {});
+    this.raw = (method, payload = {}) => this.callApi(method, payload);
+  }
+
+  async callApi(method, payload = {}) {
+    let fn = this._base;
+    for (const t of this.config.transformers) {
+      const prev = fn;
+      fn = (m, p) => t(prev, m, p);
+    }
+    return fn(method, payload);
+  }
+
+  /* =============== metode umum =============== */
+  getMe() { return this.callApi('getMe'); }
+  logOut() { return this.callApi('logOut'); }
+  close() { return this.callApi('close'); }
+
+  /* ---- pesan ---- */
+  sendMessage(chat_id, text, extra = {}) { return this.callApi('sendMessage', { chat_id, text, ...extra }); }
+  forwardMessage(chat_id, from_chat_id, message_id, extra = {}) { return this.callApi('forwardMessage', { chat_id, from_chat_id, message_id, ...extra }); }
+  forwardMessages(chat_id, from_chat_id, message_ids, extra = {}) { return this.callApi('forwardMessages', { chat_id, from_chat_id, message_ids, ...extra }); }
+  copyMessage(chat_id, from_chat_id, message_id, extra = {}) { return this.callApi('copyMessage', { chat_id, from_chat_id, message_id, ...extra }); }
+  copyMessages(chat_id, from_chat_id, message_ids, extra = {}) { return this.callApi('copyMessages', { chat_id, from_chat_id, message_ids, ...extra }); }
+  editMessageText(chat_id, message_id, text, extra = {}) { return this.callApi('editMessageText', { chat_id, message_id, text, ...extra }); }
+  editMessageCaption(chat_id, message_id, extra = {}) { return this.callApi('editMessageCaption', { chat_id, message_id, ...extra }); }
+  editMessageMedia(chat_id, message_id, media, extra = {}) { return this.callApi('editMessageMedia', { chat_id, message_id, media, ...extra }); }
+  editMessageReplyMarkup(chat_id, message_id, extra = {}) { return this.callApi('editMessageReplyMarkup', { chat_id, message_id, ...extra }); }
+  deleteMessage(chat_id, message_id) { return this.callApi('deleteMessage', { chat_id, message_id }); }
+  deleteMessages(chat_id, message_ids) { return this.callApi('deleteMessages', { chat_id, message_ids }); }
+  setMessageReaction(chat_id, message_id, reaction, extra = {}) { return this.callApi('setMessageReaction', { chat_id, message_id, reaction, ...extra }); }
+  sendChatAction(chat_id, action, extra = {}) { return this.callApi('sendChatAction', { chat_id, action, ...extra }); }
+
+  /* ---- media ---- */
+  sendPhoto(c, photo, e = {}) { return this.callApi('sendPhoto', { chat_id: c, photo, ...e }); }
+  sendVideo(c, video, e = {}) { return this.callApi('sendVideo', { chat_id: c, video, ...e }); }
+  sendAudio(c, audio, e = {}) { return this.callApi('sendAudio', { chat_id: c, audio, ...e }); }
+  sendDocument(c, document, e = {}) { return this.callApi('sendDocument', { chat_id: c, document, ...e }); }
+  sendAnimation(c, animation, e = {}) { return this.callApi('sendAnimation', { chat_id: c, animation, ...e }); }
+  sendVoice(c, voice, e = {}) { return this.callApi('sendVoice', { chat_id: c, voice, ...e }); }
+  sendVideoNote(c, vn, e = {}) { return this.callApi('sendVideoNote', { chat_id: c, video_note: vn, ...e }); }
+  sendSticker(c, sticker, e = {}) { return this.callApi('sendSticker', { chat_id: c, sticker, ...e }); }
+  sendMediaGroup(c, media, e = {}) { return this.callApi('sendMediaGroup', { chat_id: c, media, ...e }); }
+  sendLocation(c, lat, lon, e = {}) { return this.callApi('sendLocation', { chat_id: c, latitude: lat, longitude: lon, ...e }); }
+  sendVenue(c, lat, lon, title, address, e = {}) { return this.callApi('sendVenue', { chat_id: c, latitude: lat, longitude: lon, title, address, ...e }); }
+  sendContact(c, phone, first, e = {}) { return this.callApi('sendContact', { chat_id: c, phone_number: phone, first_name: first, ...e }); }
+  sendPoll(c, question, options, e = {}) { return this.callApi('sendPoll', { chat_id: c, question, options, ...e }); }
+  sendDice(c, emoji, e = {}) { return this.callApi('sendDice', { chat_id: c, ...(emoji ? { emoji } : {}), ...e }); }
+  stopPoll(c, message_id, e = {}) { return this.callApi('stopPoll', { chat_id: c, message_id, ...e }); }
+
+  /* ---- file ---- */
+  getFile(file_id) { return this.callApi('getFile', { file_id }); }
+  /** Unduh file_id ke disk; return path tujuan. */
+  async downloadFile(file_id, dest, axiosOpts = {}) {
+    const f = await this.getFile(file_id);
+    const axios = require('axios');
+    const fs = require('fs');
+    const url = `https://api.telegram.org/file/bot${this.token}/${f.file_path}`;
+    const res = await axios.get(url, { responseType: 'stream', ...axiosOpts });
+    const out = fs.createWriteStream(dest);
+    await new Promise((ok, no) => { res.data.pipe(out); out.on('finish', ok); out.on('error', no); res.data.on('error', no); });
+    return dest;
+  }
+
+  /* ---- callback & inline ---- */
+  answerCallbackQuery(id, e = {}) { return this.callApi('answerCallbackQuery', { callback_query_id: id, ...e }); }
+  answerInlineQuery(id, results, e = {}) { return this.callApi('answerInlineQuery', { inline_query_id: id, results, ...e }); }
+
+  /* ---- grup & admin ---- */
+  banChatMember(c, u, e = {}) { return this.callApi('banChatMember', { chat_id: c, user_id: u, ...e }); }
+  unbanChatMember(c, u, e = {}) { return this.callApi('unbanChatMember', { chat_id: c, user_id: u, ...e }); }
+  restrictChatMember(c, u, permissions, e = {}) { return this.callApi('restrictChatMember', { chat_id: c, user_id: u, permissions, ...e }); }
+  promoteChatMember(c, u, e = {}) { return this.callApi('promoteChatMember', { chat_id: c, user_id: u, ...e }); }
+  setChatAdministratorCustomTitle(c, u, t) { return this.callApi('setChatAdministratorCustomTitle', { chat_id: c, user_id: u, custom_title: t }); }
+  approveChatJoinRequest(c, u) { return this.callApi('approveChatJoinRequest', { chat_id: c, user_id: u }); }
+  declineChatJoinRequest(c, u) { return this.callApi('declineChatJoinRequest', { chat_id: c, user_id: u }); }
+  getChat(c) { return this.callApi('getChat', { chat_id: c }); }
+  getChatAdministrators(c) { return this.callApi('getChatAdministrators', { chat_id: c }); }
+  getChatMemberCount(c) { return this.callApi('getChatMemberCount', { chat_id: c }); }
+  getChatMember(c, u) { return this.callApi('getChatMember', { chat_id: c, user_id: u }); }
+  leaveChat(c) { return this.callApi('leaveChat', { chat_id: c }); }
+  setChatTitle(c, title) { return this.callApi('setChatTitle', { chat_id: c, title }); }
+  setChatDescription(c, description) { return this.callApi('setChatDescription', { chat_id: c, description }); }
+  setChatPhoto(c, photo) { return this.callApi('setChatPhoto', { chat_id: c, photo }); }
+  setChatPermissions(c, permissions, e = {}) { return this.callApi('setChatPermissions', { chat_id: c, permissions, ...e }); }
+  pinChatMessage(c, m, e = {}) { return this.callApi('pinChatMessage', { chat_id: c, message_id: m, ...e }); }
+  unpinChatMessage(c, e = {}) { return this.callApi('unpinChatMessage', { chat_id: c, ...e }); }
+  unpinAllChatMessages(c) { return this.callApi('unpinAllChatMessages', { chat_id: c }); }
+  exportChatInviteLink(c) { return this.callApi('exportChatInviteLink', { chat_id: c }); }
+
+  /* ---- konfigurasi bot ---- */
+  setMyCommands(commands, e = {}) { return this.callApi('setMyCommands', { commands, ...e }); }
+  getMyCommands(e = {}) { return this.callApi('getMyCommands', e); }
+  deleteMyCommands(e = {}) { return this.callApi('deleteMyCommands', e); }
+  setMyName(e = {}) { return this.callApi('setMyName', e); }
+  getMyName(e = {}) { return this.callApi('getMyName', e); }
+  setMyDescription(e = {}) { return this.callApi('setMyDescription', e); }
+  getMyDescription(e = {}) { return this.callApi('getMyDescription', e); }
+  setMyShortDescription(e = {}) { return this.callApi('setMyShortDescription', e); }
+  setChatMenuButton(e = {}) { return this.callApi('setChatMenuButton', e); }
+
+  /* ---- webhook ---- */
+  setWebhook(url, e = {}) { return this.callApi('setWebhook', { url, ...e }); }
+  deleteWebhook(e = {}) { return this.callApi('deleteWebhook', e); }
+  getWebhookInfo() { return this.callApi('getWebhookInfo'); }
+
+  /* ---- forum topic ---- */
+  createForumTopic(c, name, e = {}) { return this.callApi('createForumTopic', { chat_id: c, name, ...e }); }
+  closeForumTopic(c, tid) { return this.callApi('closeForumTopic', { chat_id: c, message_thread_id: tid }); }
+
+  /* ---- pembayaran & stars ---- */
+  sendInvoice(c, title, description, payload, currency, prices, e = {}) { return this.callApi('sendInvoice', { chat_id: c, title, description, payload, currency, prices, ...e }); }
+  refundStarPayment(user_id, telegram_payment_charge_id) { return this.callApi('refundStarPayment', { user_id, telegram_payment_charge_id }); }
+  getStarTransactions(e = {}) { return this.callApi('getStarTransactions', e); }
+}
+
+/**
+ * Api = ApiBase + Proxy: metode APA PUN di Bot API bisa dipanggil
+ *   api.setWebhookCustom({ url })  →  callApi('setWebhookCustom', {...})
+ * Implementasi: kalau nama ada di ApiBase, pakai definisi resminya; kalau
+ * tidak, fallback jadi satu-argumen-payload.
+ */
+function makeApi(token, transport) {
+  const base = new ApiBase(token, transport);
+  return new Proxy(base, {
+    get(target, prop, recv) {
+      const v = Reflect.get(target, prop, recv);
+      if (v !== undefined) return typeof v === 'function' ? v.bind(target) : v;
+      if (typeof prop === 'string' && /^[a-z][a-zA-Z0-9]*$/.test(prop)) {
+        return (payload = {}) => target.callApi(prop, payload);
+      }
+      return undefined;
+    },
+    set(target, prop, value) { Reflect.set(target, prop, value); return true; },
+  });
+}
+
+module.exports = { makeApi, ApiBase };

package/lib/broadcast.js

@@ -0,0 +1,35 @@
+// lib/broadcast.js — kirim ke banyak chat dengan pacing aman rate-limit.
+'use strict';
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+/**
+ * bot.broadcast(ids, pesan, opts)
+ *   ids   : array chat id
+ *   pesan : string  → { text: string }
+ *           object  → payload sendMessage/salinan
+ *           fungsi  → (chatId) => payload (personal per penerima)
+ *   opts  : { delay = 35 } ms antar kirim (≈28 pesan/detik, di bawah limit Telegram)
+ *
+ * Return: { terkirim, gagal, errors: [{ chatId, pesan }] }
+ */
+async function broadcast(api, ids, pesan, opts = {}) {
+  const delay = Number.isFinite(opts.delay) ? opts.delay : 35;
+  const failures = [];
+  let terkirim = 0;
+
+  for (const chatId of ids) {
+    let p = typeof pesan === 'function' ? await pesan(chatId) : pesan;
+    if (typeof p === 'string') p = { text: p };
+    try {
+      await api.callApi('sendMessage', { chat_id: chatId, ...p });
+      terkirim += 1;
+    } catch (err) {
+      failures.push({ chatId, pesan: (err && (err.description || err.message)) || String(err) });
+    }
+    if (delay > 0) await sleep(delay);
+  }
+  return { terkirim, gagal: failures.length, errors: failures };
+}
+
+module.exports = { broadcast };