Skip to content

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+.

typescript
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 โ€‹

OpsiDefaultDeskripsi
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.
maxBodySizeBytes1_000_000Body 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:

typescript
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 โ€‹

typescript
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 โ€‹

typescript
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 โ€‹

typescript
// 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:

typescript
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.

FiturNode.js 20+Bun / DenoEdge (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.

Released under the ISC License.