com-angel-authorization 1.0.14 → 1.0.15

package/dist/react/index.d.cts

@@ -339,7 +339,71 @@ type MenuManagerProps = {
 };
 declare function MenuManager({ api, title, pageSize: initialPageSize, toolbarExtra, }: MenuManagerProps): react.JSX.Element;
 
-type SystemAdminMenuKey = 'menu' | 'resource';
+type SystemRole = {
+    roleId: string;
+    name: string;
+    description: string;
+};
+type SystemRoleFormValues = {
+    name: string;
+    description: string;
+};
+type CreateSystemRoleBody = SystemRoleFormValues;
+type UpdateSystemRoleBody = Partial<SystemRoleFormValues>;
+type FetchSystemRolesParams = {
+    keyword?: string;
+    pagination?: ListPaginationParams;
+};
+type SystemRoleListResult = {
+    records: SystemRole[];
+    pageToken: string;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+};
+/** 角色授权树节点 */
+type RolePermissionTreeNode = {
+    resourceId: string;
+    name: string;
+    children: RolePermissionTreeNode[];
+};
+/** GET /system/roles/{role-id}/permissions */
+type RolePermissionsResult = {
+    /** 当前角色已授予的资源 ID，用于树回显勾选 */
+    resourceIds: string[];
+    resourceTree: RolePermissionTreeNode[];
+};
+/** POST /system/roles/{role-id}/permissions */
+type SaveRolePermissionsBody = {
+    resourceIds: string[];
+};
+
+type SystemRoleApi = {
+    list: (params?: FetchSystemRolesParams, signal?: AbortSignal) => Promise<SystemRoleListResult>;
+    create: (values: SystemRoleFormValues, signal?: AbortSignal) => Promise<unknown>;
+    update: (roleId: string, values: SystemRoleFormValues, signal?: AbortSignal) => Promise<unknown>;
+    remove: (roleId: string, signal?: AbortSignal) => Promise<unknown>;
+    getPermissions: (roleId: string, signal?: AbortSignal) => Promise<RolePermissionsResult>;
+    savePermissions: (roleId: string, resourceIds: string[], signal?: AbortSignal) => Promise<unknown>;
+};
+declare function mapSystemRole(item: unknown): SystemRole | null;
+declare function mapPermissionTreeNode(item: unknown): RolePermissionTreeNode | null;
+declare function mapRolePermissions(payload: unknown): RolePermissionsResult;
+/** 收集节点及其全部子孙 resourceId */
+declare function collectTreeResourceIds(node: RolePermissionTreeNode): string[];
+declare function buildCreateRoleBody(values: SystemRoleFormValues): CreateSystemRoleBody;
+declare function buildUpdateRoleBody(values: SystemRoleFormValues): UpdateSystemRoleBody;
+declare function buildSavePermissionsBody(resourceIds: string[]): SaveRolePermissionsBody;
+declare function createSystemRoleApi(request: ResourceHttpRequest): SystemRoleApi;
+
+type RoleManagerProps = {
+    api: SystemRoleApi;
+    title?: string;
+    pageSize?: string;
+    toolbarExtra?: ReactNode;
+};
+declare function RoleManager({ api, title, pageSize: initialPageSize, toolbarExtra, }: RoleManagerProps): react.JSX.Element;
+
+type SystemAdminMenuKey = 'menu' | 'resource' | 'role';
 type SystemAdminSubMenu = {
     key: SystemAdminMenuKey;
     label: string;
@@ -349,13 +413,14 @@ type SystemAdminMenuGroup = {
     label: string;
     children: SystemAdminSubMenu[];
 };
-/** 系统管理菜单结构：菜单管理、权限点管理为其子菜单 */
+/** 系统管理菜单结构 */
 declare const SYSTEM_ADMIN_MENU: SystemAdminMenuGroup;
 declare const SYSTEM_ADMIN_DEFAULT_KEY: SystemAdminMenuKey;
 
 type SystemAdminProps = {
     menuApi: MenuResourceApi;
     resourceApi: AuthorizationResourceApi;
+    roleApi: SystemRoleApi;
     /** 默认选中的子菜单，默认菜单管理 */
     defaultActiveKey?: SystemAdminMenuKey;
     /** 受控选中 key */
@@ -365,9 +430,9 @@ type SystemAdminProps = {
     toolbarExtra?: ReactNode;
 };
 /**
- * 系统管理：侧栏父菜单「系统管理」，子菜单为「菜单管理」「权限点管理」。
+ * 系统管理：侧栏父菜单「系统管理」，子菜单为菜单 / 权限点 / 角色管理。
  */
-declare function SystemAdmin({ menuApi, resourceApi, defaultActiveKey, activeKey: controlledKey, onActiveKeyChange, title, toolbarExtra, }: SystemAdminProps): react.JSX.Element;
+declare function SystemAdmin({ menuApi, resourceApi, roleApi, defaultActiveKey, activeKey: controlledKey, onActiveKeyChange, title, toolbarExtra, }: SystemAdminProps): react.JSX.Element;
 
 interface SnowyflakeOptions {
     epoch?: bigint;
@@ -399,4 +464,4 @@ declare const snowyflake: ConfigurableSnowflake;
 declare function getAppClientId(): string;
 declare function getDeviceWorkerId(): string;
 
-export { type ApiResourceType, type AuthorizationResource, type AuthorizationResourceApi, type AuthorizationResourceFormValues, type AuthorizationResourceListResult, Can, type CanProps, type CheckOptions, type CreateAuthorizationResourceBody, type CreateDefaultResourceRequestOptions, type CreateMenuResourceBody, type FetchAuthorizationResourcesParams, type FetchMenuResourcesParams, type HttpMethod, type ListPaginationParams, type ListPaginationResult, MENU_LEAF_NO, MENU_LEAF_YES, MENU_LIST_TYPE_PARAM, MENU_TYPE_BUTTON, MENU_TYPE_LABEL, MENU_TYPE_MENU, MENU_TYPE_OPTIONS, MENU_TYPE_PAGE, MENU_VISIBILITY_OPTIONS, type MatchMode, MenuManager, type MenuManagerProps, type MenuResource, type MenuResourceApi, type MenuResourceFormValues, type MenuResourceListResult, type MenuResourceType, type PageDirection, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, type PermissionStoreAPI, RESOURCE_PRIVATE_OPTIONS, RESOURCE_STATUS_DISABLED, RESOURCE_STATUS_ENABLED, RESOURCE_STATUS_OPTIONS, RESOURCE_TYPE_API, ROOT_MENU_DEPTH, ROOT_PARENT_ID, type ResourceHttpRequest, ResourceManager, type ResourceManagerProps, type ResourceRequestOptions, type ResourceStatus, type ResourceType, type RoleCode, SYSTEM_ADMIN_DEFAULT_KEY, SYSTEM_ADMIN_MENU, SystemAdmin, type SystemAdminMenuGroup, type SystemAdminMenuKey, type SystemAdminProps, type SystemAdminSubMenu, type UpdateAuthorizationResourceBody, type UpdateMenuResourceBody, type UsePermissionResult, appendQueryParam, buildCreateBody, buildCreateMenuBody, buildUpdateBody, buildUpdateMenuBody, createAuthorizationResourceApi, createDefaultResourceRequest, createMenuResourceApi, createPermissionStore, extractPagination, extractRecords, getAppClientId, getDeviceWorkerId, isMenuLeaf, mapAuthorizationResource, mapMenuResource, resolveMenuDepth, snowyflake, useHasPermission, useHasRole, usePermission };
+export { type ApiResourceType, type AuthorizationResource, type AuthorizationResourceApi, type AuthorizationResourceFormValues, type AuthorizationResourceListResult, Can, type CanProps, type CheckOptions, type CreateAuthorizationResourceBody, type CreateDefaultResourceRequestOptions, type CreateMenuResourceBody, type CreateSystemRoleBody, type FetchAuthorizationResourcesParams, type FetchMenuResourcesParams, type FetchSystemRolesParams, type HttpMethod, type ListPaginationParams, type ListPaginationResult, MENU_LEAF_NO, MENU_LEAF_YES, MENU_LIST_TYPE_PARAM, MENU_TYPE_BUTTON, MENU_TYPE_LABEL, MENU_TYPE_MENU, MENU_TYPE_OPTIONS, MENU_TYPE_PAGE, MENU_VISIBILITY_OPTIONS, type MatchMode, MenuManager, type MenuManagerProps, type MenuResource, type MenuResourceApi, type MenuResourceFormValues, type MenuResourceListResult, type MenuResourceType, type PageDirection, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, type PermissionStoreAPI, RESOURCE_PRIVATE_OPTIONS, RESOURCE_STATUS_DISABLED, RESOURCE_STATUS_ENABLED, RESOURCE_STATUS_OPTIONS, RESOURCE_TYPE_API, ROOT_MENU_DEPTH, ROOT_PARENT_ID, type ResourceHttpRequest, ResourceManager, type ResourceManagerProps, type ResourceRequestOptions, type ResourceStatus, type ResourceType, type RoleCode, RoleManager, type RoleManagerProps, type RolePermissionTreeNode, type RolePermissionsResult, SYSTEM_ADMIN_DEFAULT_KEY, SYSTEM_ADMIN_MENU, type SaveRolePermissionsBody, SystemAdmin, type SystemAdminMenuGroup, type SystemAdminMenuKey, type SystemAdminProps, type SystemAdminSubMenu, type SystemRole, type SystemRoleApi, type SystemRoleFormValues, type SystemRoleListResult, type UpdateAuthorizationResourceBody, type UpdateMenuResourceBody, type UpdateSystemRoleBody, type UsePermissionResult, appendQueryParam, buildCreateBody, buildCreateMenuBody, buildCreateRoleBody, buildSavePermissionsBody, buildUpdateBody, buildUpdateMenuBody, buildUpdateRoleBody, collectTreeResourceIds, createAuthorizationResourceApi, createDefaultResourceRequest, createMenuResourceApi, createPermissionStore, createSystemRoleApi, extractPagination, extractRecords, getAppClientId, getDeviceWorkerId, isMenuLeaf, mapAuthorizationResource, mapMenuResource, mapPermissionTreeNode, mapRolePermissions, mapSystemRole, resolveMenuDepth, snowyflake, useHasPermission, useHasRole, usePermission };

package/dist/react/index.d.ts

@@ -339,7 +339,71 @@ type MenuManagerProps = {
 };
 declare function MenuManager({ api, title, pageSize: initialPageSize, toolbarExtra, }: MenuManagerProps): react.JSX.Element;
 
-type SystemAdminMenuKey = 'menu' | 'resource';
+type SystemRole = {
+    roleId: string;
+    name: string;
+    description: string;
+};
+type SystemRoleFormValues = {
+    name: string;
+    description: string;
+};
+type CreateSystemRoleBody = SystemRoleFormValues;
+type UpdateSystemRoleBody = Partial<SystemRoleFormValues>;
+type FetchSystemRolesParams = {
+    keyword?: string;
+    pagination?: ListPaginationParams;
+};
+type SystemRoleListResult = {
+    records: SystemRole[];
+    pageToken: string;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+};
+/** 角色授权树节点 */
+type RolePermissionTreeNode = {
+    resourceId: string;
+    name: string;
+    children: RolePermissionTreeNode[];
+};
+/** GET /system/roles/{role-id}/permissions */
+type RolePermissionsResult = {
+    /** 当前角色已授予的资源 ID，用于树回显勾选 */
+    resourceIds: string[];
+    resourceTree: RolePermissionTreeNode[];
+};
+/** POST /system/roles/{role-id}/permissions */
+type SaveRolePermissionsBody = {
+    resourceIds: string[];
+};
+
+type SystemRoleApi = {
+    list: (params?: FetchSystemRolesParams, signal?: AbortSignal) => Promise<SystemRoleListResult>;
+    create: (values: SystemRoleFormValues, signal?: AbortSignal) => Promise<unknown>;
+    update: (roleId: string, values: SystemRoleFormValues, signal?: AbortSignal) => Promise<unknown>;
+    remove: (roleId: string, signal?: AbortSignal) => Promise<unknown>;
+    getPermissions: (roleId: string, signal?: AbortSignal) => Promise<RolePermissionsResult>;
+    savePermissions: (roleId: string, resourceIds: string[], signal?: AbortSignal) => Promise<unknown>;
+};
+declare function mapSystemRole(item: unknown): SystemRole | null;
+declare function mapPermissionTreeNode(item: unknown): RolePermissionTreeNode | null;
+declare function mapRolePermissions(payload: unknown): RolePermissionsResult;
+/** 收集节点及其全部子孙 resourceId */
+declare function collectTreeResourceIds(node: RolePermissionTreeNode): string[];
+declare function buildCreateRoleBody(values: SystemRoleFormValues): CreateSystemRoleBody;
+declare function buildUpdateRoleBody(values: SystemRoleFormValues): UpdateSystemRoleBody;
+declare function buildSavePermissionsBody(resourceIds: string[]): SaveRolePermissionsBody;
+declare function createSystemRoleApi(request: ResourceHttpRequest): SystemRoleApi;
+
+type RoleManagerProps = {
+    api: SystemRoleApi;
+    title?: string;
+    pageSize?: string;
+    toolbarExtra?: ReactNode;
+};
+declare function RoleManager({ api, title, pageSize: initialPageSize, toolbarExtra, }: RoleManagerProps): react.JSX.Element;
+
+type SystemAdminMenuKey = 'menu' | 'resource' | 'role';
 type SystemAdminSubMenu = {
     key: SystemAdminMenuKey;
     label: string;
@@ -349,13 +413,14 @@ type SystemAdminMenuGroup = {
     label: string;
     children: SystemAdminSubMenu[];
 };
-/** 系统管理菜单结构：菜单管理、权限点管理为其子菜单 */
+/** 系统管理菜单结构 */
 declare const SYSTEM_ADMIN_MENU: SystemAdminMenuGroup;
 declare const SYSTEM_ADMIN_DEFAULT_KEY: SystemAdminMenuKey;
 
 type SystemAdminProps = {
     menuApi: MenuResourceApi;
     resourceApi: AuthorizationResourceApi;
+    roleApi: SystemRoleApi;
     /** 默认选中的子菜单，默认菜单管理 */
     defaultActiveKey?: SystemAdminMenuKey;
     /** 受控选中 key */
@@ -365,9 +430,9 @@ type SystemAdminProps = {
     toolbarExtra?: ReactNode;
 };
 /**
- * 系统管理：侧栏父菜单「系统管理」，子菜单为「菜单管理」「权限点管理」。
+ * 系统管理：侧栏父菜单「系统管理」，子菜单为菜单 / 权限点 / 角色管理。
  */
-declare function SystemAdmin({ menuApi, resourceApi, defaultActiveKey, activeKey: controlledKey, onActiveKeyChange, title, toolbarExtra, }: SystemAdminProps): react.JSX.Element;
+declare function SystemAdmin({ menuApi, resourceApi, roleApi, defaultActiveKey, activeKey: controlledKey, onActiveKeyChange, title, toolbarExtra, }: SystemAdminProps): react.JSX.Element;
 
 interface SnowyflakeOptions {
     epoch?: bigint;
@@ -399,4 +464,4 @@ declare const snowyflake: ConfigurableSnowflake;
 declare function getAppClientId(): string;
 declare function getDeviceWorkerId(): string;
 
-export { type ApiResourceType, type AuthorizationResource, type AuthorizationResourceApi, type AuthorizationResourceFormValues, type AuthorizationResourceListResult, Can, type CanProps, type CheckOptions, type CreateAuthorizationResourceBody, type CreateDefaultResourceRequestOptions, type CreateMenuResourceBody, type FetchAuthorizationResourcesParams, type FetchMenuResourcesParams, type HttpMethod, type ListPaginationParams, type ListPaginationResult, MENU_LEAF_NO, MENU_LEAF_YES, MENU_LIST_TYPE_PARAM, MENU_TYPE_BUTTON, MENU_TYPE_LABEL, MENU_TYPE_MENU, MENU_TYPE_OPTIONS, MENU_TYPE_PAGE, MENU_VISIBILITY_OPTIONS, type MatchMode, MenuManager, type MenuManagerProps, type MenuResource, type MenuResourceApi, type MenuResourceFormValues, type MenuResourceListResult, type MenuResourceType, type PageDirection, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, type PermissionStoreAPI, RESOURCE_PRIVATE_OPTIONS, RESOURCE_STATUS_DISABLED, RESOURCE_STATUS_ENABLED, RESOURCE_STATUS_OPTIONS, RESOURCE_TYPE_API, ROOT_MENU_DEPTH, ROOT_PARENT_ID, type ResourceHttpRequest, ResourceManager, type ResourceManagerProps, type ResourceRequestOptions, type ResourceStatus, type ResourceType, type RoleCode, SYSTEM_ADMIN_DEFAULT_KEY, SYSTEM_ADMIN_MENU, SystemAdmin, type SystemAdminMenuGroup, type SystemAdminMenuKey, type SystemAdminProps, type SystemAdminSubMenu, type UpdateAuthorizationResourceBody, type UpdateMenuResourceBody, type UsePermissionResult, appendQueryParam, buildCreateBody, buildCreateMenuBody, buildUpdateBody, buildUpdateMenuBody, createAuthorizationResourceApi, createDefaultResourceRequest, createMenuResourceApi, createPermissionStore, extractPagination, extractRecords, getAppClientId, getDeviceWorkerId, isMenuLeaf, mapAuthorizationResource, mapMenuResource, resolveMenuDepth, snowyflake, useHasPermission, useHasRole, usePermission };
+export { type ApiResourceType, type AuthorizationResource, type AuthorizationResourceApi, type AuthorizationResourceFormValues, type AuthorizationResourceListResult, Can, type CanProps, type CheckOptions, type CreateAuthorizationResourceBody, type CreateDefaultResourceRequestOptions, type CreateMenuResourceBody, type CreateSystemRoleBody, type FetchAuthorizationResourcesParams, type FetchMenuResourcesParams, type FetchSystemRolesParams, type HttpMethod, type ListPaginationParams, type ListPaginationResult, MENU_LEAF_NO, MENU_LEAF_YES, MENU_LIST_TYPE_PARAM, MENU_TYPE_BUTTON, MENU_TYPE_LABEL, MENU_TYPE_MENU, MENU_TYPE_OPTIONS, MENU_TYPE_PAGE, MENU_VISIBILITY_OPTIONS, type MatchMode, MenuManager, type MenuManagerProps, type MenuResource, type MenuResourceApi, type MenuResourceFormValues, type MenuResourceListResult, type MenuResourceType, type PageDirection, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, type PermissionStoreAPI, RESOURCE_PRIVATE_OPTIONS, RESOURCE_STATUS_DISABLED, RESOURCE_STATUS_ENABLED, RESOURCE_STATUS_OPTIONS, RESOURCE_TYPE_API, ROOT_MENU_DEPTH, ROOT_PARENT_ID, type ResourceHttpRequest, ResourceManager, type ResourceManagerProps, type ResourceRequestOptions, type ResourceStatus, type ResourceType, type RoleCode, RoleManager, type RoleManagerProps, type RolePermissionTreeNode, type RolePermissionsResult, SYSTEM_ADMIN_DEFAULT_KEY, SYSTEM_ADMIN_MENU, type SaveRolePermissionsBody, SystemAdmin, type SystemAdminMenuGroup, type SystemAdminMenuKey, type SystemAdminProps, type SystemAdminSubMenu, type SystemRole, type SystemRoleApi, type SystemRoleFormValues, type SystemRoleListResult, type UpdateAuthorizationResourceBody, type UpdateMenuResourceBody, type UpdateSystemRoleBody, type UsePermissionResult, appendQueryParam, buildCreateBody, buildCreateMenuBody, buildCreateRoleBody, buildSavePermissionsBody, buildUpdateBody, buildUpdateMenuBody, buildUpdateRoleBody, collectTreeResourceIds, createAuthorizationResourceApi, createDefaultResourceRequest, createMenuResourceApi, createPermissionStore, createSystemRoleApi, extractPagination, extractRecords, getAppClientId, getDeviceWorkerId, isMenuLeaf, mapAuthorizationResource, mapMenuResource, mapPermissionTreeNode, mapRolePermissions, mapSystemRole, resolveMenuDepth, snowyflake, useHasPermission, useHasRole, usePermission };