mgacn-commonsdk 1.0.4 → 1.1.0

package/README.md

@@ -28,16 +28,104 @@ npm install mgacn-commonsdk
 ## 使用
 
 ```js
-import MgacnCommonSdk from 'mgacn-commonsdk';
+// 顺序不能乱：先 EP 默认，再品牌主题（主题不要被 JS 副作用提前加载）
+import 'element-plus/dist/index.css';
 import 'mgacn-commonsdk/style.css';
+import MgacnCommonSdk from 'mgacn-commonsdk';
 
 app.use(MgacnCommonSdk, {
   tokenKey: 'your_token_key',
   baseURL: import.meta.env.VITE_API_BASE_URL,
-  systemIdKey: 'mgacn_systemid', // 可选，有的系统需要
+  systemId: '', // 可选；子应用也可接口拿到后 setSystemId
+});
+```
+
+`style.css` 已包含门户与子系统共用的主题样式（**必须**放在 `element-plus` 样式之后；SDK 的 JS 入口不再副作用引入主题，避免被 Vite CSS 去重后排到 EP 前面）：
+
+- `element-variables.scss` — 品牌色与 EP 变量
+- `common.scss` — 通用工具类
+- `reset-element.scss` — Element Plus 样式重置
+
+子应用从接口获取 `systemId` 后（接口待定）：
+
+```js
+import { setSystemId } from 'mgacn-commonsdk';
+
+setSystemId(systemId); // 之后请求头会带 systemId
+```
+
+### 按钮权限
+
+`app.use` 时传入权限列表读取函数（通常来自菜单 store 的 `permissions`），SDK 会注册指令并提供 `hasPermission`：
+
+```js
+import { useMenuStore } from '@/store/menuStore';
+
+app.use(MgacnCommonSdk, {
+  tokenKey: 'mgacn_token',
+  getPermissions: () => useMenuStore().permissions,
+});
+```
+
+也可事后设置：
+
+```js
+import { setPermissionGetter, hasPermission, checkPermission } from 'mgacn-commonsdk';
+
+setPermissionGetter(() => useMenuStore().permissions);
+
+hasPermission('menu:add');
+hasPermission(['menu:add', 'menu:edit']); // 且
+hasPermission(['menu:add', 'menu:edit'], 'or'); // 或
+checkPermission(['menu:add'], 'menu:add'); // 纯函数，不依赖 getter
+```
+
+模板指令（`install` 时自动注册）：
+
+```vue
+<el-button v-hasPermission="'menu:add'">新增</el-button>
+<el-button v-hasAnyPermission="'menu:add,menu:edit'">编辑类</el-button>
+<span v-hasNoPermission="'menu:add'">无新增权限时可见</span>
+```
+
+未传入 `getPermissions` / `setPermissionGetter` 时，`hasPermission` 不拦截（恒为 `true`）。
+
+### 子系统壳层（`mgacn-commonsdk/admin`）
+
+门户**不要**引入；仅各业务子系统使用。仍是**同一个 npm 包**，通过子路径导出，无需发第二个包。
+
+包含：顶栏、侧栏、布局、user/system/menu store、动态路由、菜单管理、角色管理。
+
+```js
+import { bootstrapAdminApp } from 'mgacn-commonsdk/admin';
+import 'element-plus/dist/index.css';
+import 'mgacn-commonsdk/style.css';
+import App from './App.vue';
+import Homepage from './views/homepage/index.vue';
+
+bootstrapAdminApp({
+  App,
+  homepageComponent: Homepage,
+  deployKey: 'account_cms', // 部署目录名，匹配当前系统
+  appTitle: '芒果ACN账号库',
+  portalUrl: import.meta.env.VITE_PORTAL_URL, // 如 /portal_cms#
+  ossDomain: import.meta.env.VITE_OSS_URL,
+  viewModules: import.meta.glob('./views/**/*.vue'),
+  isDev: import.meta.env.DEV,
+  setupIcons: (app) => { /* 注册图标 */ },
 });
 ```
 
+菜单 `pathComponent` 为 `system/menu`、`system/role` 时走壳内页面；其它业务页由宿主 `viewModules` 解析。
+
+本地 monorepo 可在 Vite 中 alias：
+
+```js
+'mgacn-commonsdk/admin' → '../mgacn-commonsdk/src/admin/index.js'
+```
+
+peer 依赖需宿主已安装：`vue`、`vue-router`、`pinia`、`element-plus`、`@element-plus/icons-vue`。
+
 ### 网络请求（宿主使用 .GET / .POST）
 
 先 `app.use` 后，页面里这样调：
@@ -241,7 +329,7 @@ import { createRequest, createApi } from 'mgacn-commonsdk';
 const request = createRequest({
   tokenKey: 'your_token_key',
   baseURL: '/api',
-  systemIdKey: 'mgacn_systemid', // 可选
+  systemId: '', // 可选；也可事后 setSystemId
 });
 const api = createApi(request);
 ```

package/dist/index-Y2_0CiYi.js

@@ -0,0 +1,289 @@
+import T from "axios";
+function I(t) {
+  if (!t)
+    throw new Error("[mgacn-commonsdk] createApi 需要传入 request 实例");
+  return {
+    // ---------- 注销登录 ----------
+    logout(n) {
+      return t.GET(`/yhAdmin/login/exit/${n}`);
+    },
+    // ---------- 用户 ----------
+    getUserInfo(n) {
+      return t.GET(`/yhAdmin/user/queryUser/${n}`);
+    },
+    // ---------- OSS ----------
+    getOssSts(n) {
+      return t.GET("/yhAdmin/oss/getStsToken", { params: { dir: n } });
+    }
+  };
+}
+const y = "__MGACN_COMMONSDK_API__";
+function G(t) {
+  globalThis[y] = t;
+}
+function K() {
+  const t = globalThis[y];
+  if (!t)
+    throw new Error("[mgacn-commonsdk] 请先 app.use(MgacnCommonSdk, { tokenKey, baseURL })");
+  return t;
+}
+const b = "__MGACN_COMMONSDK_SYSTEM_ID__";
+function E(t) {
+  globalThis[b] = t == null ? "" : String(t);
+}
+function M() {
+  return globalThis[b] || "";
+}
+function Y(t = {}) {
+  const {
+    baseURL: n = "",
+    timeout: e = 6e4,
+    tokenKey: r,
+    systemId: s,
+    loginUrl: o = "/login"
+  } = t;
+  s != null && s !== "" && E(s);
+  const c = T.create({ baseURL: n, timeout: e });
+  let a = !1;
+  function f() {
+    typeof localStorage < "u" && localStorage.clear(), !a && (a = !0, setTimeout(() => {
+      typeof window < "u" && window.location.replace(o);
+    }, 1500));
+  }
+  return c.interceptors.request.use(
+    (i) => {
+      if (i.headers["Content-Type"] = "application/json;charset=UTF-8", typeof localStorage < "u" && r) {
+        const m = localStorage.getItem(r);
+        m && (i.headers.Authorization = m);
+      }
+      const u = M();
+      return u && (i.headers.systemId = u), i;
+    },
+    (i) => Promise.reject(i)
+  ), c.interceptors.response.use(
+    (i) => {
+      if (i.status !== 200)
+        return Promise.reject(new Error(`请求发生错误，状态码 ${i.status}`));
+      const { data: u, config: m } = i;
+      if (m.responseType === "arraybuffer") return u;
+      if (u && u.code === 0) return u.data;
+      const l = Number(u == null ? void 0 : u.code);
+      if (l === 401 || l === 403)
+        return f(), Promise.reject(new Error("登录失效，请重新登录"));
+      const g = S(u) || "请求失败";
+      return Promise.reject(new Error(g));
+    },
+    (i) => {
+      var g, h;
+      const u = (g = i == null ? void 0 : i.response) == null ? void 0 : g.status;
+      if (u === 401 || u === 403)
+        return f(), Promise.reject(new Error("登录失效，请重新登录"));
+      const m = (h = i == null ? void 0 : i.response) == null ? void 0 : h.data, l = S(m) || (i == null ? void 0 : i.message) || "请求失败";
+      return Promise.reject(new Error(String(l)));
+    }
+  ), c;
+}
+function S(t) {
+  if (t == null) return "";
+  if (typeof t == "string") {
+    const e = t.trim();
+    return e ? /^<!DOCTYPE html>/i.test(e) || /^<html[\s>]/i.test(e) ? "接口地址无效或未配置代理" : e.length > 200 ? `${e.slice(0, 200)}…` : e : "";
+  }
+  if (typeof t != "object") return String(t);
+  const n = [t.message, t.msg, t.data, t.error];
+  for (const e of n)
+    if (!(e == null || e === "") && (typeof e == "string" || typeof e == "number")) {
+      const r = String(e).trim();
+      return /^<!DOCTYPE html>/i.test(r) || /^<html[\s>]/i.test(r) ? "接口地址无效或未配置代理" : r.length > 200 ? `${r.slice(0, 200)}…` : r;
+    }
+  return "";
+}
+function x(t = {}) {
+  const n = Y(t);
+  return {
+    GET(e, r = {}) {
+      return n({ method: "get", url: e, ...r });
+    },
+    POST(e, r, s = {}) {
+      return n({ method: "post", url: e, data: r, ...s });
+    },
+    DELETE(e, r = {}) {
+      return n({ method: "delete", url: e, ...r });
+    }
+  };
+}
+const N = "__MGACN_COMMONSDK_REQUEST__";
+function U(t) {
+  globalThis[N] = t;
+}
+function q() {
+  const t = globalThis[N];
+  if (!t)
+    throw new Error("[mgacn-commonsdk] 请先 app.use(MgacnCommonSdk, { tokenKey, baseURL })");
+  return t;
+}
+const _ = "__MGACN_COMMONSDK_PERMISSION_GETTER__";
+function L(t) {
+  globalThis[_] = typeof t == "function" ? t : null;
+}
+function w() {
+  return globalThis[_] || null;
+}
+function A(t, n, e = "and") {
+  const r = (Array.isArray(n) ? n : [n]).map((o) => String(o ?? "").trim()).filter(Boolean);
+  if (!r.length) return !0;
+  const s = new Set((t || []).map(String));
+  return e === "or" ? r.some((o) => s.has(o)) : r.every((o) => s.has(o));
+}
+function z(t, n = "and") {
+  const e = w();
+  return typeof e != "function" ? !0 : A(e(), t, n);
+}
+const F = (t, n) => {
+  const e = t.__vccOpts || t;
+  for (const [r, s] of n)
+    e[r] = s;
+  return e;
+};
+function O(t) {
+  return !!(t == null || typeof t == "string" && t.trim() === "" || Array.isArray(t) && t.length === 0 || typeof t == "object" && !Array.isArray(t) && Object.keys(t).length === 0);
+}
+function d(t) {
+  if (t === null || typeof t != "object") return t;
+  if (t instanceof Date) return new Date(t.getTime());
+  if (Array.isArray(t)) return t.map((e) => d(e));
+  const n = {};
+  return Object.keys(t).forEach((e) => {
+    n[e] = d(t[e]);
+  }), n;
+}
+function P(t, n = 300) {
+  let e = null;
+  return function(...s) {
+    e && clearTimeout(e), e = setTimeout(() => {
+      t.apply(this, s);
+    }, n);
+  };
+}
+function j(t, n = 300) {
+  let e = 0;
+  return function(...s) {
+    const o = Date.now();
+    o - e >= n && (e = o, t.apply(this, s));
+  };
+}
+function D(t) {
+  if (t == null || t === "") return null;
+  if (t instanceof Date)
+    return Number.isNaN(t.getTime()) ? null : t;
+  if (typeof t == "number") {
+    const s = new Date(t);
+    return Number.isNaN(s.getTime()) ? null : s;
+  }
+  const n = String(t).trim();
+  if (!n) return null;
+  if (/^\d{10,13}$/.test(n)) {
+    const s = n.length === 10 ? Number(n) * 1e3 : Number(n), o = new Date(s);
+    return Number.isNaN(o.getTime()) ? null : o;
+  }
+  if (/[Zz]$|[+-]\d{2}:?\d{2}$/.test(n)) {
+    const s = new Date(n);
+    return Number.isNaN(s.getTime()) ? null : s;
+  }
+  const e = n.match(
+    /^(\d{4})[-/.年](\d{1,2})[-/.月](\d{1,2})日?(?:[\sT]+(\d{1,2}):(\d{1,2})(?::(\d{1,2}))?(?:\.(\d{1,3}))?)?/
+  );
+  if (e) {
+    const [, s, o, c, a = "0", f = "0", i = "0", u = "0"] = e, m = new Date(
+      Number(s),
+      Number(o) - 1,
+      Number(c),
+      Number(a),
+      Number(f),
+      Number(i),
+      Number(String(u).padEnd(3, "0"))
+    );
+    return Number.isNaN(m.getTime()) ? null : m;
+  }
+  const r = new Date(n);
+  return Number.isNaN(r.getTime()) ? null : r;
+}
+function p(t, n = "YYYY-MM-DD HH:mm:ss") {
+  const e = D(t);
+  if (!e) return "";
+  const r = e.getFullYear(), s = e.getMonth() + 1, o = e.getDate(), c = e.getHours(), a = e.getMinutes(), f = e.getSeconds(), i = {
+    YYYY: String(r),
+    MM: String(s).padStart(2, "0"),
+    DD: String(o).padStart(2, "0"),
+    HH: String(c).padStart(2, "0"),
+    mm: String(a).padStart(2, "0"),
+    ss: String(f).padStart(2, "0"),
+    M: String(s),
+    D: String(o),
+    H: String(c),
+    m: String(a),
+    s: String(f)
+  };
+  return n.replace(/YYYY|MM|DD|HH|mm|ss|M|D|H|m|s/g, (u) => i[u]);
+}
+function C() {
+  const t = /* @__PURE__ */ new Date();
+  t.setHours(23, 59, 59, 0);
+  const n = /* @__PURE__ */ new Date();
+  return n.setDate(n.getDate() - 30), n.setHours(0, 0, 0, 0), {
+    start: p(n, "YYYY-MM-DD HH:mm:ss"),
+    end: p(t, "YYYY-MM-DD HH:mm:ss")
+  };
+}
+function k(t) {
+  const n = {};
+  return Object.keys(t || {}).forEach((e) => {
+    const r = t[e];
+    r == null || r === "" || Array.isArray(r) && r.length === 0 || (n[e] = r);
+  }), n;
+}
+function H(t, n = 2) {
+  if (t == null || t === "") return t;
+  const e = Number(t);
+  if (Number.isNaN(e)) return t;
+  const r = e.toFixed(n), [s, o] = r.split("."), c = s.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+  if (o == null) return c;
+  const a = o.replace(/0+$/, "");
+  return a ? `${c}.${a}` : c;
+}
+function R(t = "id") {
+  return `${t}_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+const B = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  cleanParams: k,
+  debounce: P,
+  deepClone: d,
+  formatDate: p,
+  formatNum: H,
+  getRecentMonthRange: C,
+  isEmpty: O,
+  parseDate: D,
+  throttle: j,
+  uniqueId: R
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  F as _,
+  q as a,
+  k as b,
+  A as c,
+  d,
+  P as e,
+  L as f,
+  K as g,
+  z as h,
+  x as i,
+  I as j,
+  U as k,
+  G as l,
+  Y as m,
+  w as n,
+  M as o,
+  B as p,
+  E as s
+};