balebaazoo 1.0.0

package/README.en.md

@@ -0,0 +1,61 @@
+# balebaazoo
+
+Modern, type-safe TypeScript SDK for the [Bale Bot API](https://docs.bale.ai/).
+
+[![npm version](https://img.shields.io/npm/v/balebaazoo)](https://www.npmjs.com/package/balebaazoo)
+[![CI](https://github.com/HadiMardanian/baleBaazooSDK/actions/workflows/ci.yml/badge.svg)](https://github.com/HadiMardanian/baleBaazooSDK/actions/workflows/ci.yml)
+
+## Install
+
+```bash
+npm install balebaazoo
+```
+
+Requires Node.js 18+.
+
+## Quick start
+
+```typescript
+import { Bot, InlineKeyboard } from "balebaazoo";
+
+const bot = new Bot(process.env.BOT_TOKEN!);
+
+bot.command("start", (ctx) =>
+  ctx.reply("Hello! Welcome to my bot.", {
+    reply_markup: new InlineKeyboard().text("About", "about"),
+  }),
+);
+
+bot.on("callback_query:data", async (ctx) => {
+  await ctx.answerCallbackQuery();
+  await ctx.reply("More info...");
+});
+
+bot.start();
+```
+
+## Features
+
+- Full Bale Bot API client with TypeScript types
+- Bot framework: middleware, filters, commands, composers
+- Polling and webhook support
+- Context shortcuts (`ctx.reply`, `ctx.replyWithPhoto`, ...)
+- Wallet payments, `askReview`, `inquireTransaction`
+- Zero runtime dependencies
+
+## Documentation
+
+- **English:** this README
+- **Persian (full guide):** [docs/fa/usage.md](docs/fa/usage.md)
+
+## Examples
+
+```bash
+npm run example:echo
+```
+
+See [`examples/`](examples/) for more.
+
+## License
+
+GPL-3.0-or-later

package/README.md

@@ -0,0 +1,70 @@
+# balebaazoo
+
+SDK مدرن و type-safe برای توسعهٔ بازو (Bot) در پیام‌رسان بله.
+
+[![npm version](https://img.shields.io/npm/v/balebaazoo)](https://www.npmjs.com/package/balebaazoo)
+
+بر پایهٔ [مستندات رسمی API بازوی بله](https://docs.bale.ai/) ساخته شده است.
+
+**English:** [README.en.md](README.en.md)
+
+## مستندات فارسی
+
+- **[راهنمای کامل استفاده](docs/fa/usage.md)**
+- **[راهنمای انتشار npm](docs/fa/publishing.md)**
+
+## نصب
+
+```bash
+npm install balebaazoo
+```
+
+## شروع سریع
+
+```typescript
+import { Bot, InlineKeyboard } from "balebaazoo";
+
+const bot = new Bot(process.env.BOT_TOKEN!);
+
+bot.command("start", (ctx) =>
+  ctx.reply("سلام! به بازو خوش آمدید 👋", {
+    reply_markup: new InlineKeyboard().text("درباره ما", "about"),
+  }),
+);
+
+bot.on("callback_query:data", async (ctx) => {
+  await ctx.answerCallbackQuery();
+  await ctx.reply("اطلاعات بیشتر...");
+});
+
+bot.start();
+```
+
+## ویژگی‌ها
+
+- **Type-safe** — تایپ‌های کامل TypeScript برای API و handlerها
+- **Middleware** — سیستم middleware و `Composer` برای ساختار ماژولار
+- **Filter queries** — `message:text`، `callback_query:data`، `pre_checkout_query` و ...
+- **Shortcuts** — `ctx.reply()`، `ctx.replyWithPhoto()`، `ctx.answerCallbackQuery()`
+- **Polling و Webhook** — `bot.start()` و `webhookFromJson()`
+- **Bale-native** — `askReview`، `inquireTransaction`، کیف‌پول، Markdown بله
+- **بدون dependency** — فقط Node.js 18+ با fetch بومی
+
+## مثال‌ها
+
+- [`examples/echo-bot.ts`](examples/echo-bot.ts)
+- [`examples/inline-keyboard.ts`](examples/inline-keyboard.ts)
+- [`examples/payment-bot.ts`](examples/payment-bot.ts)
+- [`examples/webhook-server.ts`](examples/webhook-server.ts)
+
+## توسعه
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## لایسنس
+
+GPL-3.0-or-later