auth-mn 1.2.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

@@ -75,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;

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;

package/dist/user.d.ts

@@ -7,8 +7,14 @@ import { PageResult, Result, UserBankAccount, UserListFilter, UserLite, UserT, V
  *   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
@@ -75,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;

package/dist/user.js

@@ -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;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auth-mn",
-  "version": "1.2.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",