@das-fed/upf-utils 6.4.0-hot.12 → 6.4.0-hot.13

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

@@ -1,13 +1,16 @@
 export type PermissionId = string | number;
+export type PermissionQueryType = 'menuId' | 'appId';
 export interface PermissionQuery {
     appIds: PermissionId[];
     moduleIds?: PermissionId[];
 }
-type PermissionQueryInput = PermissionQuery | {
+export interface CurrentUserPermissionRequest {
+    type?: PermissionQueryType;
+    menuId?: PermissionId;
     appIds?: PermissionId | PermissionId[];
     moduleIds?: PermissionId | PermissionId[];
-};
-type PermissionCallback<T> = (data: T) => void;
+}
+export type PermissionCallback<T> = (data: T) => void;
 export declare const groupPermissionListByModuleAndCode: (permissionList: unknown) => {
     id: {
         id: number[];
@@ -21,6 +24,54 @@ 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 {};
+export declare const getCurrentUserPermissionList: {
+    /**
+     * 按菜单 ID 查询当前用户的功能权限列表。
+     * @param menuId 菜单 ID（string 或 number）
+     * @param cb 可选回调，接收权限列表数据
+     * @example
+     * getCurrentUserPermissionList(12345)
+     * getCurrentUserPermissionList('12345', (list) => console.log(list))
+     */
+    (menuId: PermissionId, cb?: PermissionCallback<any[]>): Promise<any[]>;
+    /**
+     * 按结构化参数查询当前用户的功能权限列表，支持 menuId / appId 两种模式。
+     * - `type: 'menuId'`（默认）：通过 `menuId` 查询当前菜单的功能权限。
+     * - `type: 'appId'`：通过 `appIds`（必填）+ `moduleIds`（可选）跨应用查询权限。
+     * @param params 查询参数对象
+     * @param cb 可选回调，接收权限列表数据
+     * @example
+     * // 按菜单 ID 查询
+     * getCurrentUserPermissionList({ type: 'menuId', menuId: 12345 })
+     * // 按应用 ID 查询
+     * getCurrentUserPermissionList({ type: 'appId', appIds: ['xxx'], moduleIds: ['yyy'] })
+     */
+    (params: CurrentUserPermissionRequest, cb?: PermissionCallback<any[]>): Promise<any[]>;
+};
+/**
+ * 基于 sessionStorage 中的 menuList 树，判断当前用户是否拥有指定菜单或应用的访问权限。
+ *
+ * - 仅传 `appId`：判断该应用是否存在于权限列表中（应用级权限）。
+ * - 仅传 `routeCode`：在所有应用的菜单树中查找是否包含该路由编码（菜单级权限）。
+ * - 同时传入 `appId` 与 `routeCode`：在指定应用的菜单树中查找是否包含该路由编码。
+ * - 两者均未传：直接返回 `false`。
+ *
+ * 菜单匹配时仅采集最深层的菜单节点（父级容器节点不参与判断），以避免中间层级干扰鉴权结果。
+ *
+ * @param routeCode - 菜单路由编码，对应菜单配置中的 `routeCode` 字段，可不传。
+ * @param appId - 应用 ID，用于限定查询的应用范围，可不传。
+ * @returns `true` 表示拥有对应权限，`false` 表示无权限或参数无效。
+ *
+ * @example
+ * // 判断是否拥有某应用权限
+ * hasMenuPermissionByRouteCode('', '001')
+ *
+ * @example
+ * // 判断是否拥有某菜单路由权限（全局范围）
+ * hasMenuPermissionByRouteCode('user.manage')
+ *
+ * @example
+ * // 判断在指定应用下是否拥有某菜单路由权限
+ * hasMenuPermissionByRouteCode('user.manage', '001')
+ */
+export declare const hasMenuPermissionByRouteCode: (routeCode?: string, appId?: PermissionId) => boolean;