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.
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/.gitignore +2 -1
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/CHANGELOG.md +114 -38
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/PKG-INFO +87 -82
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/README.md +81 -76
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/README_EN.md +75 -69
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/pyproject.toml +6 -6
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/__init__.py +3 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/README.md +61 -61
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/README_EN.md +18 -18
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/__init__.py +1 -1
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_console.py +13 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/README.md +72 -71
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/README_EN.md +25 -24
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/README.md +10 -9
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/README_EN.md +10 -9
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/README.md +106 -94
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/README_EN.md +35 -22
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/__init__.py +1 -0
- fbchat_v2-2.3.4/src/fbchat_v2/_messaging/_bridge_checksums.py +11 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_listening.py +257 -39
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_listening_e2ee.py +1078 -80
- fbchat_v2-2.3.4/src/fbchat_v2/_messaging/_reconnect.py +327 -0
- fbchat_v2-2.3.2/src/fbchat_v2/_messaging/_bridge_checksums.py +0 -11
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/LICENSE +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_facebookLogin.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_http.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_permissions.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_session.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_storage.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_types.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_core/_utils.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/__init__.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/__init__.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_archivePost.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_blocking.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_changeBio.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_createPost.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_deletePost.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_get_user_info.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_marketplace.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_notification.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_professional.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_reactionPost.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_registerOnProfile.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_search.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_facebook/_unFriend.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/__init__.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_addAdmin.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_all_thread_data.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_changeEmoji.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_changeNameThread.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_features/_thread/_changeNickname.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_attachments.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_bridge_actions.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_changeTheme.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_createNotes.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_editMessage.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_message_requests.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_reactions.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_send.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_send_e2ee.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/_messaging/_unsend.py +0 -0
- {fbchat_v2-2.3.2 → fbchat_v2-2.3.4}/src/fbchat_v2/py.typed +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
|
|
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`
|
|
56
|
-
|
|
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
|
|
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
|
|
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
|
|
91
|
-
|
|
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
|
|
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
|
|
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
|
-
-
|
|
278
|
-
-
|
|
279
|
-
-
|
|
280
|
-
-
|
|
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`
|
|
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
|
|
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`:
|
|
324
|
-
- `Client.sendE2EEMessage(...)`
|
|
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
|
-
|
|
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
|
|
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")` -
|
|
442
|
-
tạo lại
|
|
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
|
|
446
|
-
mutation
|
|
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`
|
|
452
|
-
|
|
453
|
-
Input
|
|
454
|
-
-
|
|
455
|
-
|
|
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
|
-
-
|
|
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`
|
|
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
|
|
550
|
-
>
|
|
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
|
-
>
|
|
601
|
-
>
|
|
602
|
-
>
|
|
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
|
-
-
|
|
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.
|
|
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
|