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.
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/.gitignore +5 -4
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/CHANGELOG.md +39 -1
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/PKG-INFO +55 -51
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/README.md +631 -631
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/README_EN.md +640 -639
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/pyproject.toml +31 -13
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/__init__.py +3 -2
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/README.md +388 -387
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/README_EN.md +371 -370
- fbchat_v2-2.3.0/src/fbchat_v2/_core/__init__.py +27 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_facebookLogin.py +541 -523
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_http.py +97 -81
- fbchat_v2-2.3.0/src/fbchat_v2/_core/_permissions.py +144 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_session.py +171 -152
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_storage.py +122 -103
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_types.py +92 -83
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_core/_utils.py +307 -288
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/README.md +549 -516
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/README_EN.md +519 -486
- fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/__init__.py +31 -0
- fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/_archivePost.py +94 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_blocking.py +100 -82
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_changeBio.py +86 -68
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_createPost.py +142 -124
- fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/_deletePost.py +93 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_get_user_info.py +85 -63
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_marketplace.py +323 -303
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_notification.py +72 -54
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_professional.py +88 -70
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_registerOnProfile.py +78 -60
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_facebook/_search.py +151 -133
- fbchat_v2-2.3.0/src/fbchat_v2/_features/_facebook/_unFriend.py +69 -0
- fbchat_v2-2.3.0/src/fbchat_v2/_features/_thread/__init__.py +26 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_addAdmin.py +74 -56
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_all_thread_data.py +237 -206
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_changeEmoji.py +66 -48
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_changeNameThread.py +108 -90
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/_thread/_changeNickname.py +74 -56
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/README.md +959 -957
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/README_EN.md +855 -853
- fbchat_v2-2.3.0/src/fbchat_v2/_messaging/__init__.py +32 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_attachments.py +278 -255
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_bridge_actions.py +357 -357
- fbchat_v2-2.3.0/src/fbchat_v2/_messaging/_bridge_checksums.py +10 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_changeTheme.py +549 -526
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_createNotes.py +494 -474
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_editMessage.py +334 -304
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_listening.py +354 -335
- fbchat_v2-2.3.0/src/fbchat_v2/_messaging/_listening_e2ee.py +1678 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_message_requests.py +116 -98
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_reactions.py +112 -94
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_send.py +259 -240
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_send_e2ee.py +384 -381
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_messaging/_unsend.py +68 -50
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/attrs-26.1.0.dist-info/licenses/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/certifi-2026.4.22.dist-info/licenses/LICENSE +0 -20
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/charset_normalizer-3.4.7.dist-info/licenses/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_core/README.md +0 -261
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_core/README_EN.md +0 -261
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_features/README.md +0 -263
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_features/README_EN.md +0 -263
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_messaging/README.md +0 -412
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/fbchat_v2/_messaging/README_EN.md +0 -412
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/certifi/LICENSE +0 -20
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/distro/LICENSE +0 -202
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/packaging/LICENSE +0 -3
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/pkg_resources/LICENSE +0 -17
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/platformdirs/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/pygments/LICENSE +0 -25
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/pyproject_hooks/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/requests/LICENSE +0 -175
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/resolvelib/LICENSE +0 -13
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/rich/LICENSE +0 -19
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/tomli/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/tomli_w/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip/_vendor/truststore/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/certifi/LICENSE +0 -20
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/distro/LICENSE +0 -202
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE +0 -3
- 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
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/platformdirs/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/pygments/LICENSE +0 -25
- 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
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/requests/LICENSE +0 -175
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/resolvelib/LICENSE +0 -13
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/rich/LICENSE +0 -19
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/tomli/LICENSE +0 -21
- 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
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pip-26.1.1.dist-info/licenses/src/pip/_vendor/truststore/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/pyotp-2.9.0.dist-info/LICENSE +0 -21
- fbchat_v2-2.2.0/.venv-test/Lib/site-packages/requests-2.34.0.dist-info/licenses/LICENSE +0 -175
- fbchat_v2-2.2.0/LICENSE +0 -201
- fbchat_v2-2.2.0/src/fbchat_v2/_core/__init__.py +0 -8
- fbchat_v2-2.2.0/src/fbchat_v2/_features/_facebook/__init__.py +0 -11
- fbchat_v2-2.2.0/src/fbchat_v2/_features/_thread/__init__.py +0 -7
- fbchat_v2-2.2.0/src/fbchat_v2/_messaging/__init__.py +0 -13
- fbchat_v2-2.2.0/src/fbchat_v2/_messaging/_listening_e2ee.py +0 -775
- {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
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/_features/__init__.py +0 -0
- {fbchat_v2-2.2.0 → fbchat_v2-2.3.0}/src/fbchat_v2/py.typed +0 -0
|
@@ -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]
|
|
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.
|
|
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 ::
|
|
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
|
[](https://github.com/MinhHuyDev/fbchat-v2)
|
|
249
|
-
[](https://pypi.org/project/fbchat-v2/)
|
|
254
|
+
[](https://www.python.org/)
|
|
255
|
+
[](https://github.com/MinhHuyDev/fbchat-v2/releases)
|
|
256
|
+
[](https://github.com/MinhHuyDev/fbchat-v2/issues)
|
|
253
257
|
[](LICENSE)
|
|
254
|
-
[](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.
|
|
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
|
-
|
|
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.
|
|
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
|
|
464
|
+
### 3. Cài package từ PyPI
|
|
470
465
|
|
|
471
466
|
```bash
|
|
472
|
-
pip install --upgrade pip
|
|
473
|
-
pip install -
|
|
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
|
|
474
|
+
python -c "import fbchat_v2; from fbchat_v2._features._facebook import _unFriend; print(fbchat_v2.__version__)"
|
|
480
475
|
```
|
|
481
476
|
|
|
482
|
-
### 4.
|
|
477
|
+
### 4. Xác minh package đã cài
|
|
483
478
|
|
|
484
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
835
|
+
Các gate đóng gói nên chạy trước commit:
|
|
831
836
|
|
|
832
837
|
```bash
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
|
|
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
|
-
|
|
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
|