Release Notes

v2.9.0

February 2026

New Features

Organization Unit Management

Full support for ABP's organization unit hierarchy:

import { OrganizationUnitService } from '@abpjs/identity-pro';
import { RestService } from '@abpjs/core';

const restService = new RestService();
const orgUnitService = new OrganizationUnitService(restService);

// Get all organization units
const units = await orgUnitService.getListByInput({
  maxResultCount: 100,
  skipCount: 0,
});

// Create a new organization unit
const newUnit = await orgUnitService.createByInput({
  displayName: 'Engineering',
  parentId: null, // Root level
});

// Create a child unit
const childUnit = await orgUnitService.createByInput({
  displayName: 'Frontend Team',
  parentId: newUnit.id,
});

// Move an organization unit to a new parent
await orgUnitService.moveByIdAndInput(
  { newParentId: anotherUnitId },
  childUnit.id
);

// Add members to an organization unit
await orgUnitService.addMembersByIdAndInput(
  { userIds: ['user-id-1', 'user-id-2'] },
  newUnit.id
);

// Add roles to an organization unit
await orgUnitService.addRolesByIdAndInput(
  { roleIds: ['role-id-1'] },
  newUnit.id
);

// Get members of an organization unit
const members = await orgUnitService.getMembersById(
  { maxResultCount: 10, skipCount: 0 },
  newUnit.id
);

// Get roles of an organization unit
const roles = await orgUnitService.getRolesById(
  { maxResultCount: 10, skipCount: 0 },
  newUnit.id
);

// Remove a member from an organization unit
await orgUnitService.removeMemberByIdAndMemberId(newUnit.id, 'user-id-1');

// Remove a role from an organization unit
await orgUnitService.removeRoleByIdAndRoleId(newUnit.id, 'role-id-1');

// Delete an organization unit
await orgUnitService.deleteById(childUnit.id);

TreeAdapter Utility

New utility for converting flat lists into tree structures, useful for rendering organization unit hierarchies:

import { TreeAdapter, TreeNode, BaseNode } from '@abpjs/identity-pro';

// Works with any entity implementing BaseNode interface
interface MyNode extends BaseNode {
  id: string;
  parentId: string | null;
  displayName: string;
}

// Create adapter from flat list
const units = await orgUnitService.getListByInput();
const adapter = new TreeAdapter(units.items);

// Get tree structure for rendering
const tree = adapter.getTree(); // Returns TreeNode<OrganizationUnitWithDetailsDto>[]

// Find a specific node
const node = adapter.getNodeById('some-id');

// Expand/collapse operations
adapter.expandAll();
adapter.collapseAll();
adapter.expandPathToNode('target-node-id'); // Expands all ancestors

// Get expanded keys (useful for controlled tree components)
const expandedKeys = adapter.getExpandedKeys();
adapter.setExpandedKeys(['id-1', 'id-2']);

// Handle drag-and-drop
adapter.handleDrop(droppedNode);

// Handle removal
adapter.handleRemove(nodeToRemove);

// Custom name resolver
const adapterWithResolver = new TreeAdapter(units.items, (unit) => {
  return `${unit.displayName} (${unit.memberCount} members)`;
});

User Organization Units

Users can now be assigned to organization units:

import { IdentityService } from '@abpjs/identity-pro';

const identityService = new IdentityService(restService);

// Get organization units for a user
const userOrgUnits = await identityService.getUserOrganizationUnits(userId);

// Create/update user with organization unit assignments
await identityService.createUser({
  userName: 'john',
  email: 'john@example.com',
  password: 'SecurePassword123!',
  roleNames: ['Manager'],
  organizationUnitIds: ['org-unit-id-1', 'org-unit-id-2'], // New in v2.9.0
});

New Models

Model	Description
OrganizationUnitWithDetailsDto	Organization unit with member/role counts
OrganizationUnitCreateDto	DTO for creating organization units
OrganizationUnitUpdateDto	DTO for updating organization units
OrganizationUnitMoveInput	Input for moving units in hierarchy
OrganizationUnitRoleInput	Input for adding roles to units
OrganizationUnitUserInput	Input for adding members to units
GetOrganizationUnitInput	Query parameters for listing units

New Components

Added to eIdentityComponents:

import { eIdentityComponents } from '@abpjs/identity-pro';

eIdentityComponents.OrganizationUnits    // 'Identity.OrganizationUnitsComponent'
eIdentityComponents.OrganizationMembers  // 'Identity.OrganizationMembersComponent'
eIdentityComponents.OrganizationRoles    // 'Identity.OrganizationRolesComponent'

New Route Names

Added to eIdentityRouteNames:

import { eIdentityRouteNames } from '@abpjs/identity-pro';

eIdentityRouteNames.OrganizationUnits  // 'AbpIdentity::OrganizationUnits'

State Updates

• Identity.State.organizationUnits - New state property for cached organization units
• Identity.UserSaveRequest.organizationUnitIds - Array of organization unit IDs for user assignment

---

v2.7.0

February 2026

New Features

Admin Change Password

New method to change a user's password as an admin:

import { useIdentityService } from '@abpjs/identity-pro';

function AdminPasswordReset() {
  const identityService = useIdentityService();

  const resetPassword = async (userId: string, newPassword: string) => {
    await identityService.changePassword(userId, { newPassword });
  };
}

Route Names

New constants for identity pro route names (localization keys):

import { eIdentityRouteNames } from '@abpjs/identity-pro';

// Available route names:
// eIdentityRouteNames.Administration = 'AbpUiNavigation::Menu:Administration'
// eIdentityRouteNames.IdentityManagement = 'AbpIdentity::Menu:IdentityManagement'
// eIdentityRouteNames.Roles = 'AbpIdentity::Roles'
// eIdentityRouteNames.Users = 'AbpIdentity::Users'
// eIdentityRouteNames.ClaimTypes = 'AbpIdentity::ClaimTypes'

API Changes

• eIdentityComponents - Changed from TypeScript enum to const object for better tree-shaking and type inference:

  // Before (v2.4.0)
  enum eIdentityComponents {
    Claims = 'Identity.ClaimsComponent',
    // ...
  }
  
  // After (v2.7.0)
  const eIdentityComponents = {
    Claims: 'Identity.ClaimsComponent',
    // ...
  } as const;

New Exports

• IdentityService.changePassword(id, body) - Admin method to change user password
• Identity.ChangePasswordRequest - Interface for password change request
• eIdentityRouteNames - Constants for route names (localization keys)
• IdentityRouteNameKey - Type for identity route name values
• IdentityComponentKey - Type for identity component key values

---

v2.4.0

February 2026

New Features

• IdentityService.apiName property - New property for REST API configuration. Defaults to 'default'.

• getAllRoles() method - New method to fetch all roles without pagination:

  import { useIdentityService } from '@abpjs/identity-pro';
  
  function RoleSelector() {
    const identityService = useIdentityService();
    const [roles, setRoles] = useState<Identity.RoleItem[]>([]);
  
    useEffect(() => {
      // Fetch all roles without pagination (calls /api/identity/roles/all)
      identityService.getAllRoles().then((response) => {
        setRoles(response.items);
      });
    }, []);
  
    return (
      <select>
        {roles.map((role) => (
          <option key={role.id} value={role.id}>
            {role.name}
          </option>
        ))}
      </select>
    );
  }

• eIdentityComponents enum - New enum for component identifiers, useful for component registration and customization:

  import { eIdentityComponents } from '@abpjs/identity-pro';
  
  // Available components:
  // eIdentityComponents.Claims = 'Identity.ClaimsComponent'
  // eIdentityComponents.Roles = 'Identity.RolesComponent'
  // eIdentityComponents.Users = 'Identity.UsersComponent'

---

v2.2.0

February 2026

New Features

• User Unlock - Added unlockUser(id) method to IdentityService and useUsers hook for unlocking locked out users
• Permissions Modal State - Added built-in permissions modal state management to useRoles and useUsers hooks:
  • visiblePermissions - Boolean state for modal visibility
  • permissionsProviderKey - Provider key for the permissions modal
  • onVisiblePermissionsChange(value) - Callback to handle modal visibility changes
  • openPermissionsModal(providerKey) - Method to open permissions modal for a specific entity

---

v2.1.1

February 2026

• Version alignment with @abpjs/core

---

v2.0.0

January 2026

New Features

• IdentityStateService - New state service for programmatic identity operations with 17 dispatch methods:

  Role Operations:

  • dispatchGetRoles(params?) - Fetch roles and update internal state
  • dispatchGetRoleById(id) - Fetch a single role by ID
  • dispatchCreateRole(body) - Create a new role
  • dispatchUpdateRole(id, body) - Update an existing role
  • dispatchDeleteRole(id) - Delete a role

  User Operations:

  • dispatchGetUsers(params?) - Fetch users and update internal state
  • dispatchGetUserById(id) - Fetch a single user by ID
  • dispatchCreateUser(body) - Create a new user
  • dispatchUpdateUser(id, body) - Update an existing user
  • dispatchDeleteUser(id) - Delete a user
  • dispatchGetUserRoles(id) - Get roles assigned to a user

  Claim Type Operations (Pro):

  • dispatchGetClaimTypes(params?) - Fetch claim types and update internal state
  • dispatchGetClaimTypeById(id) - Fetch a single claim type by ID
  • dispatchCreateClaimType(body) - Create a new claim type
  • dispatchUpdateClaimType(body) - Update an existing claim type
  • dispatchDeleteClaimType(id) - Delete a claim type
  • dispatchGetClaimTypeNames() - Get all claim type names

  State Getter Methods:

  • getRoles() / getRolesTotalCount() - Access cached roles
  • getUsers() / getUsersTotalCount() - Access cached users
  • getClaimTypes() / getClaimTypesTotalCount() - Access cached claim types
  • getClaimTypeNames() - Access cached claim type names

Example

import { IdentityStateService } from '@abpjs/identity-pro';
import { RestService } from '@abpjs/core';

const restService = new RestService();
const stateService = new IdentityStateService(restService);

// Fetch and manage roles
await stateService.dispatchGetRoles({ maxResultCount: 10 });
const roles = stateService.getRoles();
console.log(`Found ${stateService.getRolesTotalCount()} roles`);

// Create a new role
await stateService.dispatchCreateRole({
  name: 'Manager',
  isDefault: false,
  isPublic: true,
});

// Fetch and manage users
await stateService.dispatchGetUsers({ filter: 'admin' });
const users = stateService.getUsers();

// Fetch claim types (Pro feature)
await stateService.dispatchGetClaimTypes();
const claimTypes = stateService.getClaimTypes();

---

v1.0.0

January 2026

• Version alignment with @abpjs/core v1.0.0

---

v0.7.2 (Initial Release)

Components

• RolesComponent - Full role management UI with CRUD operations and permissions
• UsersComponent - Complete user management with role assignment and settings
• ClaimsComponent - Claim type management UI (Pro feature)
• ClaimModal - Reusable modal for managing user/role claims (Pro feature)

Hooks

• useRoles - State management for roles with pagination, sorting, and CRUD operations
• useUsers - State management for users with pagination, sorting, and CRUD operations
• useIdentity - Combined hook for roles and users management
• useClaims - State management for claim types and user/role claims (Pro feature)

Services

• IdentityService with comprehensive methods:
  • Role operations: getRoles, getRoleById, createRole, updateRole, deleteRole
  • User operations: getUsers, getUserById, getUserRoles, createUser, updateUser, deleteUser
  • Claim type operations: getClaimTypeNames, getClaimTypes, getClaimTypeById, createClaimType, updateClaimType, deleteClaimType (Pro)
  • User/Role claims: getClaims, updateClaims (Pro)

Constants

• IDENTITY_ROUTES - Pre-configured route definitions
• IDENTITY_ROUTE_PATHS - Route path constants for navigation
• IDENTITY_POLICIES - Required policy constants for authorization

TypeScript

• Identity namespace with all types:
  • RoleItem, RoleSaveRequest, RoleResponse
  • User, UserItem, UserSaveRequest, UserResponse
  • ClaimType, ClaimTypeName, ClaimRequest, ClaimResponse (Pro)
  • ClaimValueType enum (Pro)
  • State interface for state management