@xbibzlibrary/telebibz 0.4.5 → 3.1.1

package/lib/composer.js

@@ -0,0 +1,174 @@
+// lib/composer.js — mesin middleware & routing filter (recoded, konsep gaya grammY).
+'use strict';
+
+const { msgOf } = require('./context');
+
+/* ---------- matcher filter ---------- */
+const UPDATE_FIELDS = {
+  message: (u) => u.message, edited_message: (u) => u.edited_message,
+  channel_post: (u) => u.channel_post, edited_channel_post: (u) => u.edited_channel_post,
+  business_message: (u) => u.business_message, edited_business_message: (u) => u.edited_business_message,
+  callback_query: (u) => u.callback_query, inline_query: (u) => u.inline_query,
+  chat_join_request: (u) => u.chat_join_request, chat_member: (u) => u.chat_member,
+  my_chat_member: (u) => u.my_chat_member, message_reaction: (u) => u.message_reaction,
+  message_reaction_count: (u) => u.message_reaction_count,
+  business_connection: (u) => u.business_connection, poll: (u) => u.poll, poll_answer: (u) => u.poll_answer,
+  chosen_inline_result: (u) => u.chosen_inline_result, shipping_query: (u) => u.shipping_query,
+  pre_checkout_query: (u) => u.pre_checkout_query, purchased_paid_media: (u) => u.purchased_paid_media,
+};
+const MSG_PROPS = {
+  text: (m) => typeof m.text === 'string', caption: (m) => typeof m.caption === 'string',
+  photo: (m) => Array.isArray(m.photo), video: (m) => !!m.video, audio: (m) => !!m.audio,
+  voice: (m) => !!m.voice, video_note: (m) => !!m.video_note, document: (m) => !!m.document,
+  sticker: (m) => !!m.sticker, animation: (m) => !!m.animation, location: (m) => !!m.location,
+  contact: (m) => !!m.contact, poll: (m) => !!m.poll, venue: (m) => !!m.venue,
+  dice: (m) => !!m.dice, game: (m) => !!m.game, invoice: (m) => !!m.invoice,
+  new_chat_members: (m) => Array.isArray(m.new_chat_members), left_chat_member: (m) => !!m.left_chat_member,
+  successful_payment: (m) => !!m.successful_payment, web_app_data: (m) => !!m.web_app_data,
+  via_bot: (m) => !!m.via_bot, reply_to_message: (m) => !!m.reply_to_message, entities: (m) => Array.isArray(m.entities),
+  media: (m) => Array.isArray(m.photo) || !!m.video || !!m.document || !!m.audio,
+  data: () => false, // khusus callback_query ditangani di bawah
+  successful_payment: (m) => !!m.successful_payment,
+};
+
+/** filter 'message:photo', ':text', 'callback_query': → fungsi (ctx) => boolean */
+function compileFilter(str) {
+  // ':prop' → pesan (atau edited/channel/business) dengan properti tsb — gaya grammY
+  if (String(str).startsWith(':')) {
+    const prop = String(str).slice(1);
+    const test = MSG_PROPS[prop];
+    if (test) return (ctx) => { const m = msgOf(ctx.update); return !!m && test(m); };
+    return () => false;
+  }
+  const [head, prop] = String(str).split(':');
+  if (head === 'chat_type') return (ctx) => { const c = ctx.chat; return !!c && c.type === prop; };
+  if (head === 'callback_query' && prop === 'data') return (ctx) => !!(ctx.callback_query && typeof ctx.callback_query.data === 'string');
+  if (head && prop) {
+    const get = UPDATE_FIELDS[head];
+    const test = MSG_PROPS[prop];
+    if (get && test) return (ctx) => { const m = get(ctx.update); return !!m && test(m); };
+    if (get) return (ctx) => !!get(ctx.update);
+    if (test) return (ctx) => { const m = msgOf(ctx.update); return !!m && test(m); };
+  }
+  if (UPDATE_FIELDS[head]) return (ctx) => !!UPDATE_FIELDS[head](ctx.update);
+  if (MSG_PROPS[head]) return (ctx) => { const m = msgOf(ctx.update); return !!m && MSG_PROPS[head](m); };
+  return () => false;
+}
+
+/* ---------- composer ---------- */
+class Composer {
+  constructor(...mw) { this.stack = []; for (const m of mw) this.use(m); }
+
+  use(...mw) {
+    for (const m of mw) {
+      const fn = m instanceof Composer ? m.middleware() : m;
+      this.stack.push({ match: () => true, fns: [fn] });
+    }
+    return this;
+  }
+  on(filter, ...mw) { [].concat(filter).forEach((f) => this.stack.push({ match: compileFilter(f), fns: mw })); return this; }
+  hears(re, ...mw) {
+    [].concat(re).forEach((r) => this.stack.push({
+      match: (ctx) => { const m = msgOf(ctx.update); const t = m && (m.text || m.caption || ''); return !!t && r.test(t); },
+      fns: mw,
+    }));
+    return this;
+  }
+  command(names, ...mw) {
+    const set = [].concat(names).map((n) => String(n).toLowerCase());
+    this.stack.push({
+      match: (ctx) => {
+        const m = msgOf(ctx.update);
+        if (!m || typeof m.text !== 'string') return false;
+        const mobj = /^\/([A-Za-z0-9_]+)(?:@([A-Za-z0-9_]+))?(\s|$)/.exec(m.text);
+        if (!mobj) return false;
+        if (!set.includes(mobj[1].toLowerCase())) return false;
+        if (mobj[2] && ctx.me && ctx.me.username && mobj[2].toLowerCase() !== ctx.me.username.toLowerCase()) return false;
+        ctx.match = m.text.slice(mobj[0].length); // argumen setelah perintah
+        return true;
+      },
+      fns: mw,
+    });
+    return this;
+  }
+  callbackQuery(trigs, ...mw) {
+    const list = [].concat(trigs);
+    this.stack.push({
+      match: (ctx) => {
+        const q = ctx.callback_query || ctx.update.callback_query;
+        if (!q || typeof q.data !== 'string') return false;
+        return list.some((t) => t instanceof RegExp ? t.test(q.data) : String(t) === q.data);
+      },
+      fns: mw,
+    });
+    return this;
+  }
+
+  /** Jalankan mw hanya jika pred true. */
+  filter(pred, ...mw) { const c = new Composer(...mw); this.use(async (ctx, next) => (await pred(ctx) ? c.run(ctx, next) : next())); return c; }
+  /** Lewati mw jika pred true. */
+  drop(pred, ...mw) { const c = new Composer(...mw); this.use(async (ctx, next) => (await pred(ctx) ? undefined : c.run(ctx, next))); return c; }
+  /** Cabang dua: pred ? A : B. */
+  branch(pred, a, b) { const ca = new Composer(a), cb = new Composer(b); this.use(async (ctx, next) => (await pred(ctx) ? ca.run(ctx, next) : cb.run(ctx, next))); return this; }
+  /** Petakan ctx→key ke composer berbeda: route('type',{private:c, group:c2}) */
+  route(router, by) {
+    const map = new Map(Object.entries(by).map(([k, v]) => [k, v instanceof Composer ? v : new Composer(v)]));
+    this.use(async (ctx, next) => { const k = typeof router === 'function' ? await router(ctx) : ctx[router]; const c = map.get(k); return c ? c.run(ctx, next) : next(); });
+    return this;
+  }
+  /** Bangun mw malas per-update: lazy((ctx)=>ctx.from?.is_bot?botmw:usermw) */
+  lazy(factory) { this.use(async (ctx, next) => { const mw = await factory(ctx); const c = new Composer(...(Array.isArray(mw) ? mw : [mw]).filter(Boolean)); return c.run(ctx, next); }); return this; }
+  /** Jalankan mw DI LATAR BELAKANG (tidak menahan next) — cocok untuk tugas lambat. */
+  fork(...mw) { const c = new Composer(...mw); this.use((ctx, next) => { c.run(ctx).then(()=>{},(e)=>ctx.api && console.error('[telebibz:fork]', e.message)); return next(); }); return this; }
+
+  /** Lindungi subpohon middleware dengan handler error — pola batas rambu grammY. */
+  errorBoundary(handler, ...mw) {
+    const sub = new Composer(...mw);
+    this.use(async (ctx, next) => {
+      let called = false;
+      const cont = () => ((called = true), Promise.resolve());
+      try { await sub.run(ctx, cont); }
+      catch (err) { called = false; await handler(new BotError(err, ctx), cont); }
+      if (called) return next();
+    });
+    return sub;
+  }
+
+  /** Jalankan rantai middleware terhadap satu ctx. */
+  async run(ctx, next) {
+    const entries = this.stack;
+    let idx = -1;
+    const dispatch = async (i) => {
+      if (i <= idx) throw new Error('next() dipanggil dua kali');
+      idx = i;
+      if (i >= entries.length) return next ? next() : undefined;
+      const e = entries[i];
+      if (!e.match(ctx)) return dispatch(i + 1);
+      let continued = false;
+      for (let j = 0; j < e.fns.length; j++) {
+        const isLast = j === e.fns.length - 1;
+        let stepNext = false;
+        const r = await e.fns[j](ctx, async () => {
+          stepNext = true;
+          if (isLast) { continued = true; return dispatch(i + 1); }
+        });
+        if (!stepNext) return r; // handler berhenti di sini (tak lanjut middleware)
+      }
+      if (!continued) return undefined;
+    };
+    return dispatch(0);
+  }
+  middleware() { return (ctx, next) => this.run(ctx, next); }
+}
+
+/** Error yang dibungkus konteksnya, gaya BotError grammY. */
+class BotError extends Error {
+  constructor(err, ctx) {
+    super(err && err.message ? err.message : String(err));
+    this.name = 'BotError';
+    this.error = err;
+    this.ctx = ctx;
+  }
+}
+
+module.exports = { Composer, BotError, compileFilter };

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;