Fetch API & Edge Runtime โ
createFetchHandler() mengembalikan webhook handler standar Web (request: Request) => Promise<Response>. Handler ini hanya memakai primitif Fetch API, sehingga kode bot yang sama berjalan di Cloudflare Workers, Deno, Bun, Vercel / Netlify Edge, route handler Next.js, dan Node.js 20+.
import { Bot, createFetchHandler } from 'vibegram';
const bot = new Bot(process.env.BOT_TOKEN!);
bot.on(':text', ctx => ctx.reply(`Kamu bilang: ${ctx.message.text}`));
const handleWebhook = createFetchHandler(bot, {
secretToken: process.env.WEBHOOK_SECRET,
healthPath: '/healthz',
});Opsi โ
| Opsi | Default | Deskripsi |
|---|---|---|
secretToken | โ | Nilai X-Telegram-Bot-Api-Secret-Token yang wajib cocok. Sangat disarankan di production. |
healthPath | โ | Path GET yang membalas 200 OK tanpa memproses update. |
maxBodySizeBytes | 1_000_000 | Body yang lebih besar dibalas 413 Payload Too Large (dicek saat streaming). |
waitUntil | โ | Balas Telegram segera lalu selesaikan update di background, misalnya ctx.waitUntil milik Cloudflare. Error kemudian hanya sampai ke bot.catch() dan hook observability. |
Respons: 200 berhasil ยท 403 secret salah ยท 405 bukan POST ยท 415 bukan JSON ยท 400 JSON atau update tidak valid ยท 413 terlalu besar ยท 500 error handler (tanpa waitUntil).
Cloudflare Workers โ
Secret hanya tersedia di dalam fetch(), jadi buat bot secara lazy lalu pakai ulang:
import { Bot, createFetchHandler } from 'vibegram';
interface Env {
BOT_TOKEN: string;
WEBHOOK_SECRET: string;
}
let handler: ((request: Request) => Promise<Response>) | undefined;
export default {
fetch(request: Request, env: Env, ctx: ExecutionContext) {
handler ??= (() => {
const bot = new Bot(env.BOT_TOKEN);
bot.command('start', ctx => ctx.reply('Halo dari edge!'));
return createFetchHandler(bot, {
secretToken: env.WEBHOOK_SECRET,
waitUntil: promise => ctx.waitUntil(promise),
});
})();
return handler(request);
},
};Deno โ
import { Bot, createFetchHandler } from 'npm:vibegram';
const bot = new Bot(Deno.env.get('BOT_TOKEN')!);
bot.command('start', ctx => ctx.reply('Halo dari Deno!'));
Deno.serve(createFetchHandler(bot, { secretToken: Deno.env.get('WEBHOOK_SECRET') }));Bun โ
import { Bot, createFetchHandler } from 'vibegram';
const bot = new Bot(Bun.env.BOT_TOKEN!);
bot.command('start', ctx => ctx.reply('Halo dari Bun!'));
Bun.serve({ port: 3000, fetch: createFetchHandler(bot, { secretToken: Bun.env.WEBHOOK_SECRET }) });Next.js (App Router) / Vercel โ
// app/api/telegram/route.ts
import { Bot, createFetchHandler } from 'vibegram';
export const runtime = 'edge'; // atau 'nodejs'
const bot = new Bot(process.env.BOT_TOKEN!);
bot.command('start', ctx => ctx.reply('Halo dari Next.js!'));
export const POST = createFetchHandler(bot, { secretToken: process.env.WEBHOOK_SECRET });Mendaftarkan webhook โ
Handler serverless hanya menerima update; daftarkan URL-nya sekali, misalnya dari script deploy:
await bot.setWebhook('https://example.com/api/telegram', {
secret_token: process.env.WEBHOOK_SECRET,
allowed_updates: ['message', 'callback_query'],
});Dukungan runtime โ
Entry point utama vibegram tidak memuat modul bawaan Node.js dan tidak membutuhkan global Buffer; sebuah test CI memastikan hal ini untuk setiap import yang terjangkau dari src/index.ts.
| Fitur | Node.js 20+ | Bun / Deno | Edge (Workers, Vercel Edge) |
|---|---|---|---|
Panggilan Bot API, middleware, session, createFetchHandler | โ | โ | โ |
Upload dari Buffer / Uint8Array / { source, filename } | โ | โ | โ
(Uint8Array) |
WebAppUtils.validate() | โ | โ | โ |
Long polling (bot.launch()) | โ | โ | โ tidak ada proses yang berjalan lama |
Server webhook bawaan (launch({ webhook })), createNativeHandler | โ | โ lewat Node compat | โ pakai createFetchHandler |
downloadFile(id, destPath) ke disk | โ | โ lewat Node compat | โ pakai downloadFile(id) atau getFileLink() |
@vibegram/codex | โ | โ ๏ธ butuh API Node | โ |
Status verifikasi
Node.js dicakup oleh seluruh test suite. Bun, Deno, dan edge runtime ditargetkan secara desain dan diverifikasi lewat simulasi (pelacak import dan pelacak akses Buffer pada build ESM), tetapi belum lewat eksekusi otomatis di runtime tersebut.