@cnv-vn/track 0.3.0-beta.12 → 0.3.0-beta.15

package/dist/types/index.d.ts

@@ -668,8 +668,9 @@ interface PanelShapes {
  *   | 'project-suspended' | 'network'`: reject ngay lời gọi `loginWithZalo(...)`
  *   (trước khi có {@link ZaloQrLoginSession}) — lỗi thiết lập phiên, không có
  *   `session`/`session.result` nào để bắt.
- * - `'expired' | 'denied' | 'cancelled'`: reject {@link ZaloQrLoginSession.result}
- *   — xảy ra SAU khi đã có `session` (QR đã hiển thị), khi chờ kết quả quét.
+ * - `'expired' | 'denied' | 'cancelled' | 'agent-registration-required' | 'login-blocked'`:
+ *   reject {@link ZaloQrLoginSession.result} — xảy ra SAU khi đã có `session` (QR đã hiển
+ *   thị), khi chờ kết quả quét.
  *
  * Bọc `try/catch` quanh CẢ hai điểm `await` (xem ví dụ ở `loginWithZalo` JSDoc)
  * để không bỏ sót nhóm đầu.
@@ -678,34 +679,30 @@ interface PanelShapes {
  * theo HTTP status server trả về (401/403) — đây là lỗi CẤU HÌNH (project key
  * gõ sai/thiếu, hoặc project bị khoá), KHÔNG PHẢI lỗi mạng/CORS thật. Trước đây
  * cả 2 nhóm bị gộp chung `'network'`, khiến integrator debug sai hướng.
+ *
+ * `'agent-registration-required'`: khách đã quét QR và xác thực Zalo XONG, nhưng shop bật
+ * plugin đăng ký đại lý (`apps.agent-registration`) và khách chưa đăng ký / chưa được shop
+ * duyệt làm đại lý. Khác `'denied'` (khách tự bấm "Từ chối" trong Mini App) ở chỗ khách không
+ * làm gì sai và bấm "Thử lại" cũng vô nghĩa: việc cần làm là mở Mini App của shop để đăng ký
+ * đại lý trước. `'login-blocked'` là ca shop chặn vì lý do khác (backend gửi mã lạ) — dùng câu
+ * thông báo chung, vẫn cho thử lại.
  */
-type ZaloQrLoginErrorReason = 'not-initialized' | 'disabled' | 'consent-required' | 'invalid-project-key' | 'project-suspended' | 'network' | 'expired' | 'denied' | 'cancelled';
+type ZaloQrLoginErrorReason = 'not-initialized' | 'disabled' | 'consent-required' | 'invalid-project-key' | 'project-suspended' | 'network' | 'expired' | 'denied' | 'cancelled' | 'agent-registration-required' | 'login-blocked';
 /** Tuỳ chọn cho `loginWithZalo()`. */
 interface ZaloQrLoginOptions {
     /** Ưu tiên SSE (mặc định `true`); `false` ⇒ chỉ dùng poll ngay từ đầu. */
     preferSse?: boolean;
     /** Khoảng poll fallback (ms). Mặc định 2000. */
     pollIntervalMs?: number;
-    /**
-     * Mặc định `true` — quét thành công thì SDK **tự chọn** giữa `identify()`/`alias()`, integrator
-     * không cần tự nghĩ về ca "site đã có tài khoản riêng":
-     * - Chưa từng `identify()` trước đó → Zalo QR là cách đăng nhập chính → `identify(String(contactId), {...})`.
-     * - Đã có `userId` từ trước (site tự `identify()` sau login thường của họ) → **không ghi đè** —
-     *   `alias(String(contactId), userId cũ)` để backend biết 2 ID là cùng một người, `userId`
-     *   hiện tại giữ nguyên, lịch sử tracking không bị "nhảy" giữa chừng.
-     *
-     * Đặt `false` để tắt hẳn cả 2 nhánh trên, tự quyết định 100% bằng `result.contactId` — xem
-     * "autoIdentify: false" trong docs.
-     */
-    autoIdentify?: boolean;
 }
 /**
  * Kết quả khi người dùng quét QR và xác thực Zalo thành công.
  *
  * KHÔNG có `phone` — số điện thoại thật KHÔNG được trả về client (cùng lý do đã bỏ
  * `apiToken`/`loginToken`: PII/credential lộ ra bất kỳ script nào chạy chung trang hoặc
- * ai mở DevTools). `contactId` là định danh dùng để `identify()` — nếu cần số điện thoại
- * cho nghiệp vụ, tự tra cứu ở backend của bạn bằng `contactId` (đã xác thực thật).
+ * ai mở DevTools). `contactId` là định danh khách trong CDP, server đã nối với anonymousId
+ * của phiên; host KHÔNG cần gọi identify(). Nếu cần số điện thoại cho nghiệp vụ, tự tra cứu
+ * ở backend của bạn bằng `contactId` (đã xác thực thật).
  */
 interface ZaloQrLoginResult {
     contactId?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnv-vn/track",
-  "version": "0.3.0-beta.12",
+  "version": "0.3.0-beta.15",
   "description": "CNV Tracking SDK — lightweight, async-first web analytics tracker (<30KB gzipped).",
   "keywords": [
     "analytics",