auth-mn 1.1.0 → 1.3.0

package/README.md

@@ -1,236 +1,240 @@
-# auth-mn
-
-**Auth.mn** — таны апп-уудын нэгдсэн хэрэглэгчийн систем. Хэрэглэгч бүртгүүлэх, нэвтрэх
-(утас / имэйл OTP, Google, Facebook, Steam, QR), профайл, төхөөрөмж, мэдэгдлийг Auth.mn
-хариуцна; таны апп зөвхөн **хэрэглэгчийн token**-ийг хүлээж аваад Auth.mn-ээс мэдээллийг нь
-асууна.
-
-Энэ сан нь таны **backend (Node.js)** дээр ажиллана:
-
-| Та юу хийх вэ | Сангийн функц | Шаардлагатай эрх |
-|---|---|---|
-| Frontend-ээс ирсэн хэрэглэгчийн token шалгаж мэдээллийг авах | `user.verify(token)` / `user.middleware()` | `user.verify` |
-| user_id / утас / имэйлээр нэг хэрэглэгч авах | `user.find({...})` | `user.read` |
-| Олон хэрэглэгч (өөрийн апп-ийн хэрэглэгчид, ID жагсаалт, хайлт) | `user.list({...})` / `user.listAll({...})` | `user.read` |
-| Push мэдэгдэл, SMS, имэйл илгээх | `notification.push / sms / mail` | `notification.*` |
-| Хэрэглэгчийн нээлттэй апп дээр realtime toast / төлөв харуулах | `socket.toast / status / orderStatus / emit` | `socket.*` |
-
-Frontend дээр нэвтрэх товч, QR нэвтрэлт хэрэгтэй бол **[auth-mn-react](https://www.npmjs.com/package/auth-mn-react)** санг хэрэглэнэ.
-
-```bash
-npm i auth-mn
-```
-
----
-
-## 1. Client бүртгүүлэх
-
-Auth.mn **admin panel → Апп-ууд (Client)** дээр апп-аа бүртгэхэд `client_id` (`cl_…`) болон
-`client_secret` (`sk_…`) олгоно. Secret **нэг л удаа** харагдана — `.env`-дээ хадгална.
-Тухайн апп ямар API дуудаж болохыг (эрхүүдийг) admin тэндээ сонгоно; эрхгүй API дуудвал
-`403` + ямар эрх дутууг хэлсэн message ирнэ.
-
-```env
-AUTH_MN_CLIENT_ID=cl_xxxxxxxxxxxxxxxx
-AUTH_MN_CLIENT_SECRET=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-```
-
-## 2. Тохиргоо
-
-```ts
-import authMn, { setAuth, setHost } from "auth-mn";
-
-setHost("prod"); // "staging" эсвэл setHost({ MAIN: "https://api.auth.mn" })
-setAuth({
-  client_id: process.env.AUTH_MN_CLIENT_ID!,
-  client_secret: process.env.AUTH_MN_CLIENT_SECRET!
-});
-```
-
-Үүний дараа юу ч хийх шаардлагагүй: сан `client_id + secret`-ээр access token (1 цаг) болон
-refresh token (30 хоног) авч, хугацаа дуусахаас өмнө өөрөө сунгана. 401 ирвэл token-оо
-сэргээж нэг удаа дахин оролдоно. **Бүх функц `{ success, message, data, status }` буцна, throw хийхгүй.**
-
-## 3. Хэрэглэгч нэвтрүүлэх (гол урсгал)
-
-```
-[Frontend]  auth-mn-react → Auth.mn дээр нэвтэрнэ → таны сайт руу ?authToken=... буцна
-                 (эсвэл QR / OTP-оор token авна)
-      │  Authorization: Bearer <authToken>
-      ▼
-[Таны backend]  authMn.user.verify(authToken)  ──►  Auth.mn (client token + user.verify эрх)
-      │                                               token-ийг задалж, хэрэглэгчийн
-      ▼                                               мэдээллийг буцаана
-   өөрийн session / JWT үүсгэнэ, хэрэглэгчийг DB-дээ user_id-аар холбоно
-```
-
-### 3.1 Нэвтрэх endpoint
-
-```ts
-app.post("/api/auth/callback", async (req, res) => {
-  const v = await authMn.user.verify(req.body.authToken);
-  if (!v.success) return res.status(401).json({ message: v.message });
-
-  const u = v.data.user; // user_id, user_name, primary_phone, primary_email, profile_image_url, ...
-  // 1) өөрийн DB-д user_id-аар хайж байхгүй бол үүсгэнэ
-  // 2) өөрийн session / JWT үүсгэж cookie-д хадгална
-  res.json({ success: true, user: u });
-});
-```
-
-`v.data`:
-
-```ts
-{
-  user: UserT;                        // доорх бүтэц
-  exp: number | null;                 // хэрэглэгчийн token дуусах хугацаа (unix sec)
-  client: { client_id, name }         // ямар client-ээр шалгасан
-}
-```
-
-Шалгалт бүр хэрэглэгчийн **нэвтрэлтийн түүхэнд** "`<таны домэйн>`-д дамжуулсан" гэж бүртгэгдэнэ —
-хэрэглэгч Auth.mn дээрээ аль апп-д хэзээ нэвтэрснээ харна.
-
-### 3.2 Route хамгаалах middleware
-
-Хэрэглэгчийн token-ийг хүсэлт бүрт шалгах бол:
-
-```ts
-// Authorization: Bearer <token>  (эсвэл ?authToken= / body.authToken)
-app.get("/api/me", authMn.user.middleware(), (req, res) => {
-  res.json(req.authMnUser); // UserT
-});
-
-app.get("/api/feed", authMn.user.middleware({ required: false }), (req, res) => {
-  // нэвтрээгүй бол req.authMnUser === null, алдаа өгөхгүй
-});
-```
-
-> Хүсэлт бүрт Auth.mn руу нэг дуудлага хийдэг тул ачаалал ихтэй бол 3.1-ийн адил нэвтрэх үед нэг удаа
-> шалгаад өөрийн session/JWT ашиглахыг зөвлөнө.
-
-### 3.3 Хэрэглэгч хайх
-
-```ts
-const r = await authMn.user.find({ user_id: 5742248 });   // эсвэл { phone_number: "99112233" } / { email }
-if (r.success) console.log(r.data.user_name);
-```
-
-### 3.4 Олон хэрэглэгч (жагсаалт)
-
-```ts
-// Таны апп-д бүртгүүлсэн бүх хэрэглэгч — campaign, push илгээхэд
-const r = await authMn.user.list({ app_name: "CHARGEX", fields: "lite", page: 1, limit: 500 });
-// r.data = { list: UserLite[], total, page, limit }
-
-const all = await authMn.user.listAll({ app_name: "CHARGEX", fields: "lite" }); // бүх хуудсыг нэгтгэнэ
-await authMn.user.list({ user_ids: [5742248, 5742249] });
-await authMn.user.list({ q: "9911", last_login_after: "2026-01-01" });
-```
-
-Шүүлтүүр: `user_ids | app_name | phone_number | email | name | q | gender | last_login_after | page | limit (≤500) | fields ("full" | "lite")`.
-
-### UserT
-
-```ts
-{
-  user_id: number;              // Auth.mn-ийн тогтмол ID — өөрийн DB-д үүгээр холбоно
-  user_name: string;
-  nick_name: string;
-  primary_phone: string | null;
-  primary_email: string | null;
-  emails: { email, verified, primary }[];
-  phone_numbers: { number, verified, primary }[];
-  profile_image_url: string;
-  gender?: "MEN" | "WOMEN";
-  date_of_birth: Date | null;
-  auth_profiles: { google_id, facebook_id, steam_id, ... };
-  sign_up_date, last_login, ...
-}
-```
-
-## 4. Мэдэгдэл
-
-```ts
-await authMn.notification.push({
-  user_id: 5742248,
-  target_app: "MY-APP",
-  body: { title: "Захиалга", body: "Захиалга #123 батлагдлаа", button: { title: "Харах", url: "https://..." } }
-});                                                                             // notification.push
-await authMn.notification.sms({ to: "99112233", from: "MYAPP", text: "Код: 1234" }); // notification.sms
-await authMn.notification.mail({
-  type: "notification", to: ["a@b.mn"], subject: "Сайн уу",
-  body: { name: "Бат", title: "Тавтай морил", desc: "..." }
-});                                                                             // notification.mail
-```
-
-## 5. Socket (realtime)
-
-Хэрэглэгч Auth.mn-тэй холбогдсон аль нэг апп-аа нээлттэй байхад:
-
-```ts
-await authMn.socket.toast({ user_id, type: "info", text: "Төлбөр амжилттай" });          // socket.toast
-await authMn.socket.status({ user_id, id: "order-123", type: "Loading", title: "Боловсруулж байна" }); // socket.status
-await authMn.socket.status({ user_id, id: "order-123", type: "Success", title: "Амжилттай", amount: 15000 });
-await authMn.socket.orderStatus({ user_id, order_id: "order-123" });                      // socket.status
-await authMn.socket.emit([{ user_id, emit_name: "my-event", data: { any: 1 } }]);        // socket.emit
-```
-
-## 6. EXP нэмэх (Seller Panda г.м.)
-
-Хэрэглэгчид exp олгох. client_id/secret-ээс **тусдаа EXP түлхүүр** хэрэгтэй — Admin panel →
-**EXP түлхүүр** дээр нэр (ж: `Seller Panda`) + нэг дуудлагад олгох exp-ийг admin тохируулж
-үүсгэнэ (`exp_…`, нэг удаа харагдана). Хэдэн exp нэмэгдэх нь түлхүүр дээр тогтсон — дуудагч
-тал өөрчилж чадахгүй.
-
-```ts
-import authMn, { setExpKey } from "auth-mn";
-
-setExpKey(process.env.AUTH_MN_EXP_KEY); // exp_…
-
-// user_id-ээр
-const r = await authMn.exp.add({
-  user_id: 8636569,
-  desc: "Худалдан авалт #1234",
-  ref: "order-1234" // optional — ижил ref-ээр дахин дуудахад давхар нэмэхгүй
-});
-// r.data → { user_id, exp: 10, exp_total: 1250, desc, ref, duplicate: false, ... }
-
-// эсвэл frontend-ээс ирсэн хэрэглэгчийн token-оор
-await authMn.exp.add({ token: userToken, desc: "Өдөр тутмын нэвтрэлт" });
-
-// тухайн түлхүүрээр нэмсэн лог
-const logs = await authMn.exp.logs({ user_id: 8636569, page: 1, limit: 20 });
-```
-
-Шууд HTTP: `POST https://api.auth.mn/main/v1/auth/exp/add` — `Authorization: Bearer exp_…`
-(эсвэл `x-exp-key: exp_…`), body `{ user_id | token, desc, ref? }`.
-
-## 7. Client өөрийн мэдээлэл
-
-```ts
-import { config } from "auth-mn";
-await authMn.auth.getToken();   // хүчинтэй access token (шаардлагатай бол refresh / login хийгээд)
-config.token;                   // одоогийн access token — гараар Authorization: Bearer үүсгэхэд
-
-await authMn.auth.me();                      // { client_id, name, permissions, ... }
-authMn.auth.hasPermission("notification.sms"); // сүүлийн token-оос
-await authMn.auth.permissions();             // Auth.mn-ийн бүх боломжит эрх
-await authMn.auth.revoke();                  // refresh token-оо хүчингүй болгоод cache цэвэрлэнэ
-```
-
-## Алдаа
-
-| status | Шалтгаан |
-|---|---|
-| 401 | client_id/secret буруу, client идэвхгүй, эсвэл хэрэглэгчийн token хүчингүй |
-| 403 | Энэ API-д шаардлагатай эрх client-д олгогдоогүй — admin panel дээр нэмнэ |
-| 0 | Сүлжээний алдаа (`message`-д шалтгаан) |
-
-## 0.x → 1.0 шилжилт
-
-- `config.auth.username / password`, `auth.TOKEN({username,password})` → `setAuth({ client_id, client_secret })`.
-  Хуучин client бүртгэлүүд admin panel дээр **Secret шинэчлэх** дарж secret авна.
-- `find.USER / MERCHANT / ADMIN / CLIENT / CRM` **хасагдсан** — хэрэглэгчийн мэдээлэл `user.verify` / `user.find`-ээр.
-- `notification.SinglePushNoti / SMS / MAIL`, `socket.ShowToast / ShowStatus / ShowOrderStatus / EMIT` хэвээр ажиллана (alias).
-- `notification._3RD.*` хасагдсан.
+# auth-mn
+
+**Auth.mn** — таны апп-уудын нэгдсэн хэрэглэгчийн систем. Хэрэглэгч бүртгүүлэх, нэвтрэх
+(утас / имэйл OTP, Google, Facebook, Steam, QR), профайл, төхөөрөмж, мэдэгдлийг Auth.mn
+хариуцна; таны апп зөвхөн **хэрэглэгчийн token**-ийг хүлээж аваад Auth.mn-ээс мэдээллийг нь
+асууна.
+
+Энэ сан нь таны **backend (Node.js)** дээр ажиллана:
+
+| Та юу хийх вэ | Сангийн функц | Шаардлагатай эрх |
+|---|---|---|
+| Frontend-ээс ирсэн хэрэглэгчийн token шалгаж мэдээллийг авах | `user.verify(token)` / `user.middleware()` | `user.verify` |
+| user_id / утас / имэйлээр нэг хэрэглэгч авах | `user.find({...})` | `user.read` |
+| Олон хэрэглэгч (өөрийн апп-ийн хэрэглэгчид, ID жагсаалт, хайлт) | `user.list({...})` / `user.listAll({...})` | `user.read` |
+| Push мэдэгдэл, SMS, имэйл илгээх | `notification.push / sms / mail` | `notification.*` |
+| Хэрэглэгчийн нээлттэй апп дээр realtime toast / төлөв харуулах | `socket.toast / status / orderStatus / emit` | `socket.*` |
+
+Frontend дээр нэвтрэх товч, QR нэвтрэлт хэрэгтэй бол **[auth-mn-react](https://www.npmjs.com/package/auth-mn-react)** санг хэрэглэнэ.
+
+```bash
+npm i auth-mn
+```
+
+---
+
+## 1. Client бүртгүүлэх
+
+Auth.mn **admin panel → Апп-ууд (Client)** дээр апп-аа бүртгэхэд `client_id` (`cl_…`) болон
+`client_secret` (`sk_…`) олгоно. Secret **нэг л удаа** харагдана — `.env`-дээ хадгална.
+Тухайн апп ямар API дуудаж болохыг (эрхүүдийг) admin тэндээ сонгоно; эрхгүй API дуудвал
+`403` + ямар эрх дутууг хэлсэн message ирнэ.
+
+```env
+AUTH_MN_CLIENT_ID=cl_xxxxxxxxxxxxxxxx
+AUTH_MN_CLIENT_SECRET=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+```
+
+## 2. Тохиргоо
+
+```ts
+import authMn, { setAuth, setHost } from "auth-mn";
+
+setHost("prod"); // "staging" эсвэл setHost({ MAIN: "https://api.auth.mn" })
+setAuth({
+  client_id: process.env.AUTH_MN_CLIENT_ID!,
+  client_secret: process.env.AUTH_MN_CLIENT_SECRET!
+});
+```
+
+Үүний дараа юу ч хийх шаардлагагүй: сан `client_id + secret`-ээр access token (1 цаг) болон
+refresh token (30 хоног) авч, хугацаа дуусахаас өмнө өөрөө сунгана. 401 ирвэл token-оо
+сэргээж нэг удаа дахин оролдоно. **Бүх функц `{ success, message, data, status }` буцна, throw хийхгүй.**
+
+## 3. Хэрэглэгч нэвтрүүлэх (гол урсгал)
+
+```
+[Frontend]  auth-mn-react → Auth.mn дээр нэвтэрнэ → таны сайт руу ?authToken=... буцна
+                 (эсвэл QR / OTP-оор token авна)
+      │  Authorization: Bearer <authToken>
+      ▼
+[Таны backend]  authMn.user.verify(authToken)  ──►  Auth.mn (client token + user.verify эрх)
+      │                                               token-ийг задалж, хэрэглэгчийн
+      ▼                                               мэдээллийг буцаана
+   өөрийн session / JWT үүсгэнэ, хэрэглэгчийг DB-дээ user_id-аар холбоно
+```
+
+### 3.1 Нэвтрэх endpoint
+
+```ts
+app.post("/api/auth/callback", async (req, res) => {
+  const v = await authMn.user.verify(req.body.authToken);
+  if (!v.success) return res.status(401).json({ message: v.message });
+
+  const u = v.data.user; // user_id, user_name, primary_phone, primary_email, profile_image_url, ...
+  // 1) өөрийн DB-д user_id-аар хайж байхгүй бол үүсгэнэ
+  // 2) өөрийн session / JWT үүсгэж cookie-д хадгална
+  res.json({ success: true, user: u });
+});
+```
+
+`v.data`:
+
+```ts
+{
+  user: UserT;                        // доорх бүтэц
+  exp: number | null;                 // хэрэглэгчийн token дуусах хугацаа (unix sec)
+  client: { client_id, name }         // ямар client-ээр шалгасан
+}
+```
+
+Шалгалт бүр хэрэглэгчийн **нэвтрэлтийн түүхэнд** "`<таны домэйн>`-д дамжуулсан" гэж бүртгэгдэнэ —
+хэрэглэгч Auth.mn дээрээ аль апп-д хэзээ нэвтэрснээ харна.
+
+`user.verify` default-оор token-ийн payload-аас шууд буцаадаг (Auth.mn DB руу хандахгүй, хурдан;
+мэдээлэл token-ийн хугацаа дуустал хуучирч болно). Төлбөр, данс зэрэг чухал үйлдэлд
+`authMn.user.verify(token, { fresh: true })` — DB-ээс хамгийн сүүлийн мэдээлэл.
+
+### 3.2 Route хамгаалах middleware
+
+Хэрэглэгчийн token-ийг хүсэлт бүрт шалгах бол:
+
+```ts
+// Authorization: Bearer <token>  (эсвэл ?authToken= / body.authToken)
+app.get("/api/me", authMn.user.middleware(), (req, res) => {
+  res.json(req.authMnUser); // UserT
+});
+
+app.get("/api/feed", authMn.user.middleware({ required: false }), (req, res) => {
+  // нэвтрээгүй бол req.authMnUser === null, алдаа өгөхгүй
+});
+```
+
+> Хүсэлт бүрт Auth.mn руу нэг дуудлага хийдэг тул ачаалал ихтэй бол 3.1-ийн адил нэвтрэх үед нэг удаа
+> шалгаад өөрийн session/JWT ашиглахыг зөвлөнө.
+
+### 3.3 Хэрэглэгч хайх
+
+```ts
+const r = await authMn.user.find({ user_id: 5742248 });   // эсвэл { phone_number: "99112233" } / { email }
+if (r.success) console.log(r.data.user_name);
+```
+
+### 3.4 Олон хэрэглэгч (жагсаалт)
+
+```ts
+// Таны апп-д бүртгүүлсэн бүх хэрэглэгч — campaign, push илгээхэд
+const r = await authMn.user.list({ app_name: "CHARGEX", fields: "lite", page: 1, limit: 500 });
+// r.data = { list: UserLite[], total, page, limit }
+
+const all = await authMn.user.listAll({ app_name: "CHARGEX", fields: "lite" }); // бүх хуудсыг нэгтгэнэ
+await authMn.user.list({ user_ids: [5742248, 5742249] });
+await authMn.user.list({ q: "9911", last_login_after: "2026-01-01" });
+```
+
+Шүүлтүүр: `user_ids | app_name | phone_number | email | name | q | gender | last_login_after | page | limit (≤500) | fields ("full" | "lite")`.
+
+### UserT
+
+```ts
+{
+  user_id: number;              // Auth.mn-ийн тогтмол ID — өөрийн DB-д үүгээр холбоно
+  user_name: string;
+  nick_name: string;
+  primary_phone: string | null;
+  primary_email: string | null;
+  emails: { email, verified, primary }[];
+  phone_numbers: { number, verified, primary }[];
+  profile_image_url: string;
+  gender?: "MEN" | "WOMEN";
+  date_of_birth: Date | null;
+  auth_profiles: { google_id, facebook_id, steam_id, ... };
+  sign_up_date, last_login, ...
+}
+```
+
+## 4. Мэдэгдэл
+
+```ts
+await authMn.notification.push({
+  user_id: 5742248,
+  target_app: "MY-APP",
+  body: { title: "Захиалга", body: "Захиалга #123 батлагдлаа", button: { title: "Харах", url: "https://..." } }
+});                                                                             // notification.push
+await authMn.notification.sms({ to: "99112233", from: "MYAPP", text: "Код: 1234" }); // notification.sms
+await authMn.notification.mail({
+  type: "notification", to: ["a@b.mn"], subject: "Сайн уу",
+  body: { name: "Бат", title: "Тавтай морил", desc: "..." }
+});                                                                             // notification.mail
+```
+
+## 5. Socket (realtime)
+
+Хэрэглэгч Auth.mn-тэй холбогдсон аль нэг апп-аа нээлттэй байхад:
+
+```ts
+await authMn.socket.toast({ user_id, type: "info", text: "Төлбөр амжилттай" });          // socket.toast
+await authMn.socket.status({ user_id, id: "order-123", type: "Loading", title: "Боловсруулж байна" }); // socket.status
+await authMn.socket.status({ user_id, id: "order-123", type: "Success", title: "Амжилттай", amount: 15000 });
+await authMn.socket.orderStatus({ user_id, order_id: "order-123" });                      // socket.status
+await authMn.socket.emit([{ user_id, emit_name: "my-event", data: { any: 1 } }]);        // socket.emit
+```
+
+## 6. EXP нэмэх (Seller Panda г.м.)
+
+Хэрэглэгчид exp олгох. client_id/secret-ээс **тусдаа EXP түлхүүр** хэрэгтэй — Admin panel →
+**EXP түлхүүр** дээр нэр (ж: `Seller Panda`) + нэг дуудлагад олгох exp-ийг admin тохируулж
+үүсгэнэ (`exp_…`, нэг удаа харагдана). Хэдэн exp нэмэгдэх нь түлхүүр дээр тогтсон — дуудагч
+тал өөрчилж чадахгүй.
+
+```ts
+import authMn, { setExpKey } from "auth-mn";
+
+setExpKey(process.env.AUTH_MN_EXP_KEY); // exp_…
+
+// user_id-ээр
+const r = await authMn.exp.add({
+  user_id: 8636569,
+  desc: "Худалдан авалт #1234",
+  ref: "order-1234" // optional — ижил ref-ээр дахин дуудахад давхар нэмэхгүй
+});
+// r.data → { user_id, exp: 10, exp_total: 1250, desc, ref, duplicate: false, ... }
+
+// эсвэл frontend-ээс ирсэн хэрэглэгчийн token-оор
+await authMn.exp.add({ token: userToken, desc: "Өдөр тутмын нэвтрэлт" });
+
+// тухайн түлхүүрээр нэмсэн лог
+const logs = await authMn.exp.logs({ user_id: 8636569, page: 1, limit: 20 });
+```
+
+Шууд HTTP: `POST https://api.auth.mn/main/v1/auth/exp/add` — `Authorization: Bearer exp_…`
+(эсвэл `x-exp-key: exp_…`), body `{ user_id | token, desc, ref? }`.
+
+## 7. Client өөрийн мэдээлэл
+
+```ts
+import { config } from "auth-mn";
+await authMn.auth.getToken();   // хүчинтэй access token (шаардлагатай бол refresh / login хийгээд)
+config.token;                   // одоогийн access token — гараар Authorization: Bearer үүсгэхэд
+
+await authMn.auth.me();                      // { client_id, name, permissions, ... }
+authMn.auth.hasPermission("notification.sms"); // сүүлийн token-оос
+await authMn.auth.permissions();             // Auth.mn-ийн бүх боломжит эрх
+await authMn.auth.revoke();                  // refresh token-оо хүчингүй болгоод cache цэвэрлэнэ
+```
+
+## Алдаа
+
+| status | Шалтгаан |
+|---|---|
+| 401 | client_id/secret буруу, client идэвхгүй, эсвэл хэрэглэгчийн token хүчингүй |
+| 403 | Энэ API-д шаардлагатай эрх client-д олгогдоогүй — admin panel дээр нэмнэ |
+| 0 | Сүлжээний алдаа (`message`-д шалтгаан) |
+
+## 0.x → 1.0 шилжилт
+
+- `config.auth.username / password`, `auth.TOKEN({username,password})` → `setAuth({ client_id, client_secret })`.
+  Хуучин client бүртгэлүүд admin panel дээр **Secret шинэчлэх** дарж secret авна.
+- `find.USER / MERCHANT / ADMIN / CLIENT / CRM` **хасагдсан** — хэрэглэгчийн мэдээлэл `user.verify` / `user.find`-ээр.
+- `notification.SinglePushNoti / SMS / MAIL`, `socket.ShowToast / ShowStatus / ShowOrderStatus / EMIT` хэвээр ажиллана (alias).
+- `notification._3RD.*` хасагдсан.

package/dist/index.d.ts

@@ -9,15 +9,17 @@
  * Token-ийг lib өөрөө авч, хугацаа дуусахаас өмнө refresh хийнэ.
  * Client-д олгосон permission-ээс гадуур API дуудвал 403 + message буцна.
  *
- * Хамрах хүрээ: хэрэглэгч (verify / find), мэдэгдэл (push / sms / mail),
+ * Хамрах хүрээ: хэрэглэгч (verify / find / bankAccounts), мэдэгдэл (push / sms / mail),
  * socket (toast / status / orderStatus / emit), exp (хэрэглэгчид exp нэмэх —
- * тусдаа EXP түлхүүр, setExpKey). Merchant/admin зэрэг дотоод бүртгэлүүд энэ санд байхгүй.
+ * тусдаа EXP түлхүүр, setExpKey), wallet (хэрэглэгчийн token-оор хэтэвч
+ * үүсгэх / үлдэгдэл / лог). Merchant/admin зэрэг дотоод бүртгэлүүд энэ санд байхгүй.
  */
 import auth from "./auth";
 import user from "./user";
 import notification from "./notification";
 import socket from "./socket";
 import exp from "./exp";
+import wallet from "./wallet";
 export type Env = "prod" | "staging";
 export type Config = {
     /** Одоогийн client access token (сан автоматаар шинэчилнэ; гараар Authorization header үүсгэхэд ашиглаж болно) */
@@ -54,7 +56,7 @@ export declare const setLogger: (status: boolean) => void;
 export declare const jsonToQueryString: (params: Record<string, any>) => string;
 export declare const ObjectId: () => string;
 import { authState } from "./auth";
-export { auth, user, notification, socket, exp, authState };
+export { auth, user, notification, socket, exp, wallet, authState };
 export * from "./types";
 declare const _default: {
     auth: {
@@ -73,7 +75,9 @@ declare const _default: {
         state: import("./auth").AuthState;
     };
     user: {
-        verify: (token: string) => Promise<import("./types").Result<import("./types").VerifiedUser>>;
+        verify: (token: string, opts?: {
+            fresh?: boolean;
+        }) => Promise<import("./types").Result<import("./types").VerifiedUser>>;
         find: (query: {
             user_id?: number | string;
             phone_number?: string;
@@ -81,6 +85,9 @@ declare const _default: {
         }) => Promise<import("./types").Result<import("./types").UserT>>;
         list: typeof import("./user").list;
         listAll: typeof import("./user").listAll;
+        bankAccounts: (query: {
+            user_id: number | string;
+        }) => Promise<import("./types").Result<import("./types").UserBankAccount[]>>;
         middleware: (opts?: import("./user").MiddlewareOptions) => (req: {
             [k: string]: any;
             headers: Record<string, any>;
@@ -123,6 +130,17 @@ declare const _default: {
             limit?: number;
         }, key?: string) => Promise<import("./types").Result<import("./types").PageResult<import("./types").ExpLog>>>;
     };
+    wallet: {
+        templates: (token: string) => Promise<import("./types").Result<import("./types").WalletTemplate[]>>;
+        create: (token: string, key_id: string) => Promise<import("./types").Result<import("./types").UserWalletItem>>;
+        balance: (token: string) => Promise<import("./types").Result<import("./types").WalletBalanceItem[]>>;
+        logs: (token: string, params?: {
+            wallet_id?: string;
+            tra_type?: string;
+            page?: number;
+            limit?: number;
+        }) => Promise<import("./types").Result<import("./types").PageResult<import("./types").WalletLogItem>>>;
+    };
     setAuth: (auth: {
         client_id: string;
         client_secret: string;

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.authState = exports.exp = exports.socket = exports.notification = exports.user = exports.auth = exports.ObjectId = exports.jsonToQueryString = exports.setLogger = exports.setExpKey = exports.setAuth = exports.setHost = exports.config = void 0;
+exports.authState = exports.wallet = exports.exp = exports.socket = exports.notification = exports.user = exports.auth = exports.ObjectId = exports.jsonToQueryString = exports.setLogger = exports.setExpKey = exports.setAuth = exports.setHost = exports.config = void 0;
 /**
  * auth-mn — Auth.mn API client (Node.js)
  *
@@ -26,9 +26,10 @@ exports.authState = exports.exp = exports.socket = exports.notification = export
  * Token-ийг lib өөрөө авч, хугацаа дуусахаас өмнө refresh хийнэ.
  * Client-д олгосон permission-ээс гадуур API дуудвал 403 + message буцна.
  *
- * Хамрах хүрээ: хэрэглэгч (verify / find), мэдэгдэл (push / sms / mail),
+ * Хамрах хүрээ: хэрэглэгч (verify / find / bankAccounts), мэдэгдэл (push / sms / mail),
  * socket (toast / status / orderStatus / emit), exp (хэрэглэгчид exp нэмэх —
- * тусдаа EXP түлхүүр, setExpKey). Merchant/admin зэрэг дотоод бүртгэлүүд энэ санд байхгүй.
+ * тусдаа EXP түлхүүр, setExpKey), wallet (хэрэглэгчийн token-оор хэтэвч
+ * үүсгэх / үлдэгдэл / лог). Merchant/admin зэрэг дотоод бүртгэлүүд энэ санд байхгүй.
  */
 const auth_1 = require("./auth");
 exports.auth = auth_1.default;
@@ -40,6 +41,8 @@ const socket_1 = require("./socket");
 exports.socket = socket_1.default;
 const exp_1 = require("./exp");
 exports.exp = exp_1.default;
+const wallet_1 = require("./wallet");
+exports.wallet = wallet_1.default;
 const HOSTS = {
     prod: { MAIN: "https://api.auth.mn", WALLET: "https://api.auth.mn" },
     staging: { MAIN: "https://staging-api.auth.mn", WALLET: "https://staging-api.auth.mn" }
@@ -109,6 +112,7 @@ exports.default = {
     notification: notification_1.default,
     socket: socket_1.default,
     exp: exp_1.default,
+    wallet: wallet_1.default,
     setAuth: exports.setAuth,
     setHost: exports.setHost,
     setExpKey: exports.setExpKey,

package/dist/types.d.ts

@@ -32,6 +32,8 @@ export type VerifiedUser = {
         client_id: string;
         name: string;
     };
+    /** true бол DB-ээс шинээр уншсан, false бол token-ийн payload */
+    fresh?: boolean;
 };
 export type ClientInfo = {
     client_id: string;
@@ -250,3 +252,54 @@ export type EmitT = {
     emit_name: string;
     data: any;
 };
+/** GET /main/v1/wallet/balance — хэтэвч тус бүрийн үлдэгдэл */
+export type WalletBalanceItem = {
+    key_id: string;
+    name: string;
+    wallet_id: string;
+    balance: number;
+    status: string;
+    wallet_type: string;
+};
+/** GET /main/v1/wallet/list — апп-уудын хэтэвчний загварууд */
+export type WalletTemplate = {
+    key_id: string;
+    wallet_type: string;
+    wallet_name: string;
+    role: string[];
+};
+/** GET /main/v1/wallet/logs — гүйлгээний лог (wallet service-ээс sync хийгдсэн) */
+export type WalletLogItem = {
+    _id?: string;
+    group_id?: string;
+    payment_id?: string;
+    description?: string;
+    /** P2P | M2P | M2M | P2M | T2M | T2P | P2T | M2T */
+    type?: string;
+    /** NORMAL | FEE | REFUND */
+    tra_type?: string;
+    source?: string;
+    receiver?: string;
+    wallet_id?: string;
+    amount?: number;
+    createdAt?: string | Date;
+    [k: string]: unknown;
+};
+export type UserBankAccount = {
+    _id: string;
+    /** Khan refNo (ж: "003" Хаан, "203" Голомт) */
+    bank_code: string;
+    bank_name: string;
+    /** Дансны дугаар (IBAN-гүй) */
+    account: string;
+    iban: string;
+    currency?: string;
+    /** Банкнаас ирсэн дансны эзний нэр */
+    holder_name: string;
+    /** ДАН-ы нэртэй таарц, 0–100 */
+    match: number;
+    primary: boolean;
+    label?: string;
+    verified_at?: string | Date | null;
+    createdAt?: string | Date;
+};

package/dist/user.d.ts

@@ -1,4 +1,4 @@
-import { PageResult, Result, UserListFilter, UserLite, UserT, VerifiedUser } from "./types";
+import { PageResult, Result, UserBankAccount, UserListFilter, UserLite, UserT, VerifiedUser } from "./types";
 /**
  * Хэрэглэгчийн token-ийг Auth.mn сервер дээр баталгаажуулж, хэрэглэгчийн
  * мэдээллийг авна. Frontend (auth-mn-react redirect / QR / OTP) -ээс ирсэн
@@ -7,8 +7,14 @@ import { PageResult, Result, UserListFilter, UserLite, UserT, VerifiedUser } fro
  *   const v = await authMn.user.verify(token);
  *   if (!v.success) return res.status(401).json({ message: v.message });
  *   v.data.user.user_id ...
+ *
+ * Default-оор Auth.mn token-ийн payload-аас шууд буцаана (DB-гүй, хурдан) — мэдээлэл token-ийн
+ * хугацаа дуустал хуучирч болно. Төлбөр, данс зэрэг чухал үйлдэлд { fresh: true } өгвөл DB-ээс
+ * хамгийн сүүлийн мэдээллийг уншина.
  */
-export declare const verify: (token: string) => Promise<Result<VerifiedUser>>;
+export declare const verify: (token: string, opts?: {
+    fresh?: boolean;
+}) => Promise<Result<VerifiedUser>>;
 /**
  * Хэрэглэгч хайх — user_id, phone_number эсвэл email-ийн аль нэгээр (нэг хэрэглэгч).
  * Permission: user.read
@@ -35,6 +41,16 @@ export declare function listAll(filter: UserListFilter & {
     fields: "lite";
 }, max?: number): Promise<Result<UserLite[]>>;
 export declare function listAll(filter?: UserListFilter, max?: number): Promise<Result<UserT[]>>;
+/**
+ * Хэрэглэгчийн ДАН-аар баталгаажуулж холбосон банкны дансууд (primary эхэндээ).
+ * Мөнгө буцаан олголт, таталтын хүсэлтэд ашиглана. Permission: user.bank.read
+ *
+ *   const r = await authMn.user.bankAccounts({ user_id: 8636569 });
+ *   r.data → [{ bank_code, bank_name, account, iban, holder_name, primary, ... }]
+ */
+export declare const bankAccounts: (query: {
+    user_id: number | string;
+}) => Promise<Result<UserBankAccount[]>>;
 type AnyReq = {
     headers: Record<string, any>;
     query?: any;
@@ -65,7 +81,9 @@ export type MiddlewareOptions = {
  */
 export declare const middleware: (opts?: MiddlewareOptions) => (req: AnyReq, res: AnyRes, next: Next) => Promise<any>;
 declare const _default: {
-    verify: (token: string) => Promise<Result<VerifiedUser>>;
+    verify: (token: string, opts?: {
+        fresh?: boolean;
+    }) => Promise<Result<VerifiedUser>>;
     find: (query: {
         user_id?: number | string;
         phone_number?: string;
@@ -73,6 +91,9 @@ declare const _default: {
     }) => Promise<Result<UserT>>;
     list: typeof list;
     listAll: typeof listAll;
+    bankAccounts: (query: {
+        user_id: number | string;
+    }) => Promise<Result<UserBankAccount[]>>;
     middleware: (opts?: MiddlewareOptions) => (req: AnyReq, res: AnyRes, next: Next) => Promise<any>;
 };
 export default _default;

package/dist/user.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.middleware = exports.find = exports.verify = void 0;
+exports.middleware = exports.bankAccounts = exports.find = exports.verify = void 0;
 exports.list = list;
 exports.listAll = listAll;
 const request_1 = require("./request");
@@ -12,12 +12,16 @@ const request_1 = require("./request");
  *   const v = await authMn.user.verify(token);
  *   if (!v.success) return res.status(401).json({ message: v.message });
  *   v.data.user.user_id ...
+ *
+ * Default-оор Auth.mn token-ийн payload-аас шууд буцаана (DB-гүй, хурдан) — мэдээлэл token-ийн
+ * хугацаа дуустал хуучирч болно. Төлбөр, данс зэрэг чухал үйлдэлд { fresh: true } өгвөл DB-ээс
+ * хамгийн сүүлийн мэдээллийг уншина.
  */
-const verify = (token) => (0, request_1.request)({
+const verify = (token, opts = {}) => (0, request_1.request)({
     method: "POST",
     path: "/main/v1/auth/client/user/verify",
     name: "user verify",
-    data: { token }
+    data: { token, fresh: !!opts.fresh }
 });
 exports.verify = verify;
 /**
@@ -49,6 +53,20 @@ async function listAll(filter = {}, max = 50000) {
     }
     return { success: true, message: "Амжилттай", data: all, status: 200 };
 }
+/**
+ * Хэрэглэгчийн ДАН-аар баталгаажуулж холбосон банкны дансууд (primary эхэндээ).
+ * Мөнгө буцаан олголт, таталтын хүсэлтэд ашиглана. Permission: user.bank.read
+ *
+ *   const r = await authMn.user.bankAccounts({ user_id: 8636569 });
+ *   r.data → [{ bank_code, bank_name, account, iban, holder_name, primary, ... }]
+ */
+const bankAccounts = (query) => (0, request_1.request)({
+    method: "POST",
+    path: "/main/v1/auth/client/user/bank-accounts",
+    name: "user bank accounts",
+    data: query
+});
+exports.bankAccounts = bankAccounts;
 const defaultGetToken = (req) => {
     var _a, _b, _c, _d;
     const h = String(((_a = req.headers) === null || _a === void 0 ? void 0 : _a.authorization) || ((_b = req.headers) === null || _b === void 0 ? void 0 : _b.Authorization) || "");
@@ -90,4 +108,4 @@ const middleware = (opts = {}) => async (req, res, next) => {
     return next();
 };
 exports.middleware = middleware;
-exports.default = { verify: exports.verify, find: exports.find, list, listAll, middleware: exports.middleware };
+exports.default = { verify: exports.verify, find: exports.find, list, listAll, bankAccounts: exports.bankAccounts, middleware: exports.middleware };

package/dist/wallet.d.ts

@@ -0,0 +1,47 @@
+import { PageResult, Result, UserWalletItem, WalletBalanceItem, WalletLogItem, WalletTemplate } from "./types";
+/**
+ * Wallet — хэрэглэгчийн хэтэвч (Auth.mn main API, /main/v1/wallet/*).
+ *
+ * Эдгээр нь бүгд ХЭРЭГЛЭГЧИЙН token-оор дуудагддаг: frontend-ээс ирсэн
+ * Bearer token-ийг эхний аргумент болгон өгнө. Client permission шаардахгүй.
+ *
+ *   // Хэтэвч үүсгэх (апп-ын key_id-ээр, ж: "SELLER-APP")
+ *   const w = await authMn.wallet.create(userToken, "SELLER-APP");
+ *   // Үлдэгдэл (хэрэглэгчийн бүх хэтэвч)
+ *   const b = await authMn.wallet.balance(userToken);
+ *   // Гүйлгээний лог
+ *   const l = await authMn.wallet.logs(userToken, { wallet_id: w.data?.wallet_id });
+ *
+ * Хэрэглэгчийн wallet_id/wallet_key-г сервер талаас token-гүй авах бол
+ * authMn.user.find({ user_id }) → data.wallets (permission: user.read).
+ */
+/** Үүсгэж болох хэтэвчний загварууд */
+export declare const templates: (token: string) => Promise<Result<WalletTemplate[]>>;
+/**
+ * Хэтэвч үүсгэх. Хэрэглэгч тухайн key_id-ийн хэтэвчтэй бол байгааг нь буцаана.
+ * key_id нь Auth.mn дээр бүртгэлтэй байх ёстой (ERR_WALLET_KEY).
+ */
+export declare const create: (token: string, key_id: string) => Promise<Result<UserWalletItem>>;
+/** Хэрэглэгчийн бүх хэтэвчний үлдэгдэл */
+export declare const balance: (token: string) => Promise<Result<WalletBalanceItem[]>>;
+/** Гүйлгээний лог (wallet_id өгөхгүй бол бүх хэтэвч) */
+export declare const logs: (token: string, params?: {
+    wallet_id?: string;
+    /** NORMAL | FEE | REFUND */
+    tra_type?: string;
+    page?: number;
+    limit?: number;
+}) => Promise<Result<PageResult<WalletLogItem>>>;
+declare const _default: {
+    templates: (token: string) => Promise<Result<WalletTemplate[]>>;
+    create: (token: string, key_id: string) => Promise<Result<UserWalletItem>>;
+    balance: (token: string) => Promise<Result<WalletBalanceItem[]>>;
+    logs: (token: string, params?: {
+        wallet_id?: string;
+        /** NORMAL | FEE | REFUND */
+        tra_type?: string;
+        page?: number;
+        limit?: number;
+    }) => Promise<Result<PageResult<WalletLogItem>>>;
+};
+export default _default;

package/dist/wallet.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logs = exports.balance = exports.create = exports.templates = void 0;
+const request_1 = require("./request");
+/**
+ * Wallet — хэрэглэгчийн хэтэвч (Auth.mn main API, /main/v1/wallet/*).
+ *
+ * Эдгээр нь бүгд ХЭРЭГЛЭГЧИЙН token-оор дуудагддаг: frontend-ээс ирсэн
+ * Bearer token-ийг эхний аргумент болгон өгнө. Client permission шаардахгүй.
+ *
+ *   // Хэтэвч үүсгэх (апп-ын key_id-ээр, ж: "SELLER-APP")
+ *   const w = await authMn.wallet.create(userToken, "SELLER-APP");
+ *   // Үлдэгдэл (хэрэглэгчийн бүх хэтэвч)
+ *   const b = await authMn.wallet.balance(userToken);
+ *   // Гүйлгээний лог
+ *   const l = await authMn.wallet.logs(userToken, { wallet_id: w.data?.wallet_id });
+ *
+ * Хэрэглэгчийн wallet_id/wallet_key-г сервер талаас token-гүй авах бол
+ * authMn.user.find({ user_id }) → data.wallets (permission: user.read).
+ */
+/** Үүсгэж болох хэтэвчний загварууд */
+const templates = (token) => (0, request_1.rawRequest)({ method: "GET", path: "/main/v1/wallet/list", name: "wallet templates", auth: false }, token);
+exports.templates = templates;
+/**
+ * Хэтэвч үүсгэх. Хэрэглэгч тухайн key_id-ийн хэтэвчтэй бол байгааг нь буцаана.
+ * key_id нь Auth.mn дээр бүртгэлтэй байх ёстой (ERR_WALLET_KEY).
+ */
+const create = (token, key_id) => (0, request_1.rawRequest)({
+    method: "POST",
+    path: "/main/v1/wallet/create",
+    name: "wallet create",
+    data: { key_id },
+    auth: false
+}, token);
+exports.create = create;
+/** Хэрэглэгчийн бүх хэтэвчний үлдэгдэл */
+const balance = (token) => (0, request_1.rawRequest)({ method: "GET", path: "/main/v1/wallet/balance", name: "wallet balance", auth: false }, token);
+exports.balance = balance;
+/** Гүйлгээний лог (wallet_id өгөхгүй бол бүх хэтэвч) */
+const logs = (token, params = {}) => (0, request_1.rawRequest)({ method: "GET", path: "/main/v1/wallet/logs", name: "wallet logs", params, auth: false }, token);
+exports.logs = logs;
+exports.default = { templates: exports.templates, create: exports.create, balance: exports.balance, logs: exports.logs };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auth-mn",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Auth.mn API client for Node.js — client_id/secret token, user, notification, socket",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",