@das-fed/upf-utils 6.4.0-dev.235 → 6.4.0-dev.237

package/common-info/getPermissionMethod/index.d.ts

@@ -1,8 +1,15 @@
 export type PermissionId = string | number;
+export type PermissionQueryType = 'menuId' | 'appId';
 export interface PermissionQuery {
     appIds: PermissionId[];
     moduleIds?: PermissionId[];
 }
+export interface CurrentUserPermissionRequest {
+    type?: PermissionQueryType;
+    menuId?: PermissionId;
+    appIds?: PermissionId | PermissionId[];
+    moduleIds?: PermissionId | PermissionId[];
+}
 type PermissionQueryInput = PermissionQuery | {
     appIds?: PermissionId | PermissionId[];
     moduleIds?: PermissionId | PermissionId[];
@@ -21,6 +28,32 @@ export declare const getGroupedCurrentUserPermissionList: () => {
     code: Record<string, any>;
 };
 export declare const getCurrentModulePermissionData: (returnType?: "id" | "code" | "all") => any;
-export declare const getCurrentUserPermissionsList: (paramsObj: PermissionQueryInput, cb?: PermissionCallback<any[]>) => unknown;
-export declare const getCurrentUserMenuPermissionsList: (id: string, cb?: PermissionCallback<any[]>) => unknown;
+export declare const getCurrentUserPermissionList: (paramsObj: PermissionId | PermissionQueryInput | CurrentUserPermissionRequest, cb?: PermissionCallback<any[]>) => unknown;
+/**
+ * 基于 sessionStorage 中的 menuList 树，判断当前用户是否拥有指定菜单或应用的访问权限。
+ *
+ * - 仅传 `appId`：判断该应用是否存在于权限列表中（应用级权限）。
+ * - 仅传 `routeCode`：在所有应用的菜单树中查找是否包含该路由编码（菜单级权限）。
+ * - 同时传入 `appId` 与 `routeCode`：在指定应用的菜单树中查找是否包含该路由编码。
+ * - 两者均未传：直接返回 `false`。
+ *
+ * 菜单匹配时仅采集最深层的菜单节点（父级容器节点不参与判断），以避免中间层级干扰鉴权结果。
+ *
+ * @param routeCode - 菜单路由编码，对应菜单配置中的 `routeCode` 字段，可不传。
+ * @param appId - 应用 ID，用于限定查询的应用范围，可不传。
+ * @returns `true` 表示拥有对应权限，`false` 表示无权限或参数无效。
+ *
+ * @example
+ * // 判断是否拥有某应用权限
+ * hasMenuPermissionByRouteCode(undefined, '001')
+ *
+ * @example
+ * // 判断是否拥有某菜单路由权限（全局范围）
+ * hasMenuPermissionByRouteCode('user.manage')
+ *
+ * @example
+ * // 判断在指定应用下是否拥有某菜单路由权限
+ * hasMenuPermissionByRouteCode('user.manage', '001')
+ */
+export declare const hasMenuPermissionByRouteCode: (routeCode?: string, appId?: PermissionId) => any;
 export {};