@abpjs/identity 0.9.0 → 1.1.0

package/dist/index.d.mts

@@ -158,6 +158,11 @@ interface RoleOperationResult {
     success: boolean;
     error?: string;
 }
+/**
+ * Sort order type
+ * @since 1.0.0
+ */
+type SortOrder = 'asc' | 'desc' | '';
 /**
  * Return type for useRoles hook
  */
@@ -172,7 +177,11 @@ interface UseRolesReturn {
     isLoading: boolean;
     /** Error message if any */
     error: string | null;
-    /** Fetch all roles with optional pagination/filtering (v0.9.0) */
+    /** Current sort key @since 1.0.0 */
+    sortKey: string;
+    /** Current sort order @since 1.0.0 */
+    sortOrder: SortOrder;
+    /** Fetch all roles with optional pagination/filtering */
     fetchRoles: (params?: ABP.PageQueryParams) => Promise<RoleOperationResult>;
     /** Get a role by ID and set it as selected */
     getRoleById: (id: string) => Promise<RoleOperationResult>;
@@ -184,6 +193,10 @@ interface UseRolesReturn {
     deleteRole: (id: string) => Promise<RoleOperationResult>;
     /** Set the selected role */
     setSelectedRole: (role: Identity.RoleItem | null) => void;
+    /** Set sort key @since 1.0.0 */
+    setSortKey: (key: string) => void;
+    /** Set sort order @since 1.0.0 */
+    setSortOrder: (order: SortOrder) => void;
     /** Reset state */
     reset: () => void;
 }
@@ -252,6 +265,10 @@ interface UseUsersReturn {
     error: string | null;
     /** Current page query parameters */
     pageQuery: ABP.PageQueryParams;
+    /** Current sort key @since 1.0.0 */
+    sortKey: string;
+    /** Current sort order @since 1.0.0 */
+    sortOrder: SortOrder;
     /** Fetch users with pagination */
     fetchUsers: (params?: ABP.PageQueryParams) => Promise<UserOperationResult>;
     /** Get a user by ID and set it as selected */
@@ -268,6 +285,10 @@ interface UseUsersReturn {
     setSelectedUser: (user: Identity.UserItem | null) => void;
     /** Set page query parameters */
     setPageQuery: (query: ABP.PageQueryParams) => void;
+    /** Set sort key @since 1.0.0 */
+    setSortKey: (key: string) => void;
+    /** Set sort order @since 1.0.0 */
+    setSortOrder: (order: SortOrder) => void;
     /** Reset state */
     reset: () => void;
 }
@@ -388,6 +409,11 @@ interface RolesComponentProps {
  */
 declare function RolesComponent({ onRoleCreated, onRoleUpdated, onRoleDeleted, }: RolesComponentProps): React.ReactElement;
 
+/**
+ * Password rule type for validation display
+ * @since 1.1.0
+ */
+type PasswordRule = 'number' | 'small' | 'capital' | 'special';
 /**
  * Props for UsersComponent
  */
@@ -398,35 +424,29 @@ interface UsersComponentProps {
     onUserUpdated?: (user: Identity.UserItem) => void;
     /** Optional callback when a user is deleted */
     onUserDeleted?: (id: string) => void;
+    /**
+     * Password validation rules to display
+     * @since 1.1.0
+     */
+    passwordRulesArr?: PasswordRule[];
+    /**
+     * Required minimum password length
+     * @since 1.1.0
+     */
+    requiredPasswordLength?: number;
 }
-/**
- * UsersComponent - Component for managing users
- *
- * This is the React equivalent of Angular's UsersComponent.
- * It displays a table of users with CRUD operations, role assignment, and permission management.
- *
- * @example
- * ```tsx
- * function IdentityPage() {
- *   return (
- *     <UsersComponent
- *       onUserCreated={(user) => console.log('User created:', user)}
- *       onUserDeleted={(id) => console.log('User deleted:', id)}
- *     />
- *   );
- * }
- * ```
- */
-declare function UsersComponent({ onUserCreated, onUserUpdated, onUserDeleted, }: UsersComponentProps): React.ReactElement;
+declare function UsersComponent({ onUserCreated, onUserUpdated, onUserDeleted, passwordRulesArr, requiredPasswordLength, }: UsersComponentProps): React.ReactElement;
 
 /**
- * Identity module routes configuration (v0.9.0 format).
+ * Identity module routes configuration.
  * Translated from @abp/ng.identity IDENTITY_ROUTES.
  *
  * These routes define the navigation structure for the identity module
  * within the ABP Framework application.
  *
- * In v0.9.0, the format changed from `ABP.FullRoute[]` to `{ routes: ABP.FullRoute[] }`
+ * @deprecated since version 1.0.0. Route configuration is now handled by
+ * identity config services. This constant is kept for backwards compatibility
+ * but may be removed in future versions.
  */
 declare const IDENTITY_ROUTES: {
     routes: ABP.FullRoute[];
@@ -465,4 +485,4 @@ declare const IDENTITY_POLICIES: {
     readonly ROLES_DELETE: "AbpIdentity.Roles.Delete";
 };
 
-export { IDENTITY_POLICIES, IDENTITY_ROUTES, IDENTITY_ROUTE_PATHS, Identity, IdentityService, type RoleOperationResult, RolesComponent, type RolesComponentProps, type UseIdentityReturn, type UseRolesReturn, type UseUsersReturn, type UserOperationResult, UsersComponent, type UsersComponentProps, useIdentity, useRoles, useUsers };
+export { IDENTITY_POLICIES, IDENTITY_ROUTES, IDENTITY_ROUTE_PATHS, Identity, IdentityService, type PasswordRule, type RoleOperationResult, RolesComponent, type RolesComponentProps, type SortOrder, type UseIdentityReturn, type UseRolesReturn, type UseUsersReturn, type UserOperationResult, UsersComponent, type UsersComponentProps, useIdentity, useRoles, useUsers };

package/dist/index.d.ts

@@ -158,6 +158,11 @@ interface RoleOperationResult {
     success: boolean;
     error?: string;
 }
+/**
+ * Sort order type
+ * @since 1.0.0
+ */
+type SortOrder = 'asc' | 'desc' | '';
 /**
  * Return type for useRoles hook
  */
@@ -172,7 +177,11 @@ interface UseRolesReturn {
     isLoading: boolean;
     /** Error message if any */
     error: string | null;
-    /** Fetch all roles with optional pagination/filtering (v0.9.0) */
+    /** Current sort key @since 1.0.0 */
+    sortKey: string;
+    /** Current sort order @since 1.0.0 */
+    sortOrder: SortOrder;
+    /** Fetch all roles with optional pagination/filtering */
     fetchRoles: (params?: ABP.PageQueryParams) => Promise<RoleOperationResult>;
     /** Get a role by ID and set it as selected */
     getRoleById: (id: string) => Promise<RoleOperationResult>;
@@ -184,6 +193,10 @@ interface UseRolesReturn {
     deleteRole: (id: string) => Promise<RoleOperationResult>;
     /** Set the selected role */
     setSelectedRole: (role: Identity.RoleItem | null) => void;
+    /** Set sort key @since 1.0.0 */
+    setSortKey: (key: string) => void;
+    /** Set sort order @since 1.0.0 */
+    setSortOrder: (order: SortOrder) => void;
     /** Reset state */
     reset: () => void;
 }
@@ -252,6 +265,10 @@ interface UseUsersReturn {
     error: string | null;
     /** Current page query parameters */
     pageQuery: ABP.PageQueryParams;
+    /** Current sort key @since 1.0.0 */
+    sortKey: string;
+    /** Current sort order @since 1.0.0 */
+    sortOrder: SortOrder;
     /** Fetch users with pagination */
     fetchUsers: (params?: ABP.PageQueryParams) => Promise<UserOperationResult>;
     /** Get a user by ID and set it as selected */
@@ -268,6 +285,10 @@ interface UseUsersReturn {
     setSelectedUser: (user: Identity.UserItem | null) => void;
     /** Set page query parameters */
     setPageQuery: (query: ABP.PageQueryParams) => void;
+    /** Set sort key @since 1.0.0 */
+    setSortKey: (key: string) => void;
+    /** Set sort order @since 1.0.0 */
+    setSortOrder: (order: SortOrder) => void;
     /** Reset state */
     reset: () => void;
 }
@@ -388,6 +409,11 @@ interface RolesComponentProps {
  */
 declare function RolesComponent({ onRoleCreated, onRoleUpdated, onRoleDeleted, }: RolesComponentProps): React.ReactElement;
 
+/**
+ * Password rule type for validation display
+ * @since 1.1.0
+ */
+type PasswordRule = 'number' | 'small' | 'capital' | 'special';
 /**
  * Props for UsersComponent
  */
@@ -398,35 +424,29 @@ interface UsersComponentProps {
     onUserUpdated?: (user: Identity.UserItem) => void;
     /** Optional callback when a user is deleted */
     onUserDeleted?: (id: string) => void;
+    /**
+     * Password validation rules to display
+     * @since 1.1.0
+     */
+    passwordRulesArr?: PasswordRule[];
+    /**
+     * Required minimum password length
+     * @since 1.1.0
+     */
+    requiredPasswordLength?: number;
 }
-/**
- * UsersComponent - Component for managing users
- *
- * This is the React equivalent of Angular's UsersComponent.
- * It displays a table of users with CRUD operations, role assignment, and permission management.
- *
- * @example
- * ```tsx
- * function IdentityPage() {
- *   return (
- *     <UsersComponent
- *       onUserCreated={(user) => console.log('User created:', user)}
- *       onUserDeleted={(id) => console.log('User deleted:', id)}
- *     />
- *   );
- * }
- * ```
- */
-declare function UsersComponent({ onUserCreated, onUserUpdated, onUserDeleted, }: UsersComponentProps): React.ReactElement;
+declare function UsersComponent({ onUserCreated, onUserUpdated, onUserDeleted, passwordRulesArr, requiredPasswordLength, }: UsersComponentProps): React.ReactElement;
 
 /**
- * Identity module routes configuration (v0.9.0 format).
+ * Identity module routes configuration.
  * Translated from @abp/ng.identity IDENTITY_ROUTES.
  *
  * These routes define the navigation structure for the identity module
  * within the ABP Framework application.
  *
- * In v0.9.0, the format changed from `ABP.FullRoute[]` to `{ routes: ABP.FullRoute[] }`
+ * @deprecated since version 1.0.0. Route configuration is now handled by
+ * identity config services. This constant is kept for backwards compatibility
+ * but may be removed in future versions.
  */
 declare const IDENTITY_ROUTES: {
     routes: ABP.FullRoute[];
@@ -465,4 +485,4 @@ declare const IDENTITY_POLICIES: {
     readonly ROLES_DELETE: "AbpIdentity.Roles.Delete";
 };
 
-export { IDENTITY_POLICIES, IDENTITY_ROUTES, IDENTITY_ROUTE_PATHS, Identity, IdentityService, type RoleOperationResult, RolesComponent, type RolesComponentProps, type UseIdentityReturn, type UseRolesReturn, type UseUsersReturn, type UserOperationResult, UsersComponent, type UsersComponentProps, useIdentity, useRoles, useUsers };
+export { IDENTITY_POLICIES, IDENTITY_ROUTES, IDENTITY_ROUTE_PATHS, Identity, IdentityService, type PasswordRule, type RoleOperationResult, RolesComponent, type RolesComponentProps, type SortOrder, type UseIdentityReturn, type UseRolesReturn, type UseUsersReturn, type UserOperationResult, UsersComponent, type UsersComponentProps, useIdentity, useRoles, useUsers };

package/dist/index.js

@@ -185,6 +185,8 @@ function useRoles() {
   const [selectedRole, setSelectedRole] = (0, import_react.useState)(null);
   const [isLoading, setIsLoading] = (0, import_react.useState)(false);
   const [error, setError] = (0, import_react.useState)(null);
+  const [sortKey, setSortKey] = (0, import_react.useState)("name");
+  const [sortOrder, setSortOrder] = (0, import_react.useState)("");
   const fetchRoles = (0, import_react.useCallback)(async (params) => {
     setIsLoading(true);
     setError(null);
@@ -283,12 +285,16 @@ function useRoles() {
     selectedRole,
     isLoading,
     error,
+    sortKey,
+    sortOrder,
     fetchRoles,
     getRoleById,
     createRole,
     updateRole,
     deleteRole,
     setSelectedRole,
+    setSortKey,
+    setSortOrder,
     reset
   };
 }
@@ -311,6 +317,8 @@ function useUsers() {
   const [isLoading, setIsLoading] = (0, import_react2.useState)(false);
   const [error, setError] = (0, import_react2.useState)(null);
   const [pageQuery, setPageQuery] = (0, import_react2.useState)(DEFAULT_PAGE_QUERY);
+  const [sortKey, setSortKey] = (0, import_react2.useState)("userName");
+  const [sortOrder, setSortOrder] = (0, import_react2.useState)("");
   const fetchUsers = (0, import_react2.useCallback)(
     async (params) => {
       setIsLoading(true);
@@ -435,6 +443,8 @@ function useUsers() {
     isLoading,
     error,
     pageQuery,
+    sortKey,
+    sortOrder,
     fetchUsers,
     getUserById,
     getUserRoles,
@@ -443,6 +453,8 @@ function useUsers() {
     deleteUser,
     setSelectedUser,
     setPageQuery,
+    setSortKey,
+    setSortOrder,
     reset
   };
 }
@@ -721,10 +733,26 @@ var DEFAULT_FORM_STATE2 = {
   twoFactorEnabled: true,
   roleNames: []
 };
+function getPasswordRuleLabel(rule, t) {
+  switch (rule) {
+    case "number":
+      return t("AbpIdentity::Password:RequireDigit");
+    case "small":
+      return t("AbpIdentity::Password:RequireLowercase");
+    case "capital":
+      return t("AbpIdentity::Password:RequireUppercase");
+    case "special":
+      return t("AbpIdentity::Password:RequireNonAlphanumeric");
+    default:
+      return rule;
+  }
+}
 function UsersComponent({
   onUserCreated,
   onUserUpdated,
-  onUserDeleted
+  onUserDeleted,
+  passwordRulesArr = [],
+  requiredPasswordLength = 0
 }) {
   const { t } = (0, import_core4.useLocalization)();
   const confirmation = (0, import_theme_shared2.useConfirmation)();
@@ -1020,17 +1048,26 @@ function UsersComponent({
                 }
               ) })
             ] }),
-            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_theme_shared2.FormField, { label: t("AbpIdentity::Password"), required: !selectedUser?.id, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-              import_react7.Input,
-              {
-                type: "password",
-                value: formState.password,
-                onChange: (e) => handleInputChange("password", e.target.value),
-                autoComplete: "new-password",
-                maxLength: 32,
-                placeholder: selectedUser?.id ? t("AbpIdentity::LeaveBlankToKeepCurrent") : ""
-              }
-            ) }),
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_theme_shared2.FormField, { label: t("AbpIdentity::Password"), required: !selectedUser?.id, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+                import_react7.Input,
+                {
+                  type: "password",
+                  value: formState.password,
+                  onChange: (e) => handleInputChange("password", e.target.value),
+                  autoComplete: "new-password",
+                  maxLength: 32,
+                  placeholder: selectedUser?.id ? t("AbpIdentity::LeaveBlankToKeepCurrent") : ""
+                }
+              ),
+              (requiredPasswordLength > 0 || passwordRulesArr.length > 0) && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_react7.Box, { mt: 2, fontSize: "sm", color: "gray.500", children: [
+                requiredPasswordLength > 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react7.Text, { children: t("AbpIdentity::Password:MinLength", String(requiredPasswordLength)) }),
+                passwordRulesArr.map((rule) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_react7.Text, { children: [
+                  "\u2022 ",
+                  getPasswordRuleLabel(rule, t)
+                ] }, rule))
+              ] })
+            ] }),
             /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_theme_shared2.FormField, { label: t("AbpIdentity::EmailAddress"), required: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
               import_react7.Input,
               {

package/dist/index.mjs

@@ -151,6 +151,8 @@ function useRoles() {
   const [selectedRole, setSelectedRole] = useState(null);
   const [isLoading, setIsLoading] = useState(false);
   const [error, setError] = useState(null);
+  const [sortKey, setSortKey] = useState("name");
+  const [sortOrder, setSortOrder] = useState("");
   const fetchRoles = useCallback(async (params) => {
     setIsLoading(true);
     setError(null);
@@ -249,12 +251,16 @@ function useRoles() {
     selectedRole,
     isLoading,
     error,
+    sortKey,
+    sortOrder,
     fetchRoles,
     getRoleById,
     createRole,
     updateRole,
     deleteRole,
     setSelectedRole,
+    setSortKey,
+    setSortOrder,
     reset
   };
 }
@@ -277,6 +283,8 @@ function useUsers() {
   const [isLoading, setIsLoading] = useState2(false);
   const [error, setError] = useState2(null);
   const [pageQuery, setPageQuery] = useState2(DEFAULT_PAGE_QUERY);
+  const [sortKey, setSortKey] = useState2("userName");
+  const [sortOrder, setSortOrder] = useState2("");
   const fetchUsers = useCallback2(
     async (params) => {
       setIsLoading(true);
@@ -401,6 +409,8 @@ function useUsers() {
     isLoading,
     error,
     pageQuery,
+    sortKey,
+    sortOrder,
     fetchUsers,
     getUserById,
     getUserRoles,
@@ -409,6 +419,8 @@ function useUsers() {
     deleteUser,
     setSelectedUser,
     setPageQuery,
+    setSortKey,
+    setSortOrder,
     reset
   };
 }
@@ -707,10 +719,26 @@ var DEFAULT_FORM_STATE2 = {
   twoFactorEnabled: true,
   roleNames: []
 };
+function getPasswordRuleLabel(rule, t) {
+  switch (rule) {
+    case "number":
+      return t("AbpIdentity::Password:RequireDigit");
+    case "small":
+      return t("AbpIdentity::Password:RequireLowercase");
+    case "capital":
+      return t("AbpIdentity::Password:RequireUppercase");
+    case "special":
+      return t("AbpIdentity::Password:RequireNonAlphanumeric");
+    default:
+      return rule;
+  }
+}
 function UsersComponent({
   onUserCreated,
   onUserUpdated,
-  onUserDeleted
+  onUserDeleted,
+  passwordRulesArr = [],
+  requiredPasswordLength = 0
 }) {
   const { t } = useLocalization2();
   const confirmation = useConfirmation2();
@@ -1006,17 +1034,26 @@ function UsersComponent({
                 }
               ) })
             ] }),
-            /* @__PURE__ */ jsx2(FormField2, { label: t("AbpIdentity::Password"), required: !selectedUser?.id, children: /* @__PURE__ */ jsx2(
-              Input2,
-              {
-                type: "password",
-                value: formState.password,
-                onChange: (e) => handleInputChange("password", e.target.value),
-                autoComplete: "new-password",
-                maxLength: 32,
-                placeholder: selectedUser?.id ? t("AbpIdentity::LeaveBlankToKeepCurrent") : ""
-              }
-            ) }),
+            /* @__PURE__ */ jsxs2(FormField2, { label: t("AbpIdentity::Password"), required: !selectedUser?.id, children: [
+              /* @__PURE__ */ jsx2(
+                Input2,
+                {
+                  type: "password",
+                  value: formState.password,
+                  onChange: (e) => handleInputChange("password", e.target.value),
+                  autoComplete: "new-password",
+                  maxLength: 32,
+                  placeholder: selectedUser?.id ? t("AbpIdentity::LeaveBlankToKeepCurrent") : ""
+                }
+              ),
+              (requiredPasswordLength > 0 || passwordRulesArr.length > 0) && /* @__PURE__ */ jsxs2(Box2, { mt: 2, fontSize: "sm", color: "gray.500", children: [
+                requiredPasswordLength > 0 && /* @__PURE__ */ jsx2(Text2, { children: t("AbpIdentity::Password:MinLength", String(requiredPasswordLength)) }),
+                passwordRulesArr.map((rule) => /* @__PURE__ */ jsxs2(Text2, { children: [
+                  "\u2022 ",
+                  getPasswordRuleLabel(rule, t)
+                ] }, rule))
+              ] })
+            ] }),
             /* @__PURE__ */ jsx2(FormField2, { label: t("AbpIdentity::EmailAddress"), required: true, children: /* @__PURE__ */ jsx2(
               Input2,
               {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abpjs/identity",
-  "version": "0.9.0",
+  "version": "1.1.0",
   "description": "ABP Framework identity components for React - translated from @abp/ng.identity",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -25,9 +25,9 @@
   "dependencies": {
     "@chakra-ui/react": "^3.2.0",
     "@emotion/react": "^11.11.0",
-    "@abpjs/core": "0.9.0",
-    "@abpjs/permission-management": "0.9.0",
-    "@abpjs/theme-shared": "0.9.0"
+    "@abpjs/core": "1.1.0",
+    "@abpjs/permission-management": "1.1.0",
+    "@abpjs/theme-shared": "1.1.0"
   },
   "devDependencies": {
     "@abp/ng.identity": "0.9.0",
@@ -52,7 +52,8 @@
     "tailwindcss": "^3.4.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "vitest": "^1.0.0"
+    "vitest": "^1.0.0",
+    "@vitest/coverage-v8": "^1.0.0"
   },
   "author": "tekthar.com",
   "license": "LGPL-3.0",
@@ -61,7 +62,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/abpjs/abp-react"
+    "url": "https://github.com/abpjs/abp-react",
+    "directory": "packages/identity"
   },
   "homepage": "https://docs.abpjs.io/docs/packages/identity/overview",
   "bugs": {
@@ -80,6 +82,7 @@
     "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
     "type-check": "tsc --noEmit",
-    "test": "vitest"
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }