mesauth-angular 1.9.1 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mesauth-angular",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Angular helper library to connect to a backend API and SignalR hub to surface the current logged-in user and incoming notifications with dark/light theme support",
   "keywords": [
     "angular",

package/types/mesauth-angular.d.ts

@@ -52,6 +52,11 @@ interface IUser {
     perms?: Set<string>;
     employeeCode?: string;
     avatarPath?: string;
+    avatarShape?: 'circle' | 'rounded' | 'rectangle' | 'portrait';
+    avatarFrame?: string | null;
+    avatarSize?: 'sm' | 'md' | 'lg';
+    avatarRatio?: 'ar-11' | 'ar-43' | 'ar-169';
+    avatarStyleAllowed?: boolean;
     loginMethod?: number;
     hrFullNameVn?: string;
     hrFullNameEn?: string;
@@ -145,6 +150,7 @@ declare class MesAuthService {
     /** _ngZone accepted but ignored - not needed in zoneless apps. */
     init(config: MesAuthConfig, httpClient: HttpClient, router?: Router, _ngZone?: unknown): void;
     private injectThemeStylesheet;
+    private updateThemeStylesheetVersion;
     getConfig(): MesAuthConfig | null;
     private fetchCurrentUser;
     getUnreadCount(): Observable<any>;
@@ -168,6 +174,16 @@ declare class MesAuthService {
      * Callers can subscribe to wait for completion before proceeding (e.g., navigating after login).
      */
     refreshUser(): Observable<any>;
+    getAvatarStyle(): Observable<{
+        data: string;
+        allowedActions: string[];
+    }>;
+    updateAvatarStyle(avatarShape: string | null, avatarFrame: string | null, avatarSize: string | null, avatarRatio: string | null): Observable<{
+        avatarShape: string | null;
+        avatarFrame: string | null;
+        avatarSize: string | null;
+        avatarRatio: string | null;
+    }>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MesAuthService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MesAuthService>;
 }
@@ -185,6 +201,33 @@ declare class MesAuthModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<MesAuthModule>;
 }
 
+type AvatarSize = 'sm' | 'md' | 'lg' | 'xl';
+type AvatarShape = 'circle' | 'rounded' | 'rectangle' | 'portrait';
+interface AvatarFrameDef {
+    id: string;
+    label: string;
+}
+declare const AVATAR_FRAMES: ReadonlyArray<AvatarFrameDef>;
+declare class MaAvatarComponent {
+    src: _angular_core.InputSignal<string>;
+    alt: _angular_core.InputSignal<string>;
+    initials: _angular_core.InputSignal<string>;
+    size: _angular_core.InputSignal<AvatarSize>;
+    shape: _angular_core.InputSignal<AvatarShape>;
+    frame: _angular_core.InputSignal<string>;
+    ratio: _angular_core.InputSignal<string>;
+    scale: _angular_core.InputSignal<number>;
+    private themeService;
+    get themeClass(): string;
+    readonly wrapperClass: _angular_core.Signal<string>;
+    readonly wrapperStyle: _angular_core.Signal<{
+        '--avatar-scale': number;
+    }>;
+    readonly showImage: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaAvatarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaAvatarComponent, "ma-avatar", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "ratio": { "alias": "ratio"; "required": false; "isSignal": true; }; "scale": { "alias": "scale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class UserProfileComponent {
     notificationClick: _angular_core.OutputEmitterRef<void>;
     approvalClick: _angular_core.OutputEmitterRef<void>;
@@ -194,6 +237,11 @@ declare class UserProfileComponent {
     readonly pendingApprovalCount: _angular_core.WritableSignal<number>;
     readonly dropdownOpen: _angular_core.WritableSignal<boolean>;
     readonly avatarRefresh: _angular_core.WritableSignal<number>;
+    readonly navAvatarSize: _angular_core.Signal<AvatarSize>;
+    readonly dropAvatarSize: _angular_core.Signal<AvatarSize>;
+    readonly avatarShape: _angular_core.Signal<"circle" | "rounded" | "rectangle" | "portrait">;
+    readonly avatarFrame: _angular_core.Signal<string>;
+    readonly avatarRatio: _angular_core.Signal<"ar-11" | "ar-43" | "ar-169">;
     private readonly authService;
     private readonly router;
     private readonly themeService;
@@ -686,6 +734,8 @@ interface MaUiManifest {
     /** Feature flags read by components at runtime. */
     features?: Record<string, boolean>;
 }
+/** Current installed package version — keep in sync with package.json. */
+declare const PACKAGE_VERSION = "1.10.0";
 /**
  * Provides server-driven UI configuration loaded from the hosted manifest.
  * Components read `labels()` and `features()` signals instead of hardcoded strings.
@@ -696,12 +746,15 @@ declare class MaUiConfigService {
     private _labels;
     private _features;
     private _updateRequired;
+    private _manifestVersion;
     /** Reactive map of UI string overrides from the server manifest. */
     readonly labels: _angular_core.Signal<Record<string, string>>;
     /** Reactive map of feature flags from the server manifest. */
     readonly features: _angular_core.Signal<Record<string, boolean>>;
     /** True when the server signals that a package upgrade is needed. */
     readonly updateRequired: _angular_core.Signal<boolean>;
+    /** The manifest version string loaded from the server, or null if not yet loaded. */
+    readonly manifestVersion: _angular_core.Signal<string>;
     /**
      * Returns a label by key, falling back to `defaultValue` when the server
      * manifest has not provided an override.
@@ -768,5 +821,5 @@ declare class MaThemeDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MaThemeDirective, "[maTheme]", never, {}, {}, never, never, true, never>;
 }
 
-export { ALL_ACTIONS, ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, MES_AUTH_CONFIG, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, MaIconComponent, MaThemeDirective, MaUiConfigService, MaUserComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, extractXMaPerm, mesAuthInterceptor, provideMesAuth, withXMaPerm, xMaResource };
-export type { ApprovalDashboardDto, ApprovalDocumentDto, ApprovalDocumentSummaryDto, ApprovalHistoryDto, ApprovalReferenceDto, ApprovalStepDto, ApprovalStepRequest, ApprovalSubmitResult, ApprovalTemplateDto, ApprovalTemplateStepDto, ApprovalTemplateSummaryDto, ApproveRejectRequest, CreateApprovalRequest, CreateApprovalResponseDto, CreateApprovalTemplateRequest, DelegateRequest, FrontEndRoute, IUser, MaUiManifest, MesAuthConfig, NotificationDto, PagedList, PermissionHeader, RealTimeNotificationDto, RequestConfig, RolePreviewUserDto, StepRoleDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };
+export { ALL_ACTIONS, AVATAR_FRAMES, ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, MES_AUTH_CONFIG, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, MaAvatarComponent, MaIconComponent, MaThemeDirective, MaUiConfigService, MaUserComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, PACKAGE_VERSION, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, extractXMaPerm, mesAuthInterceptor, provideMesAuth, withXMaPerm, xMaResource };
+export type { ApprovalDashboardDto, ApprovalDocumentDto, ApprovalDocumentSummaryDto, ApprovalHistoryDto, ApprovalReferenceDto, ApprovalStepDto, ApprovalStepRequest, ApprovalSubmitResult, ApprovalTemplateDto, ApprovalTemplateStepDto, ApprovalTemplateSummaryDto, ApproveRejectRequest, AvatarFrameDef, AvatarShape, AvatarSize, CreateApprovalRequest, CreateApprovalResponseDto, CreateApprovalTemplateRequest, DelegateRequest, FrontEndRoute, IUser, MaUiManifest, MesAuthConfig, NotificationDto, PagedList, PermissionHeader, RealTimeNotificationDto, RequestConfig, RolePreviewUserDto, StepRoleDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };