Skip to main content
Version: 4.0.0

v3.2.0

Release Date: February 2026

This release is a major feature drop introducing typed proxy services across nearly all packages, a new file management package, CLI proxy code generation, replaceable components, and many new utilities in core. Most packages now include proxy services and DTOs that provide full type safety when communicating with ABP backend APIs.

Highlights​

  • Proxy Services & DTOs - Typed proxy services and DTO models across identity, tenant-management, permission-management, feature-management, audit-logging, language-management, saas, text-template-management, and more
  • New Package: @abpjs/file-management - File and directory management with FileDescriptorService and DirectoryDescriptorService
  • CLI Proxy Generation - @abpjs/schematics now includes abpjs CLI tool for generating typed proxy code from a running ABP backend
  • ReplaceableComponentsService - New service-based component replacement system in @abpjs/core (deprecating the action-based approach)
  • Custom Tree Node Templates - @abpjs/components Tree now supports custom node and icon templates
  • Profile & 2FA Services - New ProfileService in @abpjs/account-pro for profile pictures and two-factor authentication

Breaking Changes​

@abpjs/account​

  • RegisterResponse.twoFactorEnabled removed - This property has been removed from the registration response. Fetch 2FA status separately from the user's profile or settings.

New Package​

@abpjs/file-management​

New package providing file and directory management services for ABP React applications.

import { FileDescriptorService, DirectoryDescriptorService } from '@abpjs/file-management';

const fileService = new FileDescriptorService(restService);
const dirService = new DirectoryDescriptorService(restService);

// File operations
const files = await fileService.getList('directory-id');
await fileService.create({ directoryId: 'dir-id', name: 'doc.pdf', mimeType: 'application/pdf', content: bytes });

// Directory operations
const children = await dirService.getList('parent-id');
await dirService.create({ parentId: 'root-id', name: 'New Folder' });

Includes route providers, policy names, component keys, and proxy DTOs. See: File Management Overview

New Features​

@abpjs/core​

  • ReplaceableComponentsService - New service for managing replaceable components with add(), remove(), getComponent(), onUpdate() methods
  • useReplaceableComponent(key, defaultComponent) hook - React hook for using replaceable components
  • ApplicationConfiguration.CurrentUser new fields - emailVerified, name, surName, phoneNumber, phoneNumberVerified
  • InternalStore<State> - Lightweight state management class with patch(), sliceState(), subscribe(), reset()
  • downloadBlob(blob, filename) - Utility for downloading blobs as files
  • interpolate(text, params) - String parameter substitution
  • reloadRoute() - Reload the current route
  • oAuthStorage / clearOAuthStorage() - OAuth storage management utilities
  • LocalizationService.getResource() - Get an entire localization resource
  • ConfigStateService.getLocalizationResource() - Get localization resources from config state
  • DeepPartial<T> - New utility type for deep partial objects

@abpjs/components​

  • Custom Node Templates - Tree component supports customNodeTemplate and expandedIconTemplate props
  • TreeAdapter update methods - New handleUpdate() and updateTreeFromList() methods

@abpjs/schematics​

  • CLI Proxy Generation - proxy-add, proxy-refresh, proxy-remove commands for generating typed proxy code
  • React Query Hook Generation - Auto-generated useQuery / useMutation hooks for each service
  • Updated PROXY_WARNING - Now includes guidance for npm module publishing

@abpjs/account-pro​

  • ProfileService - Profile pictures (get/set with Gravatar or custom image) and two-factor authentication management
  • ManageProfileTabsService - Service for managing profile tabs in the Manage Profile page
  • ProfilePictureType enum - Gravatar, Image
  • eTwoFactorBehaviour enum - Two-factor authentication behavior options

Proxy Services (across multiple packages)​

New typed proxy services providing full type safety for ABP backend API calls:

PackageProxy Services
@abpjs/identityIdentityRoleService, IdentityUserService, IdentityUserLookupService, ProfileService
@abpjs/identity-proIdentityRoleService, IdentityUserService, IdentityClaimTypeService, + more
@abpjs/tenant-managementTenantService (CRUD + connection string management)
@abpjs/permission-managementPermissionsService (get/update permissions by provider)
@abpjs/feature-managementFeaturesService (get/update features by provider)
@abpjs/audit-loggingAuditLogsService (logs + statistics)
@abpjs/language-managementLanguageService, LanguageTextService
@abpjs/saasTenantService, EditionService
@abpjs/text-template-managementTemplateDefinitionService, TemplateContentService

@abpjs/theme-shared​

  • Datatable scroll CSS fix - New .datatable-scroll styles in DEFAULT_STYLES for horizontal scroll issues

@abpjs/theme-basic​

  • Loading overlay opacity reduced - .abp-loading background opacity reduced from 0.1 to 0.05 for a more subtle loading experience

Deprecations​

@abpjs/core​

  • AddReplaceableComponent action - Use ReplaceableComponentsService.add() instead
  • ReplaceableComponentsState - Use ReplaceableComponentsService instead

Legacy types deprecated across proxy packages​

Many packages deprecate legacy model types in favor of new proxy DTOs. See individual package release notes for full deprecation tables. Legacy types will be removed in v5.0.

Packages​

PackageVersionChanges
@abpjs/core3.2.0ReplaceableComponentsService, InternalStore, CurrentUser fields, file/string/OAuth utilities
@abpjs/theme-shared3.2.0Datatable scroll CSS fix
@abpjs/theme-basic3.2.0Loading overlay opacity reduced
@abpjs/account3.2.0Breaking: RegisterResponse.twoFactorEnabled removed
@abpjs/account-pro3.2.0ProfileService, ManageProfileTabsService, ProfilePictureType, eTwoFactorBehaviour
@abpjs/identity3.2.0Proxy services: IdentityRoleService, IdentityUserService, IdentityUserLookupService, ProfileService
@abpjs/identity-pro3.2.0Multiple proxy services, IdentityClaimValueType enum, eTwoFactorBehaviour
@abpjs/feature-management3.2.0FeaturesService proxy, ValueTypes enum, IStringValueType
@abpjs/permission-management3.2.0PermissionsService proxy, PermissionWithStyle type
@abpjs/setting-management3.2.0Version alignment
@abpjs/tenant-management3.2.0TenantService proxy with connection string management
@abpjs/components3.2.0Custom node templates, TreeAdapter update methods
@abpjs/schematics3.2.0CLI proxy generation, React Query hooks, EJS templates
@abpjs/file-management3.2.0New package - FileDescriptorService, DirectoryDescriptorService
@abpjs/audit-logging3.2.0AuditLogsService proxy with statistics
@abpjs/language-management3.2.0LanguageService, LanguageTextService proxies
@abpjs/saas3.2.0TenantService, EditionService proxies
@abpjs/text-template-management3.2.0TemplateDefinitionService, TemplateContentService proxies
@abpjs/chat3.2.0Version alignment

Upgrade​

Free Packages​

npm install @abpjs/core@3.2.0 @abpjs/theme-shared@3.2.0 @abpjs/theme-basic@3.2.0 @abpjs/account@3.2.0 @abpjs/identity@3.2.0 @abpjs/feature-management@3.2.0 @abpjs/permission-management@3.2.0 @abpjs/setting-management@3.2.0 @abpjs/tenant-management@3.2.0 @abpjs/components@3.2.0 @abpjs/schematics@3.2.0

Pro Packages​

npm install @abpjs/account-pro@3.2.0 @abpjs/audit-logging@3.2.0 @abpjs/chat@3.2.0 @abpjs/identity-pro@3.2.0 @abpjs/language-management@3.2.0 @abpjs/saas@3.2.0 @abpjs/text-template-management@3.2.0 @abpjs/file-management@3.2.0

See Also​