@xbibzlibrary/telebibz 3.1.2 → 3.1.3

package/lib/context.js

@@ -8,15 +8,18 @@ const fs = require('fs');
 /** 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;
+    update.edited_channel_post || update.business_message || update.edited_business_message ||
+    update.guest_message || null;
 }
 
 const UPDATE_KEYS = [
   'message', 'edited_message', 'channel_post', 'edited_channel_post',
-  'business_message', 'edited_business_message', 'callback_query', 'inline_query',
+  'business_message', 'edited_business_message', 'deleted_business_messages', 'guest_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',
+  'chat_boost', 'removed_chat_boost', 'stopped_message_generation',
 ];
 
 class Context {
@@ -37,6 +40,10 @@ class Context {
     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;
+    if (this.deleted_business_messages) return this.deleted_business_messages.chat;
+    if (this.chat_boost) return this.chat_boost.chat;
+    if (this.removed_chat_boost) return this.removed_chat_boost.chat;
+    if (this.stopped_message_generation) return this.stopped_message_generation.chat;
     return undefined;
   }
   get from() {
@@ -49,9 +56,11 @@ class Context {
   get chatId() { const c = this.chat; return c ? c.id : undefined; }
   get msgId() { return this.msg ? this.msg.message_id : undefined; }
   get businessConnectionId() {
+    const msg = this.msg || (this.callback_query && this.callback_query.message);
     return (this.business_connection && this.business_connection.id) ||
-      (this.msg && this.msg.business_connection_id) || undefined;
+      (msg && msg.business_connection_id) || undefined;
   }
+  get guestQueryId() { return this.msg && this.msg.guest_query_id; }
   get senderChat() { return this.msg ? this.msg.sender_chat : undefined; }
   get inlineMessageId() { return this.callback_query ? this.callback_query.inline_message_id : undefined; }
 
@@ -62,13 +71,33 @@ class Context {
     return c;
   }
   _biz(extra = {}) {
-    // Otomatis sertakan business_connection_id pada pesan business (gaya BizWrapper)
+    // Sertakan business_connection_id untuk pesan business, termasuk callback atas pesannya.
+    const msg = this.msg || (this.callback_query && this.callback_query.message);
     const bc = this.businessConnectionId;
-    return bc && this.msg && this.msg.business_connection_id ? { business_connection_id: bc, ...extra } : extra;
+    return bc && msg && 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)); }
+  replyWithRichMessage(richMessage, extra = {}) {
+    return this.api.sendRichMessage({ chat_id: this._cid(), rich_message: richMessage, ...this._biz(extra) });
+  }
+  replyWithLivePhoto(livePhoto, photo, extra = {}) {
+    return this.api.sendLivePhoto({ chat_id: this._cid(), live_photo: livePhoto, photo, ...this._biz(extra) });
+  }
+  replyEphemeral(text, receiverUserId, extra = {}) {
+    const { ephemeral_message_parameters = {}, ...other } = extra;
+    return this.api.sendMessage(this._cid(), text, {
+      ...this._biz(other),
+      ephemeral_message_parameters: { ...ephemeral_message_parameters, receiver_user_id: receiverUserId },
+    });
+  }
+  sendMessageDraft(draftId, text, extra = {}) {
+    return this.api.sendMessageDraft({ chat_id: this._cid(), draft_id: draftId, text, ...this._biz(extra) });
+  }
+  sendRichMessageDraft(draftId, richMessage, extra = {}) {
+    return this.api.sendRichMessageDraft({ chat_id: this._cid(), draft_id: draftId, rich_message: richMessage, ...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)); }
@@ -76,19 +105,19 @@ class Context {
   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); }
+  replyWithVoice(v, e = {}) { return this.api.sendVoice(this._cid(), v, this._biz(e)); }
+  replyWithVideoNote(v, e = {}) { return this.api.sendVideoNote(this._cid(), v, this._biz(e)); }
+  replyWithSticker(s, e = {}) { return this.api.sendSticker(this._cid(), s, this._biz(e)); }
+  replyWithMediaGroup(media, e = {}) { return this.api.sendMediaGroup(this._cid(), media, this._biz(e)); }
+  replyWithLocation(lat, lon, e = {}) { return this.api.sendLocation(this._cid(), lat, lon, this._biz(e)); }
+  replyWithVenue(lat, lon, title, address, e = {}) { return this.api.sendVenue(this._cid(), lat, lon, title, address, this._biz(e)); }
+  replyWithContact(phone, first, e = {}) { return this.api.sendContact(this._cid(), phone, first, this._biz(e)); }
+  replyWithPoll(question, options, e = {}) { return this.api.sendPoll(this._cid(), question, options, this._biz(e)); }
+  replyWithDice(emoji, e = {}) { return this.api.sendDice(this._cid(), emoji, this._biz(e)); }
   replyWithInvoice(title, description, payload, currency, prices, e = {}) {
-    return this.api.sendInvoice(this._cid(), title, description, payload, currency, prices, e);
+    return this.api.sendInvoice(this._cid(), title, description, payload, currency, prices, this._biz(e));
   }
-  replyWithChatAction(action = 'typing', e = {}) { return this.api.sendChatAction(this._cid(), action, e); }
+  replyWithChatAction(action = 'typing', e = {}) { return this.api.sendChatAction(this._cid(), action, this._biz(e)); }
 
   /* ---------- teruskan & salin ---------- */
   forwardMessage(to, from, messageId, e = {}) {
@@ -104,22 +133,50 @@ class Context {
   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);
+    return this.api.editMessageText(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, text, this._biz(e));
+  }
+  editRichMessage(richMessage, e = {}) {
+    const m = this.callback_query && this.callback_query.message;
+    if (this.inlineMessageId) return this.api.callApi('editMessageText', { inline_message_id: this.inlineMessageId, rich_message: richMessage, ...e });
+    return this.api.callApi('editMessageText', {
+      chat_id: this._cid(m ? m.chat.id : undefined),
+      message_id: m ? m.message_id : this.msgId,
+      rich_message: richMessage,
+      ...this._biz(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);
+    return this.api.editMessageCaption(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, this._biz(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);
+    return this.api.editMessageMedia(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, media, this._biz(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);
+    return this.api.editMessageReplyMarkup(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, this._biz(e));
+  }
+  editEphemeralMessageText(receiverUserId, ephemeralMessageId, text, extra = {}) {
+    return this.api.editEphemeralMessageText({ chat_id: this._cid(), receiver_user_id: receiverUserId, ephemeral_message_id: ephemeralMessageId, text, ...extra });
+  }
+  editEphemeralRichMessage(receiverUserId, ephemeralMessageId, richMessage, extra = {}) {
+    return this.api.editEphemeralMessageText({ chat_id: this._cid(), receiver_user_id: receiverUserId, ephemeral_message_id: ephemeralMessageId, rich_message: richMessage, ...extra });
+  }
+  editEphemeralMessageMedia(receiverUserId, ephemeralMessageId, media, extra = {}) {
+    return this.api.editEphemeralMessageMedia({ chat_id: this._cid(), receiver_user_id: receiverUserId, ephemeral_message_id: ephemeralMessageId, media, ...extra });
+  }
+  editEphemeralMessageCaption(receiverUserId, ephemeralMessageId, extra = {}) {
+    return this.api.editEphemeralMessageCaption({ chat_id: this._cid(), receiver_user_id: receiverUserId, ephemeral_message_id: ephemeralMessageId, ...extra });
+  }
+  editEphemeralMessageReplyMarkup(receiverUserId, ephemeralMessageId, extra = {}) {
+    return this.api.editEphemeralMessageReplyMarkup({ chat_id: this._cid(), receiver_user_id: receiverUserId, ephemeral_message_id: ephemeralMessageId, ...extra });
+  }
+  deleteEphemeralMessage(receiverUserId, ephemeralMessageId) {
+    return this.api.deleteEphemeralMessage({ chat_id: this._cid(), receiver_user_id: receiverUserId, ephemeral_message_id: ephemeralMessageId });
   }
   deleteMessage(chatId, messageId) {
     if (messageId !== undefined) return this.api.deleteMessage(chatId, messageId);
@@ -128,8 +185,9 @@ class Context {
   }
   deleteMessages(ids) { return this.api.deleteMessages(this._cid(), ids); }
   react(emoji = '👍', e = {}) {
+    const m = this.callback_query && this.callback_query.message;
     const reaction = [{ type: 'emoji', emoji }];
-    return this.api.setMessageReaction(this._cid(), this.msgId, reaction, e);
+    return this.api.setMessageReaction(this._cid(m ? m.chat.id : undefined), m ? m.message_id : this.msgId, reaction, e);
   }
 
   /* ---------- callback & inline ---------- */
@@ -142,6 +200,10 @@ class Context {
     if (!this.inline_query) return Promise.resolve(false);
     return this.api.answerInlineQuery(this.inline_query.id, results, e);
   }
+  answerGuestQuery(result) {
+    if (!this.guestQueryId) return Promise.resolve(false);
+    return this.api.answerGuestQuery({ guest_query_id: this.guestQueryId, result });
+  }
 
   /* ---------- admin & grup ---------- */
   banChatMember(cid, uid, e = {}) { return this.api.banChatMember(cid, uid, e); }

package/lib/file.js

@@ -33,9 +33,16 @@ class InputFile extends File {}
 const InputMediaBuilder = {
   photo: (media, extra = {}) => ({ type: 'photo', media, ...extra }),
   video: (media, extra = {}) => ({ type: 'video', media, ...extra }),
+  livePhoto: (media, photo, extra = {}) => ({ type: 'live_photo', media, photo, ...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 };
+const InputPaidMediaBuilder = {
+  photo: (media, extra = {}) => ({ type: 'photo', media, ...extra }),
+  video: (media, extra = {}) => ({ type: 'video', media, ...extra }),
+  livePhoto: (media, photo, extra = {}) => ({ type: 'live_photo', media, photo, ...extra }),
+};
+
+module.exports = { File, InputFile, InputMediaBuilder, InputPaidMediaBuilder };

package/lib/inline-query.js

@@ -9,13 +9,18 @@ function matchInlineQuery(trigger) {
     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()));
+    return list.some((t) => {
+      if (!(t instanceof RegExp)) return text.toLowerCase().includes(String(t).toLowerCase());
+      t.lastIndex = 0;
+      return t.test(text);
+    });
   };
 }
 
 /** 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']) }),
+  richArticle: (id, title, richMessage, extra = {}) => ({ type: 'article', id: String(id), title, input_message_content: { rich_message: richMessage }, ...omit(extra, ['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 }),

package/lib/logger.js

@@ -1,14 +1,17 @@
-// lib/logger.js — log terminal cantik tanpa dependency.
+// lib/logger.js — log terminal rapi, berwarna, dan mudah dibaca.
 'use strict';
 
 const C = {
-  reset: '', dim: '', bold: '',
-  red: '', green: '', yellow: '', blue: '',
-  magenta: '', cyan: '', gray: '',
+  reset: '\u001b[0m', dim: '\u001b[2m', bold: '\u001b[1m',
+  red: '\u001b[31m', green: '\u001b[32m', yellow: '\u001b[33m', blue: '\u001b[34m',
+  magenta: '\u001b[35m', cyan: '\u001b[36m', gray: '\u001b[90m',
+  developer: '\u001b[1;35m', border: '\u001b[36m',
+  title: '\u001b[1;97;44m', panel: '\u001b[97;44m',
 };
 
 function paint(code, s) {
-  return process.stdout && process.stdout.isTTY ? `${C[code]}${s}${C.reset}` : String(s);
+  const colorsEnabled = process.stdout && process.stdout.isTTY && !process.env.NO_COLOR;
+  return colorsEnabled ? `${C[code]}${s}${C.reset}` : String(s);
 }
 
 function stamp() {
@@ -23,16 +26,43 @@ const log = {
   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}┘`);
+/** Banner boot: identitas developer berada di atas panel warna. */
+log.banner = (title, rows = [], developer = 'Xbibz Technology ID') => {
+  const innerWidth = Math.max(displayWidth(title), ...rows.map((r) => displayWidth(strip(r)))) + 4;
+  const top = `┏${'━'.repeat(innerWidth)}┓`;
+  const divider = `┣${'━'.repeat(innerWidth)}┫`;
+  const bottom = `┗${'━'.repeat(innerWidth)}┛`;
+  const line = (text, color) => {
+    const plain = `  ${text}${' '.repeat(Math.max(0, innerWidth - displayWidth(text) - 4))}  `;
+    console.log(`${paint('border', '┃')}${paint(color, plain)}${paint('border', '┃')}`);
+  };
+
+  console.log(paint('developer', `◆ DEVELOPER  ${developer}`));
+  console.log(paint('border', top));
+  line(title, 'title');
+  console.log(paint('border', divider));
+  for (const row of rows) line(strip(row), 'panel');
+  console.log(paint('border', bottom));
 };
 
-function strip(s) { return String(s).replace(/\[\d+m/g, ''); }
+function strip(s) { return String(s).replace(/\u001b\[[0-?]*[ -/]*[@-~]/g, ''); }
+
+// Hitung lebar tampilan terminal (emoji/CJK = 2 kolom; combining mark = 0).
+function displayWidth(value) {
+  let width = 0;
+  for (const ch of String(value)) {
+    const cp = ch.codePointAt(0);
+    if (/\p{Mark}/u.test(ch) || cp === 0x200d || (cp >= 0xfe00 && cp <= 0xfe0f)) continue;
+    width += cp >= 0x1100 && (
+      cp <= 0x115f || cp === 0x2329 || cp === 0x232a ||
+      (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) ||
+      (cp >= 0xac00 && cp <= 0xd7a3) || (cp >= 0xf900 && cp <= 0xfaff) ||
+      (cp >= 0xfe10 && cp <= 0xfe19) || (cp >= 0xfe30 && cp <= 0xfe6f) ||
+      (cp >= 0xff00 && cp <= 0xff60) || (cp >= 0xffe0 && cp <= 0xffe6) ||
+      (cp >= 0x1f300 && cp <= 0x1faff) || (cp >= 0x20000 && cp <= 0x3fffd)
+    ) ? 2 : 1;
+  }
+  return width;
+}
 
 module.exports = log;

package/lib/ratelimit.js

@@ -28,24 +28,31 @@ function autoRetry({ maxRetry = 5, baseDelayMs = 500 } = {}) {
 /** Transformer antrean: jaga maks `perSecond` panggilan API global.
  *  Pasang: bot.api.config.use(throttler()) */
 function throttler({ perSecond = 28 } = {}) {
+  if (!Number.isFinite(perSecond) || perSecond <= 0) throw new RangeError('throttler: perSecond harus > 0');
   const interval = 1000 / perSecond;
   let last = 0; let chain = Promise.resolve();
   return (prev, method, payload) => {
-    chain = chain.then(async () => {
+    const task = chain.then(async () => {
       const wait = last + interval - Date.now();
       if (wait > 0) await new Promise((r) => setTimeout(r, wait));
       last = Date.now();
       return prev(method, payload);
     });
-    return chain;
+    // Satu request gagal tidak boleh meracuni antrean request berikutnya.
+    chain = task.then(() => undefined, () => undefined);
+    return task;
   };
 }
 
 /** Middleware anti-spam: maks `limit` update per user per `windowMs`. */
 function limiter({ windowMs = 2000, limit = 3, onExceeded } = {}) {
+  if (!Number.isFinite(windowMs) || windowMs <= 0 || !Number.isInteger(limit) || limit <= 0) {
+    throw new RangeError('limiter: windowMs dan limit harus > 0');
+  }
   const bucket = new Map();
+  let checks = 0;
   return async (ctx, next) => {
-    const key = ctx.from ? ctx.from.id : (ctx.chatId || '?');
+    const key = ctx.from && ctx.from.id !== undefined ? `u:${ctx.from.id}` : `c:${ctx.chatId ?? '?'}`;
     const now = Date.now();
     const arr = bucket.get(key) || [];
     const alive = arr.filter((t) => now - t < windowMs);
@@ -54,6 +61,12 @@ function limiter({ windowMs = 2000, limit = 3, onExceeded } = {}) {
       return; // diamkan spam
     }
     alive.push(now); bucket.set(key, alive);
+    // Bersihkan bucket user/chat tidak aktif agar Map tidak tumbuh tanpa batas.
+    if (++checks % 256 === 0) {
+      for (const [k, times] of bucket) {
+        if (!times.some((t) => now - t < windowMs)) bucket.delete(k);
+      }
+    }
     return next();
   };
 }

package/lib/rich.js

@@ -0,0 +1,170 @@
+// lib/rich.js — builders for Telegram Bot API 10.3 Rich Messages.
+'use strict';
+
+const { File } = require('./file');
+const CONTENT_FIELDS = ['html', 'markdown', 'blocks'];
+const INPUT_BLOCK_TYPES = new Set([
+  'paragraph', 'heading', 'pre', 'footer', 'divider', 'mathematical_expression', 'anchor',
+  'list', 'blockquote', 'expandable_blockquote', 'pullquote', 'collage', 'slideshow',
+  'table', 'details', 'map', 'animation', 'audio', 'document', 'photo', 'video',
+  'voice_note', 'buttons', 'thinking',
+]);
+
+function inputRichMessage(content, options = {}) {
+  const fields = CONTENT_FIELDS.filter((key) => Object.hasOwn(content, key));
+  if (fields.length !== 1) throw new TypeError('InputRichMessage harus memiliki tepat satu dari html, markdown, atau blocks');
+  if (fields[0] === 'blocks' && !Array.isArray(content.blocks)) throw new TypeError('InputRichMessage.blocks harus berupa array');
+  for (const key of CONTENT_FIELDS) {
+    if (Object.hasOwn(options, key)) throw new TypeError(`Gunakan rich.${key}() untuk menetapkan konten, jangan lewat options`);
+  }
+  return { ...content, ...options };
+}
+
+function assertDraftHasNoFileUpload(value) {
+  if (value instanceof File) throw new TypeError('Rich message draft tidak mendukung upload File baru; gunakan file_id Telegram bila perlu');
+  if (!value || typeof value !== 'object') return;
+  for (const child of Array.isArray(value) ? value : Object.values(value)) assertDraftHasNoFileUpload(child);
+}
+
+function draftRichMessage(content, options = {}) {
+  const result = inputRichMessage(content, options);
+  assertDraftHasNoFileUpload(result);
+  return result;
+}
+
+function block(type, props = {}) {
+  if (!INPUT_BLOCK_TYPES.has(type)) throw new TypeError(`Jenis InputRichBlock tidak dikenal: ${type}`);
+  const { type: _ignored, ...rest } = props;
+  return { ...rest, type };
+}
+
+const textEntity = (type, text, extra = {}) => ({ type, text, ...extra });
+const caption = (text, credit) => ({ text, ...(credit !== undefined ? { credit } : {}) });
+
+const rich = {
+  html: (html, options = {}) => inputRichMessage({ html: String(html) }, options),
+  markdown: (markdown, options = {}) => inputRichMessage({ markdown: String(markdown) }, options),
+  blocks: (blocks, options = {}) => inputRichMessage({ blocks: [...blocks] }, options),
+  draftHtml: (html, options = {}) => draftRichMessage({ html: String(html) }, options),
+  draftMarkdown: (markdown, options = {}) => draftRichMessage({ markdown: String(markdown) }, options),
+  draftBlocks: (blocks, options = {}) => draftRichMessage({ blocks: [...blocks] }, options),
+  block,
+
+  // RichText inline entities.
+  bold: (text) => textEntity('bold', text),
+  italic: (text) => textEntity('italic', text),
+  underline: (text) => textEntity('underline', text),
+  strikethrough: (text) => textEntity('strikethrough', text),
+  spoiler: (text) => textEntity('spoiler', text),
+  subscript: (text) => textEntity('subscript', text),
+  superscript: (text) => textEntity('superscript', text),
+  marked: (text) => textEntity('marked', text),
+  code: (text) => textEntity('code', text),
+  dateTime: (text, unixTime, format = 'r') => ({ type: 'date_time', text, unix_time: unixTime, date_time_format: format }),
+  textMention: (text, user) => ({ type: 'text_mention', text, user }),
+  customEmoji: (customEmojiId, alternativeText) => ({ type: 'custom_emoji', custom_emoji_id: String(customEmojiId), alternative_text: alternativeText }),
+  mathText: (expression) => ({ type: 'mathematical_expression', expression }),
+  url: (text, url) => textEntity('url', text, { url }),
+  email: (text, emailAddress) => textEntity('email_address', text, { email_address: emailAddress }),
+  phone: (text, phoneNumber) => textEntity('phone_number', text, { phone_number: phoneNumber }),
+  bankCard: (text, bankCardNumber) => textEntity('bank_card_number', text, { bank_card_number: bankCardNumber }),
+  mention: (text, username) => textEntity('mention', text, { username }),
+  hashtag: (text, hashtag) => textEntity('hashtag', text, { hashtag }),
+  cashtag: (text, cashtag) => textEntity('cashtag', text, { cashtag }),
+  botCommand: (text, botCommand) => textEntity('bot_command', text, { bot_command: botCommand }),
+  anchorText: (name) => ({ type: 'anchor', name }),
+  anchorLink: (text, anchorName) => textEntity('anchor_link', text, { anchor_name: anchorName }),
+  reference: (text, name) => textEntity('reference', text, { name }),
+  referenceLink: (text, referenceName) => textEntity('reference_link', text, { reference_name: referenceName }),
+  button: (text, action, style) => {
+    if (!action || typeof action !== 'object') throw new TypeError('rich.button() membutuhkan satu jenis aksi button');
+    const keys = ['url', 'callback_data', 'web_app', 'login_url', 'switch_inline_query', 'switch_inline_query_current_chat', 'switch_inline_query_chosen_chat', 'copy_text', 'disabled'];
+    const defined = keys.filter((key) => Object.hasOwn(action, key));
+    if (defined.length !== 1) throw new TypeError('RichMessageButton harus memiliki tepat satu field aksi');
+    if (style !== undefined && !['danger', 'success', 'primary', 'link'].includes(style)) {
+      throw new TypeError('Style rich button harus danger, success, primary, atau link');
+    }
+    if (style === 'link' && defined[0] !== 'callback_data') {
+      throw new TypeError('Style link hanya didukung pada rich callback button');
+    }
+    return { type: 'button', button: { text, ...action, ...(style ? { style } : {}) } };
+  },
+
+  // InputRichBlock builders.
+  paragraph: (text) => block('paragraph', { text }),
+  heading: (text, size = 2) => {
+    if (!Number.isInteger(size) || size < 1 || size > 6) throw new RangeError('rich.heading(): size harus 1–6');
+    return block('heading', { text, size });
+  },
+  pre: (text, language) => block('pre', { text, ...(language ? { language } : {}) }),
+  footer: (text) => block('footer', { text }),
+  divider: () => block('divider'),
+  mathBlock: (expression) => block('mathematical_expression', { expression }),
+  anchor: (name) => block('anchor', { name }),
+  list: (items) => block('list', { items: items.map((item) => {
+    if (Array.isArray(item)) return { blocks: item };
+    if (typeof item === 'string' || typeof item === 'number') return { blocks: [block('paragraph', { text: String(item) })] };
+    return item;
+  }) }),
+  quote: (blocks, credit) => block('blockquote', { blocks, ...(credit !== undefined ? { credit } : {}) }),
+  expandableQuote: (text, credit) => block('expandable_blockquote', { text, ...(credit !== undefined ? { credit } : {}) }),
+  pullQuote: (text, credit) => block('pullquote', { text, ...(credit !== undefined ? { credit } : {}) }),
+  collage: (blocks, captionText, credit) => block('collage', { blocks, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  slideshow: (blocks, captionText, credit) => block('slideshow', { blocks, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  table: (cells, options = {}) => block('table', {
+    cells,
+    ...(options.bordered ? { is_bordered: true } : {}),
+    ...(options.striped ? { is_striped: true } : {}),
+    ...(options.compact ? { is_compact: true } : {}),
+    ...(options.caption !== undefined ? { caption: options.caption } : {}),
+  }),
+  details: (summary, blocks, open = false) => block('details', { summary, blocks, ...(open ? { is_open: true } : {}) }),
+  map: (location, zoom, width, height, captionText, credit) => block('map', {
+    location, zoom, width, height,
+    ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}),
+  }),
+  animation: (animation, captionText, credit) => block('animation', { animation, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  audio: (audio, captionText, credit) => block('audio', { audio, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  document: (document, captionText, credit) => block('document', { document, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  photo: (photo, captionText, credit) => block('photo', { photo, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  video: (video, captionText, credit) => block('video', { video, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  voiceNote: (voiceNote, captionText, credit) => block('voice_note', { voice_note: voiceNote, ...(captionText !== undefined ? { caption: caption(captionText, credit) } : {}) }),
+  buttons: (buttons, align) => {
+    if (align !== undefined && !['left', 'center', 'right'].includes(align)) {
+      throw new TypeError('rich.buttons(): align harus left, center, atau right');
+    }
+    return block('buttons', { buttons, ...(align ? { align } : {}) });
+  },
+  thinking: (text = '') => block('thinking', { text }),
+};
+
+class RichMessageBuilder {
+  constructor() { this._content = null; this._options = {}; }
+  _set(field, value) {
+    if (this._content) throw new Error('RichMessageBuilder: tentukan satu mode saja (html, markdown, atau blocks)');
+    this._content = { [field]: value };
+    return this;
+  }
+  html(value) { return this._set('html', String(value)); }
+  markdown(value) { return this._set('markdown', String(value)); }
+  blocks(value = []) { return this._set('blocks', [...value]); }
+  add(...items) {
+    if (!this._content) this._content = { blocks: [] };
+    if (!Array.isArray(this._content.blocks)) throw new Error('RichMessageBuilder.add() hanya bisa dipakai pada mode blocks');
+    this._content.blocks.push(...items);
+    return this;
+  }
+  media(items) { this._options.media = [...items]; return this; }
+  rtl(value = true) { this._options.is_rtl = Boolean(value); return this; }
+  skipEntityDetection(value = true) { this._options.skip_entity_detection = Boolean(value); return this; }
+  build() {
+    if (!this._content) throw new Error('RichMessageBuilder: konten belum diisi');
+    return inputRichMessage(this._content, this._options);
+  }
+  buildDraft() {
+    if (!this._content) throw new Error('RichMessageBuilder: konten belum diisi');
+    return draftRichMessage(this._content, this._options);
+  }
+}
+
+module.exports = { rich, RichMessageBuilder, inputRichMessage };

package/lib/runner.js

@@ -16,7 +16,7 @@ async function pollLoop({ api, handleUpdate, allowedUpdates, dropPending, onConf
   if (dropPending) {
     try {
       const u = await api.callApi('getUpdates', { offset: -1, timeout: 0, allowed_updates: allowedUpdates });
-      if (u.length) offset = u[u.length - 1].update_id + 1;
+      if (Array.isArray(u) && u.length) offset = u[u.length - 1].update_id + 1;
     } catch { /* abaikan — loop utama yang menangani */ }
   }
 
@@ -28,10 +28,19 @@ async function pollLoop({ api, handleUpdate, allowedUpdates, dropPending, onConf
     } catch (err) {
       const code = err && (err.error_code || err.code);
       if (shouldStop()) break;
-      if (code === 409) { if (onConflict) onConflict(err); await sleep(conflictDelay); continue; }
-      const fatal = code && code !== 429;
-      if (fatal) { if (onFatal) onFatal(err); break; }
-      await sleep(1000); continue; // koneksi putus / 429 → napas sebentar
+      if (code === 409) { if (onConflict) await onConflict(err); await sleep(conflictDelay); continue; }
+      if (code === 429) {
+        const retryAfter = Number(err && err.parameters && err.parameters.retry_after);
+        await sleep(Number.isFinite(retryAfter) && retryAfter >= 0 ? retryAfter * 1000 : 1000);
+        continue;
+      }
+      if (Number.isInteger(code) && code >= 500 && code < 600) { await sleep(1000); continue; }
+      const networkCode = err && ['ECONNABORTED', 'ETIMEDOUT', 'ECONNRESET', 'EAI_AGAIN', 'ENOTFOUND', 'EPIPE', 'ENETUNREACH', 'ECONNREFUSED'].includes(err.code);
+      if (!err || err.network || networkCode || !err.error_code) {
+        await sleep(1000); continue; // jaringan putus/time-out: retry, bukan fatal
+      }
+      if (onFatal) await onFatal(err);
+      break;
     }
 
     for (const u of updates) {

package/lib/session.js

@@ -24,12 +24,20 @@ function session(opts = {}) {
     const key = getKey(ctx);
     if (key === undefined) { ctx.session = {}; return next(); }
     let s = await read(key);
-    if (s === undefined || s === null) { s = initial(); await write(key, s); }
-    // Proxy: properti __deleted di akhir → hapus dari store
+    if (s === undefined || s === null) s = initial();
+    if (!s || typeof s !== 'object') throw new TypeError('session: initial/storage harus mengembalikan object');
+    // Proxy: simpan ulang setelah middleware agar storage hasil deserialisasi juga awet.
     ctx.session = new Proxy(s, {
-      get: (t, p) => t[p], set: (t, p, v) => { t[p] = v; return true; },
+      get: (t, p) => t[p],
+      set: (t, p, v) => { t[p] = v; return true; },
+      deleteProperty: (t, p) => { delete t[p]; return true; },
     });
-    return next();
+    try {
+      return await next();
+    } finally {
+      if (s.__deleted === true) await del(key);
+      else await write(key, s);
+    }
   };
 }