fbchat-v2 2.3.2__tar.gz → 2.3.4__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 (63) hide show
  1. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/.gitignore +2 -1
  2. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/CHANGELOG.md +114 -38
  3. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/PKG-INFO +87 -82
  4. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/README.md +81 -76
  5. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/README_EN.md +75 -69
  6. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/pyproject.toml +6 -6
  7. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/__init__.py +3 -0
  8. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/README.md +61 -61
  9. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/README_EN.md +18 -18
  10. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/__init__.py +1 -1
  11. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_console.py +13 -0
  12. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/README.md +72 -71
  13. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/README_EN.md +25 -24
  14. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/README.md +10 -9
  15. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/README_EN.md +10 -9
  16. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/README.md +106 -94
  17. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/README_EN.md +35 -22
  18. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/__init__.py +1 -0
  19. fbchat_v2-2.3.4/src/fbchat_v2/_messaging/_bridge_checksums.py +11 -0
  20. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_listening.py +257 -39
  21. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_listening_e2ee.py +1078 -80
  22. fbchat_v2-2.3.4/src/fbchat_v2/_messaging/_reconnect.py +327 -0
  23. fbchat_v2-2.3.2/src/fbchat_v2/_messaging/_bridge_checksums.py +0 -11
  24. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/LICENSE +0 -0
  25. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_facebookLogin.py +0 -0
  26. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_http.py +0 -0
  27. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_permissions.py +0 -0
  28. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_session.py +0 -0
  29. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_storage.py +0 -0
  30. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_types.py +0 -0
  31. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_utils.py +0 -0
  32. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/__init__.py +0 -0
  33. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/__init__.py +0 -0
  34. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_archivePost.py +0 -0
  35. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_blocking.py +0 -0
  36. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_changeBio.py +0 -0
  37. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_createPost.py +0 -0
  38. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_deletePost.py +0 -0
  39. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_get_user_info.py +0 -0
  40. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_marketplace.py +0 -0
  41. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_notification.py +0 -0
  42. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_professional.py +0 -0
  43. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_reactionPost.py +0 -0
  44. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_registerOnProfile.py +0 -0
  45. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_search.py +0 -0
  46. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_unFriend.py +0 -0
  47. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/__init__.py +0 -0
  48. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_addAdmin.py +0 -0
  49. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_all_thread_data.py +0 -0
  50. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_changeEmoji.py +0 -0
  51. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_changeNameThread.py +0 -0
  52. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_changeNickname.py +0 -0
  53. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_attachments.py +0 -0
  54. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_bridge_actions.py +0 -0
  55. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_changeTheme.py +0 -0
  56. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_createNotes.py +0 -0
  57. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_editMessage.py +0 -0
  58. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_message_requests.py +0 -0
  59. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_reactions.py +0 -0
  60. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_send.py +0 -0
  61. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_send_e2ee.py +0 -0
  62. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_unsend.py +0 -0
  63. {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/py.typed +0 -0
@@ -41,6 +41,7 @@ venv.bak/
41
41
  *.log
42
42
  logs/
43
43
  .tmp/
44
+ /.state/
44
45
  *.sqlite3
45
46
  *.db
46
47
  *.db-journal
@@ -49,4 +50,4 @@ AGENT_MEMORYs.md
49
50
  .vbsec-tmp/
50
51
  vbsec-reports/
51
52
  src/test.py
52
- .understand-anything
53
+ .understand-anything
@@ -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,81 @@ 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.4] - 2026-10-21
47
+
48
+ ### Added
49
+
50
+ - Thêm `ReconnectPolicy` cho MQTT/E2EE: retry khi startup mất mạng hoặc kết nối
51
+ bị ngắt, exponential backoff có jitter, delay trần và retry budget tùy chọn.
52
+ - Thêm `connection_state`, `connection_status` và callback trạng thái. Bridge
53
+ cung cấp capability `structuredConnectionStatus` cùng failure code an toàn,
54
+ không đưa cookie, ID hội thoại hoặc nội dung chat vào snapshot.
55
+ - Thêm test offline cho outage, startup retry, mất riêng socket E2EE, giới hạn
56
+ retry, stop/cancel và lọc message replay qua các generation của bridge.
57
+
58
+ ### Changed
59
+
60
+ - MQTT dùng một supervisor quản lý retry; giữ sync token/sequence và cache ID
61
+ có giới hạn qua reconnect. E2EE ưu tiên socket Go tự nối lại khi RPC còn khỏe,
62
+ chỉ thay process khi generation không thể dùng tiếp.
63
+ - Lỗi auth/checkpoint/config/protocol hoặc chưa phân loại được dừng rõ ràng,
64
+ không retry vô hạn. Lỗi chứng chỉ TLS được phân loại trước lỗi mạng chung.
65
+ - E2EE memory-only báo `device_state_lost` khi process chết, không tự pair mới
66
+ hoặc ghi key ra đĩa. Persistent device vẫn là lựa chọn chủ động của ứng dụng.
67
+ - Bot mẫu tiếp tục chờ khi startup đang reconnecting. Stop/cancel chờ worker
68
+ thu dọn, kể cả khi coroutine bị cancel nhiều lần.
69
+ - Nâng Go lên `1.26.10` để vá `GO-2026-6809` trong `crypto/x509`; giữ nguyên
70
+ vulnerability gate của CI.
71
+
72
+ ### Giới hạn
73
+
74
+ - Policy của wrapper không ghi đè backoff socket native Go. Với E2EE, retry
75
+ budget khi native reconnect đếm lượt quan sát, không phải số TCP attempt.
76
+ - Reconnect không đảm bảo nhận đủ mọi tin trong thời gian offline. Khi thay
77
+ process, listener báo nguy cơ message gap; tin gửi có kết quả `unknown`
78
+ không được tự gửi lại.
79
+ - Các thay đổi reconnect được kiểm bằng test offline. Cold restart sau payload
80
+ thật và mất mạng riêng bridge vẫn cần kiểm chứng live riêng.
81
+
82
+ ## [2.3.3] - 2026-10-16
83
+
84
+ ### Added
85
+
86
+ - Che thông tin nhạy cảm trong log của Python và Go bridge: cookie, token, ID nhà
87
+ cung cấp, JID, tên hội thoại, URL, cursor, payload, XML crypto, prekey và chữ
88
+ ký; vẫn giữ `database_id` để chẩn đoán đúng luồng LightSpeed.
89
+ - Bot thử nghiệm E2EE trả lời message group thường qua Go LightSpeed bridge,
90
+ không fallback sang Python MQTT.
91
+ - Thêm canary/soak driver có opt-in peer, cold restart bằng persistent device,
92
+ E2EE text/media round trip, kiểm digest, fault injection watchdog và evidence
93
+ RSS/queue không chứa secret.
94
+
95
+ ### Changed
96
+
97
+ - Cập nhật Messagix/LightSpeed lên flow DGW hiện hành, bổ sung sync V4 cho
98
+ `databaseID=1` và thích nghi API event/media/store mới.
99
+ - Chia startup deadline thành từng phase contract, client, regular connect,
100
+ regular ready, E2EE connect và E2EE ready; exception gốc được giữ qua
101
+ `__cause__` sau khi thông tin nhạy cảm đã được che.
102
+ - Cập nhật hướng dẫn cài đặt, tài liệu và ví dụ import theo namespace công khai
103
+ `fbchat_v2`; tên release là `v.2.3.3`, tag kỹ thuật là
104
+ `v2.3.3`.
105
+
106
+ ### Fixed
107
+
108
+ - Lưu device đã đăng ký trước khi khởi tạo Whatsmeow client, sửa tình trạng
109
+ regular socket báo connected nhưng E2EE không hoàn tất pairing/readiness.
110
+ - `wait_until_connected()` chờ watchdog reconnect sau khi bridge dừng, thay vì
111
+ trả `False` ngay khi trạng thái startup đã qua.
112
+ - Driver thử nghiệm sửa thiếu `await`, giữ Unicode trên console Windows và
113
+ không log nội dung/định danh riêng tư theo mặc định.
114
+ - Media E2EE dùng temp file có DACL riêng ngay từ lúc tạo trên Windows;
115
+ typing được hủy theo lifecycle và có deadline 10 giây.
116
+ - Go/Python log drain giới hạn dòng 64 KiB, bỏ nguyên dòng quá cỡ và tiếp tục
117
+ drain thay vì giữ buffer vô hạn hoặc in fragment có secret.
118
+ - Nâng Go lên `1.26.9` và `golang.org/x/net` lên `0.60.0` theo kết quả pinned
119
+ `govulncheck`; giữ nguyên vulnerability gate trong CI.
120
+
46
121
  ## [2.3.2] - 2026-09-15
47
122
 
48
123
  ### Added
@@ -52,15 +127,15 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
52
127
  - Thêm public namespace `fbchat_v2` có thể tái tạo trực tiếp từ source chính,
53
128
  kèm exact allowlist, kiểm tra `RECORD`/`PKG-INFO`, smoke test wheel/sdist và
54
129
  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.
130
+ - GitHub Release đính kèm wheel, sdist và `SHA256SUMS-python` từ job đã kiểm
131
+ tra, không build lại artifact Python bằng một quy trình khác.
57
132
 
58
133
  ### Changed
59
134
 
60
135
  - Nâng Go lên `1.26.6` và `gorilla/websocket` lên `1.5.3` để loại các call path
61
136
  có lỗ hổng mà `govulncheck` đã phát hiện.
62
137
  - 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.
138
+ `uncertain` với `retryable=false`, không báo message đã gửi khi chưa xác nhận.
64
139
  - Queue event E2EE dùng hard limit 1.000 phần tử, drop-oldest và telemetry đã
65
140
  che payload khi chịu burst.
66
141
 
@@ -78,7 +153,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
78
153
  không còn kế thừa `PSModulePath` không tương thích từ PowerShell 7.
79
154
  - Standalone E2EE sender dọn bridge ở mọi handshake failure; Go bridge rollback
80
155
  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
156
+ - Bot không cache/log message timeout như delivered; khóa `/unsend` khi chưa
157
+ cấu hình admin.
82
158
  - Bot giới hạn độ dài và quota `/search`; console log giữ được Unicode trên
83
159
  Windows nhưng không làm lộ query hoặc payload nhạy cảm.
84
160
  - Runtime version không còn bị một distribution cũ trong môi trường local ghi
@@ -87,8 +163,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
87
163
  ### Packaging and CI
88
164
 
89
165
  - Đồ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.
166
+ - Wheel/sdist PyPI dùng đúng byte đã qua quality gate, có checksum và
167
+ provenance; không rebuild thủ công ở checkout khác.
92
168
  - Release workflow khóa immutable commit SHA, recheck tag trước upload, từ chối
93
169
  asset cũ/thừa và pin toàn bộ third-party action bằng commit SHA.
94
170
 
@@ -151,7 +227,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
151
227
  - Chuyển feature HTTP sang transport `httpx` sync/async dùng chung; legacy
152
228
  adapter chỉ còn ở boundary nội bộ có lý do rõ.
153
229
  - 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õ.
230
+ lifecycle async, gồm startup, readiness, cancellation, shutdown và cleanup.
155
231
  - Quản lý E2EE bridge theo generation với total deadline, exponential backoff,
156
232
  recovery tuần tự, writer queue riêng và timeout cho process/pipe treo.
157
233
  - Chỉ công bố readiness khi socket thường đã kết nối và E2EE đã đăng nhập;
@@ -179,7 +255,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
179
255
 
180
256
  - Khôi phục delivery tin nhắn thường và E2EE từ live upsert; lọc typing,
181
257
  read-receipt, reaction cùng event phụ trước queue, giới hạn queue và chống
182
- replay/dedupe placeholder.
258
+ replay và dedupe placeholder.
183
259
  - Sửa async `disconnect()` không await shutdown, cleanup startup nằm ngoài
184
260
  `finally`, bridge response sai kiểu, short write, stale generation và race
185
261
  giữa close/reconnect.
@@ -274,13 +350,13 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
274
350
  ## [2.2.0-beta] - 2026-07-06
275
351
 
276
352
  ### ✨ 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.
353
+ - Thêm API sync và async cho `_messaging`; các hành động `send`, `unsend`, `react`, ... có thể dùng `async`/`await`.
354
+ - Dùng `httpx` cho HTTP async; endpoint legacy được giữ sau adapter nội bộ.
355
+ - Bổ sung type hint (`TypedDict`, `Literal`) cho 11 module core và messaging.
356
+ - 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
357
 
282
358
  ### 🛠 Changed
283
- - Module `_core._session.py` và `_utils.py` hiện tại sử dụng helper `send_request` và `send_request_async`.
359
+ - Module `_core._session.py` và `_utils.py` chuyển sang helper `send_request` và `send_request_async`.
284
360
 
285
361
  ---
286
362
 
@@ -317,15 +393,15 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
317
393
  `100012345678` -> `100012345678@msgr`.
318
394
  - `api.send(...)` chấp nhận cả JID đầy đủ lẫn user ID; input sai trả
319
395
  `invalid_chat_jid` rõ ràng hơn.
320
- - `api.send_to_user(...)` là entry point tiện dụng cho flow chủ động.
396
+ - `api.send_to_user(...)` là entry point để gửi chủ động theo user ID.
321
397
  - `src/_e2ee_send_test.py`: test script giờ tự resolve `--device-path` relative
322
398
  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.
399
+ - `bridge-e2ee`: sửa lỗi gửi E2EE chủ động khi chưa có session.
400
+ - `Client.sendE2EEMessage(...)` tạo hoặc xác nhận encrypted DM thread trước khi gửi.
325
401
  - `DeviceStore.GetManySessions()` trả đủ session address được hỏi để
326
402
  `whatsmeow` nhận ra device chưa có session và tự fetch prekey.
327
403
  - `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.
404
+ để lưu được vào đường dẫn như `./src/e2ee_device.json`.
329
405
 
330
406
  ### 📝 Documentation
331
407
 
@@ -344,7 +420,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
344
420
  ### ✨ Added
345
421
 
346
422
  - `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`.
423
+ - 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
424
  - `--dry-run` kiểm tra normalize Facebook numeric ID -> `<id>@msgr` mà không
349
425
  cần cookie/bridge.
350
426
  - Chế độ gửi thật đọc cookie từ `FBCHAT_COOKIE` hoặc `src/config.json`, tự
@@ -438,28 +514,28 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
438
514
  - `checkNote(dataFB)` - lấy note hiện tại (`msgr_user_rich_status`).
439
515
  - `createNote(dataFB, text, privacy="FRIENDS")` - tạo note text 24h.
440
516
  - `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).
517
+ - `recreateNote(dataFB, oldNoteID, newText, privacy="FRIENDS")` - xóa rồi
518
+ tạo lại; dừng nếu một bước trả lỗi.
443
519
  - Entry point thống nhất:
444
520
  `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`:
521
+ - Mỗi thao tác gọi GraphQL `friendly_name` / `doc_id` riêng, không dùng chung
522
+ mutation giữa `delete` và `create`:
447
523
  - `MWInboxTrayNoteCreationDialogQuery` (doc_id `30899655739648624`)
448
524
  - `MWInboxTrayNoteCreationDialogCreationStepContentMutation`
449
525
  (doc_id `24060573783603122`)
450
526
  - `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ử).
527
+ - Privacy mapping (`PRIVACY_ALIASES`): `EVERYONE` / `PUBLIC` được đổi về
528
+ `FRIENDS`, scope Messenger Notes hỗ trợ ở bản này.
529
+ Input được chuyển thành chữ hoa; các giá trị khác được gửi nguyên trạng.
530
+ - Dùng `timeout=(connect=10s, read=45s)` và retry tối đa 2 lần cho lỗi
531
+ timeout/transport (tổng <= 3 lần thử ở bản này).
456
532
  - Tự strip prefix `for (;;);` trước khi `json.loads`.
457
533
  - `client_mutation_id` random `0-10`; `session_id` sinh nội bộ qua
458
534
  `generate_client_id()` - caller không cần truyền.
459
535
  - Schema return chuẩn fbchat-v2:
460
536
  - ✅ `{"success": 1, "messages": "...", "data": {...}}`
461
537
  - ❌ `{"error": 1, "messages": "...", "details" | "raw": ...}`
462
- - Hard-coded `duration = 86400s` (24h) - Messenger web flow chưa hỗ trợ
538
+ - Cố định `duration = 86400s` (24h) - Messenger web flow chưa hỗ trợ
463
539
  duration tuỳ ý.
464
540
 
465
541
  ### 📝 Documentation
@@ -526,7 +602,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
526
602
 
527
603
  ### 📝 Documentation
528
604
 
529
- - `DOCS.md` được viết lại hoàn toàn bằng tiếng Anh + bổ sung section FAQ
605
+ - Viết lại `DOCS.md` bằng tiếng Anh, bổ sung FAQ
530
606
  ~20 câu hỏi (cookie expiry, `BridgeError`, `chat_jid` vs `threadID`,
531
607
  phân biệt `_send.api` vs `_send_e2ee.api`, persist Signal keys, v.v.).
532
608
  - `src/_messaging/README.md` + `README_EN.md`: thêm mục `_send_e2ee.py` vào
@@ -546,9 +622,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
546
622
 
547
623
  ## [2.1.1] - 2026-05-12
548
624
 
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.
625
+ > Bản vá tài liệu và cách phân phối, không thay đổi runtime. Cập nhật website,
626
+ > README và phát hành lên PyPI để cài bằng `pip install fbchat-v2`.
552
627
 
553
628
  ### ✨ Added
554
629
 
@@ -597,9 +672,9 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
597
672
 
598
673
  ## [2.1.0] - 2026-05-12
599
674
 
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.
675
+ > Thêm giải mã End-to-End Encryption (E2EE) cho tin nhắn cá nhân Messenger.
676
+ > Schema event giữ các field của `_listening.py` để ứng dụng dùng lại phần
677
+ > xử lý tin nhắn; listener E2EE cần bridge Go.
603
678
 
604
679
  ### ✨ Added
605
680
 
@@ -682,7 +757,7 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
682
757
  - Tái cấu trúc toàn bộ codebase thành 3 tầng `_core` / `_features` /
683
758
  `_messaging`.
684
759
  - 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
760
+ - Thêm các tính năng gửi tin / sticker / attachment, react, unsend, message
686
761
  transport HTTP, quản lý nhóm (admin / nickname / emoji / poll), facebook
687
762
  features (post, bio, search, marketplace, professional…).
688
763
  - Đăng nhập bằng cookie hoặc username/password (kèm 2FA TOTP).
@@ -692,7 +767,8 @@ phiên bản tuân theo [Semantic Versioning](https://semver.org/lang/vi/).
692
767
 
693
768
  ---
694
769
 
695
- [Unreleased]: https://github.com/m008v/fbchat-v2/compare/v2.3.2...HEAD
770
+ [Unreleased]: https://github.com/m008v/fbchat-v2/compare/v2.3.3...HEAD
771
+ [2.3.3]: https://github.com/m008v/fbchat-v2/compare/v2.3.2...v2.3.3
696
772
  [2.3.2]: https://github.com/m008v/fbchat-v2/releases/tag/v2.3.2
697
773
  [2.3.1]: https://github.com/m008v/fbchat-v2/releases/tag/v2.3.1
698
774
  [2.3.0]: https://github.com/m008v/fbchat-v2/releases/tag/v2.3.0