@done-coding/admin-core 0.7.1-alpha.0 → 0.8.1-alpha.0

package/README.md

@@ -14,7 +14,7 @@ npm install @done-coding/admin-core
 
 ### 自定义分页字段（pnpm patch 逃生通道）
 
-`@done-coding/admin-core` 的列表分页 KEY 配置（`APP_API_LIST_MODEL_KEY_CONFIG`）在 core 包内**固化为公司级约定**：
+`@done-coding/admin-core` 的列表分页 KEY 配置（`APP_API_LIST_MODEL_KEY_CONFIG`）在 core 包内**固化为标准级约定**：
 
 ```ts
 {

package/es/bridge/index.mjs

@@ -1,27 +1,26 @@
-import { createStorageWithNamespace as U } from "./storage.mjs";
-import { createUseState as a } from "./state.mjs";
-import { createGenerateRouteMetaRawTree as G } from "./route.mjs";
-function L(e) {
+import { createStorageWithNamespace as a } from "./storage.mjs";
+import { createUseState as c } from "./state.mjs";
+import { createGenerateRouteMetaRawTree as o } from "./route.mjs";
+function l(e) {
   const F = e.APP_CACHE_CONFIG.namespace;
   let _;
   F === "" ? (console.error(
     "[adminBridge] APP_CACHE_CONFIG.namespace 为空，已兜底为 'ADMIN_CORE'"
   ), _ = "ADMIN_CORE") : _ = F, Object.freeze(e);
-  let g = U(_), C = e.routes, N = e.getUserInfoInitFn;
-  const i = a(_), u = G(
+  const g = a(_), C = e.routes, u = e.getUserInfoInitFn, N = e.userInfoAccess, i = c(_), R = o(
     e.APP_ROUTER_META_DEFAULT_CONFIG
-  ), R = Object.freeze({
+  ), U = Object.freeze({
     header: e.APP_LAYOUT_HEADER_CONFIG,
     footer: e.APP_LAYOUT_FOOTER_CONFIG,
     sidebar: e.APP_LAYOUT_SIDEBAR_CONFIG,
     breadcrumb: e.APP_LAYOUT_BREADCRUMB_CONFIG,
     body: e.APP_LAYOUT_BODY_CONFIG
   });
-  let t, P, O, n, T, I, f, E;
+  let t, P, n, O, T, I, f, E;
   const A = (r) => `admin bridge: ${r} 未注册`;
   return {
     register(r) {
-      r.getToken && (t = r.getToken), r.goToLogin && (P = r.goToLogin), r.refreshToken && (O = r.refreshToken), r.refreshAuth && (n = r.refreshAuth), r.loginApi && (T = r.loginApi), r.logoutApi && (I = r.logoutApi), r.getUserInfoApi && (f = r.getUserInfoApi), r.refreshTokenApi && (E = r.refreshTokenApi);
+      r.getToken && (t = r.getToken), r.goToLogin && (P = r.goToLogin), r.refreshToken && (n = r.refreshToken), r.refreshAuth && (O = r.refreshAuth), r.loginApi && (T = r.loginApi), r.logoutApi && (I = r.logoutApi), r.getUserInfoApi && (f = r.getUserInfoApi), r.refreshTokenApi && (E = r.refreshTokenApi);
     },
     // 已注册返回 undefined 是合法业务态不 throw
     // v3 终锁 Δ8b：零参 facade（BR-1 ③ 终裁——core 对 UserInfo 不透明 + 拦截器无 info 源）
@@ -35,11 +34,11 @@ function L(e) {
     },
     // 异步对：未注册才返回 rejected Promise（既有降级语义保留）。
     refreshToken() {
-      return O ? O().then(() => {
+      return n ? n().then(() => {
       }) : Promise.reject(new Error(A("refreshToken")));
     },
     refreshAuth() {
-      return n ? n().then(() => {
+      return O ? O().then(() => {
       }) : Promise.reject(new Error(A("refreshAuth")));
     },
     getStorage() {
@@ -49,10 +48,10 @@ function L(e) {
       return C;
     },
     getUserInfoInitFn() {
-      return N;
+      return u;
     },
     useState: i,
-    generateRouteMetaRawTree: u,
+    generateRouteMetaRawTree: R,
     // ============ #2.5 期 12 readonly 属性值挂载（per ADR-1 sibling pattern 复用 useState / generateRouteMetaRawTree） ============
     /** 应用基础信息（per #2.5 期 REQ-1 直接挂载形态） */
     APP_BASE_INFO: e.APP_BASE_INFO,
@@ -71,7 +70,7 @@ function L(e) {
     /** 应用布局-页面主体配置（per #2.5 期 REQ-1） */
     APP_LAYOUT_BODY_CONFIG: e.APP_LAYOUT_BODY_CONFIG,
     /** 应用布局聚合配置（per #2.5 期 ADR-3 bridge 内部聚合派生） */
-    APP_LAYOUT_CONFIG: R,
+    APP_LAYOUT_CONFIG: U,
     /** 应用路由元信息默认配置（per #2.5 期 REQ-1） */
     APP_ROUTER_META_DEFAULT_CONFIG: e.APP_ROUTER_META_DEFAULT_CONFIG,
     /** 应用路由配置（per #2.5 期 REQ-1） */
@@ -80,6 +79,8 @@ function L(e) {
     APP_ROUTER_PATHS_CONFIG: e.APP_ROUTER_PATHS_CONFIG,
     /** 应用主题配置（per #2.5 期 REQ-1） */
     APP_THEME_CONFIG: e.APP_THEME_CONFIG,
+    /** 用户信息字段访问器集（第一宪法：业务注入 get/set 读写 token/refreshToken/permission） */
+    userInfoAccess: N,
     // 异步对：未注册返回 rejected 原生 Error（#4a-2 per-method 降级）
     loginApi(r) {
       return T ? T(r) : Promise.reject(new Error(A("loginApi")));
@@ -96,8 +97,8 @@ function L(e) {
   };
 }
 export {
-  L as createAdminBridge,
-  G as createGenerateRouteMetaRawTree,
-  U as createStorageWithNamespace,
-  a as createUseState
+  l as createAdminBridge,
+  o as createGenerateRouteMetaRawTree,
+  a as createStorageWithNamespace,
+  c as createUseState
 };

package/es/store/user.mjs

@@ -1,91 +1,92 @@
-import { defineStore as U } from "pinia";
-import { computed as n, watch as f } from "vue";
-import p from "lodash/get";
-import _ from "lodash/set";
-import L from "lodash/cloneDeep";
-import { flatRouteMetaResolveRaw as E } from "../utils/router.mjs";
-function D(d) {
-  const { bridge: o } = d;
-  return U("USER", () => {
-    const k = o.getUserInfoInitFn(), c = (e, t, m) => {
-      const g = L(e);
-      return _(g, t, m), g;
-    }, S = (e) => p(e, "permission"), r = o.useState(
-      k(),
+import { defineStore as y } from "pinia";
+import { computed as o, watch as l } from "vue";
+import { flatRouteMetaResolveRaw as P } from "../utils/router.mjs";
+function L(g) {
+  const { bridge: t } = g;
+  return y("USER", () => {
+    const h = t.getUserInfoInitFn(), n = t.useState(
+      h(),
       {
         moduleKey: "USER_STORE",
         debug: !1,
         cache: !0
       }
-    ), s = n(() => r.state), a = n(
-      () => p(s.value, "token")
-    ), u = n(() => !!a.value), v = n(
-      () => p(s.value, "refresh_token")
-    ), h = n(() => S(s.value) || []), R = n(
-      () => o.generateRouteMetaRawTree(o.getRoutes(), {
+    ), r = o(() => n.state), a = o(
+      () => t.userInfoAccess.token.get(r.value)
+    ), u = o(() => !!a.value), m = o(
+      () => t.userInfoAccess.refreshToken.get(r.value)
+    ), v = o(
+      () => t.userInfoAccess.permission.get(r.value)
+    ), p = o(
+      () => t.generateRouteMetaRawTree(t.getRoutes(), {
         // 配置权限且有权限 或 (未配置权限无子路由(即末端子路由) 或 子路由有权限)
-        filterFn: (e, t, m) => e.checkPermission ? h.value.includes(e.permissionKey) : !m || t,
-        sortFn: (e, t) => e.menuSort - t.menuSort
+        filterFn: (e, s, f) => e.checkPermission ? v.value.includes(e.permissionKey) : !f || s,
+        sortFn: (e, s) => e.menuSort - s.menuSort
       })
-    ), y = n(() => E(R.value)), P = n(() => y.value.map((e) => e.path)), l = () => {
-      r.resetState();
-    }, T = async () => {
+    ), d = o(() => P(p.value)), k = o(() => d.value.map((e) => e.path)), i = () => {
+      n.resetState();
+    }, I = async () => {
       try {
-        u.value && await o.logoutApi();
+        u.value && await t.logoutApi();
       } catch (e) {
         console.error("退出登录失败", e);
       }
-      l();
-    }, I = async (e) => {
-      l();
-      const t = await o.loginApi(e);
-      r.updateState(t);
-    }, i = async () => {
-      const e = await o.getUserInfoApi(), t = c(
-        c(e, "token", a.value),
-        "refresh_token",
-        v.value
+      i();
+    }, A = async (e) => {
+      i();
+      const s = await t.loginApi(e);
+      n.updateState(s);
+    }, c = async () => {
+      const e = await t.getUserInfoApi(), s = t.userInfoAccess.token.set(
+        e,
+        a.value
+      ), f = t.userInfoAccess.refreshToken.set(
+        s,
+        m.value
       );
-      return r.updateState(t), e;
-    }, w = async () => {
-      const e = await o.refreshTokenApi(
-        v.value
+      return n.updateState(f), e;
+    }, S = async () => {
+      const e = await t.refreshTokenApi(
+        m.value
       );
-      r.updateState(
-        c(s.value, "token", e)
+      n.updateState(
+        t.userInfoAccess.token.set(
+          r.value,
+          e
+        )
       );
     };
-    o.register({
+    t.register({
       getToken: () => a.value,
-      refreshToken: w,
-      refreshAuth: i
+      refreshToken: S,
+      refreshAuth: c
     });
-    const A = (e) => P.value.includes(e), F = (e) => h.value.includes(e);
-    return f(
+    const T = (e) => k.value.includes(e), R = (e) => v.value.includes(e);
+    return l(
       u,
-      (e, t) => {
-        e && (t ?? i());
+      (e, s) => {
+        e && (s ?? c());
       },
       {
         immediate: !0
       }
-    ), f(u, (e, t) => {
-      e && !t && i();
-    }), f(a, (e, t) => {
-      e && t && i();
+    ), l(u, (e, s) => {
+      e && !s && c();
+    }), l(a, (e, s) => {
+      e && s && c();
     }), {
-      userInfo: s,
+      userInfo: r,
       token: a,
       isLogin: u,
-      login: I,
-      logout: T,
-      noApiLogout: l,
-      getInfo: i,
-      havePermissionByPath: A,
-      havePermissionByKey: F
+      login: A,
+      logout: I,
+      noApiLogout: i,
+      getInfo: c,
+      havePermissionByPath: T,
+      havePermissionByKey: R
     };
   });
 }
 export {
-  D as createUserStore
+  L as createUserStore
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@done-coding/admin-core",
-  "version": "0.7.1-alpha.0",
+  "version": "0.8.1-alpha.0",
   "description": "后台管理核心",
   "private": false,
   "main": "lib/index.cjs",
@@ -81,5 +81,5 @@
     "node": ">=18.0.0",
     "pnpm": ">=9.0.0"
   },
-  "gitHead": "6c5fb5f9b618d2ffb6c0af50c81fb8912e659501"
+  "gitHead": "611bac8c61ae3bafdde1ad22d358c992094b95d5"
 }

package/types/bridge/index.d.ts

@@ -238,6 +238,49 @@ export type AppThemeConfig = AppConfig["APP_THEME_CONFIG"];
 export type AppRouterMetaDefaultConfig = AppConfig["APP_ROUTER_META_DEFAULT_CONFIG"];
 /** 应用缓存配置 type 别名 */
 export type AppCacheConfig = AppConfig["APP_CACHE_CONFIG"];
+/**
+ * token / refreshToken 字段访问器（含 get + set）。
+ *
+ * 第一宪法：core 对业务 `UserInfo` shape 完全不透明——业务自存自取，经本 adapter
+ * 注入读写两字段的纯函数，core [MUST NOT] 硬编字面字段名/路径耦合业务字段位置。
+ * `set` [MUST] 产新对象（[MUST NOT] 原地 mutate，破响应式 + 破不可变）。
+ */
+export interface UserInfoFieldAccessor<UserInfo = unknown> {
+    /** 从用户信息读取字段值（未命中返回 undefined） */
+    get: (info: Partial<UserInfo>) => string | undefined;
+    /**
+     * 写入字段值，返回**保留 info 其余全部字段**的新对象。
+     *
+     * [MUST] 含 info 全字段（如 `{ ...info, <业务字段>: value }`）——createUserStore
+     * getInfo 顺势更新全部用户信息时以 data 为基，依赖本契约把 token/refreshToken
+     * 贴回而不丢失 data 其余字段；[MUST NOT] 只返回单字段对象，[MUST NOT] 原地 mutate info。
+     */
+    set: (info: Partial<UserInfo>, value: string) => Partial<UserInfo>;
+}
+/**
+ * permission 字段访问器（仅 get）。
+ *
+ * 权限由服务端下发只读，core 不写——仅 get 无 set；返回权限 key 列表（业务侧保底 `[]`）。
+ */
+export interface UserInfoPermissionAccessor<UserInfo = unknown> {
+    /** 从用户信息读取权限列表 */
+    get: (info: Partial<UserInfo>) => (string | number)[];
+}
+/**
+ * 用户信息字段访问器集（token / refreshToken / permission 三字段注入）。
+ *
+ * createUserStore 经 `bridge.userInfoAccess.<字段>.get/set` 读写业务 UserInfo，
+ * core 零字段名耦合（第一宪法）。业务 shape 完全自由（嵌套 / 组合 / 任意命名），
+ * core 只认 adapter 契约不认数据结构。
+ */
+export interface UserInfoAccess<UserInfo = unknown> {
+    /** token 字段访问器 */
+    token: UserInfoFieldAccessor<UserInfo>;
+    /** refreshToken 字段访问器 */
+    refreshToken: UserInfoFieldAccessor<UserInfo>;
+    /** permission 字段访问器（仅 get） */
+    permission: UserInfoPermissionAccessor<UserInfo>;
+}
 /**
  * `createAdminBridge` 入参类型（#2.5 期 schema 扩张到 14 顶层字段，per ADR-3 / ADR-6）。
  *
@@ -247,9 +290,9 @@ export type AppCacheConfig = AppConfig["APP_CACHE_CONFIG"];
  *
  * `routes`（#4e additive）为 app 嵌套路由树（带 children），createUserStore 经此算权限树；
  * `getUserInfoInitFn` 为 createUserStore 用户信息空保底注入面（core 对 UserInfo 不透明，
- * 业务 shape 不下沉，规则 8）。#C 期：删 `userInfoAccess` access pattern——token/refreshToken
- * 与 permission 对称为固定字面字段名（`"token"` / `"refresh_token"` / `"permission"`），
- * 嵌套场景由业务方 wrap getUserInfoApi 时摊平（wrap 是业务方天然控制点）。
+ * 业务 shape 不下沉，规则 8）。`userInfoAccess` 为 token / refreshToken / permission
+ * 三字段的业务注入访问器（第一宪法：core 经纯函数 get/set 读写，零字面字段名耦合，
+ * 业务 UserInfo shape 完全自由）。
  */
 export interface AdminBridgeInitOptions<UserInfo = unknown> {
     /** 应用基础信息（store/app 仅取 name） */
@@ -280,6 +323,8 @@ export interface AdminBridgeInitOptions<UserInfo = unknown> {
     routes: RouteRecordRaw[];
     /** 用户信息空保底工厂（v3 终锁 Δ0b；恒返非空业务字段默认值对象，createUserStore useState 经此取初值，core 不锁业务 shape） */
     getUserInfoInitFn: () => UserInfo;
+    /** 用户信息字段访问器集（第一宪法：core 经业务注入 get/set 读写 token/refreshToken/permission，零字段名耦合，业务 shape 自由） */
+    userInfoAccess: UserInfoAccess<UserInfo>;
 }
 /**
  * 认证桥接实例类型。
@@ -343,6 +388,8 @@ export interface AdminBridge<UserInfo = unknown, LoginParams = unknown> {
     readonly APP_ROUTER_PATHS_CONFIG: AppRouterPathsConfig;
     /** 应用主题配置（per #2.5 期 REQ-1） */
     readonly APP_THEME_CONFIG: AppThemeConfig;
+    /** 用户信息字段访问器集（业务注入；createUserStore 经 bridge.userInfoAccess.<字段>.get/set 读写，第一宪法 core 零字段耦合） */
+    readonly userInfoAccess: UserInfoAccess<UserInfo>;
 }
 /**
  * 认证桥接无状态纯工厂：接收 init 参数，内部立即初始化，返回可直接使用的

package/types/store/user.d.ts

@@ -8,10 +8,8 @@ import { RoutePermission } from '../types';
  * 运行时配置 + 注入面全部经 `bridge`——`getAppConfig` / `getRoutes` / 4 业务 api /
  * `getUserInfoInitFn()`（用户信息空保底工厂，替代 0fd94cc `userInfoInit` deps 字段）。
  *
- * #C 期：删 `userInfoAccess` access pattern + `buildRefreshTokenParams` deps，
- * token / refresh_token / permission 三字段对称为固定字面字符串经 lodash path 读写
- * （与 permission design D-a 同模式），refreshTokenApi 直传 refreshToken string 由
- * 业务方 wrap 内自打包业务 shape。
+ * 第一宪法：token / refreshToken / permission 三字段经 `bridge.userInfoAccess.<字段>`
+ * 业务注入访问器读写（纯函数 get/set，core 零字面字段名耦合，业务 UserInfo shape 自由）。
  */
 export interface CreateUserStoreDeps<UserInfo, LoginParams = unknown> {
     /** app 侧 admin bridge 单例（注入而非 core 持单例，守规则 8；getUserInfoInitFn 经 bridge.init 注入，本工厂经 bridge.getUserInfoInitFn() 读） */
@@ -50,7 +48,7 @@ export declare function createUserStore<UserInfo, LoginParams = unknown>(deps: C
     getInfo: () => Promise<Partial<UserInfo>>;
     havePermissionByPath: (path: string) => boolean;
     havePermissionByKey: (key?: RoutePermission["key"]) => boolean;
-}, "token" | "userInfo" | "isLogin">, Pick<{
+}, "userInfo" | "token" | "isLogin">, Pick<{
     userInfo: ComputedRef<UserInfo>;
     token: ComputedRef<string | undefined>;
     isLogin: ComputedRef<boolean>;