@xbibzlibrary/telebibz 0.1.13 → 0.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.id.md +2 -2
  2. package/README.zh-CN.md +2 -2
  3. package/RELEASE_AUTOMATION.md +5 -9
  4. package/package.json +1 -1
package/README.id.md CHANGED
@@ -145,7 +145,7 @@ Daftar method dihasilkan dari dokumentasi Telegram Bot API saat skema diperbarui
145
145
 
146
146
  ## Otomatisasi release
147
147
 
148
- Repository GitHub menyediakan CI dan workflow auto-publish. Setiap push ke `main` menjalankan quality gates, memilih patch version yang belum dipakai, membuat commit dan tag, menerbitkan tarball yang sama ke npmjs dan GitHub Packages, lalu membuat GitHub Release. Karena source repository bersifat private, workflow menggunakan `--provenance=false` untuk npmjs. GitHub Packages memakai `GITHUB_TOKEN` dengan permission `packages: write`. Konfigurasikan secret `NPM_TOKEN` pada GitHub Actions sebelum mengandalkan publish otomatis. Lihat [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) dan panduan [GitHub Packages](docs/GITHUB_PACKAGES.id.md).
148
+ Repository GitHub menyediakan CI dan workflow auto-publish. Setiap push ke `main` menjalankan quality gates, memilih patch version yang belum dipakai, membuat commit dan tag, menerbitkan package ke npmjs, lalu membuat GitHub Release. Karena source repository bersifat private, workflow menggunakan `--provenance=false`. GitHub Packages tersedia sebagai opsi terpisah jika organisasi GitHub dengan scope `xbibzlibrary` dibuat kemudian. Konfigurasikan secret `NPM_TOKEN` pada GitHub Actions sebelum mengandalkan publish otomatis. Lihat [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) dan panduan [GitHub Packages](docs/GITHUB_PACKAGES.id.md).
149
149
 
150
150
  ## Policy project dan kontribusi
151
151
 
@@ -157,7 +157,7 @@ Repository GitHub menyediakan CI dan workflow auto-publish. Setiap push ke `main
157
157
  | [GOVERNANCE.md](GOVERNANCE.md) | Peran, pengambilan keputusan, triage, perlindungan repository, dan perubahan aturan. |
158
158
  | [SECURITY.md](SECURITY.md) | Pelaporan vulnerability privat, batas security, dan rotasi credential. |
159
159
  | [SUPPORT.md](SUPPORT.md) | Channel support, aturan laporan aman, dan ekspektasi response. |
160
- | [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) | Automation GitHub-to-npm/GitHub Packages dan setup `NPM_TOKEN`. |
160
+ | [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) | Automation GitHub-to-npm dan setup `NPM_TOKEN`. |
161
161
  | [RELEASE_POLICY.md](RELEASE_POLICY.md) | Kontrol immutable release dan hardening. |
162
162
  | [NOTICE.md](NOTICE.md) | Atribusi declaration pihak ketiga. |
163
163
 
package/README.zh-CN.md CHANGED
@@ -145,7 +145,7 @@ npm run release:check
145
145
 
146
146
  ## 发布自动化
147
147
 
148
- GitHub repository 提供 CI 和自动发布 workflow。每次推送到 `main` 都会运行 quality gates，选择尚未使用的 patch version，创建 commit 和 tag，将相同的 tarball 发布到 npmjs 和 GitHub Packages，然后创建 GitHub Release。由于 source repository 是 private，npmjs 发布使用 `--provenance=false`；GitHub Packages 使用带有 `packages: write` 权限的 `GITHUB_TOKEN`。依赖自动发布前，请在 GitHub Actions 中配置 `NPM_TOKEN` secret。请参阅 [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) 和 [GitHub Packages 指南](docs/GITHUB_PACKAGES.zh-CN.md)。
148
+ GitHub repository 提供 CI 和自动发布 workflow。每次推送到 `main` 都会运行 quality gates，选择尚未使用的 patch version，创建 commit 和 tag，将 package 发布到 npmjs，然后创建 GitHub Release。由于 source repository 是 private，npmjs 发布使用 `--provenance=false`。如果以后创建了 scope 为 `xbibzlibrary` 的 GitHub organization，GitHub Packages 可以作为独立选项启用。依赖自动发布前，请在 GitHub Actions 中配置 `NPM_TOKEN` secret。请参阅 [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) 和 [GitHub Packages 指南](docs/GITHUB_PACKAGES.zh-CN.md)。
149
149
 
150
150
  ## 项目 policy 和贡献
151
151
 
@@ -157,7 +157,7 @@ GitHub repository 提供 CI 和自动发布 workflow。每次推送到 `main`
157
157
  | [GOVERNANCE.md](GOVERNANCE.md) | 角色、决策、triage、repository protection 和规则修改。 |
158
158
  | [SECURITY.md](SECURITY.md) | 私密漏洞报告、security boundary 和 credential rotation。 |
159
159
  | [SUPPORT.md](SUPPORT.md) | Support channel、安全报告规则和 response 预期。 |
160
- | [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) | GitHub-to-npm/GitHub Packages automation 和 `NPM_TOKEN` setup。 |
160
+ | [RELEASE_AUTOMATION.md](RELEASE_AUTOMATION.md) | GitHub-to-npm automation 和 `NPM_TOKEN` setup。 |
161
161
  | [RELEASE_POLICY.md](RELEASE_POLICY.md) | Immutable release 和 hardening 控制。 |
162
162
  | [NOTICE.md](NOTICE.md) | 第三方 declaration attribution。 |
163
163
 
package/RELEASE_AUTOMATION.md CHANGED
@@ -1,6 +1,6 @@
1
- # GitHub-to-npm and GitHub Packages Release Automation
1
+ # GitHub-to-npm Release Automation
2
2
 
3
- Repository ini menggunakan GitHub Actions untuk menjaga source GitHub, package npmjs, dan package GitHub Packages tetap sinkron melalui satu jalur release yang tervalidasi. Repository source tetap private; karena itu workflow menggunakan npm publish tanpa provenance, sesuai batasan registry npm untuk source private. Panduan instalasi GitHub Packages tersedia dalam [English](docs/GITHUB_PACKAGES.md), [Bahasa Indonesia](docs/GITHUB_PACKAGES.id.md), dan [简体中文](docs/GITHUB_PACKAGES.zh-CN.md).
3
+ Repository ini menggunakan GitHub Actions untuk menjaga source GitHub dan package npmjs tetap sinkron melalui satu jalur release yang tervalidasi. Repository source tetap private; karena itu workflow menggunakan npm publish tanpa provenance, sesuai batasan registry npm untuk source private. GitHub digunakan sebagai source code, tempat workflow, tag, dan GitHub Release. Panduan GitHub Packages tersedia sebagai opsi terpisah jika organisasi GitHub dengan scope `xbibzlibrary` dibuat kemudian.
4
4
 
5
5
  ## Alur otomatis
6
6
 
@@ -12,24 +12,21 @@ Setiap push ke branch `main` menjalankan workflow `.github/workflows/auto-publis
12
12
  | Install | Menjalankan `npm ci --ignore-scripts`. |
13
13
  | Version | Membaca versi dari `package.json`, membaca versi latest npm, lalu memilih patch version berikutnya yang lebih tinggi dari keduanya. |
14
14
  | Verification | Menjalankan typecheck, type-level tests, lint, runtime tests, build ESM/CommonJS, security audit, dan release check. |
15
- | Immutable guard | Menolak publish jika versi target sudah ada di npmjs atau GitHub Packages. |
15
+ | Immutable guard | Menolak publish jika versi target sudah ada di npmjs. |
16
16
  | Git sync | Commit otomatis `chore(release): vX.Y.Z [skip release]`, membuat annotated tag `vX.Y.Z`, lalu push commit dan tag ke GitHub. |
17
- | npmjs publish | Menerbitkan tarball terverifikasi ke npmjs menggunakan `NPM_TOKEN`; provenance dinonaktifkan karena npm menolak provenance dari source repository private. |
18
- | GitHub Packages publish | Menerbitkan tarball yang sama ke `https://npm.pkg.github.com` menggunakan `GITHUB_TOKEN` dan permission `packages: write`. |
17
+ | npmjs publish | Menerbitkan package public menggunakan `NPM_TOKEN`; provenance dinonaktifkan karena npm menolak provenance dari source repository private. |
19
18
  | GitHub Release | Membuat GitHub Release dengan generated notes. |
20
19
 
21
20
  Push commit version otomatis tidak memicu release kedua karena mengandung `[skip release]`. Workflow menggunakan concurrency sehingga release berjalan satu per satu.
22
21
 
23
22
  ## Secret dan permission yang wajib tersedia
24
23
 
25
- Workflow membutuhkan `packages: write` untuk GitHub Packages dan `contents: write` untuk version bump, tag, serta GitHub Release. Buka repository GitHub, kemudian masuk ke **Settings → Secrets and variables → Actions** dan tambahkan repository atau environment secret berikut:
24
+ Workflow membutuhkan `contents: write` untuk version bump, tag, dan GitHub Release. Buka repository GitHub, kemudian masuk ke **Settings → Secrets and variables → Actions** dan tambahkan repository atau environment secret berikut:
26
25
 
27
26
  ```text
28
27
  NPM_TOKEN=${NPM_TOKEN}
29
28
  ```
30
29
 
31
- GitHub Packages menggunakan `GITHUB_TOKEN` bawaan Actions; tidak perlu membuat atau menyimpan GitHub PAT sebagai repository secret untuk package yang diterbitkan oleh workflow repository ini.
32
-
33
30
  Jika memakai GitHub Environment bernama `npm-release`, secret dapat disimpan sebagai environment secret dan environment tersebut dapat diberi required reviewers untuk approval manual sebelum publish.
34
31
 
35
32
  Jangan menyimpan token di repository, `.npmrc`, source code, issue, commit, atau workflow. Token npm yang pernah ditempelkan di chat harus dicabut dan diganti dengan granular token baru.
@@ -66,5 +63,4 @@ Setelah workflow selesai, verifikasi:
66
63
 
67
64
  ```bash
68
65
  npm view @xbibzlibrary/telebibz version dist.integrity dist.tarball
69
- npm view @xbibzlibrary/telebibz version --registry=https://npm.pkg.github.com
70
66
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xbibzlibrary/telebibz",
3
- "version": "0.1.13",
3
+ "version": "0.1.15",
4
4
  "description": "Production-grade, strongly typed Telegram Bot API SDK and framework for Node.js and TypeScript.",
5
5
  "type": "module",
6
6
  "private": false,