@kuzntsv/uikit 1.0.13 → 1.0.16

package/types/kuzntsv-uikit.d.ts

@@ -2,6 +2,7 @@ import * as i0 from '@angular/core';
 import { InjectionToken } from '@angular/core';
 import { HttpContextToken } from '@angular/common/http';
 import * as rxjs from 'rxjs';
+import { Observable } from 'rxjs';
 
 interface UikitConfig {
     apiUrls: {
@@ -19,6 +20,16 @@ interface UikitConfig {
 }
 declare const UIKIT_CONFIG: InjectionToken<UikitConfig>;
 
+/**
+ * Специальный маркер-роль в массиве ограничений,
+ * который полностью скрывает элемент от обычных пользователей.
+ */
+declare const HIDE_ROLE_MARKER = "HIDE";
+/**
+ * Системная роль Администратора, которая игнорирует любые ограничения прав.
+ */
+declare const ADMIN_ROLE = "ADMIN";
+
 declare const API_NAME: HttpContextToken<string>;
 declare const BYPASS_AUTH: HttpContextToken<boolean>;
 declare const DEFAULT_TIMEOUT: InjectionToken<number>;
@@ -35,47 +46,50 @@ interface AppEnvironment {
 }
 declare const APP_ENVIRONMENT: InjectionToken<AppEnvironment>;
 
+/**
+   * Сервис уведомлений.
+   */
 interface INotificationService {
     /**
-     * Показ всплывашки с сообщением
+     * Показ всплывашки с сообщением.
      *
-     * @param message сообщение
-     * @param duration задержка в миллисекундах
+     * @param message сообщение.
+     * @param duration задержка в миллисекундах.
      */
     openSnackBar(message: string, action: string, duration?: number): void;
     /**
-     * Уведомление о успехе
+     * Уведомление о успехе.
      *
      * @param message сообщение
      * @param duration задержка в миллисекундах
      */
     success(message: string, duration?: number): void;
     /**
-     * Уведомление о информации
+     * Уведомление о информации.
      *
-     * @param message сообщение
-     * @param duration задержка в миллисекундах
+     * @param message сообщение.
+     * @param duration задержка в миллисекундах.
      */
     info(message: string, duration?: number): void;
     /**
-     * Уведомление о сообщения помощи
+     * Уведомление о сообщения помощи.
      *
-     * @param message сообщение
-     * @param duration задержка в миллисекундах
+     * @param message сообщение.
+     * @param duration задержка в миллисекундах.
      */
     helper(message: string, duration?: number): void;
     /**
-     * Уведомление о предупреждении
+     * Уведомление о предупреждении.
      *
-     * @param message сообщение
-     * @param duration задержка в миллисекундах
+     * @param message сообщение.
+     * @param duration задержка в миллисекундах.
      */
     warning(message: string, duration?: number): void;
     /**
-     * Уведомление об ошибке
+     * Уведомление об ошибке.
      *
-     * @param message сообщение
-     * @param duration задержка в миллисекундах
+     * @param message сообщение.
+     * @param duration задержка в миллисекундах.
      */
     error(message: string, duration?: number): void;
 }
@@ -84,18 +98,25 @@ declare const UIKIT_NOTIFICATION_TOKEN: InjectionToken<INotificationService>;
 declare class AuthEventService {
     private readonly authErrorSource;
     readonly authError$: rxjs.Observable<void>;
+    /** Вызывается в интерцепторе при 401 ошибке */
     notify401(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AuthEventService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AuthEventService>;
 }
 
 declare class RoleService {
-    private readonly hideRole;
-    /** Проверка массива ролей */
-    hasRoles(roles: string[], checkRoles: string[]): boolean;
-    /** Элемент скрывается, если у пользователя нет ни одной роли из перереданных в "roles"
-      или в списке "roles" есть роль "hideRole". */
-    isHideElement(roles: string[], checkRoles: string[]): boolean;
+    private readonly authService;
+    /**
+     * Проверяет, заблокирован ли доступ к элементу на основе списка ограничений.
+     * Возвращает true, если у пользователя есть запрещенная роль или передан маркер 'HIDE'.
+     * Администратор (ADMIN) всегда игнорирует любые запреты и маркер 'HIDE'.
+     */
+    hasForbiddenRole(forbiddenRoles: string[]): boolean;
+    /**
+   * Проверяет, есть ли у пользователя хотя бы одна из разрешенных ролей.
+   * ADMIN всегда возвращает true.
+   */
+    hasAnyRole(allowedRoles: string[]): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<RoleService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<RoleService>;
 }
@@ -141,19 +162,22 @@ declare class AuthService {
     private readonly _loggedIn;
     readonly roles: i0.Signal<string[]>;
     readonly loggedIn: i0.Signal<boolean>;
-    private readonly defaultHeader;
+    private readonly defaultOptions;
     private readonly notificationService;
     private readonly userService;
     private readonly eventService;
     private readonly destroyRef;
-    private http;
-    private config;
-    private router;
+    private readonly http;
+    private readonly config;
+    private readonly router;
     constructor();
-    /** Запрос авторизации */
-    login(username: string, password: string, idCas: number, onErrorFn: () => void): void;
+    /**
+     * Запрос авторизации
+     * Возвращает Observable, позволяя компоненту реагировать на статус запроса.
+     */
+    login(username: string, password: string, idCas: number): Observable<User>;
     /** Aвторизация по пропуску */
-    loginByPermit(permit: string, idCas: number): rxjs.Subscription;
+    loginByPermit(permit: string, idCas: number): Observable<User>;
     logout(): void;
     /** При успешной авторизации */
     private successLoginAction;
@@ -174,5 +198,10 @@ declare class NotificationService implements INotificationService {
     static ɵprov: i0.ɵɵInjectableDeclaration<NotificationService>;
 }
 
-export { API_NAME, APP_ENVIRONMENT, AuthEventService, AuthService, BYPASS_AUTH, DEFAULT_TIMEOUT, NotificationService, REQUEST_TIMEOUT, RoleService, UIKIT_CONFIG, UIKIT_NOTIFICATION_TOKEN, User, UserService };
+/**
+ * Проверяет, пересекаются ли два массива (есть ли хотя бы один общий элемент).
+ */
+declare function hasArrayIntersection<T>(arrayA: T[], arrayB: T[]): boolean;
+
+export { ADMIN_ROLE, API_NAME, APP_ENVIRONMENT, AuthEventService, AuthService, BYPASS_AUTH, DEFAULT_TIMEOUT, HIDE_ROLE_MARKER, NotificationService, REQUEST_TIMEOUT, RoleService, UIKIT_CONFIG, UIKIT_NOTIFICATION_TOKEN, User, UserService, hasArrayIntersection };
 export type { AppEnvironment, INotificationService, UikitConfig };