@xbibzlibrary/telebibz 0.1.2 → 0.1.4

package/docs/README.md

@@ -1,21 +1,40 @@
-# 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 |
-
-## Prinsip dokumentasi
-
-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.
+| 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` |
+| Governance and community | `CODE_OF_CONDUCT.md`, `GOVERNANCE.md`, `CONTRIBUTING.md`, and `CONTRIBUTION_RULES.md` |
+| Security and support | `SECURITY.md` and `SUPPORT.md` |
+| Third-party notices | `NOTICE.md` and `LICENSE` |
+| GitHub contribution templates | Bug, feature, documentation, question/support, security notice, and pull request templates under `.github/` |
+
+## GitHub templates
+
+Issue forms are available for bug reports, feature requests, documentation problems, and support questions. A security notice template redirects reporters to the private process in `SECURITY.md`; vulnerabilities must not be disclosed in public issues. Pull requests use `.github/PULL_REQUEST_TEMPLATE/pull_request_template.md` to require tests, documentation, compatibility, and security checks.
+
+## Documentation principle
+
+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,21 +1,29 @@
 {
   "name": "@xbibzlibrary/telebibz",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Production-grade, strongly typed Telegram Bot API SDK and framework for Node.js and TypeScript.",
   "type": "module",
   "private": false,
   "publishConfig": {
     "access": "public",
-    "provenance": true
+    "provenance": false
   },
   "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,20 @@
     "dist-cjs",
     "bin",
     "README.md",
+    "README.id.md",
+    "README.zh-CN.md",
     "LICENSE",
     "CHANGELOG.md",
     "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "CONTRIBUTING.md",
+    "CONTRIBUTION_RULES.md",
+    "GOVERNANCE.md",
+    "SUPPORT.md",
+    "NOTICE.md",
     "APPROVAL_FEATURE.md",
     "RELEASE_POLICY.md",
+    "RELEASE_AUTOMATION.md",
     "assets",
     "docs"
   ],