@xbibzlibrary/telebibz 0.1.2 → 0.1.3

package/docs/README.md

@@ -1,21 +1,32 @@
-# Dokumentasi telebibz
+# telebibz Documentation
 
-Dokumentasi ini disusun menurut lifecycle aplikasi: mulai dari bot paling sederhana, API client dan transport, update routing, middleware dan context, state/session, interaction UI, background work, deployment, lalu testing dan migration.
+The default documentation language is **English**. Translated README and API references are available below.
+
+| Language | README | Complete API reference |
+|---|---|---|
+| English (default) | [`README.md`](../README.md) | [`API.md`](API.md) |
+| Bahasa Indonesia | [`README.id.md`](../README.id.md) | [`API.id.md`](API.id.md) |
+| 简体中文 | [`README.zh-CN.md`](../README.zh-CN.md) | [`API.zh-CN.md`](API.zh-CN.md) |
+
+![telebibz overview](../assets/telebibz-readme-preview.png)
+
+The API references are organized by lifecycle: bot startup and shutdown, API client and transport, update routing, middleware and context, state/session, interaction UI, background work, deployment, testing, and migration boundaries.
 
 | Area | Status |
 |---|---|
-| Getting started | Tersedia di `README.md` |
-| Bot lifecycle, polling, webhook | Core implementation dan tests tersedia |
-| API client dan generated method list | Tersedia; object type generation masih partial |
-| Router, middleware, context | Tersedia dan diuji |
-| Keyboard, callback, menus, pagination | Keyboard/callback core tersedia; menu/pagination lanjutan partial |
-| Sessions, conversations, scenes, wizard, forms | Memory session dan primitives forms/conversation tersedia; integration lanjutan partial |
-| Storage, cache, queue, scheduler | Memory primitives tersedia; distributed adapters belum tersedia |
-| Plugins, services, observability | Lifecycle/plugin/service hooks tersedia |
-| Mini Apps, payments, business features | Raw API access tersedia; high-level subsystem belum lengkap |
-| Testing dan security | Unit, integration, type-level, gated E2E, CI, security policy tersedia |
-| Deployment dan migration | Roadmap dan package boundaries perlu diperluas sebelum stable release |
+| Getting started | Available in all three README files |
+| Complete API reference | Available in English, Indonesian, and Simplified Chinese |
+| Bot lifecycle, polling, webhook | Core implementation, per-update error isolation, reconnect backoff, and tests available |
+| API client and generated method list | Available; full vendored Telegram declarations are exposed through `TelegramTypes` |
+| Router, middleware, context | Available and tested; first-match is default, all-match is explicit |
+| Keyboard, callback, menus, pagination | Keyboard/callback core, permission menus, MenuController, and pagination available |
+| Sessions, conversations, wizards, forms | Storage-backed session/conversation primitives and forms available; scene orchestration remains application-owned |
+| Storage, cache, queue, scheduler | Memory, JSON file, Redis, SQL, Mongo driver adapters, cache, queue, and full five-field cron available |
+| Plugins, services, observability | Lifecycle/plugin/service hooks available |
+| Mini Apps, payments, business features | Web App signature validation and PaymentsClient wrappers available; UI is application-owned |
+| Testing and security | Unit, integration, type-level, gated E2E, CI, and security policy available |
+| Deployment and migration | Release automation is documented in `RELEASE_AUTOMATION.md` |
 
-## Prinsip dokumentasi
+## Documentation principle
 
-Dokumentasi tidak akan menyebut fitur `production-ready` jika implementasi, test, atau adapter-nya belum benar-benar tersedia. Batas native Telegram dan kemampuan Mini App/Web App harus dijelaskan terpisah agar API tidak menjanjikan kemampuan yang tidak dimiliki Telegram.
+The documentation describes only capabilities that are implemented and tested in the current package. Telegram-native API access, Mini App/Web App behavior, external persistence, and distributed adapters are described separately so the documentation does not promise features that are not included.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbibzlibrary/telebibz",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Production-grade, strongly typed Telegram Bot API SDK and framework for Node.js and TypeScript.",
   "type": "module",
   "private": false,
@@ -9,13 +9,21 @@
     "provenance": true
   },
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/XbibzOfficial777/telebibz.git"
+  },
+  "homepage": "https://github.com/XbibzOfficial777/telebibz#readme",
+  "bugs": {
+    "url": "https://github.com/XbibzOfficial777/telebibz/issues"
+  },
   "engines": {
     "node": ">=20"
   },
   "scripts": {
     "generate": "node scripts/generate-api.mjs",
     "update:telegram": "node scripts/fetch-telegram-api.mjs && npm run generate",
-    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/create-cjs-package.mjs",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/create-cjs-package.mjs && node scripts/copy-telegram-types.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "tsc -p tsconfig.json --noEmit && eslint scripts/*.mjs bin/*.mjs --no-error-on-unmatched-pattern",
     "test": "vitest run",
@@ -62,11 +70,14 @@
     "dist-cjs",
     "bin",
     "README.md",
+    "README.id.md",
+    "README.zh-CN.md",
     "LICENSE",
     "CHANGELOG.md",
     "SECURITY.md",
     "APPROVAL_FEATURE.md",
     "RELEASE_POLICY.md",
+    "RELEASE_AUTOMATION.md",
     "assets",
     "docs"
   ],