@xbibzlibrary/telebibz 0.4.5 → 3.0.1

package/docs/TESTING.id.md

@@ -1,203 +0,0 @@
-# Panduan testing (Bahasa Indonesia)
-
-Uji bot telebibz sepenuhnya offline: palsukan transport, rakit update, asersikan panggilan keluar, dan jalankan conversation utuh end-to-end.
-
-## Daftar isi
-
-1. [Subpath testing](#1-subpath-testing)
-2. [MockTransport](#2-mocktransport)
-3. [Men-drive update ke dalam bot](#3-men-drive-update-ke-dalam-bot)
-4. [Asersi panggilan keluar](#4-asersi-panggilan-keluar)
-5. [Menguji wizard end-to-end](#5-menguji-wizard-end-to-end)
-6. [Menguji unduhan file](#6-menguji-unduhan-file)
-7. [Menguji webhook](#7-menguji-webhook)
-8. [Menguji jalur error](#8-menguji-jalur-error)
-9. [Pola Vitest / Jest](#9-pola-vitest--jest)
-
-## 1. Subpath testing
-
-Semuanya tersedia dari `@xbibzlibrary/telebibz/testing`:
-
-```ts
-import { MockTransport, createTestBot, createMockUpdate, createMockCallbackUpdate, createMockContext } from "@xbibzlibrary/telebibz/testing";
-```
-
-- `createTestBot()` → `{ bot, transport }` — sebuah `Bot` yang terhubung ke `MockTransport`, branding dimatikan.
-- `createMockUpdate(overrides?)` → update pesan teks `/start` sederhana.
-- `createMockCallbackUpdate(overrides?)` → update callback-query.
-- `createMockContext(bot, update?)` → sebuah `Context` tanpa me-routing apa pun.
-
-## 2. MockTransport
-
-`MockTransport` merekam setiap request keluar dan menjawab dari response yang dikonfigurasi:
-
-```ts
-const { bot, transport } = createTestBot();
-
-transport.respond("getMe", { ok: true, result: { id: 99, is_bot: true, first_name: "TestBot", username: "test_bot" } });
-transport.respond("sendMessage", { ok: true, result: { message_id: 1, date: 0, chat: { id: 1, type: "private" } } });
-transport.respond("getFile", (payload) => ({                                   // jawaban dinamis
-  ok: true,
-  result: { file_id: (payload as { file_id: string }).file_id, file_unique_id: "u", file_path: "documents/a.pdf" },
-}));
-```
-
-Method yang tidak dikonfigurasi menjawab `{ ok: true, result: true }` — cukup untuk panggilan yang hasilnya Anda abaikan.
-
-Ia juga mengimplementasikan member download:
-
-```ts
-transport.downloadBytes = new TextEncoder().encode("file-content");
-transport.downloads;            // setiap file_path yang diberikan ke download(), berurutan
-transport.fileUrl("a.pdf");     // "mock://files/a.pdf"
-```
-
-## 3. Men-drive update ke dalam bot
-
-Daftarkan handler, lalu kirim update — tanpa jaringan, tanpa token:
-
-```ts
-bot.on("message", async (ctx) => { await ctx.reply("hi"); });
-await bot.init();                       // tepat satu getMe, seperti produksi
-
-await bot.handleUpdate(createMockUpdate({ message: { ...createMockUpdate().message!, text: "hello" } }));
-await bot.handleUpdates([updateA, updateB, updateC]);   // satu batch penuh, paralel antar chat
-```
-
-Untuk mensimulasikan beberapa chat, variasikan chat id:
-
-```ts
-function textUpdate(updateId: number, chatId: number, text: string) {
-  const base = createMockUpdate();
-  return { ...base, update_id: updateId, message: { ...base.message!, chat: { id: chatId, type: "private" as const }, text } };
-}
-```
-
-## 4. Asersi panggilan keluar
-
-Setiap request tercatat di `transport.calls` lengkap dengan method dan payload-nya:
-
-```ts
-const replies = transport.calls
-  .filter((call) => call.method === "sendMessage")
-  .map((call) => (call.payload as { text?: string }).text);
-
-expect(replies).toEqual(["Siapa nama Anda?", "Berapa usia Anda?"]);
-
-// Keyboard callback:
-const markup = (transport.calls.at(-1)?.payload as { reply_markup?: { inline_keyboard: unknown[][] } }).reply_markup;
-expect(markup?.inline_keyboard).toHaveLength(2);
-```
-
-## 5. Menguji wizard end-to-end
-
-Berikan conversation satu pesan demi satu pesan dan asersikan balasan yang akan dilihat user:
-
-```ts
-import { Bot, Wizard } from "@xbibzlibrary/telebibz";
-
-const wizard = new Wizard()
-  .step({ id: "ask", run: async (flow) => { flow.next(); await flow.ctx.reply("Siapa nama Anda?"); } })
-  .step({ id: "save", run: async (flow) => { await flow.ctx.reply(`Halo, ${flow.ctx.message?.text}!`); } });
-bot.useWizard(wizard);
-bot.command("start", async (ctx) => { await wizard.run(ctx); });
-
-await bot.handleUpdate(textUpdate(1, 7, "/start"));
-await bot.handleUpdate(textUpdate(2, 7, "Dewi"));
-
-expect(sentTexts()).toEqual(["Siapa nama Anda?", "Halo, Dewi!"]);
-```
-
-Dua chat, dua wizard independen — update yang berselang-seling tetap terisolasi karena update dari chat yang sama diserialisasi:
-
-```ts
-await bot.handleUpdate(textUpdate(1, 7, "/start"));
-await bot.handleUpdate(textUpdate(2, 8, "/start"));
-await bot.handleUpdate(textUpdate(3, 7, "Dewi"));
-await bot.handleUpdate(textUpdate(4, 8, "Budi"));
-expect(sentTexts()).toEqual(["Siapa nama Anda?", "Siapa nama Anda?", "Halo, Dewi!", "Halo, Budi!"]);
-```
-
-## 6. Menguji unduhan file
-
-```ts
-transport.respond("getFile", { ok: true, result: { file_id: "F1", file_unique_id: "U1", file_path: "photos/pic.jpg" } });
-transport.downloadBytes = new TextEncoder().encode("jpeg-bytes");
-
-const file = await bot.downloadFile("F1", { destination: tmpFile });
-expect(file.fileName).toBe("pic.jpg");
-expect(transport.downloads).toEqual(["photos/pic.jpg"]);
-expect(await readFile(tmpFile, "utf8")).toBe("jpeg-bytes");
-```
-
-## 7. Menguji webhook
-
-`createWebhookHandler` menerima `Request` Web sungguhan:
-
-```ts
-const handler = createWebhookHandler(bot, { secretToken: "s3cret" });
-
-const response = await handler(new Request("https://example.com/telegram", {
-  method: "POST",
-  headers: { "content-type": "application/json", "x-telegram-bot-api-secret-token": "s3cret" },
-  body: JSON.stringify(createMockUpdate()),
-}));
-expect(response.status).toBe(200);
-
-// Secret salah → ditolak sebelum handler mana pun berjalan
-const rejected = await handler(new Request("https://example.com/telegram", {
-  method: "POST",
-  headers: { "content-type": "application/json", "x-telegram-bot-api-secret-token": "salah" },
-  body: JSON.stringify(createMockUpdate()),
-}));
-expect(rejected.status).toBe(401);
-```
-
-## 8. Menguji jalur error
-
-```ts
-// Telegram menolak panggilan
-transport.respond("sendMessage", { ok: false, error_code: 400, description: "Bad Request: chat not found" });
-await expect(ctx.reply("hi")).rejects.toThrow(/chat not found/);
-
-// Handler melempar — asersikan error boundary melihatnya
-const errors: unknown[] = [];
-bot.events.on("update:error", ({ error }) => errors.push(error));
-bot.onText("boom", async () => { throw new Error("boom"); });
-await bot.handleUpdate(textUpdate(1, 7, "boom"));
-expect(errors).toHaveLength(1);
-
-// handlerTimeout: update yang menggantung melempar UpdateTimeoutError sementara handler tetap berjalan
-const slow = new Bot({ token: "123456:TEST", transport, handlerTimeout: 50, branding: false, logger: { level: "silent" } });
-let finished = false;
-slow.on("message", async () => { await sleep(200); finished = true; });
-await expect(slow.handleUpdate(createMockUpdate())).rejects.toBeInstanceOf(UpdateTimeoutError);
-// nanti:
-expect(finished).toBe(true);
-```
-
-## 9. Pola Vitest / Jest
-
-**Senyapkan logger di test** — `logger: { level: "silent" }` tidak memancarkan apa pun (diuji regresi):
-
-```ts
-const bot = new Bot({ token: "123456:TEST", transport, branding: false, logger: { level: "silent" } });
-```
-
-**Transport segar per test** — jangan pernah berbagi state antar kasus:
-
-```ts
-beforeEach(() => { ({ bot, transport } = createTestBot()); });
-```
-
-**Mempercepat waktu** — untuk test `Scheduler`/TTL pakai fake timer atau interval kecil (`1ms`); parser cron murni dan bisa diuji tanpa timer:
-
-```ts
-import { nextCronOccurrence, parseCronExpression } from "@xbibzlibrary/telebibz";
-expect(parseCronExpression("*/15 * * * *")).toBeDefined();
-expect(nextCronOccurrence("0 9 * * 1", new Date("2026-08-29T00:00:00Z")).toISOString()).toContain("T09:00");
-```
-
-**Jalankan suite**: `npm test` — test E2E yang membutuhkan token asli otomatis di-skip ketika `TELEGRAM_BOT_TOKEN` tidak ada.
-
-English: [TESTING.md](TESTING.md) · 简体中文: [TESTING.zh-CN.md](TESTING.zh-CN.md)

package/docs/TESTING.md

@@ -1,203 +0,0 @@
-# Testing guide (English)
-
-Test telebibz bots fully offline: fake the transport, craft updates, assert outgoing calls, and drive whole conversations end to end.
-
-## Contents
-
-1. [The testing subpath](#1-the-testing-subpath)
-2. [MockTransport](#2-mocktransport)
-3. [Driving updates through the bot](#3-driving-updates-through-the-bot)
-4. [Asserting outgoing calls](#4-asserting-outgoing-calls)
-5. [Testing wizards end to end](#5-testing-wizards-end-to-end)
-6. [Testing file downloads](#6-testing-file-downloads)
-7. [Testing webhooks](#7-testing-webhooks)
-8. [Testing error paths](#8-testing-error-paths)
-9. [Vitest / Jest patterns](#9-vitest--jest-patterns)
-
-## 1. The testing subpath
-
-Everything ships from `@xbibzlibrary/telebibz/testing`:
-
-```ts
-import { MockTransport, createTestBot, createMockUpdate, createMockCallbackUpdate, createMockContext } from "@xbibzlibrary/telebibz/testing";
-```
-
-- `createTestBot()` → `{ bot, transport }` — a `Bot` wired to a `MockTransport`, branding off.
-- `createMockUpdate(overrides?)` → a plain text `/start` message update.
-- `createMockCallbackUpdate(overrides?)` → a callback-query update.
-- `createMockContext(bot, update?)` → a `Context` without routing anything.
-
-## 2. MockTransport
-
-`MockTransport` records every outgoing request and answers from configured responses:
-
-```ts
-const { bot, transport } = createTestBot();
-
-transport.respond("getMe", { ok: true, result: { id: 99, is_bot: true, first_name: "TestBot", username: "test_bot" } });
-transport.respond("sendMessage", { ok: true, result: { message_id: 1, date: 0, chat: { id: 1, type: "private" } } });
-transport.respond("getFile", (payload) => ({                                   // dynamic answers
-  ok: true,
-  result: { file_id: (payload as { file_id: string }).file_id, file_unique_id: "u", file_path: "documents/a.pdf" },
-}));
-```
-
-Unconfigured methods answer `{ ok: true, result: true }` — enough for calls whose result you ignore.
-
-It also implements the download members:
-
-```ts
-transport.downloadBytes = new TextEncoder().encode("file-content");
-transport.downloads;            // every file_path passed to download(), in order
-transport.fileUrl("a.pdf");     // "mock://files/a.pdf"
-```
-
-## 3. Driving updates through the bot
-
-Register handlers, then feed updates — no network, no token:
-
-```ts
-bot.on("message", async (ctx) => { await ctx.reply("hi"); });
-await bot.init();                       // exactly one getMe, like production
-
-await bot.handleUpdate(createMockUpdate({ message: { ...createMockUpdate().message!, text: "hello" } }));
-await bot.handleUpdates([updateA, updateB, updateC]);   // whole batch, parallel across chats
-```
-
-To simulate several chats, vary the chat id:
-
-```ts
-function textUpdate(updateId: number, chatId: number, text: string) {
-  const base = createMockUpdate();
-  return { ...base, update_id: updateId, message: { ...base.message!, chat: { id: chatId, type: "private" as const }, text } };
-}
-```
-
-## 4. Asserting outgoing calls
-
-Every request is recorded in `transport.calls` with its method and payload:
-
-```ts
-const replies = transport.calls
-  .filter((call) => call.method === "sendMessage")
-  .map((call) => (call.payload as { text?: string }).text);
-
-expect(replies).toEqual(["What is your name?", "How old are you?"]);
-
-// Callback keyboards:
-const markup = (transport.calls.at(-1)?.payload as { reply_markup?: { inline_keyboard: unknown[][] } }).reply_markup;
-expect(markup?.inline_keyboard).toHaveLength(2);
-```
-
-## 5. Testing wizards end to end
-
-Feed the conversation one message at a time and assert the replies the user would see:
-
-```ts
-import { Bot, Wizard } from "@xbibzlibrary/telebibz";
-
-const wizard = new Wizard()
-  .step({ id: "ask", run: async (flow) => { flow.next(); await flow.ctx.reply("Name?"); } })
-  .step({ id: "save", run: async (flow) => { await flow.ctx.reply(`Hi ${flow.ctx.message?.text}!`); } });
-bot.useWizard(wizard);
-bot.command("start", async (ctx) => { await wizard.run(ctx); });
-
-await bot.handleUpdate(textUpdate(1, 7, "/start"));
-await bot.handleUpdate(textUpdate(2, 7, "Alice"));
-
-expect(sentTexts()).toEqual(["Name?", "Hi Alice!"]);
-```
-
-Two chats, two independent wizards — interleaved updates stay isolated because same-chat updates serialize:
-
-```ts
-await bot.handleUpdate(textUpdate(1, 7, "/start"));
-await bot.handleUpdate(textUpdate(2, 8, "/start"));
-await bot.handleUpdate(textUpdate(3, 7, "Alice"));
-await bot.handleUpdate(textUpdate(4, 8, "Bob"));
-expect(sentTexts()).toEqual(["Name?", "Name?", "Hi Alice!", "Hi Bob!"]);
-```
-
-## 6. Testing file downloads
-
-```ts
-transport.respond("getFile", { ok: true, result: { file_id: "F1", file_unique_id: "U1", file_path: "photos/pic.jpg" } });
-transport.downloadBytes = new TextEncoder().encode("jpeg-bytes");
-
-const file = await bot.downloadFile("F1", { destination: tmpFile });
-expect(file.fileName).toBe("pic.jpg");
-expect(transport.downloads).toEqual(["photos/pic.jpg"]);
-expect(await readFile(tmpFile, "utf8")).toBe("jpeg-bytes");
-```
-
-## 7. Testing webhooks
-
-`createWebhookHandler` accepts a real Web `Request`:
-
-```ts
-const handler = createWebhookHandler(bot, { secretToken: "s3cret" });
-
-const response = await handler(new Request("https://example.com/telegram", {
-  method: "POST",
-  headers: { "content-type": "application/json", "x-telegram-bot-api-secret-token": "s3cret" },
-  body: JSON.stringify(createMockUpdate()),
-}));
-expect(response.status).toBe(200);
-
-// Wrong secret → rejected before any handler runs
-const rejected = await handler(new Request("https://example.com/telegram", {
-  method: "POST",
-  headers: { "content-type": "application/json", "x-telegram-bot-api-secret-token": "wrong" },
-  body: JSON.stringify(createMockUpdate()),
-}));
-expect(rejected.status).toBe(401);
-```
-
-## 8. Testing error paths
-
-```ts
-// Telegram rejects the call
-transport.respond("sendMessage", { ok: false, error_code: 400, description: "Bad Request: chat not found" });
-await expect(ctx.reply("hi")).rejects.toThrow(/chat not found/);
-
-// A handler throws — assert the error boundary saw it
-const errors: unknown[] = [];
-bot.events.on("update:error", ({ error }) => errors.push(error));
-bot.onText("boom", async () => { throw new Error("boom"); });
-await bot.handleUpdate(textUpdate(1, 7, "boom"));
-expect(errors).toHaveLength(1);
-
-// handlerTimeout: hung updates reject with UpdateTimeoutError while the handler keeps running
-const slow = new Bot({ token: "123456:TEST", transport, handlerTimeout: 50, branding: false, logger: { level: "silent" } });
-let finished = false;
-slow.on("message", async () => { await sleep(200); finished = true; });
-await expect(slow.handleUpdate(createMockUpdate())).rejects.toBeInstanceOf(UpdateTimeoutError);
-// later:
-expect(finished).toBe(true);
-```
-
-## 9. Vitest / Jest patterns
-
-**Silence the logger in tests** — `logger: { level: "silent" }` emits nothing (regression-tested):
-
-```ts
-const bot = new Bot({ token: "123456:TEST", transport, branding: false, logger: { level: "silent" } });
-```
-
-**Fresh transport per test** — never share state between cases:
-
-```ts
-beforeEach(() => { ({ bot, transport } = createTestBot()); });
-```
-
-**Fast-forwarding time** — for `Scheduler`/TTL tests use fake timers or small intervals (`1ms`); the cron parser is pure and testable without timers:
-
-```ts
-import { nextCronOccurrence, parseCronExpression } from "@xbibzlibrary/telebibz";
-expect(parseCronExpression("*/15 * * * *")).toBeDefined();
-expect(nextCronOccurrence("0 9 * * 1", new Date("2026-08-29T00:00:00Z")).toISOString()).toContain("T09:00");
-```
-
-**Run the suite**: `npm test` — E2E tests requiring a real token are skipped automatically when `TELEGRAM_BOT_TOKEN` is absent.
-
-Bahasa Indonesia: [TESTING.id.md](TESTING.id.md) · 简体中文: [TESTING.zh-CN.md](TESTING.zh-CN.md)

package/docs/TESTING.zh-CN.md

@@ -1,203 +0,0 @@
-# 测试指南（简体中文）
-
-完全离线地测试 telebibz bot：伪造传输层、构造更新、断言外发调用，并端到端驱动整段对话。
-
-## 目录
-
-1. [testing 子路径](#1-testing-子路径)
-2. [MockTransport](#2-mocktransport)
-3. [把更新送进 bot](#3-把更新送进-bot)
-4. [断言外发调用](#4-断言外发调用)
-5. [端到端测试向导](#5-端到端测试向导)
-6. [测试文件下载](#6-测试文件下载)
-7. [测试 webhook](#7-测试-webhook)
-8. [测试错误路径](#8-测试错误路径)
-9. [Vitest / Jest 模式](#9-vitest--jest-模式)
-
-## 1. testing 子路径
-
-所有工具都从 `@xbibzlibrary/telebibz/testing` 导出：
-
-```ts
-import { MockTransport, createTestBot, createMockUpdate, createMockCallbackUpdate, createMockContext } from "@xbibzlibrary/telebibz/testing";
-```
-
-- `createTestBot()` → `{ bot, transport }` —— 连接到 `MockTransport` 的 `Bot`，branding 已关闭。
-- `createMockUpdate(overrides?)` → 一条普通 `/start` 文本消息更新。
-- `createMockCallbackUpdate(overrides?)` → 一条回调查询更新。
-- `createMockContext(bot, update?)` → 不经过路由的 `Context`。
-
-## 2. MockTransport
-
-`MockTransport` 记录每个外发请求，并按配置应答：
-
-```ts
-const { bot, transport } = createTestBot();
-
-transport.respond("getMe", { ok: true, result: { id: 99, is_bot: true, first_name: "TestBot", username: "test_bot" } });
-transport.respond("sendMessage", { ok: true, result: { message_id: 1, date: 0, chat: { id: 1, type: "private" } } });
-transport.respond("getFile", (payload) => ({                                   // 动态应答
-  ok: true,
-  result: { file_id: (payload as { file_id: string }).file_id, file_unique_id: "u", file_path: "documents/a.pdf" },
-}));
-```
-
-未配置的方法应答 `{ ok: true, result: true }` —— 对结果无所谓的调用足够了。
-
-它还实现了下载成员：
-
-```ts
-transport.downloadBytes = new TextEncoder().encode("file-content");
-transport.downloads;            // 每个传给 download() 的 file_path，按顺序
-transport.fileUrl("a.pdf");     // "mock://files/a.pdf"
-```
-
-## 3. 把更新送进 bot
-
-注册 handler，然后投喂更新 —— 无网络、无 token：
-
-```ts
-bot.on("message", async (ctx) => { await ctx.reply("hi"); });
-await bot.init();                       // 恰好一次 getMe，与生产一致
-
-await bot.handleUpdate(createMockUpdate({ message: { ...createMockUpdate().message!, text: "hello" } }));
-await bot.handleUpdates([updateA, updateB, updateC]);   // 整批投喂，跨 chat 并行
-```
-
-模拟多个 chat 时，变换 chat id：
-
-```ts
-function textUpdate(updateId: number, chatId: number, text: string) {
-  const base = createMockUpdate();
-  return { ...base, update_id: updateId, message: { ...base.message!, chat: { id: chatId, type: "private" as const }, text } };
-}
-```
-
-## 4. 断言外发调用
-
-每个请求连同 method 与 payload 记录在 `transport.calls`：
-
-```ts
-const replies = transport.calls
-  .filter((call) => call.method === "sendMessage")
-  .map((call) => (call.payload as { text?: string }).text);
-
-expect(replies).toEqual(["你叫什么名字？", "你多大了？"]);
-
-// 回调键盘：
-const markup = (transport.calls.at(-1)?.payload as { reply_markup?: { inline_keyboard: unknown[][] } }).reply_markup;
-expect(markup?.inline_keyboard).toHaveLength(2);
-```
-
-## 5. 端到端测试向导
-
-逐条消息推进对话，并断言用户将看到的回复：
-
-```ts
-import { Bot, Wizard } from "@xbibzlibrary/telebibz";
-
-const wizard = new Wizard()
-  .step({ id: "ask", run: async (flow) => { flow.next(); await flow.ctx.reply("你叫什么名字？"); } })
-  .step({ id: "save", run: async (flow) => { await flow.ctx.reply(`你好，${flow.ctx.message?.text}！`); } });
-bot.useWizard(wizard);
-bot.command("start", async (ctx) => { await wizard.run(ctx); });
-
-await bot.handleUpdate(textUpdate(1, 7, "/start"));
-await bot.handleUpdate(textUpdate(2, 7, "小明"));
-
-expect(sentTexts()).toEqual(["你叫什么名字？", "你好，小明！"]);
-```
-
-两个 chat、两个独立向导 —— 交错投喂依然隔离，因为同一 chat 的更新按序串行：
-
-```ts
-await bot.handleUpdate(textUpdate(1, 7, "/start"));
-await bot.handleUpdate(textUpdate(2, 8, "/start"));
-await bot.handleUpdate(textUpdate(3, 7, "小明"));
-await bot.handleUpdate(textUpdate(4, 8, "小红"));
-expect(sentTexts()).toEqual(["你叫什么名字？", "你叫什么名字？", "你好，小明！", "你好，小红！"]);
-```
-
-## 6. 测试文件下载
-
-```ts
-transport.respond("getFile", { ok: true, result: { file_id: "F1", file_unique_id: "U1", file_path: "photos/pic.jpg" } });
-transport.downloadBytes = new TextEncoder().encode("jpeg-bytes");
-
-const file = await bot.downloadFile("F1", { destination: tmpFile });
-expect(file.fileName).toBe("pic.jpg");
-expect(transport.downloads).toEqual(["photos/pic.jpg"]);
-expect(await readFile(tmpFile, "utf8")).toBe("jpeg-bytes");
-```
-
-## 7. 测试 webhook
-
-`createWebhookHandler` 接受真实的 Web `Request`：
-
-```ts
-const handler = createWebhookHandler(bot, { secretToken: "s3cret" });
-
-const response = await handler(new Request("https://example.com/telegram", {
-  method: "POST",
-  headers: { "content-type": "application/json", "x-telegram-bot-api-secret-token": "s3cret" },
-  body: JSON.stringify(createMockUpdate()),
-}));
-expect(response.status).toBe(200);
-
-// 错误 secret → 在任何 handler 运行前被拒绝
-const rejected = await handler(new Request("https://example.com/telegram", {
-  method: "POST",
-  headers: { "content-type": "application/json", "x-telegram-bot-api-secret-token": "wrong" },
-  body: JSON.stringify(createMockUpdate()),
-}));
-expect(rejected.status).toBe(401);
-```
-
-## 8. 测试错误路径
-
-```ts
-// Telegram 拒绝调用
-transport.respond("sendMessage", { ok: false, error_code: 400, description: "Bad Request: chat not found" });
-await expect(ctx.reply("hi")).rejects.toThrow(/chat not found/);
-
-// handler 抛异常 —— 断言错误边界看到了它
-const errors: unknown[] = [];
-bot.events.on("update:error", ({ error }) => errors.push(error));
-bot.onText("boom", async () => { throw new Error("boom"); });
-await bot.handleUpdate(textUpdate(1, 7, "boom"));
-expect(errors).toHaveLength(1);
-
-// handlerTimeout：挂起的更新以 UpdateTimeoutError 拒绝，而 handler 继续运行
-const slow = new Bot({ token: "123456:TEST", transport, handlerTimeout: 50, branding: false, logger: { level: "silent" } });
-let finished = false;
-slow.on("message", async () => { await sleep(200); finished = true; });
-await expect(slow.handleUpdate(createMockUpdate())).rejects.toBeInstanceOf(UpdateTimeoutError);
-// 稍后：
-expect(finished).toBe(true);
-```
-
-## 9. Vitest / Jest 模式
-
-**测试中静音 logger** —— `logger: { level: "silent" }` 不输出任何内容（有回归测试）：
-
-```ts
-const bot = new Bot({ token: "123456:TEST", transport, branding: false, logger: { level: "silent" } });
-```
-
-**每个测试全新 transport** —— 不要在用例间共享状态：
-
-```ts
-beforeEach(() => { ({ bot, transport } = createTestBot()); });
-```
-
-**快进时间** —— `Scheduler`/TTL 测试用假定时器或小间隔（`1ms`）；cron 解析器是纯函数，无需定时器：
-
-```ts
-import { nextCronOccurrence, parseCronExpression } from "@xbibzlibrary/telebibz";
-expect(parseCronExpression("*/15 * * * *")).toBeDefined();
-expect(nextCronOccurrence("0 9 * * 1", new Date("2026-08-29T00:00:00Z")).toISOString()).toContain("T09:00");
-```
-
-**运行套件**：`npm test` —— 缺少 `TELEGRAM_BOT_TOKEN` 时，需要真实 token 的 E2E 测试自动跳过。
-
-English: [TESTING.md](TESTING.md) · Bahasa Indonesia: [TESTING.id.md](TESTING.id.md)