@xbibzlibrary/telebibz 0.4.5 → 3.0.1

package/lib/context.js

@@ -0,0 +1,190 @@
+// lib/context.js — objek konteks: SEMUA accessor update + ~60 pintasan aksi.
+'use strict';
+
+const { File } = require('./file');
+
+/** Objek "pesan" dari berbagai field update (gaya ctx.msg). */
+function msgOf(update) {
+  return update.message || update.edited_message || update.channel_post ||
+    update.edited_channel_post || update.business_message || update.edited_business_message || null;
+}
+
+const UPDATE_KEYS = [
+  'message', 'edited_message', 'channel_post', 'edited_channel_post',
+  'business_message', 'edited_business_message', 'callback_query', 'inline_query',
+  'chosen_inline_result', 'chat_join_request', 'chat_member', 'my_chat_member',
+  'message_reaction', 'message_reaction_count', 'business_connection',
+  'poll', 'poll_answer', 'shipping_query', 'pre_checkout_query', 'purchased_paid_media',
+];
+
+class Context {
+  constructor(update, api, me) {
+    this.update = update;
+    this.api = api;
+    this.me = me;
+    this.update_id = update.update_id;
+    for (const k of UPDATE_KEYS) if (update[k] !== undefined) this[k] = update[k];
+    this.msg = msgOf(update);
+  }
+
+  /* ---------- accessor dasar ---------- */
+  get chat() {
+    if (this.msg) return this.msg.chat;
+    if (this.callback_query) return this.callback_query.message && this.callback_query.message.chat;
+    if (this.inline_query || this.chosen_inline_result) return undefined;
+    if (this.business_connection) return this.business_connection.user;
+    if (this.chat_join_request) return this.chat_join_request.chat;
+    if (this.chat_member) return this.chat_member.chat;
+    if (this.my_chat_member) return this.my_chat_member.chat;
+    return undefined;
+  }
+  get from() {
+    const u = this.msg || this.callback_query || this.inline_query || this.chosen_inline_result ||
+      this.chat_join_request || this.chat_member || this.my_chat_member ||
+      this.business_connection || this.poll_answer || this.shipping_query || this.pre_checkout_query;
+    if (!u) return undefined;
+    return u.from || u.user || (u.voter_user !== undefined ? u.voter_user : undefined);
+  }
+  get chatId() { const c = this.chat; return c ? c.id : undefined; }
+  get msgId() { return this.msg ? this.msg.message_id : undefined; }
+  get businessConnectionId() {
+    return (this.business_connection && this.business_connection.id) ||
+      (this.msg && this.msg.business_connection_id) || undefined;
+  }
+  get senderChat() { return this.msg ? this.msg.sender_chat : undefined; }
+  get inlineMessageId() { return this.callback_query ? this.callback_query.inline_message_id : undefined; }
+
+  _cid(cid) {
+    if (cid !== undefined) return cid;
+    const c = this.chatId;
+    if (c === undefined) throw new Error('telebibz: ctx tanpa chat (update inline/business?)');
+    return c;
+  }
+  _biz(extra = {}) {
+    // Otomatis sertakan business_connection_id pada pesan business (gaya BizWrapper)
+    const bc = this.businessConnectionId;
+    return bc && this.msg && this.msg.business_connection_id ? { business_connection_id: bc, ...extra } : extra;
+  }
+
+  /* ---------- kirim balasan ---------- */
+  reply(text, extra = {}) { return this.api.sendMessage(this._cid(), text, this._biz(extra)); }
+  replyWithHTML(text, extra = {}) { return this.reply(text, { parse_mode: 'HTML', ...extra }); }
+  replyWithMarkdown(text, extra = {}) { return this.reply(text, { parse_mode: 'MarkdownV2', ...extra }); }
+  replyWithPhoto(p, e = {}) { return this.api.sendPhoto(this._cid(), p, this._biz(e)); }
+  replyWithVideo(v, e = {}) { return this.api.sendVideo(this._cid(), v, this._biz(e)); }
+  replyWithAudio(a, e = {}) { return this.api.sendAudio(this._cid(), a, this._biz(e)); }
+  replyWithDocument(d, e = {}) { return this.api.sendDocument(this._cid(), d, this._biz(e)); }
+  replyWithAnimation(a, e = {}) { return this.api.sendAnimation(this._cid(), a, this._biz(e)); }
+  replyWithVoice(v, e = {}) { return this.api.sendVoice(this._cid(), v, { caption: e.caption, ...e }); }
+  replyWithVideoNote(v, e = {}) { return this.api.sendVideoNote(this._cid(), v, e); }
+  replyWithSticker(s, e = {}) { return this.api.sendSticker(this._cid(), s, e); }
+  replyWithMediaGroup(media, e = {}) { return this.api.sendMediaGroup(this._cid(), media, e); }
+  replyWithLocation(lat, lon, e = {}) { return this.api.sendLocation(this._cid(), lat, lon, e); }
+  replyWithVenue(lat, lon, title, address, e = {}) { return this.api.sendVenue(this._cid(), lat, lon, title, address, e); }
+  replyWithContact(phone, first, e = {}) { return this.api.sendContact(this._cid(), phone, first, e); }
+  replyWithPoll(question, options, e = {}) { return this.api.sendPoll(this._cid(), question, options, e); }
+  replyWithDice(emoji, e = {}) { return this.api.sendDice(this._cid(), emoji, e); }
+  replyWithInvoice(title, description, payload, currency, prices, e = {}) {
+    return this.api.sendInvoice(this._cid(), title, description, payload, currency, prices, e);
+  }
+  replyWithChatAction(action = 'typing', e = {}) { return this.api.sendChatAction(this._cid(), action, e); }
+
+  /* ---------- teruskan & salin ---------- */
+  forwardMessage(to, from, messageId, e = {}) {
+    if (messageId === undefined) return this.api.forwardMessage(to, this._cid(from), this.msgId, e || {});
+    return this.api.forwardMessage(to, from, messageId, e);
+  }
+  copyMessage(to, from, messageId, e = {}) {
+    if (messageId === undefined) return this.api.copyMessage(to, this._cid(from), this.msgId, e || {});
+    return this.api.copyMessage(to, from, messageId, e);
+  }
+
+  /* ---------- edit & hapus ---------- */
+  editMessageText(text, e = {}) {
+    if (this.inlineMessageId) return this.api.callApi('editMessageText', { inline_message_id: this.inlineMessageId, text, ...e });
+    const m = this.callback_query && this.callback_query.message;
+    return this.api.editMessageText(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, text, e);
+  }
+  editMessageCaption(e = {}) {
+    const m = this.callback_query && this.callback_query.message;
+    if (this.inlineMessageId) return this.api.callApi('editMessageCaption', { inline_message_id: this.inlineMessageId, ...e });
+    return this.api.editMessageCaption(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, e);
+  }
+  editMessageMedia(media, e = {}) {
+    const m = this.callback_query && this.callback_query.message;
+    if (this.inlineMessageId) return this.api.callApi('editMessageMedia', { inline_message_id: this.inlineMessageId, media, ...e });
+    return this.api.editMessageMedia(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, media, e);
+  }
+  editMessageReplyMarkup(e = {}) {
+    const m = this.callback_query && this.callback_query.message;
+    if (this.inlineMessageId) return this.api.callApi('editMessageReplyMarkup', { inline_message_id: this.inlineMessageId, ...e });
+    return this.api.editMessageReplyMarkup(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, e);
+  }
+  deleteMessage(chatId, messageId) {
+    if (messageId !== undefined) return this.api.deleteMessage(chatId, messageId);
+    const m = this.callback_query && this.callback_query.message;
+    return this.api.deleteMessage(m ? m.chat.id : this._cid(chatId), m ? m.message_id : this.msgId);
+  }
+  deleteMessages(ids) { return this.api.deleteMessages(this._cid(), ids); }
+  react(emoji = '👍', e = {}) {
+    const reaction = [{ type: 'emoji', emoji }];
+    return this.api.setMessageReaction(this._cid(), this.msgId, reaction, e);
+  }
+
+  /* ---------- callback & inline ---------- */
+  answerCallbackQuery(e = {}) {
+    if (typeof e === 'string') e = { text: e };
+    if (!this.callback_query) return Promise.resolve(false);
+    return this.api.answerCallbackQuery(this.callback_query.id, e);
+  }
+  answerInlineQuery(results, e = {}) {
+    if (!this.inline_query) return Promise.resolve(false);
+    return this.api.answerInlineQuery(this.inline_query.id, results, e);
+  }
+
+  /* ---------- admin & grup ---------- */
+  banChatMember(cid, uid, e = {}) { return this.api.banChatMember(cid, uid, e); }
+  unbanChatMember(cid, uid, e = {}) { return this.api.unbanChatMember(cid, uid, e); }
+  restrictChatMember(cid, uid, permissions, e = {}) { return this.api.restrictChatMember(cid, uid, permissions, e); }
+  kickChatMember(cid, uid, e = {}) { return this.api.banChatMember(cid, uid, e); } // alias
+  banAuthor(e = {}) { return this.api.banChatMember(this._cid(), this.from.id, e); }
+  kickAuthor(e = {}) { return this.api.banChatMember(this._cid(), this.from.id, e); }
+  restrictAuthor(permissions, e = {}) { return this.api.restrictChatMember(this._cid(), this.from.id, permissions, e); }
+  getChat(cid) { return this.api.getChat(this._cid(cid)); }
+  getChatAdministrators(cid) { return this.api.getChatAdministrators(this._cid(cid)); }
+  getChatMemberCount(cid) { return this.api.getChatMemberCount(this._cid(cid)); }
+  getChatMember(uid, cid) { return this.api.getChatMember(this._cid(cid), uid); }
+  getAuthor(cid) { return this.api.getChatMember(this._cid(cid), this.from.id); }
+  leaveChat(cid) { return this.api.leaveChat(this._cid(cid)); }
+  setChatTitle(title, cid) { return this.api.setChatTitle(this._cid(cid), title); }
+  setChatDescription(d, cid) { return this.api.setChatDescription(this._cid(cid), d); }
+  pinChatMessage(cid, mid, e = {}) { return this.api.pinChatMessage(this._cid(cid || undefined), mid !== undefined ? mid : this.msgId, e); }
+  unpinChatMessage(e = {}) { return this.api.unpinChatMessage(this._cid(), e); }
+
+  /* ---------- download ---------- */
+  /** getFile() pesan terkait (photo terbesar / document / voice / video) lalu unduh. */
+  async getFile() {
+    const m = this.msg || {};
+    const f = m.document || m.audio || m.video || m.voice || m.video_note || m.sticker ||
+      (Array.isArray(m.photo) && m.photo.length ? m.photo[m.photo.length - 1] : null) ||
+      m.animation;
+    if (!f) throw new Error('telebibz: ctx.msg tanpa file');
+    return this.api.getFile(f.file_id);
+  }
+  async downloadFile(dest) {
+    const f = await this.getFile();
+    require('fs');
+    const axios = require('axios');
+    const fs = require('fs');
+    const url = `https://api.telegram.org/file/bot${this.api.token}/${f.file_path}`;
+    const res = await axios.get(url, { responseType: 'stream' });
+    const out = fs.createWriteStream(dest);
+    await new Promise((ok, no) => { res.data.pipe(out); out.on('finish', ok); out.on('error', no); });
+    return dest;
+  }
+
+  /* ---------- re-export util ---------- */
+  static File() { return File; }
+}
+
+module.exports = { Context, msgOf };

package/lib/errors.js

@@ -0,0 +1,35 @@
+// lib/errors.js — terjemahan error Telegram jadi saran yang bisa ditindaklanjuti.
+'use strict';
+
+const HINTS = [
+  [/401|unauthorized|not found.*token|404/i, 'Token salah/kadaluarsa — buat ulang lewat @BotFather (/revoke).'],
+  [/chat not found/i, 'Chat tak ditemukan — user belum pernah /start botmu, atau ID chat salah.'],
+  [/bot was blocked/i, 'Bot diblokir pengguna — jangan kirim ulang, hapus dari daftar broadcast.'],
+  [/user is deactivated/i, 'Akun pengguna sudah dihapus.'],
+  [/not enough rights|not enough permission/i, 'Bot bukan admin / kekurangan hak di grup itu.'],
+  [/can.t parse entities/i, 'Format teks rusak — cek tag HTML/Markdown yang belum ditutup.'],
+  [/message is not modified/i, 'Isi pesan sama — edit dibatalkan Telegram (aman diabaikan).'],
+  [/message to delete not found/i, 'Pesan sudah terhapus lebih dulu.'],
+  [/too many requests|retry after/i, 'Kena rate limit — kirim lebih lambat (lihat bot.broadcast()).'],
+  [/query is too old|query id is invalid/i, 'Callback basi (>±1 menit) — abaikan, user klik tombol lama.'],
+  [/button_data_invalid|BUTTON_DATA_INVALID/i, 'callback_data >64 byte / kosong.'],
+  [/file is too big/i, 'File >50 MB (limit upload bot).'],
+  [/wrong file identifier/i, 'file_id usang — kirim ulang dari sumbernya.'],
+  [/group chat was upgraded/i, 'Grup berubah jadi supergroup — pakai chat ID baru.'],
+  [/can't initiate conversation/i, 'Bot tak bisa PM user duluan — minta user /start botmu.'],
+];
+
+/** Ubah error telegraf/grammy jadi { pesan, saran } bahasa manusia. */
+function humanize(err) {
+  const desc =
+    (err && (err.description || err.message)) || String(err);
+  const found = HINTS.find(([re]) => re.test(desc));
+  return {
+    pesan: desc,
+    saran: found ? found[1] : null,
+    method: err && err.method,
+    code: err && (err.error_code || err.code),
+  };
+}
+
+module.exports = { humanize, HINTS };

package/lib/file.js

@@ -0,0 +1,41 @@
+// lib/file.js — file kiriman (Buffer | path | stream) + builder InputMedia.
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+let mime = null;
+try { mime = require('mime-types'); } catch { /* opsional */ }
+
+class File {
+  constructor(src, filename, type) {
+    this.src = src;
+    this.filename = filename || (typeof src === 'string' ? path.basename(src) : 'file');
+    this.type = type || (mime ? (mime.lookup(this.filename) || undefined) : undefined);
+    this._attachId = Math.random().toString(36).slice(2);
+  }
+  attachName(field) { return `${field}_${this._attachId}`; }
+  async data() {
+    if (Buffer.isBuffer(this.src)) return this.src;
+    if (this.src instanceof Uint8Array) return Buffer.from(this.src);
+    if (typeof this.src === 'string') return fs.promises.readFile(this.src);
+    if (this.src && this.src.path && fs.existsSync(this.src.path)) return fs.promises.readFile(this.src.path); // stream fs
+    if (this.src && typeof this.src[Symbol.asyncIterator] === 'function') {
+      const chunks = [];
+      for await (const c of this.src) chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+      return Buffer.concat(chunks);
+    }
+    throw new Error('telebibz File: sumber tidak dikenal (Buffer/path/stream)');
+  }
+}
+class InputFile extends File {}
+
+/** Builder media grup (album): media.photo(src, {caption}), .video(...), ... */
+const InputMediaBuilder = {
+  photo: (media, extra = {}) => ({ type: 'photo', media, ...extra }),
+  video: (media, extra = {}) => ({ type: 'video', media, ...extra }),
+  document: (media, extra = {}) => ({ type: 'document', media, ...extra }),
+  audio: (media, extra = {}) => ({ type: 'audio', media, ...extra }),
+  animation: (media, extra = {}) => ({ type: 'animation', media, ...extra }),
+};
+
+module.exports = { File, InputFile, InputMediaBuilder };

package/lib/inline-query.js

@@ -0,0 +1,28 @@
+// lib/inline-query.js — helper mode inline: matcher query + builder hasil.
+'use strict';
+
+/** bot.inlineQuery(/kucing|anjing/i, handler) atau bot.inlineQuery('*', handler) */
+function matchInlineQuery(trigger) {
+  return (ctx) => {
+    const q = ctx.inline_query;
+    if (!q) return false;
+    if (trigger === undefined || trigger === '*') return true;
+    const list = [].concat(trigger);
+    const text = q.query || '';
+    return list.some((t) => t instanceof RegExp ? t.test(text) : text.toLowerCase().includes(String(t).toLowerCase()));
+  };
+}
+
+/** Builder hasil inline (persis spek Bot API). */
+const iq = {
+  article: (id, title, extra = {}) => ({ type: 'article', id: String(id), title, input_message_content: { message_text: extra.message_text || title, ...(extra.input_message_content || {}) }, ...omit(extra, ['message_text', 'input_message_content']) }),
+  photo: (id, url, thumb, extra = {}) => ({ type: 'photo', id: String(id), photo_url: url, thumbnail_url: thumb || url, ...extra }),
+  gif: (id, url, thumb, extra = {}) => ({ type: 'gif', id: String(id), gif_url: url, thumbnail_url: thumb || url, ...extra }),
+  video: (id, url, thumb, title, extra = {}) => ({ type: 'video', id: String(id), video_url: url, thumbnail_url: thumb, title, mime_type: 'video/mp4', input_message_content: { message_text: url }, ...extra }),
+  audio: (id, url, title, extra = {}) => ({ type: 'audio', id: String(id), audio_url: url, title, ...extra }),
+  location: (id, lat, lon, title, extra = {}) => ({ type: 'location', id: String(id), latitude: lat, longitude: lon, title, ...extra }),
+  sticker: (id, fileId, extra = {}) => ({ type: 'sticker', id: String(id), sticker_file_id: fileId, ...extra }),
+};
+function omit(o, keys) { const c = { ...o }; for (const k of keys) delete c[k]; return c; }
+
+module.exports = { matchInlineQuery, iq };

package/lib/keyboard.js

@@ -0,0 +1,83 @@
+// lib/keyboard.js — pembangun tombol inline, tanpa perlu tahu struktur mentah API.
+'use strict';
+
+/**
+ * Buat tombol callback.
+ *   btn('Menu', 'menu')
+ *   btn('Hapus', 'del', 'danger')                      // warna merah
+ *   btn('Gas', 'go', 'success', '5408846744727334338') // + ikon animated
+ * Warna (Bot API 9.4): 'danger' merah · 'success' hijau · 'primary' biru/ungu.
+ * iconId = custom_emoji_id animated (butuh Premium owner / username Fragment).
+ */
+function btn(text, callbackData, style, iconId) {
+  const b = { text, callback_data: String(callbackData) };
+  if (style) b.style = style;
+  if (iconId) b.icon_custom_emoji_id = String(iconId);
+  return b;
+}
+
+/** Tombol tautan (membuka URL). */
+function url(text, link, style, iconId) {
+  const b = { text, url: String(link) };
+  if (style) b.style = style;
+  if (iconId) b.icon_custom_emoji_id = String(iconId);
+  return b;
+}
+
+/** Tombol WebApp (khusus chat pribadi). */
+function webApp(text, link, iconId) {
+  const b = { text, web_app: { url: String(link) } };
+  if (iconId) b.icon_custom_emoji_id = String(iconId);
+  return b;
+}
+
+/** Tombol salin teks ke clipboard. */
+function copy(text, value, iconId) {
+  const b = { text, copy_text: { text: String(value) } };
+  if (iconId) b.icon_custom_emoji_id = String(iconId);
+  return b;
+}
+
+/**
+ * Susun keyboard dari array 2 dimensi baris-kolom, lalu kirim apa adanya lewat
+ * ctx.reply(..., { keyboard: kb([...]) }) atau simpan sebagai markup.
+ */
+function kb(rows) {
+  return { reply_markup: { inline_keyboard: rows } };
+}
+
+/** Versi markup polos (untuk editMessageReplyMarkup dll). */
+kb.markup = (rows) => ({ inline_keyboard: rows });
+
+/** Tiga gaya warna dalam satu baris (pola konfirmasi umum). */
+kb.confirm = (yesData, noData, labelYes = '✅ Ya', labelNo = '❌ Batal') =>
+  kb([[btn(labelYes, yesData, 'success'), btn(labelNo, noData, 'danger')]]);
+
+module.exports = { btn, url, webApp, copy, kb };
+
+/* ===== kelas builder fluent (kompat gaya grammY) ===== */
+class InlineKeyboard {
+  constructor(initRows = []) { this.rows = initRows; }
+  _add(b) { (this.rows[this.rows.length - 1] || (this.rows.push([]), this.rows[this.rows.length - 1])).push(b); return this; }
+  text(t, data, style, iconId) { return this._add(btn(t, data, style, iconId)); }
+  url(t, link, style, iconId) { return this._add(url(t, link, style, iconId)); }
+  webApp(t, link, iconId) { return this._add(webApp(t, link, iconId)); }
+  copy(t, v, iconId) { return this._add(copy(t, v, iconId)); }
+  row() { if (this.rows[this.rows.length - 1].length) this.rows.push([]); return this; }
+  build() { return { reply_markup: { inline_keyboard: this.rows.filter((r) => r.length) } }; }
+}
+class Keyboard {
+  constructor() { this.rows = [[]]; this.opts = { resize_keyboard: true }; }
+  _add(b) { this.rows[this.rows.length - 1].push(b); return this; }
+  text(t) { return this._add({ text: t }); }
+  requestContact(t) { return this._add({ text: t, request_contact: true }); }
+  requestLocation(t) { return this._add({ text: t, request_location: true }); }
+  row() { if (this.rows[this.rows.length - 1].length) this.rows.push([]); return this; }
+  resized(v = true) { this.opts.resize_keyboard = v; return this; }
+  oneTime(v = true) { this.opts.one_time_keyboard = v; return this; }
+  build() {
+    return { reply_markup: { keyboard: this.rows.filter((r) => r.length), ...this.opts } };
+  }
+}
+
+module.exports = { btn, url, webApp, copy, kb, InlineKeyboard, Keyboard };

package/lib/logger.js

@@ -0,0 +1,38 @@
+// lib/logger.js — log terminal cantik tanpa dependency.
+'use strict';
+
+const C = {
+  reset: '', dim: '', bold: '',
+  red: '', green: '', yellow: '', blue: '',
+  magenta: '', cyan: '', gray: '',
+};
+
+function paint(code, s) {
+  return process.stdout && process.stdout.isTTY ? `${C[code]}${s}${C.reset}` : String(s);
+}
+
+function stamp() {
+  return paint('gray', new Date().toLocaleTimeString('id-ID', { hour12: false }));
+}
+
+const log = {
+  info: (...a) => console.log(`${stamp()} ${paint('cyan', 'ℹ')} `, ...a),
+  ok:   (...a) => console.log(`${stamp()} ${paint('green', '✔')} `, ...a),
+  warn: (...a) => console.warn(`${stamp()} ${paint('yellow', '⚠')} `, ...a),
+  error:(...a) => console.error(`${stamp()} ${paint('red', '✖')} `, ...a),
+  paint,
+};
+
+/** Banner ASCII saat bot nyala. */
+log.banner = (title, rows) => {
+  const width = Math.max(title.length, ...rows.map((r) => strip(r).length)) + 2;
+  const line = '─'.repeat(width + 2);
+  console.log(`┌${line}┐`);
+  console.log(`│  ${paint('bold', title)}${' '.repeat(width - title.length)}│`);
+  for (const r of rows) console.log(`│  ${r}${' '.repeat(Math.max(0, width - strip(r).length))}│`);
+  console.log(`└${line}┘`);
+};
+
+function strip(s) { return String(s).replace(/\[\d+m/g, ''); }
+
+module.exports = log;

package/lib/menus.js

@@ -0,0 +1,90 @@
+// lib/menus.js — Menu inline ala @grammyjs/menu (mandiri, tanpa dep tambahan).
+'use strict';
+
+const { Composer } = require('./composer');
+
+const re = (s) => String(s).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+/**
+ * const menu = new Menu('cfg');
+ * menu.text('🔔 Notif', async (ctx) => ctx.answerCallbackQuery('ditekan!'))
+ *     .row()
+ *     .url('Web', 'https://x')
+ *     .submenu('Lanjut ▶', 'cfg-lanjut');
+ *
+ * bot.use(menu);                          // handler tombol terdaftar otomatis
+ * bot.cmd('cfg', async (ctx) =>
+ *   ctx.reply('Menu:', { reply_markup: await menu.render(ctx) }));
+ */
+class Menu extends Composer {
+  constructor(id) {
+    super();
+    this.id = id;
+    this._ops = [];
+    this.callbackQuery(new RegExp(`^${re(id)}\\|`), async (ctx) => {
+      const i = Number(ctx.callback_query.data.slice(id.length + 1));
+      const op = this._ops[i];
+      if (!op) return ctx.answerCallbackQuery({ text: '⌛ Tombol usang — kirim ulang menunya', show_alert: true }).catch(() => {});
+      if (op.type === 'text' && op.handler) return op.handler(ctx);
+      if (op.type === 'submenu') {
+        const target = this._menus && this._menus.get(op.target);
+        if (target) {
+          try { await ctx.editMessageReplyMarkup({ reply_markup: await target.render(ctx) }); }
+          catch { /* pesan mungkin termodifikasi */ }
+          return ctx.answerCallbackQuery().catch(() => {});
+        }
+      }
+      return ctx.answerCallbackQuery().catch(() => {});
+    });
+  }
+
+  _add(o) { this._ops.push(o); return this; }
+
+  /** Tombol teks + handler saat ditekan. */
+  text(label, handler) { return this._add({ type: 'text', label, handler }); }
+  /** Tombol tautan. */
+  url(label, link, opts = {}) { return this._add({ type: 'url', label, link, opts }); }
+  /** Tombol WebApp. */
+  webApp(label, link) { return this._add({ type: 'webApp', label, link }); }
+  /** Tombol pindah ke menu lain dengan id target (Menu diregister lewat container). */
+  submenu(label, targetId) { return this._add({ type: 'submenu', label, target: targetId }); }
+  /** Baris baru. */
+  row() { return this._add({ type: 'row' }); }
+  /** Shortcut: kembali ke menu parent. */
+  back(label = '◀️ Kembali', parentId) { return this.submenu(label, parentId); }
+
+  /** Render keyboard (inline_keyboard). */
+  async render(ctx) {
+    const rows = [[]];
+    const push = (b) => rows[rows.length - 1].push(b);
+    for (let i = 0; i < this._ops.length; i++) {
+      const o = this._ops[i];
+      if (o.type === 'row') { rows.push([]); continue; }
+      if (o.type === 'url') { push({ text: o.label, url: o.link, ...(o.opts.style ? { style: o.opts.style } : {}), ...(o.opts.iconId ? { icon_custom_emoji_id: o.opts.iconId } : {}) }); continue; }
+      if (o.type === 'webApp') { push({ text: o.label, web_app: { url: o.link } }); continue; }
+      push({ text: o.label, callback_data: `${this.id}|${i}` });
+    }
+    return { inline_keyboard: rows.filter((r) => r.length) };
+  }
+}
+
+/**
+ * Wadah beberapa menu terkait (dengan submenu silang):
+ *   const mc = new MenuContainer();
+ *   const utama = mc.create('utama'), lanjut = mc.create('lanjut');
+ *   utama.submenu('Lanjut ▶', 'lanjut'); lanjut.back('◀️', 'utama');
+ *   bot.use(mc);
+ */
+class MenuContainer extends Composer {
+  constructor() { super(); this._menus = new Map(); }
+  create(id) {
+    const m = new Menu(id);
+    m._menus = this._menus;
+    this._menus.set(id, m);
+    this.use(m);
+    return m;
+  }
+  get(id) { return this._menus.get(id); }
+}
+
+module.exports = { Menu, MenuContainer };

package/lib/net.js

@@ -0,0 +1,115 @@
+// lib/net.js — transport Bot API production-grade (axios keep-alive, proxy, timeout,
+// multipart attach://, 429 retry_after handler, debug logging).
+'use strict';
+
+const axios = require('axios');
+const http = require('http');
+const https = require('https');
+const dbg = require('debug')('telebibz:net');
+let HttpsProxyAgent = null;
+try { ({ HttpsProxyAgent } = require('https-proxy-agent')); } catch { /* proxy opsional */ }
+
+const { File } = require('./file');
+const mime = require('mime-types');
+
+/** Error API Telegram dengan konteks debugging. */
+class ApiError extends Error {
+  constructor(description, errorCode, method, payload, parameters) {
+    super(description);
+    this.name = 'ApiError';
+    this.description = description;
+    this.error_code = errorCode;
+    this.parameters = parameters || {};
+    this.method = method;
+    this.payload = payload;
+  }
+}
+
+const keepAliveHttp = new http.Agent({ keepAlive: true, maxSockets: 64 });
+const keepAliveHttps = new https.Agent({ keepAlive: true, maxSockets: 64 });
+
+/**
+ * Bangun fungsi transport (method, payload) => result.
+ * opts: { apiRoot, proxy, timeoutMs, headers }
+ */
+function createTransport(token, opts = {}) {
+  const apiRoot = (opts.apiRoot || 'https://api.telegram.org').replace(/\/$/, '');
+  const agent = opts.proxy && HttpsProxyAgent ? new HttpsProxyAgent(opts.proxy) : keepAliveHttps;
+  const client = axios.create({
+    baseURL: `${apiRoot}/bot${token}/`,
+    httpAgent: keepAliveHttp,
+    httpsAgent: agent,
+    timeout: opts.timeoutMs || 35000, // sedikit > long-poll 25s
+    headers: opts.headers || {},
+    maxContentLength: Infinity,
+    maxBodyLength: Infinity,
+    proxy: false, // kendalikan lewat httpsAgent sendiri
+  });
+
+  return async function transport(method, payload = {}) {
+    dbg('--> %s %s', method, JSON.stringify(payload, safeReplacer).slice(0, 400));
+    const files = [];
+    // Deep-walk: File di MANA PUN (media[i].media, photo top-level, thumbnail, dll)
+    const clean = collectAttach(payload, files);
+
+    let data, config = {};
+    if (files.length) {
+      const fd = new FormData();
+      for (const [k, v] of Object.entries(clean)) fd.append(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
+      for (const [an, f] of files) {
+        const buf = await f.data();
+        fd.append(an, new Blob([buf], { type: f.type || mime.lookup(f.filename) || 'application/octet-stream' }), f.filename || an);
+      }
+      data = fd;
+    } else {
+      data = JSON.stringify(clean);
+      config.headers = { 'Content-Type': 'application/json' };
+    }
+
+    let res;
+    try {
+      res = await client.post(method, data, config);
+    } catch (err) {
+      if (err.response && err.response.data) {
+        const d = err.response.data;
+        dbg('<-- ERR %s: %s', method, d.description);
+        throw new ApiError(d.description || `HTTP ${err.response.status}`, d.error_code || err.response.status, method, payload, d.parameters);
+      }
+      // error jaringan murni: tag agar Runner menganggapnya sementara
+      err.network = !err.response;
+      dbg('<-- NETWORK ERR %s: %s', method, err.message);
+      throw err;
+    }
+    const env = res.data;
+    if (!env.ok) {
+      dbg('<-- ERR %s: %s', method, env.description);
+      throw new ApiError(env.description || 'unknown error', env.error_code, method, payload, env.parameters);
+    }
+    dbg('<-- OK %s', method);
+    return env.result;
+  };
+}
+
+/** Rekursif: salin payload sambil mengganti File jadi "attach://fileN". */
+function collectAttach(value, files) {
+  if (value instanceof File) {
+    const an = `file${files.length}`;
+    files.push([an, value]);
+    return `attach://${an}`;
+  }
+  if (Array.isArray(value)) return value.map((v) => collectAttach(v, files));
+  if (value && typeof value === 'object') {
+    const o = {};
+    for (const [k, v] of Object.entries(value)) {
+      if (v === undefined || v === null) continue;
+      o[k] = collectAttach(v, files);
+    }
+    return o;
+  }
+  return value;
+}
+
+/** JSON.stringify yang aman terhadap File (untuk debug log). */
+function safeReplacer(k, v) { return v instanceof File ? `<File:${v.filename}>` : v; }
+
+module.exports = { createTransport, ApiError };