fbchat-v2 2.2.0__tar.gz → 2.3.0__tar.gz

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 (100) hide show
  1. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/.gitignore +5 -4
  2. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/CHANGELOG.md +39 -1
  3. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/PKG-INFO +55 -51
  4. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/README.md +631 -631
  5. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/README_EN.md +640 -639
  6. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/pyproject.toml +31 -13
  7. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/__init__.py +3 -2
  8. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/README.md +388 -387
  9. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/README_EN.md +371 -370
  10. fbchat_v2-2.3.0/src/fbchat_v2/_core/__init__.py +27 -0
  11. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_facebookLogin.py +541 -523
  12. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_http.py +97 -81
  13. fbchat_v2-2.3.0/src/fbchat_v2/_core/_permissions.py +144 -0
  14. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_session.py +171 -152
  15. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_storage.py +122 -103
  16. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_types.py +92 -83
  17. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_utils.py +307 -288
  18. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/README.md +549 -516
  19. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/README_EN.md +519 -486
  20. fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/__init__.py +31 -0
  21. fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/_archivePost.py +94 -0
  22. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_blocking.py +100 -82
  23. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_changeBio.py +86 -68
  24. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_createPost.py +142 -124
  25. fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/_deletePost.py +93 -0
  26. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_get_user_info.py +85 -63
  27. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_marketplace.py +323 -303
  28. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_notification.py +72 -54
  29. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_professional.py +88 -70
  30. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_registerOnProfile.py +78 -60
  31. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_search.py +151 -133
  32. fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/_unFriend.py +69 -0
  33. fbchat_v2-2.3.0/src/fbchat_v2/_features/_thread/__init__.py +26 -0
  34. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_addAdmin.py +74 -56
  35. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_all_thread_data.py +237 -206
  36. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_changeEmoji.py +66 -48
  37. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_changeNameThread.py +108 -90
  38. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_changeNickname.py +74 -56
  39. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/README.md +959 -957
  40. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/README_EN.md +855 -853
  41. fbchat_v2-2.3.0/src/fbchat_v2/_messaging/__init__.py +32 -0
  42. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_attachments.py +278 -255
  43. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_bridge_actions.py +357 -357
  44. fbchat_v2-2.3.0/src/fbchat_v2/_messaging/_bridge_checksums.py +10 -0
  45. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_changeTheme.py +549 -526
  46. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_createNotes.py +494 -474
  47. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_editMessage.py +334 -304
  48. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_listening.py +354 -335
  49. fbchat_v2-2.3.0/src/fbchat_v2/_messaging/_listening_e2ee.py +1678 -0
  50. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_message_requests.py +116 -98
  51. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_reactions.py +112 -94
  52. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_send.py +259 -240
  53. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_send_e2ee.py +384 -381
  54. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_unsend.py +68 -50
  55. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/attrs-26.1.0.dist-info/licenses/LICENSE +0 -21
  56. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/certifi-2026.4.22.dist-info/licenses/LICENSE +0 -20
  57. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/charset_normalizer-3.4.7.dist-info/licenses/LICENSE +0 -21
  58. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_core/README.md +0 -261
  59. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_core/README_EN.md +0 -261
  60. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_features/README.md +0 -263
  61. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_features/README_EN.md +0 -263
  62. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_messaging/README.md +0 -412
  63. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_messaging/README_EN.md +0 -412
  64. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/certifi/LICENSE +0 -20
  65. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/distro/LICENSE +0 -202
  66. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/packaging/LICENSE +0 -3
  67. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/pkg_resources/LICENSE +0 -17
  68. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/platformdirs/LICENSE +0 -21
  69. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/pygments/LICENSE +0 -25
  70. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/pyproject_hooks/LICENSE +0 -21
  71. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/requests/LICENSE +0 -175
  72. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/resolvelib/LICENSE +0 -13
  73. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/rich/LICENSE +0 -19
  74. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/tomli/LICENSE +0 -21
  75. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/tomli_w/LICENSE +0 -21
  76. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/truststore/LICENSE +0 -21
  77. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/certifi/LICENSE +0 -20
  78. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/distro/LICENSE +0 -202
  79. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE +0 -3
  80. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/pkg_resources/LICENSE +0 -17
  81. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/platformdirs/LICENSE +0 -21
  82. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/pygments/LICENSE +0 -25
  83. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/pyproject_hooks/LICENSE +0 -21
  84. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/requests/LICENSE +0 -175
  85. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/resolvelib/LICENSE +0 -13
  86. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/rich/LICENSE +0 -19
  87. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/tomli/LICENSE +0 -21
  88. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/tomli_w/LICENSE +0 -21
  89. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/truststore/LICENSE +0 -21
  90. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pyotp-2.9.0.dist-info/LICENSE +0 -21
  91. fbchat_v2-2.2.0/.venv-test/Lib/site-packages/requests-2.34.0.dist-info/licenses/LICENSE +0 -175
  92. fbchat_v2-2.2.0/LICENSE +0 -201
  93. fbchat_v2-2.2.0/src/fbchat_v2/_core/__init__.py +0 -8
  94. fbchat_v2-2.2.0/src/fbchat_v2/_features/_facebook/__init__.py +0 -11
  95. fbchat_v2-2.2.0/src/fbchat_v2/_features/_thread/__init__.py +0 -7
  96. fbchat_v2-2.2.0/src/fbchat_v2/_messaging/__init__.py +0 -13
  97. fbchat_v2-2.2.0/src/fbchat_v2/_messaging/_listening_e2ee.py +0 -775
  98. {fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2-2.1.0.dist-info/licenses → fbchat_v2-2.3.0}/LICENSE +0 -0
  99. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/__init__.py +0 -0
  100. {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/py.typed +0 -0
@@ -5,14 +5,15 @@ website/
5
5
  *.egg-info/
6
6
  *.egg
7
7
  .Python
8
- .venv/
8
+ .venv*/
9
9
  .env
10
10
 
11
11
  # Build artefact
12
12
  build/
13
- dist/
14
- wheels/
15
- *.whl
13
+ dist/
14
+ wheels/
15
+ .artifacts/
16
+ *.whl
16
17
  *.tar.gz
17
18
 
18
19
  # Cấu hình runtime — KHÔNG commit
@@ -7,7 +7,11 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
7
7
 
8
8
  ---
9
9
 
10
- ## [Unreleased] - async-first hardening
10
+ ## [Unreleased]
11
+
12
+ ## [2.3.0] - 2026-08-29
13
+
14
+ ### Changed
11
15
 
12
16
  - Chuyển các feature HTTP sang transport `httpx` sync/async dùng chung; legacy adapter chỉ còn ở boundary nội bộ có lý do rõ.
13
17
  - Viết lại bot mẫu, listener thường, listener E2EE và bridge actions với lifecycle async rõ ràng.
@@ -16,6 +20,40 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
16
20
  - Sửa lỗi gỡ admin báo sai action, `professional` xử lý bool, profile bổ sung dựng header sai, Marketplace khóa nhầm category và post âm thầm bỏ attachment.
17
21
  - Viết lại tài liệu hiện hành theo async/await. Các mục release cũ bên dưới là lịch sử và có thể nhắc API sync đã tồn tại tại thời điểm phát hành.
18
22
 
23
+ ### Security
24
+
25
+ - Thay RNG tạo `AdvSecretKey` của bridge bằng `crypto/rand` và trả lỗi nếu nguồn
26
+ ngẫu nhiên an toàn thất bại.
27
+ - Pin bridge tải tự động vào đúng tag của package, bắt buộc SHA-256 được đóng
28
+ trong wheel, kiểm tra redirect/size và fail closed khi checksum sai.
29
+ - Ghi device state tuần tự bằng temp file, `fsync` và atomic rename; không còn
30
+ bỏ qua lỗi lưu identity, session hoặc prekey.
31
+ - Mutation E2EE rollback cả RAM khi persistence lỗi; callback `deviceData` chạy
32
+ ngoài khóa lưu trữ và coalesce snapshot để không chặn Signal ratchet.
33
+ - File config cookie được tạo atomic với quyền riêng tư; plaintext nội dung chat
34
+ và traceback bị ẩn mặc định.
35
+
36
+ ### Fixed
37
+
38
+ - Sửa async `disconnect()` không await công việc shutdown.
39
+ - Mutation unfriend/archive/delete không còn báo thành công khi GraphQL trả
40
+ `data=null`, `success=false` hoặc có `errors`.
41
+ - Hoàn thiện lifecycle identity/session/prekey trong DeviceStore và trả lỗi rõ
42
+ cho các store operation chưa được bridge hỗ trợ.
43
+ - Lưu đầy đủ LID/account/platform/device metadata, đồng bộ connect/disconnect và
44
+ không hạ cấp yêu cầu gửi E2EE sang transport thường khi E2EE chưa sẵn sàng.
45
+ - Loại 7 lỗi `from __future__` làm source không compile.
46
+
47
+ ### Packaging and CI
48
+
49
+ - Wheel PyPI giữ public namespace `fbchat_v2` của các bản trước, không đóng gói
50
+ namespace nội bộ `src`; thêm smoke test cho wheel và sdist cài sạch.
51
+ - CI enforce compile, Ruff, Black, mypy, pytest Python 3.10-3.14, Go test/vet,
52
+ package smoke test và JavaScript syntax.
53
+ - Nhúng checksum của đúng năm binary từ GitHub Release `v2.3.0`; auto-download
54
+ pin canonical repository/tag/path và fail-closed nếu URL, digest hoặc nội dung
55
+ tải về không khớp.
56
+
19
57
  ## [2.2.0-beta] - 2026-07-06
20
58
 
21
59
  ### ✨ Added
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: fbchat-v2
3
- Version: 2.2.0
3
+ Version: 2.3.0
4
4
  Summary: Async-first, account-based Python library for the unofficial Facebook Messenger API with E2EE support.
5
5
  Project-URL: Homepage, https://github.com/MinhHuyDev/fbchat-v2
6
6
  Project-URL: Documentation, https://github.com/MinhHuyDev/fbchat-v2/blob/main/DOCS.md
@@ -215,12 +215,14 @@ License-File: LICENSE
215
215
  Keywords: chatbot,e2ee,facebook,fbchat,labyrinth,messenger,messenger-api
216
216
  Classifier: Development Status :: 4 - Beta
217
217
  Classifier: Intended Audience :: Developers
218
- Classifier: License :: OSI Approved :: MIT License
218
+ Classifier: License :: OSI Approved :: Apache Software License
219
219
  Classifier: Operating System :: OS Independent
220
220
  Classifier: Programming Language :: Python :: 3
221
221
  Classifier: Programming Language :: Python :: 3.10
222
222
  Classifier: Programming Language :: Python :: 3.11
223
223
  Classifier: Programming Language :: Python :: 3.12
224
+ Classifier: Programming Language :: Python :: 3.13
225
+ Classifier: Programming Language :: Python :: 3.14
224
226
  Classifier: Topic :: Communications :: Chat
225
227
  Classifier: Topic :: Internet
226
228
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -231,7 +233,9 @@ Requires-Dist: paho-mqtt>=1.6.1
231
233
  Requires-Dist: pyotp>=2.9.0
232
234
  Requires-Dist: requests>=2.32.0
233
235
  Provides-Extra: dev
236
+ Requires-Dist: black; extra == 'dev'
234
237
  Requires-Dist: build>=1.2.0; extra == 'dev'
238
+ Requires-Dist: mypy>=1.11.0; extra == 'dev'
235
239
  Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
236
240
  Requires-Dist: pytest>=8.0.0; extra == 'dev'
237
241
  Requires-Dist: ruff>=0.4.0; extra == 'dev'
@@ -246,12 +250,12 @@ Description-Content-Type: text/markdown
246
250
  ### Thư viện Python async-first cho Facebook Messenger API không chính thức
247
251
 
248
252
  [![Status](https://img.shields.io/badge/status-active-22c55e)](https://github.com/MinhHuyDev/fbchat-v2)
249
- [![PyPI](https://img.shields.io/pypi/v/fbchat-v2-color=3775A9&logo=pypi&logoColor=white)](https://pypi.org/project/fbchat-v2/)
250
- [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB-logo=python&logoColor=white)](https://www.python.org/)
251
- [![Version](https://img.shields.io/badge/version-2.2.0-blue)](https://github.com/MinhHuyDev/fbchat-v2/releases)
252
- [![Issues](https://img.shields.io/github/issues/MinhHuyDev/fbchat-v2-color=orange)](https://github.com/MinhHuyDev/fbchat-v2/issues)
253
+ [![PyPI](https://img.shields.io/pypi/v/fbchat-v2?color=3775A9&logo=pypi&logoColor=white)](https://pypi.org/project/fbchat-v2/)
254
+ [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/)
255
+ [![Version](https://img.shields.io/badge/version-2.3.0-blue)](https://github.com/MinhHuyDev/fbchat-v2/releases)
256
+ [![Issues](https://img.shields.io/github/issues/MinhHuyDev/fbchat-v2?color=orange)](https://github.com/MinhHuyDev/fbchat-v2/issues)
253
257
  [![License](https://img.shields.io/badge/license-Xem%20LICENSE-lightgrey)](LICENSE)
254
- [![Telegram](https://img.shields.io/badge/Telegram-MinhHuyDev-26A5E4-logo=telegram&logoColor=white)](https://t.me/MinhHuyDev)
258
+ [![Telegram](https://img.shields.io/badge/Telegram-MinhHuyDev-26A5E4?logo=telegram&logoColor=white)](https://t.me/MinhHuyDev)
255
259
 
256
260
  [🇬🇧 English](README_EN.md) · [📖 Tài liệu](DOCS.md) · [📦 PyPI](https://pypi.org/project/fbchat-v2/) · [ 📊 Sơ đồ luồng](FLOWCHART.md) · [🐛 Báo lỗi](https://github.com/MinhHuyDev/fbchat-v2/issues)
257
261
 
@@ -260,7 +264,7 @@ Description-Content-Type: text/markdown
260
264
  ---
261
265
 
262
266
  > [!IMPORTANT]
263
- > Đây là phiên bản `v2.2.0` sử dụng *httpx.Client* thay vì *requests* như cũ và đã trang bị **async/await** nên syntax code có thể bị thay đổi hoặc xung đột với bản của bạn đang dùng. Nếu bạn vẫn muốn dùng **requests** (*no async/await*), hãy bấm vào đây: [v2.1.4](https://github.com/m008v/fbchat-v2/tree/v2.1.4)
267
+ > Đây là phiên bản `v2.3.0` sử dụng *httpx.Client* thay vì *requests* như cũ và đã trang bị **async/await** nên syntax code có thể bị thay đổi hoặc xung đột với bản của bạn đang dùng. Nếu bạn vẫn muốn dùng **requests** (*no async/await*), hãy bấm vào đây: [v2.1.4](https://github.com/m008v/fbchat-v2/tree/v2.1.4)
264
268
 
265
269
  > [!WARNING]
266
270
  > **Tuyên bố miễn trừ trách nhiệm** - Đây **không** phải là sản phẩm chính thức của Facebook. Facebook đã có sẵn API chatbot chính thức [tại đây](https://developers.facebook.com/docs/messenger-platform/). `fbchat-v2` khác biệt ở chỗ nó xác thực bằng **tài khoản / cookie người dùng Facebook thực**, vốn tiềm ẩn rủi ro. Hãy cân nhắc kỹ trước khi sử dụng.
@@ -270,7 +274,7 @@ Description-Content-Type: text/markdown
270
274
  ## 👋 Giới thiệu
271
275
  Xin chào, mình là **MinhHuyDev** (*m008v*) - tác giả và người duy trì dự án này.
272
276
 
273
- Trước hết, mình xin chân thành cảm ơn tất cả người dùng trong và ngoài nước đã đóng góp ý tưởng và báo lỗi cho dự án. Trong **bản cập nhật lớn v2.2.0** này, codebase đã được **tái cấu trúc hoàn toàn**, xử lý phần lớn các lỗi nhỏ tồn đọng và trang bị *async/await* mạnh mẽ!
277
+ Đợt refactor async-first bắt đầu ở `v2.2.0` và được hoàn thiện trong `v2.3.0` với message pipeline, lifecycle E2EE, persistence, packaging và quality gate được hardening đồng bộ.
274
278
 
275
279
  Tất nhiên vẫn sẽ còn những lỗi vặt khó tìm ra, hoặc các đoạn code chưa thật sự đồng bộ. Nếu bạn phát hiện ra ***vấn đề***, hãy mở issue trên [GitHub](https://github.com/MinhHuyDev/fbchat-v2/issues) hoặc nhắn trực tiếp cho mình qua [Telegram](https://t.me/MinhHuyDev).
276
280
 
@@ -338,9 +342,9 @@ Codebase chia thành 3 tầng. Feature không được tự quản session và m
338
342
 
339
343
  | Tầng | Đường dẫn | Trách nhiệm |
340
344
  |---|---|---|
341
- | Core | `src/_core/` | HTTP transport, session, storage, login và utility |
342
- | Features | `src/_features/` | Nghiệp vụ Facebook và quản trị thread |
343
- | Messaging | `src/_messaging/` | Send, listen, E2EE, attachment, reaction, theme và notes |
345
+ | Core | `src/fbchat_v2/_core/` | HTTP transport, session, storage, login và utility |
346
+ | Features | `src/fbchat_v2/_features/` | Nghiệp vụ Facebook và quản trị thread |
347
+ | Messaging | `src/fbchat_v2/_messaging/` | Send, listen, E2EE, attachment, reaction, theme và notes |
344
348
 
345
349
  ```mermaid
346
350
  flowchart LR
@@ -441,22 +445,13 @@ dependencies = [
441
445
 
442
446
  > Tóm tắt: **Bước 1–4 bắt buộc** cho mọi user. **Bước 5 chỉ cần nếu bạn muốn nhận tin nhắn 1-1 (E2EE)**.
443
447
 
444
- ### 1. Clone mã nguồn
445
-
446
- ```bash
447
- git clone https://github.com/MinhHuyDev/fbchat-v2
448
- cd fbchat-v2
449
- ```
450
-
451
- > Cách khác: `Code → Download ZIP` trên GitHub.
452
-
453
- ### 2. Tạo môi trường ảo *(không bắt buộc nhưng khuyến nghị)*
448
+ ### 1. Tạo môi trường ảo *(không bắt buộc nhưng khuyến nghị)*
454
449
 
455
450
  ```bash
456
451
  python -m venv .venv
457
452
  ```
458
453
 
459
- Kích hoạt môi trường:
454
+ ### 2. Kích hoạt môi trường
460
455
 
461
456
  ```bash
462
457
  # Windows (PowerShell)
@@ -466,37 +461,40 @@ Kích hoạt môi trường:
466
461
  source .venv/bin/activate
467
462
  ```
468
463
 
469
- ### 3. Cài đặt phụ thuộc Python
464
+ ### 3. Cài package từ PyPI
470
465
 
471
466
  ```bash
472
- pip install --upgrade pip
473
- pip install -e .
467
+ python -m pip install --upgrade pip
468
+ python -m pip install --upgrade "fbchat-v2==2.3.0"
474
469
  ```
475
470
 
476
471
  Kiểm tra nhanh:
477
472
 
478
473
  ```bash
479
- python -c "import httpx, requests, paho.mqtt.client, pyotp; print('OK')"
474
+ python -c "import fbchat_v2; from fbchat_v2._features._facebook import _unFriend; print(fbchat_v2.__version__)"
480
475
  ```
481
476
 
482
- ### 4. Cho phép import từ `src/`
477
+ ### 4. Xác minh package đã cài
483
478
 
484
- Khi chạy script ở thư mục gốc dự án, hãy expose `src/` để các module `_core`, `_features`, `_messaging` được import đúng:
479
+ Wheel phải giữ public namespace `fbchat_v2` để tương thích với các bản PyPI trước:
485
480
 
486
481
  ```bash
487
- # Windows (PowerShell)
488
- $env:PYTHONPATH = "src"
489
-
490
- # macOS / Linux
491
- export PYTHONPATH=src
482
+ python -c "from fbchat_v2._core._session import dataGetHome; from fbchat_v2._messaging._send import api; print('OK')"
492
483
  ```
493
484
 
494
- Hoặc bạn có thể import thủ công với prefix đầy đủ `src.`.
485
+ Không cần đặt `PYTHONPATH=src`; mọi import bắt đầu bằng `fbchat_v2.`.
495
486
 
496
487
  ### 5. *(Tuỳ chọn)* Build bridge E2EE - cho tin nhắn 1-1
497
488
 
498
489
  Nếu bạn chỉ cần nhận tin nhắn nhóm, **bỏ qua bước này**. Ngược lại, tin nhắn cá nhân (E2EE) cần binary Go `fbchat-bridge-e2ee`.
499
490
 
491
+ Package `2.3.0` đã nhúng checksum của đủ năm binary trong GitHub Release
492
+ `v2.3.0`. Ở lần chạy đầu, listener tự tải đúng asset Windows x64, Linux
493
+ x64/ARM64 hoặc macOS x64/ARM64 vào cache riêng, rồi kiểm tra tag, URL, kích
494
+ thước và SHA-256 trước khi chạy. Với nền tảng chưa được hỗ trợ hoặc khi muốn tự
495
+ quản binary, hãy build cùng version và đặt `FBCHAT_E2EE_BIN`; package vẫn
496
+ fail-closed nếu binary không xác minh được.
497
+
500
498
  #### 5.1. Cài Go toolchain
501
499
 
502
500
  - Tải về: <https://go.dev/dl/> (Go ≥ 1.24).
@@ -594,6 +592,8 @@ Ví dụ:
594
592
  "admins": [
595
593
  "1000xxxxxxxxxx"
596
594
  ],
595
+ "log_message_content": false,
596
+ "debug_errors": false,
597
597
  "version": "0.0.1"
598
598
  }
599
599
  ```
@@ -603,10 +603,15 @@ Ví dụ:
603
603
  | `cookies` | Có | Cookie phiên Facebook dạng chuỗi |
604
604
  | `prefix` | Không | Tiền tố lệnh, mặc định `/` |
605
605
  | `admins` | Không | Danh sách Facebook ID được dùng lệnh quản trị |
606
+ | `log_message_content` | Không | Cho phép ghi plaintext nội dung chat; mặc định `false` để bảo vệ riêng tư |
607
+ | `debug_errors` | Không | In payload/traceback chi tiết; mặc định `false` |
606
608
  | `botName` | Không | Metadata cho config, bot mẫu hiện không dùng |
607
609
  | `version` | Không | Metadata cho config, bot mẫu hiện không dùng |
608
610
 
609
- `src/config.json` đã bị gitignore. Không dùng `config.example.json` để chứa cookie thật.
611
+ `src/config.json` đã bị gitignore và bot sẽ siết quyền file về `0600` trên
612
+ POSIX hoặc ACL riêng cho user hiện tại/SYSTEM trên Windows. Không dùng
613
+ `config.example.json` để chứa cookie thật, và chỉ bật hai tùy chọn log trên khi
614
+ đang debug trong môi trường kiểm soát.
610
615
 
611
616
  ---
612
617
 
@@ -790,7 +795,7 @@ Event chính:
790
795
  | `error` | lỗi bridge/transport | Cần log và giám sát |
791
796
  | `bridge_fatal` | số lần retry | Watchdog đã bỏ cuộc |
792
797
 
793
- Action nâng cao như edit, unsend, typing, mark-read, gửi ảnh/audio và download media nằm trong `BridgeActions`. Xem [tài liệu messaging](src/_messaging/README.md).
798
+ Action nâng cao như edit, unsend, typing, mark-read, gửi ảnh/audio và download media nằm trong `BridgeActions`. Xem [tài liệu messaging](src/fbchat_v2/_messaging/README.md).
794
799
 
795
800
  ---
796
801
 
@@ -816,9 +821,9 @@ Queue của bot có giới hạn 1000 event và drop event cũ nhất khi đầy
816
821
  | Tài liệu | Nội dung |
817
822
  |---|---|
818
823
  | [DOCS.md](DOCS.md) | Hướng dẫn API và workflow đầy đủ |
819
- | [Core](src/_core/README.md) | Session, HTTP, storage và login |
820
- | [Features](src/_features/README.md) | Facebook feature và thread |
821
- | [Messaging](src/_messaging/README.md) | Send, listener, attachment và E2EE |
824
+ | [Core](src/fbchat_v2/_core/README.md) | Session, HTTP, storage và login |
825
+ | [Features](src/fbchat_v2/_features/README.md) | Facebook feature và thread |
826
+ | [Messaging](src/fbchat_v2/_messaging/README.md) | Send, listener, attachment và E2EE |
822
827
  | [Bridge E2EE](bridge-e2ee/README.md) | Build, binary discovery và JSON-RPC |
823
828
  | [Flowchart](FLOWCHART.md) | Luồng session, HTTP, MQTT, E2EE và shutdown |
824
829
  | [Mindmap](mindmap-mermaid.md) | Bản đồ module toàn dự án |
@@ -827,22 +832,21 @@ Queue của bot có giới hạn 1000 event và drop event cũ nhất khi đầy
827
832
 
828
833
  ## ✅ Kiểm tra chất lượng
829
834
 
830
- Chạy đúng command CI:
835
+ Các gate đóng gói nên chạy trước commit:
831
836
 
832
837
  ```bash
833
- pytest tests/ -v --tb=short
834
- ```
835
-
836
- Các gate nên chạy trước commit:
837
-
838
- ```bash
839
- python -m compileall -q src tests
840
- ruff check src tests
841
- ruff format --check src tests
838
+ python -m compileall -q src/fbchat_v2
839
+ ruff check src/fbchat_v2
840
+ black --check src/fbchat_v2
841
+ mypy
842
+ python -m build
843
+ twine check --strict dist/fbchat_v2-2.3.0-py3-none-any.whl dist/fbchat_v2-2.3.0.tar.gz
842
844
  git diff --check
843
845
  ```
844
846
 
845
- Với bridge:
847
+ Wheel và sdist phải được cài riêng trong virtual environment sạch trước khi upload.
848
+
849
+ Test runtime và bridge đầy đủ nằm trong [repo nguồn](https://github.com/MinhHuyDev/fbchat-v2):
846
850
 
847
851
  ```bash
848
852
  cd bridge-e2ee