smart-admin-web 10.14.0 → 10.20.0

package/README.md

@@ -9,7 +9,7 @@ SmartAdmin 的前端内核：布局壳、动态菜单路由、登录与鉴权、
 从前端模板起步最省事，它就是一个装好这个包的薄壳应用：
 
 ```bash
-npx degit SmartCode-X/SmartAdmin/web/template web
+npx degit SimpleOne-X/SmartAdmin/web/template web
 cd web
 npm install
 npm run dev
@@ -50,7 +50,7 @@ createSmartAdmin({
 | `routes` | 布局壳之外的顶级静态路由，比如整屏看板、打印页 |
 | `icons` | 本地 SVG：`import.meta.glob('./assets/svg/*.svg', { query: '?raw', import: 'default', eager: true })` |
 | `iconSets` | 应用自己的 `ph` 图标子集，启动时同步注册。用包带的命令生成：`npx smart-admin-icons` 扫描 `src` 里的 `ph:*` 名字，写出 `src/assets/icons/ph-subset.json`；`--check` 给 CI 用 |
-| `menuTitles` | 菜单 path → i18n key，存量库的菜单标题是中文时用 |
+| `menuTitles` | 菜单标题 → i18n key，存量库的菜单标题是中文时用。键以 `/` 开头按路由 path 登记，其余按标题原文登记；内核自带菜单与应用名的译名已内置，不用再登记 |
 | `install(app)` | 需要 app 实例的注册：`registerHeaderTool`、`registerMenuBadge`、自己的 `app.use` |
 | `plugins` | 与上面同形的插件对象。覆盖顺序：内核 < 插件（按数组顺序）< 应用 |
 | `apiBase` / `version` / `dev` / `brand` / `table` | API 根地址、页脚版本号、开发态、品牌默认值（`sys.site.*` 配置有值时以配置为准）、SmartTable 全局默认 |
@@ -66,13 +66,13 @@ import { SmartTable } from 'smart-naive-table'
 
 ## 版本
 
-版本号与 NuGet 包 `SmartAdmin` 一致：主版本 = 内核所用的 .NET 主版本，次版本加功能，修订号修 bug。内置页照同一版后端的接口写，所以 `package.json` 里精确钉住版本、不带 `^`；升级时后端的 `SmartAdmin` 包与前端的 `smart-admin-web` 填同一个数字，改动见 [CHANGELOG](https://github.com/SmartCode-X/SmartAdmin/blob/main/CHANGELOG.md)。
+版本号与 NuGet 包 `SmartAdmin` 一致：主版本 = 内核所用的 .NET 主版本，次版本加功能，修订号修 bug。内置页照同一版后端的接口写，所以 `package.json` 里精确钉住版本、不带 `^`；升级时后端的 `SmartAdmin` 包与前端的 `smart-admin-web` 填同一个数字，改动见 [CHANGELOG](https://github.com/SimpleOne-X/SmartAdmin/blob/main/CHANGELOG.md)。
 
 ## 文档
 
-- 文档站：<https://smartcode-x.github.io/SmartAdmin/zh/>
-- 共享组件目录：[web/COMPONENTS.md](https://github.com/SmartCode-X/SmartAdmin/blob/main/web/COMPONENTS.md)
-- 源码与 issue：<https://github.com/SmartCode-X/SmartAdmin>
+- 文档站：<https://simpleone-x.github.io/SmartAdmin/zh/>
+- 共享组件目录：[web/COMPONENTS.md](https://github.com/SimpleOne-X/SmartAdmin/blob/main/web/COMPONENTS.md)
+- 源码与 issue：<https://github.com/SimpleOne-X/SmartAdmin>
 
 ## 许可证
 

package/dist/api/index.d.ts

@@ -1,6 +1,7 @@
 import { components } from './schema';
 import { AddUserInput, AddUserOutput, AiProviderAddInput, AiProviderPreset, AiProviderUpdateInput, AiProviderView, AiTestResult, AiUsageGroupBy, AiUsageSummary, AiUsageTrendPoint, ChunkInitOutput, ConfigInput, CronPreviewOutput, DashboardSummary, DataScopeType, DictItem, DictItemInput, DictTypeInput, DuplicateStrategy, FileUploadOutput, ImportCommitResult, ImportPreview, ImportRow, JobDashboard, JobHandlersOutput, JobInput, LastLoginInfo, LoginOutput, ModuleInput, ModuleRow, MyModulesOutput, MySessionItem, NoticeMineItem, NoticePublishInput, OnlineSessionItem, OrgInput, PermissionRouteItem, PositionInput, RoleInput, ServerInfoOutput, SysAiUsageLog, SysConfig, SysDictItem, SysDictType, SysExceptionLog, SysFile, SysJob, SysJobLog, SysLoginLog, SysNotice, SysOpLog, SysOrg, SysPosition, SysRole, SysRoleDataScope, UpdateUserInput, UserDetail, UserItem, UserProfile, UserShortcutItem, WorkbenchTodoSummary } from '../types/api';
 import { MenuInput, MenuNode, MenuTreeNode } from '../types/menu';
+import { WatermarkSettings } from '../lib/watermark';
 /** 业务错误(含后端 code / msgKey);视图 catch 后经 translateError 展示。 */
 export declare class ApiError extends Error {
     code: number;
@@ -165,7 +166,7 @@ export declare const authApi: {
         code: string;
     }) => Promise<LoginOutput>;
 };
-/** TOTP 自助绑定 / 恢复 / 管理员清除(ADR 0006;无邀请路径)。 */
+/** TOTP 自助绑定 / 恢复 / 管理员清除(无邀请路径)。 */
 export declare const mfaApi: {
     bindStart: (body: components["schemas"]["TotpBindStartInput"]) => Promise<{
         bindChallengeId?: string;
@@ -226,7 +227,32 @@ export declare const externalAuthApi: {
     }>;
     /** 解绑某 provider 的外部账号。 */
     unbind: (code: string) => Promise<boolean>;
+    /** 管理端:类型目录 + 全部 provider 的配置状态(机密只回 hasValue 与尾四位)。「登录方式」页。 */
+    catalog: () => Promise<{
+        dataProtectionEphemeral: boolean;
+        callbackBaseUrlMissing: boolean;
+        types: components["schemas"]["ExternalAuthTypeView"][];
+        providers: components["schemas"]["ExternalAuthProviderView"][];
+        callbackUriTemplate: string;
+    }>;
+    /** 新增或更新一条配置;机密留空 = 不改。需重新验证身份。 */
+    saveProvider: (code: string, body: ExternalAuthProviderSaveInput) => Promise<boolean>;
+    /** 清除配置(软删,不动用户已绑定的外部账号)。需重新验证身份。 */
+    removeProvider: (code: string) => Promise<boolean>;
+    /** 连接测试:用表单里的值,机密留空取已保存的;不落库,失败原因在 checks 里。 */
+    testProvider: (body: ExternalAuthProviderTestInput) => Promise<{
+        ok: boolean;
+        checks: components["schemas"]["ExternalAuthCheckView"][];
+    }>;
 };
+export type ExternalAuthCatalog = components['schemas']['ExternalAuthCatalogOutput'];
+export type ExternalAuthType = components['schemas']['ExternalAuthTypeView'];
+export type ExternalAuthField = components['schemas']['ExternalAuthFieldView'];
+export type ExternalAuthProvider = components['schemas']['ExternalAuthProviderView'];
+export type ExternalAuthProviderSaveInput = components['schemas']['ExternalAuthProviderSaveInput'];
+export type ExternalAuthProviderTestInput = components['schemas']['ExternalAuthProviderTestInput'];
+export type ExternalAuthTestResult = components['schemas']['ExternalAuthTestView'];
+export type ExternalAuthCheck = components['schemas']['ExternalAuthCheckView'];
 export declare const dashboardApi: {
     /** 工作台首页统计([ActiveSession]:任何登录用户可取,无需权限码)。 */
     summary: () => Promise<DashboardSummary>;
@@ -394,6 +420,7 @@ export declare const configApi: {
         name?: string;
         groupCode?: string;
         excludedGroupCodes?: string[];
+        excludedKeys?: string[];
     }) => Promise<{
         items: SysConfig[];
         total: number;
@@ -411,6 +438,11 @@ export declare const configApi: {
         configKey: string;
         configValue?: string | null;
     }[]) => Promise<boolean>;
+    /**
+     * 上传站点 Logo(只收 PNG/JPG/WEBP、1 MB 以内,不受全局上传白名单约束)。
+     * 返回的 viewUrl 是签名直链,写进 sys.site.logo 随批量保存生效。FormData 写法同 fileApi.upload。
+     */
+    uploadLogo: (file: File) => Promise<FileUploadOutput>;
     /** 站点信息(匿名可读:站点标题/副标题/版权等品牌展示白名单)。 */
     siteInfo: () => Promise<{
         title?: string | null;
@@ -418,8 +450,15 @@ export declare const configApi: {
         copyright?: string | null;
         copyrightUrl?: string | null;
         logo?: string | null;
+        loginHero?: Record<string, {
+            headline?: string | null;
+            highlight?: string | null;
+            features?: string[] | null;
+        }> | null;
+        showFeatures?: boolean | null;
         captchaEnabled?: boolean;
         smsLoginEnabled?: boolean;
+        watermark?: Partial<Record<keyof WatermarkSettings, unknown>> | null;
     }>;
     /** 当前生效密码策略(任何登录用户可读);改密页据此展示真实规则清单,免配置读权限。 */
     passwordPolicy: () => Promise<{
@@ -519,7 +558,7 @@ export declare const dictAdminApi: {
     typeRemove: (id: number) => Promise<boolean>;
     /** 批量删除字典类型(各自级联删项)。 */
     typeBatchRemove: (ids: number[]) => Promise<boolean>;
-    /** 某类型下的字典项(管理端:含停用、带 id;非下拉缓存源)。ponytail: 拉一页 200(Api:MaxPageSize 上限),字典项数量小,真超再分页。 */
+    /** 某类型下的字典项(管理端:含停用、带 id;非下拉缓存源)。ponytail: 拉一页 200(应用把 Api:MaxPageSize 调小时也不超限),字典项数量小,真超再分页。 */
     items: (typeCode: string) => Promise<SysDictItem[]>;
     itemAdd: (body: DictItemInput) => Promise<number>;
     itemUpdate: (id: number, body: DictItemInput) => Promise<boolean>;

package/dist/api/index.js

@@ -31,14 +31,14 @@ function a(e) {
     throw new u(n.code, n.msgKey, n.args, n.message);
   return n.data;
 }
-function U(e, t, i) {
+function x(e, t, i) {
   const o = s.request;
   return o(e, t, i === void 0 ? void 0 : { body: i }).then((n) => a(n));
 }
 const r = (e) => ({
   Current: e.page,
   Size: e.pageSize
-}), x = (e) => ({
+}), U = (e) => ({
   ...r(e),
   Keyword: e.keyword,
   Number: e.number,
@@ -148,11 +148,11 @@ const C = {
   bindComplete: (e) => s.POST("/api/v1/auth/mfa/bind/complete", { body: e }).then((t) => a(t)),
   recovery: (e) => s.POST("/api/v1/auth/mfa/recovery", { body: e }).then((t) => a(t)),
   clear: (e) => s.POST("/api/v1/sys/mfa/clear", { body: e }).then((t) => a(t))
-}, q = {
+}, D = {
   list: () => s.GET("/api/v1/sys/mfa/high-sensitivity", {}).then((e) => a(e)),
   add: (e) => s.POST("/api/v1/sys/mfa/high-sensitivity", { body: e }).then((t) => a(t)),
   remove: (e) => s.DELETE("/api/v1/sys/mfa/high-sensitivity/{id}", { params: { path: { id: e } } }).then((t) => a(t))
-}, k = {
+}, q = {
   /** 登录页可用的外部登录方式(启用的);空数组 = 不显 SSO 区。 */
   providers: () => s.GET("/api/v1/auth/external/providers", {}).then((e) => a(e)),
   /** 管理端全量列表(含已禁用);系统配置「第三方登录」Tab。 */
@@ -168,11 +168,19 @@ const C = {
   /** 发起绑定:返回授权 URL,前端跳转开始 OAuth 往返(回调把身份绑到当前用户)。 */
   bindStart: (e) => s.POST("/api/v1/auth/external/{provider}/bind", { params: { path: { provider: e } } }).then((t) => a(t)),
   /** 解绑某 provider 的外部账号。 */
-  unbind: (e) => s.DELETE("/api/v1/auth/external/{provider}/binding", { params: { path: { provider: e } } }).then((t) => a(t))
-}, D = {
+  unbind: (e) => s.DELETE("/api/v1/auth/external/{provider}/binding", { params: { path: { provider: e } } }).then((t) => a(t)),
+  /** 管理端:类型目录 + 全部 provider 的配置状态(机密只回 hasValue 与尾四位)。「登录方式」页。 */
+  catalog: () => s.GET("/api/v1/sys/external-auth/providers", {}).then((e) => a(e)),
+  /** 新增或更新一条配置;机密留空 = 不改。需重新验证身份。 */
+  saveProvider: (e, t) => s.PUT("/api/v1/sys/external-auth/providers/{code}", { params: { path: { code: e } }, body: t }).then((i) => a(i)),
+  /** 清除配置(软删,不动用户已绑定的外部账号)。需重新验证身份。 */
+  removeProvider: (e) => s.DELETE("/api/v1/sys/external-auth/providers/{code}", { params: { path: { code: e } } }).then((t) => a(t)),
+  /** 连接测试:用表单里的值,机密留空取已保存的;不落库,失败原因在 checks 里。 */
+  testProvider: (e) => s.POST("/api/v1/sys/external-auth/providers/test", { body: e }).then((t) => a(t))
+}, L = {
   /** 工作台首页统计([ActiveSession]:任何登录用户可取,无需权限码)。 */
   summary: () => s.GET("/api/v1/dashboard/summary", {}).then((e) => a(e))
-}, L = {
+}, k = {
   modules: () => s.GET("/api/v1/personal/modules", {}).then((e) => a(e)),
   menu: (e) => s.GET("/api/v1/personal/menu", { params: { query: { moduleId: e } } }).then((t) => a(t)),
   setDefaultModule: (e) => s.PUT("/api/v1/personal/default-module", { body: { moduleId: e } }).then((t) => a(t)),
@@ -344,7 +352,8 @@ const C = {
         ConfigKey: e.configKey,
         Name: e.name,
         GroupCode: e.groupCode,
-        ExcludedGroupCodes: e.excludedGroupCodes
+        ExcludedGroupCodes: e.excludedGroupCodes,
+        ExcludedKeys: e.excludedKeys
       }
     }
   }).then((t) => d(t)),
@@ -366,6 +375,18 @@ const C = {
   },
   /** 批量按键回写配置值(结构化表单保存);仅更新已存在键,未知键后端忽略。 */
   saveBatch: (e) => s.PUT("/api/v1/sys/config/batch", { body: e }).then((t) => a(t)),
+  /**
+   * 上传站点 Logo(只收 PNG/JPG/WEBP、1 MB 以内,不受全局上传白名单约束)。
+   * 返回的 viewUrl 是签名直链,写进 sys.site.logo 随批量保存生效。FormData 写法同 fileApi.upload。
+   */
+  uploadLogo: (e) => s.POST("/api/v1/sys/config/logo", {
+    timeout: l,
+    body: { file: e },
+    bodySerializer: (t) => {
+      const i = new FormData();
+      return i.append("file", t.file), i;
+    }
+  }).then((t) => a(t)),
   /** 站点信息(匿名可读:站点标题/副标题/版权等品牌展示白名单)。 */
   siteInfo: () => s.GET("/api/v1/sys/config/site", {}).then(
     (e) => a(e)
@@ -473,7 +494,7 @@ const B = {
   typeRemove: (e) => s.DELETE("/api/v1/sys/dict/type/{id}", { params: { path: { id: e } } }).then((t) => a(t)),
   /** 批量删除字典类型(各自级联删项)。 */
   typeBatchRemove: (e) => s.POST("/api/v1/sys/dict/type/batch-delete", { body: { ids: e } }).then((t) => a(t)),
-  /** 某类型下的字典项(管理端:含停用、带 id;非下拉缓存源)。ponytail: 拉一页 200(Api:MaxPageSize 上限),字典项数量小,真超再分页。 */
+  /** 某类型下的字典项(管理端:含停用、带 id;非下拉缓存源)。ponytail: 拉一页 200(应用把 Api:MaxPageSize 调小时也不超限),字典项数量小,真超再分页。 */
   items: (e) => s.GET("/api/v1/sys/dict/item/page", {
     params: { query: { TypeCode: e, Current: 1, Size: 200 } }
   }).then((t) => a(t)).then((t) => t.items),
@@ -682,17 +703,17 @@ export {
   ee as aiUsageApi,
   C as authApi,
   $ as cacheApi,
-  U as callApi,
+  x as callApi,
   z as configApi,
-  D as dashboardApi,
+  L as dashboardApi,
   f as dayRange,
   V as dictAdminApi,
   J as dictApi,
-  k as externalAuthApi,
+  q as externalAuthApi,
   _ as fileApi,
-  q as highSensApi,
+  D as highSensApi,
   X as jobApi,
-  x as listQuery,
+  U as listQuery,
   B as logApi,
   W as menuApi,
   I as mfaApi,
@@ -703,7 +724,7 @@ export {
   Q as noticeApi,
   R as orgApi,
   r as pageParams,
-  L as personalApi,
+  k as personalApi,
   F as positionApi,
   Y as recycleApi,
   K as roleApi,