auth-mn 1.0.0 → 1.0.1

package/README.md

@@ -1,187 +1,206 @@
-# 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. 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/index.d.ts

@@ -19,6 +19,8 @@ import notification from "./notification";
 import socket from "./socket";
 export type Env = "prod" | "staging";
 export type Config = {
+    /** Одоогийн client access token (сан автоматаар шинэчилнэ; гараар Authorization header үүсгэхэд ашиглаж болно) */
+    token: string;
     env: Env;
     hosts: {
         MAIN: string;
@@ -52,6 +54,7 @@ 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 +74,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>;

package/dist/index.js

@@ -43,6 +43,7 @@ const HOSTS = {
     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: "" },

package/dist/types.d.ts

@@ -132,6 +132,33 @@ 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 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,6 +1,6 @@
 {
   "name": "auth-mn",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Auth.mn API client for Node.js — client_id/secret token, user, notification, socket",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",