auth-mn 1.0.0 → 1.1.0

package/README.md

@@ -1,187 +1,236 @@
-# 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` |
-| 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);
-```
-
-### 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. Client өөрийн мэдээлэл
-
-```ts
-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 дээрээ аль апп-д хэзээ нэвтэрснээ харна.
+
+### 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/auth.d.ts

@@ -26,6 +26,8 @@ export declare const refresh: () => Promise<Result<TokenData>>;
  * Бусад бүх API функц үүнийг автоматаар дуудна.
  */
 export declare const getToken: () => Promise<string>;
+/** Одоогийн access token (хоосон бол авч амжаагүй) — config.token-той ижил */
+export declare const token: () => string;
 /** Одоогийн refresh token-ийг серверт хүчингүй болгоод cache цэвэрлэнэ */
 export declare const revoke: () => Promise<Result<null>>;
 /** Client-ийн мэдээлэл + олгогдсон permission */
@@ -44,6 +46,7 @@ export declare const TOKEN: (_legacy?: {
 }) => Promise<string>;
 declare const _default: {
     getToken: () => Promise<string>;
+    token: () => string;
     login: () => Promise<Result<TokenData>>;
     refresh: () => Promise<Result<TokenData>>;
     revoke: () => Promise<Result<null>>;

package/dist/auth.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOKEN = exports.hasPermission = exports.permissions = exports.me = exports.revoke = exports.getToken = exports.refresh = exports.login = exports.authState = exports.AuthState = void 0;
+exports.TOKEN = exports.hasPermission = exports.permissions = exports.me = exports.revoke = exports.token = exports.getToken = exports.refresh = exports.login = exports.authState = exports.AuthState = void 0;
 const index_1 = require("./index");
 const request_1 = require("./request");
 /** Хугацаа дуусахаас хэдэн секундын өмнө refresh хийх */
@@ -27,6 +27,7 @@ class AuthState {
     }
     apply(d) {
         this.accessToken = d.access_token;
+        index_1.config.token = d.access_token;
         this.refreshToken = d.refresh_token;
         this.accessExpiresAt = Date.now() + d.expires_in * 1000;
         this.refreshExpiresAt = Date.now() + d.refresh_expires_in * 1000;
@@ -35,6 +36,7 @@ class AuthState {
     }
     clear() {
         this.accessToken = "";
+        index_1.config.token = "";
         this.refreshToken = "";
         this.accessExpiresAt = 0;
         this.refreshExpiresAt = 0;
@@ -107,6 +109,9 @@ const getToken = () => exports.authState.single(async () => {
     return l.success ? exports.authState.accessToken : "";
 });
 exports.getToken = getToken;
+/** Одоогийн access token (хоосон бол авч амжаагүй) — config.token-той ижил */
+const token = () => index_1.config.token;
+exports.token = token;
 /** Одоогийн refresh token-ийг серверт хүчингүй болгоод cache цэвэрлэнэ */
 const revoke = async () => {
     const rt = exports.authState.refreshToken;
@@ -144,4 +149,4 @@ const TOKEN = async (_legacy) => {
     return (0, exports.getToken)();
 };
 exports.TOKEN = TOKEN;
-exports.default = { getToken: exports.getToken, login: exports.login, refresh: exports.refresh, revoke: exports.revoke, me: exports.me, permissions: exports.permissions, hasPermission: exports.hasPermission, TOKEN: exports.TOKEN, state: exports.authState };
+exports.default = { getToken: exports.getToken, token: exports.token, login: exports.login, refresh: exports.refresh, revoke: exports.revoke, me: exports.me, permissions: exports.permissions, hasPermission: exports.hasPermission, TOKEN: exports.TOKEN, state: exports.authState };

package/dist/exp.d.ts

@@ -0,0 +1,27 @@
+import { ExpAddResult, ExpLog, PageResult, Result } from "./types";
+export declare const add: (input: {
+    user_id?: number | string;
+    token?: string;
+    desc: string;
+    ref?: string;
+}, key?: string) => Promise<Result<ExpAddResult>>;
+/** Тухайн түлхүүрээр нэмсэн exp-ийн лог (user_id-ээр шүүж болно) */
+export declare const logs: (filter?: {
+    user_id?: number | string;
+    page?: number;
+    limit?: number;
+}, key?: string) => Promise<Result<PageResult<ExpLog>>>;
+declare const _default: {
+    add: (input: {
+        user_id?: number | string;
+        token?: string;
+        desc: string;
+        ref?: string;
+    }, key?: string) => Promise<Result<ExpAddResult>>;
+    logs: (filter?: {
+        user_id?: number | string;
+        page?: number;
+        limit?: number;
+    }, key?: string) => Promise<Result<PageResult<ExpLog>>>;
+};
+export default _default;

package/dist/exp.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logs = exports.add = void 0;
+const index_1 = require("./index");
+const request_1 = require("./request");
+/**
+ * EXP — хэрэглэгчид exp нэмэх.
+ *
+ * Admin panel → "EXP түлхүүр" дээр нэр (ж: Seller Panda) + нэг дуудлагад олгох exp-тэй
+ * түлхүүр үүсгэнэ. Энэ түлхүүр client_id/secret-ээс тусдаа: setExpKey("exp_…")-ээр
+ * тохируулна (эсвэл дуудлага бүрт key өгнө).
+ *
+ *   import authMn, { setExpKey } from "auth-mn";
+ *   setExpKey(process.env.AUTH_MN_EXP_KEY);
+ *   await authMn.exp.add({ user_id: 8636569, desc: "Худалдан авалт #1234", ref: "order-1234" });
+ *   // эсвэл frontend-ээс ирсэн хэрэглэгчийн token-оор:
+ *   await authMn.exp.add({ token: userToken, desc: "Худалдан авалт" });
+ *
+ * Хэдэн exp нэмэгдэх нь түлхүүр дээр admin-ийн тохируулсан хэмжээ — дуудагч тал өөрчилж чадахгүй.
+ * `ref` өгвөл ижил ref-ээр дахин дуудахад давхар нэмэхгүй (data.duplicate = true).
+ */
+const keyOf = (key) => {
+    const k = (key || index_1.config.expKey || "").trim();
+    if (!k)
+        throw new Error("[auth-mn] EXP түлхүүр тохируулаагүй байна: setExpKey(\"exp_…\")");
+    return k;
+};
+const add = (input, key) => {
+    let k;
+    try {
+        k = keyOf(key);
+    }
+    catch (e) {
+        return Promise.resolve({ success: false, message: e.message, data: null, status: 0 });
+    }
+    return (0, request_1.rawRequest)({ method: "POST", path: "/main/v1/auth/exp/add", name: "exp add", data: input, auth: false }, k);
+};
+exports.add = add;
+/** Тухайн түлхүүрээр нэмсэн exp-ийн лог (user_id-ээр шүүж болно) */
+const logs = (filter = {}, key) => {
+    let k;
+    try {
+        k = keyOf(key);
+    }
+    catch (e) {
+        return Promise.resolve({ success: false, message: e.message, data: null, status: 0 });
+    }
+    return (0, request_1.rawRequest)({ method: "GET", path: "/main/v1/auth/exp/logs", name: "exp logs", params: filter, auth: false }, k);
+};
+exports.logs = logs;
+exports.default = { add: exports.add, logs: exports.logs };

package/dist/index.d.ts

@@ -10,15 +10,18 @@
  * Client-д олгосон permission-ээс гадуур API дуудвал 403 + message буцна.
  *
  * Хамрах хүрээ: хэрэглэгч (verify / find), мэдэгдэл (push / sms / mail),
- * socket (toast / status / orderStatus / emit). Merchant/admin зэрэг дотоод
- * бүртгэлүүд энэ санд байхгүй.
+ * socket (toast / status / orderStatus / emit), exp (хэрэглэгчид exp нэмэх —
+ * тусдаа EXP түлхүүр, setExpKey). Merchant/admin зэрэг дотоод бүртгэлүүд энэ санд байхгүй.
  */
 import auth from "./auth";
 import user from "./user";
 import notification from "./notification";
 import socket from "./socket";
+import exp from "./exp";
 export type Env = "prod" | "staging";
 export type Config = {
+    /** Одоогийн client access token (сан автоматаар шинэчилнэ; гараар Authorization header үүсгэхэд ашиглаж болно) */
+    token: string;
     env: Env;
     hosts: {
         MAIN: string;
@@ -28,6 +31,8 @@ export type Config = {
         client_id: string;
         client_secret: string;
     };
+    /** EXP түлхүүр (exp_…) — Admin panel → EXP түлхүүр. authMn.exp.* дуудлагад ашиглана */
+    expKey: string;
     logger: boolean;
     /** Хүсэлтийн timeout (ms), default 20000 */
     timeout: number;
@@ -43,15 +48,18 @@ export declare const setAuth: (auth: {
     client_id: string;
     client_secret: string;
 }) => void;
+/** EXP түлхүүр (Admin panel → EXP түлхүүр дээрээс авна). authMn.exp.add-д ашиглана */
+export declare const setExpKey: (key: string | undefined | null) => void;
 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, authState };
+export { auth, user, notification, socket, exp, authState };
 export * from "./types";
 declare const _default: {
     auth: {
         getToken: () => Promise<string>;
+        token: () => string;
         login: () => Promise<import("./types").Result<import("./types").TokenData>>;
         refresh: () => Promise<import("./types").Result<import("./types").TokenData>>;
         revoke: () => Promise<import("./types").Result<null>>;
@@ -71,6 +79,8 @@ declare const _default: {
             phone_number?: string;
             email?: string;
         }) => Promise<import("./types").Result<import("./types").UserT>>;
+        list: typeof import("./user").list;
+        listAll: typeof import("./user").listAll;
         middleware: (opts?: import("./user").MiddlewareOptions) => (req: {
             [k: string]: any;
             headers: Record<string, any>;
@@ -100,6 +110,19 @@ declare const _default: {
         ShowOrderStatus: (body: import("./types").OrderStatusT) => Promise<import("./types").Result<null>>;
         EMIT: (body: import("./types").EmitT[]) => Promise<import("./types").Result<null>>;
     };
+    exp: {
+        add: (input: {
+            user_id?: number | string;
+            token?: string;
+            desc: string;
+            ref?: string;
+        }, key?: string) => Promise<import("./types").Result<import("./types").ExpAddResult>>;
+        logs: (filter?: {
+            user_id?: number | string;
+            page?: number;
+            limit?: number;
+        }, key?: string) => Promise<import("./types").Result<import("./types").PageResult<import("./types").ExpLog>>>;
+    };
     setAuth: (auth: {
         client_id: string;
         client_secret: string;
@@ -108,6 +131,7 @@ declare const _default: {
         MAIN: string;
         WALLET?: string;
     }, env?: Env) => void;
+    setExpKey: (key: string | undefined | null) => void;
     setLogger: (status: boolean) => void;
     ObjectId: () => 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.socket = exports.notification = exports.user = exports.auth = exports.ObjectId = exports.jsonToQueryString = exports.setLogger = exports.setAuth = exports.setHost = exports.config = void 0;
+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;
 /**
  * auth-mn — Auth.mn API client (Node.js)
  *
@@ -27,8 +27,8 @@ exports.authState = exports.socket = exports.notification = exports.user = expor
  * Client-д олгосон permission-ээс гадуур API дуудвал 403 + message буцна.
  *
  * Хамрах хүрээ: хэрэглэгч (verify / find), мэдэгдэл (push / sms / mail),
- * socket (toast / status / orderStatus / emit). Merchant/admin зэрэг дотоод
- * бүртгэлүүд энэ санд байхгүй.
+ * socket (toast / status / orderStatus / emit), exp (хэрэглэгчид exp нэмэх —
+ * тусдаа EXP түлхүүр, setExpKey). Merchant/admin зэрэг дотоод бүртгэлүүд энэ санд байхгүй.
  */
 const auth_1 = require("./auth");
 exports.auth = auth_1.default;
@@ -38,14 +38,18 @@ const notification_1 = require("./notification");
 exports.notification = notification_1.default;
 const socket_1 = require("./socket");
 exports.socket = socket_1.default;
+const exp_1 = require("./exp");
+exports.exp = exp_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" }
 };
 exports.config = {
+    token: "",
     env: "prod",
     hosts: { ...HOSTS.prod },
     auth: { client_id: "", client_secret: "" },
+    expKey: "",
     logger: false,
     timeout: 20000
 };
@@ -73,6 +77,11 @@ const setAuth = (auth) => {
     auth_2.authState.clear();
 };
 exports.setAuth = setAuth;
+/** EXP түлхүүр (Admin panel → EXP түлхүүр дээрээс авна). authMn.exp.add-д ашиглана */
+const setExpKey = (key) => {
+    exports.config.expKey = (key || "").trim();
+};
+exports.setExpKey = setExpKey;
 const setLogger = (status) => {
     exports.config.logger = status;
 };
@@ -94,4 +103,15 @@ exports.ObjectId = ObjectId;
 const auth_2 = require("./auth");
 Object.defineProperty(exports, "authState", { enumerable: true, get: function () { return auth_2.authState; } });
 __exportStar(require("./types"), exports);
-exports.default = { auth: auth_1.default, user: user_1.default, notification: notification_1.default, socket: socket_1.default, setAuth: exports.setAuth, setHost: exports.setHost, setLogger: exports.setLogger, ObjectId: exports.ObjectId };
+exports.default = {
+    auth: auth_1.default,
+    user: user_1.default,
+    notification: notification_1.default,
+    socket: socket_1.default,
+    exp: exp_1.default,
+    setAuth: exports.setAuth,
+    setHost: exports.setHost,
+    setExpKey: exports.setExpKey,
+    setLogger: exports.setLogger,
+    ObjectId: exports.ObjectId
+};

package/dist/types.d.ts

@@ -132,6 +132,50 @@ export type UserT = {
     dynamic_info?: Record<string, any>;
     apps?: UserAppItem[];
 };
+export type UserListFilter = {
+    /** user_id жагсаалт (max 1000) */
+    user_ids?: (number | string)[];
+    /** Таны апп-д бүртгүүлсэн хэрэглэгчид (apps.app_name) */
+    app_name?: string;
+    phone_number?: string;
+    email?: string;
+    /** нэр (хэсэгчилсэн) */
+    name?: string;
+    /** нэр / nick / имэйл / утас дээр ерөнхий хайлт */
+    q?: string;
+    gender?: Gender;
+    /** энэ хугацаанаас хойш нэвтэрсэн (ISO) */
+    last_login_after?: string | Date;
+    page?: number;
+    /** max 500, default 100 */
+    limit?: number;
+    /** lite: зөвхөн user_id, нэр, утас, имэйл, зураг, last_login (хурдан) */
+    fields?: "full" | "lite";
+};
+export type UserLite = Pick<UserT, "user_id" | "user_name" | "nick_name" | "primary_phone" | "primary_email" | "profile_image_url" | "last_login">;
+export type PageResult<T> = {
+    list: T[];
+    total: number;
+    page: number;
+    limit: number;
+};
+export type ExpLog = {
+    _id: string;
+    user_id: number;
+    key_id: string;
+    key_name: string;
+    /** Нэмсэн exp */
+    exp: number;
+    /** Нэмсний дараах хэрэглэгчийн нийт exp */
+    exp_total: number;
+    desc: string;
+    ref?: string;
+    createdAt?: string;
+};
+export type ExpAddResult = ExpLog & {
+    /** true бол ижил ref-ээр өмнө нь нэмэгдсэн — давхар нэмээгүй */
+    duplicate: boolean;
+};
 export type PushNotiT = {
     user_id: number;
     target_app: string;

package/dist/user.d.ts

@@ -1,4 +1,4 @@
-import { Result, UserT, VerifiedUser } from "./types";
+import { PageResult, Result, UserListFilter, UserLite, UserT, VerifiedUser } from "./types";
 /**
  * Хэрэглэгчийн token-ийг Auth.mn сервер дээр баталгаажуулж, хэрэглэгчийн
  * мэдээллийг авна. Frontend (auth-mn-react redirect / QR / OTP) -ээс ирсэн
@@ -18,6 +18,23 @@ export declare const find: (query: {
     phone_number?: string;
     email?: string;
 }) => Promise<Result<UserT>>;
+/**
+ * Олон хэрэглэгч — хуудаслалттай. Permission: user.read
+ *   await authMn.user.list({ app_name: "CHARGEX", fields: "lite", limit: 500 });
+ *   → { list, total, page, limit }
+ */
+export declare function list(filter: UserListFilter & {
+    fields: "lite";
+}): Promise<Result<PageResult<UserLite>>>;
+export declare function list(filter?: UserListFilter): Promise<Result<PageResult<UserT>>>;
+/**
+ * Бүх хуудсыг татаж нэг массив болгоно (campaign, тайлан г.м.). max нь хамгаалалт (default 50000).
+ *   const users = await authMn.user.listAll({ app_name: "CHARGEX", fields: "lite" });
+ */
+export declare function listAll(filter: UserListFilter & {
+    fields: "lite";
+}, max?: number): Promise<Result<UserLite[]>>;
+export declare function listAll(filter?: UserListFilter, max?: number): Promise<Result<UserT[]>>;
 type AnyReq = {
     headers: Record<string, any>;
     query?: any;
@@ -54,6 +71,8 @@ declare const _default: {
         phone_number?: string;
         email?: string;
     }) => Promise<Result<UserT>>;
+    list: typeof list;
+    listAll: typeof listAll;
     middleware: (opts?: MiddlewareOptions) => (req: AnyReq, res: AnyRes, next: Next) => Promise<any>;
 };
 export default _default;

package/dist/user.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.middleware = exports.find = exports.verify = void 0;
+exports.list = list;
+exports.listAll = listAll;
 const request_1 = require("./request");
 /**
  * Хэрэглэгчийн token-ийг Auth.mn сервер дээр баталгаажуулж, хэрэглэгчийн
@@ -24,6 +26,29 @@ exports.verify = verify;
  */
 const find = (query) => (0, request_1.request)({ method: "POST", path: "/main/v1/auth/client/user/find", name: "user find", data: query });
 exports.find = find;
+function list(filter = {}) {
+    return (0, request_1.request)({
+        method: "POST",
+        path: "/main/v1/auth/client/user/list",
+        name: "user list",
+        data: filter
+    });
+}
+async function listAll(filter = {}, max = 50000) {
+    const limit = Math.min(500, filter.limit || 500);
+    const all = [];
+    let page = 1;
+    for (;;) {
+        const r = await list({ ...filter, page, limit });
+        if (!r.success || !r.data)
+            return { success: false, message: r.message, data: null, status: r.status };
+        all.push(...r.data.list);
+        if (all.length >= r.data.total || r.data.list.length < limit || all.length >= max)
+            break;
+        page++;
+    }
+    return { success: true, message: "Амжилттай", data: all, status: 200 };
+}
 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) || "");
@@ -65,4 +90,4 @@ const middleware = (opts = {}) => async (req, res, next) => {
     return next();
 };
 exports.middleware = middleware;
-exports.default = { verify: exports.verify, find: exports.find, middleware: exports.middleware };
+exports.default = { verify: exports.verify, find: exports.find, list, listAll, middleware: exports.middleware };

package/package.json

@@ -1,47 +1,47 @@
-{
-  "name": "auth-mn",
-  "version": "1.0.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",
-  "files": [
-    "dist/"
-  ],
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "build-ts": "rm -rf ./dist && npx tsc",
-    "build": "npx tsc",
-    "debug": "npm run build && npm run watch-debug",
-    "lint": "tsc --noEmit && eslint \"**/*.{js,ts}\" --quiet --fix",
-    "typecheck": "tsc --noEmit"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/togtokh-dev/auth-mn.git"
-  },
-  "keywords": [
-    "auth.mn",
-    "axios",
-    "togtokh.dev"
-  ],
-  "author": "TOGTOKH.DEV",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/togtokh-dev/auth-mn/issues"
-  },
-  "homepage": "https://github.com/togtokh-dev/auth-mn/#readme",
-  "dependencies": {
-    "axios": "^1.6.2"
-  },
-  "devDependencies": {
-    "@types/node": "^18.15.11",
-    "@typescript-eslint/eslint-plugin": "^6.4.0",
-    "@typescript-eslint/parser": "^6.4.0",
-    "eslint": "^8.47.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.0.4"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "auth-mn",
+  "version": "1.1.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",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build-ts": "rm -rf ./dist && npx tsc",
+    "build": "npx tsc",
+    "debug": "npm run build && npm run watch-debug",
+    "lint": "tsc --noEmit && eslint \"**/*.{js,ts}\" --quiet --fix",
+    "typecheck": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/togtokh-dev/auth-mn.git"
+  },
+  "keywords": [
+    "auth.mn",
+    "axios",
+    "togtokh.dev"
+  ],
+  "author": "TOGTOKH.DEV",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/togtokh-dev/auth-mn/issues"
+  },
+  "homepage": "https://github.com/togtokh-dev/auth-mn/#readme",
+  "dependencies": {
+    "axios": "^1.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^18.15.11",
+    "@typescript-eslint/eslint-plugin": "^6.4.0",
+    "@typescript-eslint/parser": "^6.4.0",
+    "eslint": "^8.47.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}