fbchat-v2 2.3.2__tar.gz → 2.3.3__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 (62) hide show
  1. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/CHANGELOG.md +78 -38
  2. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/PKG-INFO +83 -82
  3. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/README.md +77 -76
  4. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/README_EN.md +70 -69
  5. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/pyproject.toml +6 -6
  6. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/README.md +61 -61
  7. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/README_EN.md +18 -18
  8. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/__init__.py +1 -1
  9. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_console.py +13 -0
  10. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/README.md +72 -71
  11. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/README_EN.md +25 -24
  12. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/README.md +10 -9
  13. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/README_EN.md +10 -9
  14. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/README.md +98 -94
  15. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/README_EN.md +25 -21
  16. fbchat_v2-2.3.3/src/fbchat_v2/_messaging/_bridge_checksums.py +11 -0
  17. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_listening_e2ee.py +360 -40
  18. fbchat_v2-2.3.2/src/fbchat_v2/_messaging/_bridge_checksums.py +0 -11
  19. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/.gitignore +0 -0
  20. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/LICENSE +0 -0
  21. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/__init__.py +0 -0
  22. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_facebookLogin.py +0 -0
  23. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_http.py +0 -0
  24. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_permissions.py +0 -0
  25. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_session.py +0 -0
  26. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_storage.py +0 -0
  27. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_types.py +0 -0
  28. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_core/_utils.py +0 -0
  29. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/__init__.py +0 -0
  30. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/__init__.py +0 -0
  31. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_archivePost.py +0 -0
  32. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_blocking.py +0 -0
  33. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_changeBio.py +0 -0
  34. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_createPost.py +0 -0
  35. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_deletePost.py +0 -0
  36. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_get_user_info.py +0 -0
  37. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_marketplace.py +0 -0
  38. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_notification.py +0 -0
  39. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_professional.py +0 -0
  40. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_reactionPost.py +0 -0
  41. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_registerOnProfile.py +0 -0
  42. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_search.py +0 -0
  43. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_facebook/_unFriend.py +0 -0
  44. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_thread/__init__.py +0 -0
  45. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_thread/_addAdmin.py +0 -0
  46. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_thread/_all_thread_data.py +0 -0
  47. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_thread/_changeEmoji.py +0 -0
  48. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_thread/_changeNameThread.py +0 -0
  49. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_features/_thread/_changeNickname.py +0 -0
  50. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/__init__.py +0 -0
  51. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_attachments.py +0 -0
  52. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_bridge_actions.py +0 -0
  53. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_changeTheme.py +0 -0
  54. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_createNotes.py +0 -0
  55. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_editMessage.py +0 -0
  56. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_listening.py +0 -0
  57. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_message_requests.py +0 -0
  58. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_reactions.py +0 -0
  59. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_send.py +0 -0
  60. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_send_e2ee.py +0 -0
  61. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/_messaging/_unsend.py +0 -0
  62. {fbchat_v2-2.3.2 → fbchat_v2-2.3.3}/src/fbchat_v2/py.typed +0 -0
@@ -1,6 +1,6 @@
1
1
  # Changelog
2
2
 
3
- Tất cả thay đổi đáng chú ý của `fbchat-v2` sẽ được ghi lại tại đây.
3
+ Các thay đổi đáng chú ý của `fbchat-v2`, theo từng phiên bản.
4
4
 
5
5
  Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/vi/1.1.0/),
6
6
  phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
@@ -43,6 +43,45 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
43
43
  khoảng trắng thừa đầu hero, CSS variable thiếu, V2 badge bị ẩn và layout
44
44
  contributor/preloader trên màn hình nhỏ.
45
45
 
46
+ ## [2.3.3] - 2026-10-16
47
+
48
+ ### Added
49
+
50
+ - Che thông tin nhạy cảm trong log của Python và Go bridge: cookie, token, ID nhà
51
+ cung cấp, JID, tên hội thoại, URL, cursor, payload, XML crypto, prekey và chữ
52
+ ký; vẫn giữ `database_id` để chẩn đoán đúng luồng LightSpeed.
53
+ - Bot thử nghiệm E2EE trả lời message group thường qua Go LightSpeed bridge,
54
+ không fallback sang Python MQTT.
55
+ - Thêm canary/soak driver có opt-in peer, cold restart bằng persistent device,
56
+ E2EE text/media round trip, kiểm digest, fault injection watchdog và evidence
57
+ RSS/queue không chứa secret.
58
+
59
+ ### Changed
60
+
61
+ - Cập nhật Messagix/LightSpeed lên flow DGW hiện hành, bổ sung sync V4 cho
62
+ `databaseID=1` và thích nghi API event/media/store mới.
63
+ - Chia startup deadline thành từng phase contract, client, regular connect,
64
+ regular ready, E2EE connect và E2EE ready; exception gốc được giữ qua
65
+ `__cause__` sau khi thông tin nhạy cảm đã được che.
66
+ - Cập nhật hướng dẫn cài đặt, tài liệu và ví dụ import theo namespace công khai
67
+ `fbchat_v2`; tên release là `v.2.3.3`, tag kỹ thuật là
68
+ `v2.3.3`.
69
+
70
+ ### Fixed
71
+
72
+ - Lưu device đã đăng ký trước khi khởi tạo Whatsmeow client, sửa tình trạng
73
+ regular socket báo connected nhưng E2EE không hoàn tất pairing/readiness.
74
+ - `wait_until_connected()` chờ watchdog reconnect sau khi bridge dừng, thay vì
75
+ trả `False` ngay khi trạng thái startup đã qua.
76
+ - Driver thử nghiệm sửa thiếu `await`, giữ Unicode trên console Windows và
77
+ không log nội dung/định danh riêng tư theo mặc định.
78
+ - Media E2EE dùng temp file có DACL riêng ngay từ lúc tạo trên Windows;
79
+ typing được hủy theo lifecycle và có deadline 10 giây.
80
+ - Go/Python log drain giới hạn dòng 64 KiB, bỏ nguyên dòng quá cỡ và tiếp tục
81
+ drain thay vì giữ buffer vô hạn hoặc in fragment có secret.
82
+ - Nâng Go lên `1.26.9` và `golang.org/x/net` lên `0.60.0` theo kết quả pinned
83
+ `govulncheck`; giữ nguyên vulnerability gate trong CI.
84
+
46
85
  ## [2.3.2] - 2026-09-15
47
86
 
48
87
  ### Added
@@ -52,15 +91,15 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
52
91
  - Thêm public namespace `fbchat_v2` có thể tái tạo trực tiếp từ source chính,
53
92
  kèm exact allowlist, kiểm tra `RECORD`/`PKG-INFO`, smoke test wheel/sdist và
54
93
  kiểm tra import module lồng sâu.
55
- - GitHub Release đính kèm wheel, sdist và `SHA256SUMS-python` đúng từ job đã
56
- verify, thay vì để artifact Python trôi sang một quy trình build khác.
94
+ - GitHub Release đính kèm wheel, sdist và `SHA256SUMS-python` từ job đã kiểm
95
+ tra, không build lại artifact Python bằng một quy trình khác.
57
96
 
58
97
  ### Changed
59
98
 
60
99
  - Nâng Go lên `1.26.6` và `gorilla/websocket` lên `1.5.3` để loại các call path
61
100
  có lỗ hổng mà `govulncheck` đã phát hiện.
62
101
  - E2EE send timeout trả `deliveryStatus="unknown"`; wrapper Python trả
63
- `uncertain` với `retryable=false`, không còn giả vờ rằng message đã gửi.
102
+ `uncertain` với `retryable=false`, không báo message đã gửi khi chưa xác nhận.
64
103
  - Queue event E2EE dùng hard limit 1.000 phần tử, drop-oldest và telemetry đã
65
104
  che payload khi chịu burst.
66
105
 
@@ -78,7 +117,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
78
117
  không còn kế thừa `PSModulePath` không tương thích từ PowerShell 7.
79
118
  - Standalone E2EE sender dọn bridge ở mọi handshake failure; Go bridge rollback
80
119
  partial E2EE client, giới hạn RPC/media trước full allocation và xóa temp file.
81
- - Bot không cache/log message timeout như delivered và khóa `/unsend` khi chưa
120
+ - Bot không cache/log message timeout như delivered; khóa `/unsend` khi chưa
121
+ cấu hình admin.
82
122
  - Bot giới hạn độ dài và quota `/search`; console log giữ được Unicode trên
83
123
  Windows nhưng không làm lộ query hoặc payload nhạy cảm.
84
124
  - Runtime version không còn bị một distribution cũ trong môi trường local ghi
@@ -87,8 +127,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
87
127
  ### Packaging and CI
88
128
 
89
129
  - Đồng bộ package, bridge, workflow, verifier, tài liệu và test lên `2.3.2`.
90
- - Wheel/sdist PyPI phải là chính các byte đã được quality gate kiểm tra, ghi
91
- checksum và gắn provenance; không rebuild thủ công ở checkout khác.
130
+ - Wheel/sdist PyPI dùng đúng byte đã qua quality gate, có checksum và
131
+ provenance; không rebuild thủ công ở checkout khác.
92
132
  - Release workflow khóa immutable commit SHA, recheck tag trước upload, từ chối
93
133
  asset cũ/thừa và pin toàn bộ third-party action bằng commit SHA.
94
134
 
@@ -151,7 +191,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
151
191
  - Chuyển feature HTTP sang transport `httpx` sync/async dùng chung; legacy
152
192
  adapter chỉ còn ở boundary nội bộ có lý do rõ.
153
193
  - Viết lại bot mẫu, listener thường, listener E2EE và bridge actions theo
154
- lifecycle async có startup, readiness, cancellation, shutdown và cleanup rõ.
194
+ lifecycle async, gồm startup, readiness, cancellation, shutdown và cleanup.
155
195
  - Quản lý E2EE bridge theo generation với total deadline, exponential backoff,
156
196
  recovery tuần tự, writer queue riêng và timeout cho process/pipe treo.
157
197
  - Chỉ công bố readiness khi socket thường đã kết nối và E2EE đã đăng nhập;
@@ -179,7 +219,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
179
219
 
180
220
  - Khôi phục delivery tin nhắn thường và E2EE từ live upsert; lọc typing,
181
221
  read-receipt, reaction cùng event phụ trước queue, giới hạn queue và chống
182
- replay/dedupe placeholder.
222
+ replay và dedupe placeholder.
183
223
  - Sửa async `disconnect()` không await shutdown, cleanup startup nằm ngoài
184
224
  `finally`, bridge response sai kiểu, short write, stale generation và race
185
225
  giữa close/reconnect.
@@ -274,13 +314,13 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
274
314
  ## [2.2.0-beta] - 2026-07-06
275
315
 
276
316
  ### ✨ Added
277
- - Dual API (Sync & Async) cho toàn bộ `_messaging`: Hỗ trợ native `async`/`await` cho tất cả các hành động (`send`, `unsend`, `react`, ...).
278
- - Hỗ trợ `httpx` cho HTTP async: Các API async dùng `httpx`; endpoint legacy được cô lập sau adapter riêng thay vì lộ ra API public.
279
- - Type Hints đầy đủ: Tích hợp kiểu dữ liệu (`TypedDict`, `Literal`) cho 11 module core và messaging (giảm thiểu lỗi type runtime).
280
- - E2EE Bridge Auto-Respawn: Cơ chế tự động hồi sinh Bridge E2EE (`_listening_e2ee.py`) với exponential backoff (2s -> 32s) khi mất kết nối đột ngột hoặc crash.
317
+ - Thêm API sync và async cho `_messaging`; các hành động `send`, `unsend`, `react`, ... có thể dùng `async`/`await`.
318
+ - Dùng `httpx` cho HTTP async; endpoint legacy được giữ sau adapter nội bộ.
319
+ - Bổ sung type hint (`TypedDict`, `Literal`) cho 11 module core và messaging.
320
+ - Tự respawn E2EE bridge trong `_listening_e2ee.py` với exponential backoff (2s -> 32s) khi mất kết nối hoặc crash.
281
321
 
282
322
  ### 🛠 Changed
283
- - Module `_core._session.py` và `_utils.py` hiện tại sử dụng helper `send_request` và `send_request_async`.
323
+ - Module `_core._session.py` và `_utils.py` chuyển sang helper `send_request` và `send_request_async`.
284
324
 
285
325
  ---
286
326
 
@@ -317,15 +357,15 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
317
357
  `100012345678` -> `100012345678@msgr`.
318
358
  - `api.send(...)` chấp nhận cả JID đầy đủ lẫn user ID; input sai trả
319
359
  `invalid_chat_jid` rõ ràng hơn.
320
- - `api.send_to_user(...)` là entry point tiện dụng cho flow chủ động.
360
+ - `api.send_to_user(...)` là entry point để gửi chủ động theo user ID.
321
361
  - `src/_e2ee_send_test.py`: test script giờ tự resolve `--device-path` relative
322
362
  về root `fbchat-v2`, nên không còn phụ thuộc cwd hiện tại khi spawn bridge.
323
- - `bridge-e2ee`: fix gốc cho proactive E2EE send.
324
- - `Client.sendE2EEMessage(...)` sẽ ensure encrypted DM thread trước khi gửi.
363
+ - `bridge-e2ee`: sửa lỗi gửi E2EE chủ động khi chưa có session.
364
+ - `Client.sendE2EEMessage(...)` tạo hoặc xác nhận encrypted DM thread trước khi gửi.
325
365
  - `DeviceStore.GetManySessions()` trả đủ session address được hỏi để
326
366
  `whatsmeow` nhận ra device chưa có session và tự fetch prekey.
327
367
  - `NewDeviceStore(...)` tạo luôn thư mục cha của file device nếu chưa tồn tại,
328
- giúp path như `./src/e2ee_device.json` không bị fail khi lưu mới.
368
+ để lưu được vào đường dẫn như `./src/e2ee_device.json`.
329
369
 
330
370
  ### 📝 Documentation
331
371
 
@@ -344,7 +384,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
344
384
  ### ✨ Added
345
385
 
346
386
  - `src/_e2ee_send_test.py` - script test riêng cho `_messaging/_send_e2ee.py`.
347
- - Chạy không tham số sẽ hỏi interactive `UID/JID người nhận` và `nội dung cần gửi`.
387
+ - Chạy không tham số sẽ hỏi `UID/JID người nhận` và `nội dung cần gửi` trên console.
348
388
  - `--dry-run` kiểm tra normalize Facebook numeric ID -> `<id>@msgr` mà không
349
389
  cần cookie/bridge.
350
390
  - Chế độ gửi thật đọc cookie từ `FBCHAT_COOKIE` hoặc `src/config.json`, tự
@@ -438,28 +478,28 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
438
478
  - `checkNote(dataFB)` - lấy note hiện tại (`msgr_user_rich_status`).
439
479
  - `createNote(dataFB, text, privacy="FRIENDS")` - tạo note text 24h.
440
480
  - `deleteNote(dataFB, noteID)` - xoá note theo `rich_status_id`.
441
- - `recreateNote(dataFB, oldNoteID, newText, privacy="FRIENDS")` - xoá +
442
- tạo lại nguyên tử (fail-fast nếu bước nào lỗi thì abort).
481
+ - `recreateNote(dataFB, oldNoteID, newText, privacy="FRIENDS")` - xóa rồi
482
+ tạo lại; dừng nếu một bước trả lỗi.
443
483
  - Entry point thống nhất:
444
484
  `func(...)` với `action="check"|"create"|"delete"|"recreate"` và keyword arguments.
445
- - Mỗi call hit một GraphQL `friendly_name` / `doc_id` riêng - không share
446
- mutation, lỗi ở `delete` không cascade sang `create`:
485
+ - Mỗi thao tác gọi GraphQL `friendly_name` / `doc_id` riêng, không dùng chung
486
+ mutation giữa `delete` và `create`:
447
487
  - `MWInboxTrayNoteCreationDialogQuery` (doc_id `30899655739648624`)
448
488
  - `MWInboxTrayNoteCreationDialogCreationStepContentMutation`
449
489
  (doc_id `24060573783603122`)
450
490
  - `useMWInboxTrayDeleteNoteMutation` (doc_id `9532619970198958`)
451
- - Privacy mapping (`PRIVACY_ALIASES`): `EVERYONE` / `PUBLIC` đều bị
452
- normalize về `FRIENDS` (Messenger Notes hiện chỉ hỗ trợ scope FRIENDS).
453
- Input tự uppercase, các giá trị khác forward as-is.
454
- - Resilience: `timeout=(connect=10s, read=45s)` + 2 retries cho
455
- lỗi timeout / lỗi transport (tổng <= 3 lần thử).
491
+ - Privacy mapping (`PRIVACY_ALIASES`): `EVERYONE` / `PUBLIC` được đổi về
492
+ `FRIENDS`, scope Messenger Notes hỗ trợ ở bản này.
493
+ Input được chuyển thành chữ hoa; các giá trị khác được gửi nguyên trạng.
494
+ - Dùng `timeout=(connect=10s, read=45s)` và retry tối đa 2 lần cho lỗi
495
+ timeout/transport (tổng <= 3 lần thử ở bản này).
456
496
  - Tự strip prefix `for (;;);` trước khi `json.loads`.
457
497
  - `client_mutation_id` random `0-10`; `session_id` sinh nội bộ qua
458
498
  `generate_client_id()` - caller không cần truyền.
459
499
  - Schema return chuẩn fbchat-v2:
460
500
  - ✅ `{"success": 1, "messages": "...", "data": {...}}`
461
501
  - ❌ `{"error": 1, "messages": "...", "details" | "raw": ...}`
462
- - Hard-coded `duration = 86400s` (24h) - Messenger web flow chưa hỗ trợ
502
+ - Cố định `duration = 86400s` (24h) - Messenger web flow chưa hỗ trợ
463
503
  duration tuỳ ý.
464
504
 
465
505
  ### 📝 Documentation
@@ -526,7 +566,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
526
566
 
527
567
  ### 📝 Documentation
528
568
 
529
- - `DOCS.md` được viết lại hoàn toàn bằng tiếng Anh + bổ sung section FAQ
569
+ - Viết lại `DOCS.md` bằng tiếng Anh, bổ sung FAQ
530
570
  ~20 câu hỏi (cookie expiry, `BridgeError`, `chat_jid` vs `threadID`,
531
571
  phân biệt `_send.api` vs `_send_e2ee.api`, persist Signal keys, v.v.).
532
572
  - `src/_messaging/README.md` + `README_EN.md`: thêm mục `_send_e2ee.py` vào
@@ -546,9 +586,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
546
586
 
547
587
  ## [2.1.1] - 2026-05-12
548
588
 
549
- > Bản vá tài liệu & hạ tầng phân phối. Không thay đổi runtime; chủ yếu
550
- > hoàn thiện tài liệu trên website, README và đẩy gói lên PyPI để
551
- > `pip install fbchat-v2` hoạt động chính thức.
589
+ > Bản vá tài liệu và cách phân phối, không thay đổi runtime. Cập nhật website,
590
+ > README và phát hành lên PyPI để cài bằng `pip install fbchat-v2`.
552
591
 
553
592
  ### ✨ Added
554
593
 
@@ -597,9 +636,9 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
597
636
 
598
637
  ## [2.1.0] - 2026-05-12
599
638
 
600
- > Bản cập nhật lớn: chính thức hỗ trợ giải mã End-to-End Encryption (E2EE)
601
- > cho tin nhắn cá nhân Messenger. Schema event giữ nguyên tương thích ngược 100%
602
- > với `_listening.py` cũ - chỉ cần đổi import là chạy.
639
+ > Thêm giải mã End-to-End Encryption (E2EE) cho tin nhắn cá nhân Messenger.
640
+ > Schema event giữ các field của `_listening.py` để ứng dụng dùng lại phần
641
+ > xử lý tin nhắn; listener E2EE cần bridge Go.
603
642
 
604
643
  ### ✨ Added
605
644
 
@@ -682,7 +721,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
682
721
  - Tái cấu trúc toàn bộ codebase thành 3 tầng `_core` / `_features` /
683
722
  `_messaging`.
684
723
  - Listener MQTT WebSocket cho tin nhắn nhóm (`_listening.py`).
685
- - Bộ tính năng đầy đủ: gửi tin / sticker / attachment, react, unsend, message
724
+ - Thêm các tính năng gửi tin / sticker / attachment, react, unsend, message
686
725
  transport HTTP, quản lý nhóm (admin / nickname / emoji / poll), facebook
687
726
  features (post, bio, search, marketplace, professional…).
688
727
  - Đăng nhập bằng cookie hoặc username/password (kèm 2FA TOTP).
@@ -692,7 +731,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
692
731
 
693
732
  ---
694
733
 
695
- [Unreleased]: https://github.com/m008v/fbchat-v2/compare/v2.3.2...HEAD
734
+ [Unreleased]: https://github.com/m008v/fbchat-v2/compare/v2.3.3...HEAD
735
+ [2.3.3]: https://github.com/m008v/fbchat-v2/compare/v2.3.2...v2.3.3
696
736
  [2.3.2]: https://github.com/m008v/fbchat-v2/releases/tag/v2.3.2
697
737
  [2.3.1]: https://github.com/m008v/fbchat-v2/releases/tag/v2.3.1
698
738
  [2.3.0]: https://github.com/m008v/fbchat-v2/releases/tag/v2.3.0