@xbibzlibrary/telebibz 3.0.1 → 3.1.1

package/examples/03-wizard.js

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

package/index.d.ts

@@ -6,18 +6,36 @@ declare module '@xbibzlibrary/telebibz' {
   type Color = 'danger' | 'success' | 'primary';
   type Handler = (ctx: Context) => unknown;
 
+  type WizardMode = 'send' | 'edit' | 'delete';
+  type WizardButton = string | { text: string; value?: unknown };
   interface WizardStep {
     key: string;
     ask: string | ((ctx: Context) => string | Promise<string>);
     parse?: (text: string, ctx: Context) => unknown | Promise<unknown>;
     validate?: (value: unknown, ctx: Context) => string | null | Promise<string | null>;
     opts?: Record<string, unknown>;
+    /** Tombol pilihan: ['A','B'] | [{text,value}] | baris eksplisit [['A'],['B','C']]. */
+    buttons?: Array<WizardButton | WizardButton[]>;
+    /** true → tombol inline (callback), default reply keyboard. */
+    inline?: boolean;
+    /** true/string → tolak ketikan bebas, wajib pilih tombol. */
+    onlyButtons?: boolean | string;
+    /** Override mode tampilan per langkah. */
+    mode?: WizardMode;
+    /** Reply keyboard sekali pakai. */
+    oneTime?: boolean;
   }
   interface WizardDef {
     steps: WizardStep[];
     done: (answers: Record<string, unknown>, ctx: Context) => unknown;
     cancelWords?: string[];
     onCancel?: (ctx: Context) => unknown;
+    /** 'send' (default) | 'edit' satu pesan | 'delete' tanya-hapus per langkah. */
+    mode?: WizardMode;
+    /** Hapus pesan tanya terakhir saat wizard selesai (default: true bila mode 'delete'). */
+    cleanup?: boolean;
+    /** Singkirkan reply keyboard saat selesai (default: true bila tombol reply pernah dipakai). */
+    removeKeyboard?: boolean;
   }
 
   interface TeleBibzOpts {
@@ -25,13 +43,13 @@ declare module '@xbibzlibrary/telebibz' {
     onError?: (err: unknown, ctx?: Context) => unknown;
     silent?: boolean;
     dropPending?: boolean;
-    grammy?: Record<string, unknown>;
+    session?: { initial?: () => unknown; getKey?: (ctx: Context) => string | undefined; storage?: unknown };
+    transport?: (method: string, payload?: object) => Promise<unknown>;
   }
 
   class TeleBibz {
     constructor(token: string, opts?: TeleBibzOpts);
-    bot: Bot<Context>;
-    api: Bot<Context>['api'];
+    api: any;
     botInfo: any;
     use(...mw: any[]): this;
     cmd(names: string | string[], ...mw: Handler[]): this;
@@ -42,6 +60,9 @@ declare module '@xbibzlibrary/telebibz' {
     wizard(id: string, def: WizardDef, bindCommand?: boolean): this;
     wizardStart(ctx: Context, id: string): Promise<unknown>;
     wizardActive(ctx: Context): boolean;
+    wizardCancel(ctx: Context): Promise<boolean>;
+    wizardEdit(ctx: Context, text: string, extra?: object): Promise<unknown>;
+    wizardDelete(ctx: Context): Promise<boolean>;
     broadcast(ids: Array<number | string>, pesan: any, opts?: { delay?: number }): Promise<{ terkirim: number; gagal: number; errors: Array<{ chatId: any; pesan: string }> }>;
     launch(opts?: Record<string, unknown>): Promise<this>;
     handleUpdate(update: any): Promise<void>;
@@ -63,6 +84,10 @@ declare module '@xbibzlibrary/telebibz' {
     define: (id: string, def: WizardDef) => string;
     start: (ctx: Context, id: string) => Promise<unknown>;
     active: (ctx: Context) => boolean;
+    cancel: (ctx: Context) => Promise<boolean>;
+    editAsk: (ctx: Context, text: string, extra?: object) => Promise<unknown>;
+    deleteAsk: (ctx: Context) => Promise<boolean>;
+    KEY: string;
   };
 
   function humanize(err: unknown): { pesan: string; saran: string | null; method?: string; code?: number };

package/index.js

@@ -25,6 +25,8 @@ const say = {
 module.exports = {
   // kelas utama
   TeleBibz, Context, Composer, BotError, session,
+  // wizard (form percakapan + tombol + edit/delete)
+  wizard,
   // keyboard & menu
   btn, url, webApp, copy, kb, InlineKeyboard, Keyboard, Menu, MenuContainer,
   // percakapan

package/lib/telebibz.js

@@ -86,6 +86,9 @@ class TeleBibz {
   }
   wizardStart(ctx, id) { return wizard.start(ctx, id); }
   wizardActive(ctx) { return wizard.active(ctx); }
+  wizardCancel(ctx) { return wizard.cancel(ctx); }
+  wizardEdit(ctx, text, extra) { return wizard.editAsk(ctx, text, extra); }
+  wizardDelete(ctx) { return wizard.deleteAsk(ctx); }
 
   /* ---------- broadcast ---------- */
   broadcast(ids, pesan, opts) { return broadcast(this.api, ids, pesan, opts); }

package/lib/wizard.js

@@ -1,4 +1,6 @@
 // lib/wizard.js — percakapan tanya-jawab berurutan (form) berbasis sesi.
+// v3.1: + TOMBOL pilihan (reply keyboard / inline keyboard), mode tampilan
+//       'send' | 'edit' | 'delete', cleanup pesan & hapus keyboard otomatis.
 'use strict';
 
 const KEY = '__telebibz_wizard';
@@ -6,15 +8,28 @@ const KEY = '__telebibz_wizard';
 /**
  * Definisi wizard:
  * {
+ *   mode: 'send' | 'edit' | 'delete',   // ops, default 'send' (per-step bisa override)
+ *   cleanup: true,                       // ops: hapus pesan tanya terakhir saat selesai
+ *   removeKeyboard: true,                // ops: singkirkan reply keyboard saat selesai
  *   steps: [
  *     { key:'nama', ask:'Siapa namamu?' },
- *     { key:'umur', ask:'Umur berapa?', parse: Number,
+ *     { key:'jk', ask:'Jenis kelamin?', buttons: ['Laki-laki', 'Perempuan'] },
+ *     { key:'setuju', ask:'Setuju?', inline: true,
+ *       buttons: [[{ text:'✅ Ya', value:'ya' }, { text:'❌ Tidak', value:'tdk' }]] },
+ *     { key:'umur', ask:'Umur berapa?', parse: Number, mode: 'edit', onlyButtons: false,
  *       validate: (n) => (n>0 && n<120) ? null : 'Umur tidak masuk akal, ulangi:' },
  *   ],
  *   done: async (answers, ctx) => {},
  *   cancelWords: ['batal', '/batal', 'cancel'],   // ops, default ada
  *   onCancel: (ctx) => ctx.reply('Dibatalkan.'),  // ops
  * }
+ *
+ * Format `buttons`:
+ *   ['A', 'B']                          → label polos, nilai = label
+ *   [{ text:'A', value:'a' }]           → label + nilai berbeda (flat, disusun 2 per baris)
+ *   [['A','B'], ['C']]                  → baris eksplisit (reply maupun inline)
+ * `inline: true`  → tombol callback (klik = nilai langsung, tanpa mengetik)
+ * `onlyButtons: true` → tolak ketikan bebas, wajib pilih tombol
  */
 const wizards = new Map();
 
@@ -29,14 +44,149 @@ function define(id, def) {
 
 function get(id) { return wizards.get(id); }
 
+/* ---------- normalisasi tombol ---------- */
+function normalizeButtons(input) {
+  if (!Array.isArray(input) || !input.length) return null;
+  const norm = (b) => (b && typeof b === 'object' && b.text !== undefined
+    ? { text: String(b.text), value: b.value !== undefined ? b.value : String(b.text) }
+    : { text: String(b), value: String(b) });
+  if (Array.isArray(input[0])) return input.map((r) => (Array.isArray(r) ? r : [r]).map(norm));
+  // daftar flat → susun rapi maksimal 2 tombol per baris
+  const flat = input.map(norm);
+  const rows = [];
+  for (let i = 0; i < flat.length; i += 2) rows.push(flat.slice(i, i + 2));
+  return rows;
+}
+const flatten = (rows) => rows.reduce((a, r) => a.concat(r), []);
+
+/** Susun reply_markup untuk langkah ke-`idx` (jika ada tombolnya). */
+function stepExtra(def, st, idx) {
+  const step = def.steps[idx];
+  const extra = { ...(step.opts || {}) };
+  const rows = normalizeButtons(step.buttons);
+  if (!rows) return extra;
+  if (step.inline) {
+    let n = 0;
+    extra.reply_markup = {
+      inline_keyboard: rows.map((r) => r.map((b) => ({
+        text: b.text,
+        callback_data: `wiz:${st.cb}:${idx}:${n++}`,
+      }))),
+    };
+  } else {
+    st.rk = true; // pernah memakai reply keyboard → perlu dibersihkan saat selesai
+    extra.reply_markup = {
+      keyboard: rows.map((r) => r.map((b) => ({ text: b.text }))),
+      resize_keyboard: true,
+      ...(step.oneTime ? { one_time_keyboard: true } : {}),
+    };
+  }
+  return extra;
+}
+
+/** Tampilkan pertanyaan langkah `idx` sesuai mode ('send' | 'edit' | 'delete'). */
+async function tampil(ctx, st, def, idx, text) {
+  const step = def.steps[idx];
+  const mode = step.mode || def.mode || 'send';
+  const extra = stepExtra(def, st, idx);
+
+  if (mode === 'edit' && st.msgId) {
+    try {
+      await ctx.api.editMessageText(st.chatId, st.msgId, text, extra);
+      return;
+    } catch (e) {
+      if (/not modified/i.test((e && (e.description || e.message)) || '')) return;
+      // pesan tak ditemukan (sudah dihapus) → jatuh ke kirim baru
+    }
+  } else if (mode === 'delete' && st.msgId) {
+    try { await ctx.api.deleteMessage(st.chatId, st.msgId); } catch { /* sudah hilang */ }
+    st.msgId = undefined;
+  }
+  const sent = await ctx.reply(text, extra);
+  if (sent && sent.message_id) { st.chatId = ctx.chatId; st.msgId = sent.message_id; }
+}
+
+/** Bersihkan jejak wizard: hapus pesan tanya (cleanup) + singkirkan reply keyboard. */
+async function bersih(ctx, st, def) {
+  if (!def) return;
+  const cleanupOn = def.cleanup !== undefined ? !!def.cleanup : (def.mode === 'delete');
+  if (cleanupOn && st.msgId) {
+    try { await ctx.api.deleteMessage(st.chatId, st.msgId); } catch { /* sudah hilang */ }
+  }
+  if (st.rk && def.removeKeyboard !== false) {
+    try {
+      await ctx.api.sendMessage(st.chatId, '\u200b', { reply_markup: { remove_keyboard: true } });
+    } catch { /* chat tak terjangkau */ }
+  }
+}
+
 /** Mulai wizard dari handler mana pun (command/action/dll). */
 async function start(ctx, id) {
   const def = wizards.get(id);
   if (!def) throw new Error(`wizard "${id}" belum didefinisikan`);
   if (!ctx.session) throw new Error('telebibz: session belum aktif (lib internal)');
-  ctx.session[KEY] = { id, i: 0, ans: {} };
+  const st = { id, i: 0, ans: {}, cb: Math.random().toString(36).slice(2, 8) };
+  ctx.session[KEY] = st;
   const s0 = def.steps[0];
-  return ctx.reply(typeof s0.ask === 'function' ? await s0.ask(ctx) : s0.ask, s0.opts || {});
+  const text = typeof s0.ask === 'function' ? await s0.ask(ctx) : s0.ask;
+  return tampil(ctx, st, def, 0, text);
+}
+
+/** Proses satu jawaban (teks ketikan ATAU nilai tombol) untuk langkah aktif. */
+async function jawab(ctx, st, def, input) {
+  const step = def.steps[st.i];
+  let value = input;
+  if (step.parse) value = await step.parse(input, ctx);
+  if (step.validate) {
+    const errMsg = await step.validate(value, ctx);
+    if (errMsg) {
+      const mode = step.mode || def.mode || 'send';
+      if (mode === 'send') return ctx.reply(errMsg);
+      return tampil(ctx, st, def, st.i, errMsg); // edit/delete: ubah pesan yang sama
+    }
+  }
+  st.ans[step.key] = value;
+  st.i += 1;
+
+  if (st.i >= def.steps.length) {
+    await bersih(ctx, st, def);
+    delete ctx.session[KEY];
+    return def.done(st.ans, ctx);
+  }
+  const ns = def.steps[st.i];
+  return tampil(ctx, st, def, st.i, typeof ns.ask === 'function' ? await ns.ask(ctx) : ns.ask);
+}
+
+/** Batalkan wizard yang sedang berjalan secara programatis. */
+async function cancel(ctx) {
+  const st = ctx.session && ctx.session[KEY];
+  if (!st) return false;
+  const def = wizards.get(st.id);
+  await bersih(ctx, st, def);
+  delete ctx.session[KEY];
+  if (def && def.onCancel) { await def.onCancel(ctx); return true; }
+  await ctx.reply('✖️ Sesi dibatalkan.');
+  return true;
+}
+
+/** Edit pesan-tanya wizard yang sedang tampil (fallback: kirim baru). */
+async function editAsk(ctx, text, extra = {}) {
+  const st = ctx.session && ctx.session[KEY];
+  if (!st || !st.msgId) return ctx.reply(text, extra);
+  try { await ctx.api.editMessageText(st.chatId, st.msgId, text, extra); }
+  catch {
+    const sent = await ctx.reply(text, extra);
+    if (sent && sent.message_id) { st.chatId = ctx.chatId; st.msgId = sent.message_id; }
+  }
+}
+
+/** Hapus pesan-tanya wizard yang sedang tampil. */
+async function deleteAsk(ctx) {
+  const st = ctx.session && ctx.session[KEY];
+  if (!st || !st.msgId) return false;
+  try { await ctx.api.deleteMessage(st.chatId, st.msgId); } catch { /* sudah hilang */ }
+  st.msgId = undefined;
+  return true;
 }
 
 /** Middleware global: memproses jawaban wizard yang sedang berjalan. */
@@ -47,35 +197,51 @@ function middleware() {
     const def = wizards.get(st.id);
     if (!def) { delete ctx.session[KEY]; return next(); }
 
+    /* ---- klik tombol inline (callback_query) ---- */
+    const q = ctx.callback_query;
+    if (q && typeof q.data === 'string') {
+      const m = /^wiz:([a-z0-9]+):(\d+):(\d+)$/i.exec(q.data);
+      if (m) {
+        const stale = (pesan) => ctx.answerCallbackQuery({ text: pesan, show_alert: true }).catch(() => {});
+        if (m[1] !== st.cb || Number(m[2]) !== st.i) return stale('⌛ Tombol usang — formulir sudah berpindah/berakhir.');
+        const rows = normalizeButtons(def.steps[st.i].buttons);
+        const tombol = rows && flatten(rows)[Number(m[3])];
+        if (!tombol) return stale('⌛ Tombol usang — formulir sudah berpindah/berakhir.');
+        await ctx.answerCallbackQuery().catch(() => {});
+        return jawab(ctx, st, def, tombol.value);
+      }
+      // callback lain saat wizard aktif → diamkan, wizard menunggu (konsisten non-teks)
+    }
+
+    /* ---- jawaban teks ---- */
     const text = ctx.message && typeof ctx.message.text === 'string' ? ctx.message.text.trim() : null;
     if (text === null) return; // pesan non-teks (foto/stiker) — diamkan, wizard menunggu
 
     if (def.cancelWords.has(text.toLowerCase())) {
+      await bersih(ctx, st, def);
       delete ctx.session[KEY];
       if (def.onCancel) return def.onCancel(ctx);
       return ctx.reply('✖️ Sesi dibatalkan.');
     }
 
     const step = def.steps[st.i];
-    let value = text;
-    if (step.parse) value = await step.parse(text, ctx);
-    if (step.validate) {
-      const errMsg = await step.validate(value, ctx);
-      if (errMsg) return ctx.reply(errMsg);
-    }
-    st.ans[step.key] = value;
-    st.i += 1;
-
-    if (st.i >= def.steps.length) {
-      delete ctx.session[KEY];
-      return def.done(st.ans, ctx);
+    let input = text;
+    const rows = normalizeButtons(step.buttons);
+    if (rows) {
+      const hit = flatten(rows).find((b) => b.text.toLowerCase() === text.toLowerCase());
+      if (hit) input = hit.value; // tekan tombol reply → pakai nilainya
+      else if (step.onlyButtons) {
+        const pesan = step.onlyButtons === true
+          ? '✋ Pilih salah satu tombol yang tersedia ya:'
+          : step.onlyButtons;
+        return tampil(ctx, st, def, st.i, pesan);
+      }
     }
-    const ns = def.steps[st.i];
-    return ctx.reply(typeof ns.ask === 'function' ? await ns.ask(ctx) : ns.ask, ns.opts || {});
+    return jawab(ctx, st, def, input);
   };
 }
 
 /** True kalau user ini sedang di tengah wizard. */
 function active(ctx) { return Boolean(ctx.session && ctx.session[KEY]); }
 
-module.exports = { define, get, start, middleware, active, KEY };
+module.exports = { define, get, start, middleware, active, cancel, editAsk, deleteAsk, KEY };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xbibzlibrary/telebibz",
-  "version": "3.0.1",
-  "description": "Library Telegram Indonesia production-grade — set fitur penuh setara grammY: proxy-api segala metode, transformer, menus, inline query, media group, throttler & auto-retry, session swappable, webhook, polling tahan-409. //—Xbibz Official—//",
+  "version": "3.1.1",
+  "description": "Library Telegram Indonesia production-grade — set fitur penuh setara grammY: proxy-api segala metode, transformer, menus, inline query, media group, throttler & auto-retry, wizard + tombol + edit/delete, session swappable, webhook, polling tahan-409. //—Xbibz Official—//",
   "main": "index.js",
   "types": "index.d.ts",
   "type": "commonjs",

package/test/all.test.js

@@ -6,7 +6,7 @@ const { TeleBibz, btn, url, kb, webApp, copy, humanize, File, InlineKeyboard,
   Menu, MenuContainer, iq, autoRetry, throttler, limiter, InputMediaBuilder } = require('..');
 
 let N = 0, OK = 0;
-const TOTAL = 24;
+const TOTAL = 30;
 const t = (nama, fn) => {
   const done = () => { N++; if (N === TOTAL) { console.log(`\n${OK}/${N} lulus`); process.exit(OK === N ? 0 : 1); } };
   Promise.resolve()
@@ -332,3 +332,108 @@ t('webhook(): body JSON diproses handleUpdate', async () => {
   assert.strictEqual(status, 200);
   assert.ok(texts(calls).some((x) => /hai webhook/.test(x)));
 });
+/* ===== 25–30. wizard v3.1: tombol + edit/delete ===== */
+t('wizard v3.1: tombol reply — label cocok → nilai; onlyButtons menahan ketikan bebas', async () => {
+  const { bot, calls } = buatBot(); await boot(bot);
+  const jawab = [];
+  bot.wizard('survey', {
+    steps: [
+      { key: 'jk', ask: 'Jenis kelamin?', buttons: ['Laki-laki', 'Perempuan'], onlyButtons: true },
+      { key: 'kota', ask: 'Kota?' },
+    ],
+    done: async (ans) => { jawab.push(ans); },
+  });
+  await bot.handleUpdate(uMsg('/survey'));
+  const ask = calls.find((c) => c.method === 'sendMessage' && c.payload.text === 'Jenis kelamin?');
+  assert.ok(ask && ask.payload.reply_markup.keyboard[0][0].text === 'Laki-laki');
+  await bot.handleUpdate(uMsg('terserah'));         // bukan tombol → ditolak, wizard tetap di langkah 1
+  assert.strictEqual(jawab.length, 0);
+  await bot.handleUpdate(uMsg('Perempuan'));        // ketuk tombol
+  await bot.handleUpdate(uMsg('Magetan'));
+  assert.deepStrictEqual(jawab, [{ jk: 'Perempuan', kota: 'Magetan' }]);
+});
+
+t('wizard v3.1: tombol inline + mode edit → editMessageText, bukan pesan baru', async () => {
+  const { bot, calls } = buatBot(); await boot(bot);
+  const jawab = [];
+  bot.wizard('vote', {
+    mode: 'edit',
+    steps: [
+      { key: 'pilih', ask: 'Pilih salah satu', inline: true, buttons: [[{ text: 'Opsi A', value: 'a' }, { text: 'Opsi B', value: 'b' }]] },
+      { key: 'nama', ask: 'Siapa namamu?' },
+    ],
+    done: async (ans) => { jawab.push(ans); },
+  });
+  await bot.handleUpdate(uMsg('/vote'));
+  const ask = calls.find((c) => c.method === 'sendMessage' && c.payload.text === 'Pilih salah satu');
+  const data = ask.payload.reply_markup.inline_keyboard[0][1].callback_data;
+  assert.ok(/^wiz:[a-z0-9]+:0:1$/.test(data));
+  await bot.handleUpdate({ update_id: ++uid, callback_query: {
+    id: 'wq1', from: USER, chat_instance: 'x', data,
+    message: { message_id: ask.message_id, from: { id: 99, is_bot: true, first_name: 'B' }, chat: CHAT, date: 1 },
+  } });
+  assert.ok(calls.some((c) => c.method === 'editMessageText' && c.payload.text === 'Siapa namamu?'), 'langkah 2 harus lewat editMessageText');
+  assert.ok(!calls.some((c) => c.method === 'sendMessage' && c.payload.text === 'Siapa namamu?'), 'tidak boleh kirim pesan baru');
+  assert.ok(calls.some((c) => c.method === 'answerCallbackQuery' && c.payload.callback_query_id === 'wq1'));
+  await bot.handleUpdate(uMsg('Budi'));
+  assert.deepStrictEqual(jawab, [{ pilih: 'b', nama: 'Budi' }]);
+});
+
+t('wizard v3.1: mode delete → pesan lama dihapus; cleanup hapus pesan tanya terakhir', async () => {
+  const { bot, calls } = buatBot(); await boot(bot);
+  bot.wizard('hapus', {
+    mode: 'delete',
+    steps: [{ key: 'a', ask: 'Pertanyaan A?' }, { key: 'b', ask: 'Pertanyaan B?' }],
+    done: () => {},
+  });
+  await bot.handleUpdate(uMsg('/hapus'));
+  const idxA = calls.findIndex((c) => c.method === 'sendMessage' && c.payload.text === 'Pertanyaan A?');
+  assert.ok(idxA >= 0);
+  const idA = idxA + 1; // stub transport: message_id = calls.length saat push
+  await bot.handleUpdate(uMsg('satu'));
+  const dihapus = () => calls.filter((c) => c.method === 'deleteMessage').map((c) => c.payload.message_id);
+  assert.ok(dihapus().includes(idA), 'pesan A harus dihapus sebelum tanya B');
+  const idxB = calls.findIndex((c) => c.method === 'sendMessage' && c.payload.text === 'Pertanyaan B?');
+  await bot.handleUpdate(uMsg('dua'));
+  assert.ok(dihapus().includes(idxB + 1), 'cleanup: pesan tanya terakhir ikut dihapus');
+});
+
+t('wizard v3.1: reply keyboard otomatis disingkirkan saat wizard selesai', async () => {
+  const { bot, calls } = buatBot(); await boot(bot);
+  bot.wizard('kbd', { steps: [{ key: 'x', ask: 'Pilih:', buttons: ['Ok', 'Tidak'] }], done: () => {} });
+  await bot.handleUpdate(uMsg('/kbd'));
+  await bot.handleUpdate(uMsg('Ok'));
+  assert.ok(calls.some((c) => c.method === 'sendMessage' &&
+    c.payload.reply_markup && c.payload.reply_markup.remove_keyboard === true));
+});
+
+t('wizard v3.1: klik tombol usang → alert aman, wizard tidak rusak', async () => {
+  const { bot, calls } = buatBot(); await boot(bot);
+  bot.wizard('prog', { steps: [{ key: 'a', ask: 'A?', inline: true, buttons: ['X'] }], done: () => {} });
+  await bot.handleUpdate(uMsg('/prog'));
+  await bot.handleUpdate({ update_id: ++uid, callback_query: {
+    id: 'wq2', from: USER, chat_instance: 'x', data: 'wiz:tokenpalsu:0:0',
+    message: { message_id: 1, from: { id: 99, is_bot: true, first_name: 'B' }, chat: CHAT, date: 1 },
+  } });
+  const alert = calls.find((c) => c.method === 'answerCallbackQuery' && /usang/i.test(c.payload.text || ''));
+  assert.ok(alert && alert.payload.show_alert === true);
+  await bot.handleUpdate(uMsg('jawaban asli'));   // wizard masih berjalan normal
+});
+
+t('wizard v3.1: wizard.cancel() membatalkan sesi secara programatis', async () => {
+  const wiz = require('../lib/wizard');
+  wiz.define('manual', { steps: [{ key: 'a', ask: 'A?' }], done: () => {}, onCancel: () => {} });
+  const replies = [];
+  const ctx = {
+    session: {},
+    chatId: 555,
+    reply: async (t) => { replies.push(t); return { message_id: 42 }; },
+    api: { editMessageText: async () => true, deleteMessage: async () => true, sendMessage: async () => true },
+  };
+  await wiz.start(ctx, 'manual');
+  assert.strictEqual(wiz.active(ctx), true);
+  assert.deepStrictEqual(replies, ['A?']);
+  assert.strictEqual(await wiz.cancel(ctx), true);
+  assert.strictEqual(wiz.active(ctx), false);
+  assert.strictEqual(await wiz.cancel(ctx), false); // sudah tidak aktif
+});