Instalasi

Runtime

Node.js 18+

Sesuai engines package

Output

CJS + ESM

Aman untuk setup Node modern

Types

Strict TS

Deklarasi tipe tersedia

Install package

npm install vibegram

Feature	Support	CJS	ESM	Node	Notes
Runtime	Node.js 18+	yes	yes	18, 20, 22	Matches package engines.
Module output	Dual package	dist/cjs	dist/esm	18+	Types are emitted under dist/types.
Docs deployment	Static	-	-	18+	Safe for GitHub Pages.

Jaga secret tetap di luar repository

Install package di project aplikasi Anda, lalu baca token bot dari environment variable. Jangan commit file `.env` atau token Telegram asli.

Prasyarat

• Node.js versi 18.0 atau lebih baru
• npm atau yarn

Cek versi Node.js Anda:

node --version   # harus >= 18.0.0

Install Package

npm install vibegram

Atau menggunakan yarn:

yarn add vibegram

Inisialisasi Proyek TypeScript

Jika belum ada proyek TypeScript:

mkdir my-bot && cd my-bot
npm init -y
npm install vibegram
npm install -D typescript @types/node ts-node
npx tsc --init

Konfigurasi tsconfig.json yang direkomendasikan:

{
    "compilerOptions": {
        "target": "ES2022",
        "module": "CommonJS",
        "moduleResolution": "node",
        "strict": true,
        "esModuleInterop": true,
        "outDir": "./dist",
        "rootDir": "./src"
    },
    "include": ["src/**/*"]
}

Mendapatkan Token Bot

1. Buka Telegram dan cari @BotFather
2. Kirim /newbot dan ikuti petunjuknya
3. Simpan token yang diberikan di variabel lingkungan

# .env
BOT_TOKEN=1234567890:ABCDefGHIjklMNOpqrSTUvwxYZ

Gunakan dotenv untuk memuat .env:

npm install dotenv

import 'dotenv/config';

Bot Pertama Anda

Buat file src/index.ts:

import { Bot } from 'vibegram';

const bot = new Bot(process.env.BOT_TOKEN!);

bot.command('start', async ctx => {
    const nama = ctx.from?.first_name || 'kawan';
    await ctx.reply(`👋 Halo ${nama}! Selamat datang di bot saya.`);
});

bot.hears(/halo|hai/i, async ctx => {
    await ctx.reply('Halo! Ada yang bisa saya bantu?');
});

bot.launch().then(() => console.log('Bot berjalan! 🚀'));

Jalankan:

npx ts-node src/index.ts

Struktur Proyek yang Direkomendasikan

my-bot/
├── src/
│   ├── index.ts          # Entry point bot
│   ├── handlers/
│   │   ├── commands.ts   # Handler command (/start, /help, dll)
│   │   ├── actions.ts    # Handler callback query
│   │   └── conversations.ts  # Conversation engine
│   ├── middlewares/
│   │   └── auth.ts       # Middleware kustom
│   └── scenes/
│       └── checkout.ts   # Scene wizard
├── .env
├── package.json
└── tsconfig.json

Langkah Selanjutnya

• Instansi Bot & Polling — Pelajari opsi konfigurasi
• Pipeline Middleware — Pahami cara kerja routing
• Session — Simpan data per-pengguna