mesauth-angular 1.4.0 → 1.5.5

package/index.d.ts

@@ -1,9 +1,9 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, NgZone, EnvironmentProviders, OnDestroy, OnInit, EventEmitter, ChangeDetectorRef, AfterViewInit } from '@angular/core';
+import { InjectionToken, NgZone, EnvironmentProviders, OnDestroy, OnInit, EventEmitter, ChangeDetectorRef, AfterViewInit, ElementRef } from '@angular/core';
 import { HttpClient, HttpInterceptorFn } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import { Router } from '@angular/router';
-import { SafeHtml } from '@angular/platform-browser';
+import { SafeHtml, SafeResourceUrl } from '@angular/platform-browser';
 
 interface MesAuthConfig {
     apiBaseUrl: string;
@@ -127,6 +127,8 @@ declare class MesAuthService {
     currentUser$: Observable<IUser | null>;
     private _notifications;
     notifications$: Observable<any>;
+    private _approvalEvents;
+    approvalEvents$: Observable<any>;
     private apiBase;
     private config;
     private http;
@@ -196,19 +198,24 @@ declare class UserProfileComponent implements OnInit, OnDestroy {
     private router;
     private themeService;
     private cdr;
+    private http;
     notificationClick: EventEmitter<void>;
+    approvalClick: EventEmitter<void>;
     get themeClass(): string;
     currentUser: i0.WritableSignal<IUser>;
     currentTheme: Theme;
     unreadCount: number;
+    pendingApprovalCount: number;
     dropdownOpen: boolean;
     private hasUser;
     private destroy$;
     avatarRefresh: i0.WritableSignal<number>;
-    constructor(authService: MesAuthService, router: Router, themeService: ThemeService, cdr: ChangeDetectorRef);
+    constructor(authService: MesAuthService, router: Router, themeService: ThemeService, cdr: ChangeDetectorRef, http: HttpClient);
     ngOnInit(): void;
     ngOnDestroy(): void;
     loadUnreadCount(): void;
+    loadPendingApprovalCount(): void;
+    onApprovalClick(): void;
     getAvatarUrl(user: IUser): string;
     getLastNameInitial(user: IUser): string;
     toggleDropdown(): void;
@@ -218,13 +225,226 @@ declare class UserProfileComponent implements OnInit, OnDestroy {
     onLogout(): void;
     onNotificationClick(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<UserProfileComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<UserProfileComponent, "ma-user-profile", never, {}, { "notificationClick": "notificationClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UserProfileComponent, "ma-user-profile", never, {}, { "notificationClick": "notificationClick"; "approvalClick": "approvalClick"; }, never, never, true, never>;
+}
+
+declare enum ApprovalStepMode {
+    Sequential = 0,
+    Parallel = 1
+}
+declare enum ApprovalDocumentStatus {
+    Draft = 0,
+    Pending = 1,
+    Approved = 2,
+    Rejected = 3,
+    Cancelled = 4,
+    Expired = 5
+}
+declare enum ApprovalStepStatus {
+    Waiting = 0,
+    Active = 1,
+    Approved = 2,
+    Rejected = 3,
+    Delegated = 4,
+    Expired = 5,
+    Skipped = 6
+}
+declare enum ApprovalActionType {
+    Created = 0,
+    Submitted = 1,
+    Approved = 2,
+    Rejected = 3,
+    Delegated = 4,
+    Cancelled = 5,
+    Commented = 6,
+    Expired = 7,
+    StepAdvanced = 8
+}
+interface ApprovalDocumentSummaryDto {
+    id: string;
+    title: string;
+    description?: string;
+    thumbnailPath?: string;
+    sourceAppId: string;
+    referenceId: string;
+    requestedByUserName: string;
+    status: ApprovalDocumentStatus;
+    currentStepOrder: number;
+    totalSteps: number;
+    currentStepName?: string;
+    createdAt: string;
+    completedAt?: string;
+}
+interface ApprovalStepDto {
+    id: number;
+    stepOrder: number;
+    stepName: string;
+    mode: ApprovalStepMode;
+    assignedUserId: string;
+    assignedUserName: string;
+    delegatedToUserId?: string;
+    delegatedToUserName?: string;
+    status: ApprovalStepStatus;
+    comment?: string;
+    decidedAt?: string;
+    deadlineAt?: string;
+}
+interface ApprovalReferenceDto {
+    userId: string;
+    userName: string;
+    addedAt: string;
+}
+interface ApprovalDocumentDto {
+    id: string;
+    title: string;
+    description?: string;
+    contentPath: string;
+    thumbnailPath?: string;
+    sourceAppId: string;
+    referenceId: string;
+    templateId?: number;
+    requestedByUserId: string;
+    requestedByUserName: string;
+    status: ApprovalDocumentStatus;
+    currentStepOrder: number;
+    callbackUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    deadlineAt?: string;
+    steps: ApprovalStepDto[];
+    references: ApprovalReferenceDto[];
+}
+interface ApprovalHistoryDto {
+    id: number;
+    documentId: string;
+    stepId?: number;
+    action: ApprovalActionType;
+    actorUserId: string;
+    actorUserName: string;
+    comment?: string;
+    details?: string;
+    timestamp: string;
+}
+interface ApprovalTemplateSummaryDto {
+    id: number;
+    name: string;
+    description?: string;
+    sourceAppId: string;
+    stepCount: number;
+    referenceCount: number;
+    isActive: boolean;
+    createdAt: string;
+}
+interface ApprovalTemplateStepDto {
+    id: number;
+    stepOrder: number;
+    stepName: string;
+    mode: ApprovalStepMode;
+    deadlineHours?: number;
+    assigneeUserIds: string[];
+}
+interface ApprovalTemplateDto {
+    id: number;
+    name: string;
+    description?: string;
+    sourceAppId: string;
+    createdByUserId: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+    steps: ApprovalTemplateStepDto[];
+    referenceUserIds: string[];
+}
+interface ApprovalDashboardDto {
+    pendingCount: number;
+    approvedTodayCount: number;
+    rejectedTodayCount: number;
+    recentActivity: ApprovalDocumentSummaryDto[];
+}
+interface CreateApprovalResponseDto {
+    documentId: string;
+    message: string;
+}
+interface ApprovalStepRequest {
+    stepOrder: number;
+    stepName: string;
+    mode?: ApprovalStepMode;
+    approverUserIds: string[];
+    deadlineHours?: number;
+}
+interface CreateApprovalRequest {
+    title: string;
+    description?: string;
+    contentHtml: string;
+    thumbnailBase64?: string;
+    referenceId: string;
+    templateId?: number;
+    requestedByUserId?: string;
+    callbackUrl?: string;
+    deadlineHours?: number;
+    steps?: ApprovalStepRequest[];
+    referenceUserIds?: string[];
+}
+interface ApproveRejectRequest {
+    comment?: string;
+}
+interface DelegateRequest {
+    toUserId: string;
+    reason?: string;
+}
+interface CreateApprovalTemplateRequest {
+    name: string;
+    description?: string;
+    sourceAppId: string;
+    steps: ApprovalStepRequest[];
+    referenceUserIds?: string[];
+}
+interface UpdateApprovalTemplateRequest {
+    name: string;
+    description?: string;
+    steps: ApprovalStepRequest[];
+    referenceUserIds?: string[];
+}
+interface ApprovalSubmitResult {
+    documentId: string;
+    message: string;
+}
+
+type PanelTab = 'processing' | 'approved' | 'rejected';
+declare class MaApprovalPanelComponent implements OnInit, OnDestroy {
+    approvalActioned: EventEmitter<void>;
+    isOpen: boolean;
+    loading: boolean;
+    activeTab: PanelTab;
+    processingItems: ApprovalDocumentSummaryDto[];
+    approvedItems: ApprovalDocumentSummaryDto[];
+    rejectedItems: ApprovalDocumentSummaryDto[];
+    private destroy$;
+    private mesAuth;
+    private http;
+    private router;
+    private approvalSvc;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    switchTab(tab: PanelTab): void;
+    private loadAllTabs;
+    private loadCurrentTab;
+    navigateToDetail(id: string): void;
+    showMore(status: 'approved' | 'rejected'): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaApprovalPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MaApprovalPanelComponent, "ma-approval-panel", never, {}, { "approvalActioned": "approvalActioned"; }, never, never, true, never>;
 }
 
 declare class MaUserComponent implements AfterViewInit {
     userProfile?: UserProfileComponent;
+    approvalPanel: MaApprovalPanelComponent;
     ngAfterViewInit(): void;
     onNotificationRead(): void;
+    onApprovalActioned(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MaUserComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MaUserComponent, "ma-user", never, {}, {}, never, never, true, never>;
 }
@@ -284,6 +504,7 @@ declare class NotificationPanelComponent implements OnInit, OnDestroy {
     get currentNotifications(): NotificationDto[];
     selectedNotification: NotificationDto | null;
     selectedNotificationHtml: SafeHtml | null;
+    selectedNotificationUrl: SafeResourceUrl | null;
     selectedNotificationDate: string;
     getNotificationMessage(notification: NotificationDto): string;
     typeOf(notification: {
@@ -330,5 +551,84 @@ declare class ToastContainerComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<ToastContainerComponent, "ma-toast-container", never, {}, {}, never, never, true, never>;
 }
 
-export { MES_AUTH_CONFIG, MaUserComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, mesAuthInterceptor, provideMesAuth };
-export type { FrontEndRoute, IUser, MesAuthConfig, NotificationDto, PagedList, RealTimeNotificationDto, Theme, Toast, UserFrontEndRoutesGrouped };
+declare class MaApprovalService {
+    private apiBase;
+    private http;
+    private config;
+    constructor();
+    init(config: MesAuthConfig, httpClient: HttpClient): void;
+    private get opts();
+    getDashboard(): Observable<ApprovalDashboardDto>;
+    getPendingApprovals(page?: number, pageSize?: number): Observable<PagedList<ApprovalDocumentSummaryDto>>;
+    getMyRequests(page?: number, pageSize?: number, status?: ApprovalDocumentStatus): Observable<PagedList<ApprovalDocumentSummaryDto>>;
+    getDocument(id: string): Observable<ApprovalDocumentDto>;
+    getDocumentHistory(id: string): Observable<ApprovalHistoryDto[]>;
+    getDocumentContentUrl(id: string): string;
+    getDocumentThumbnailUrl(id: string): string;
+    approve(documentId: string, comment?: string): Observable<void>;
+    reject(documentId: string, comment: string): Observable<void>;
+    delegate(documentId: string, toUserId: string, reason?: string): Observable<void>;
+    cancel(documentId: string, reason?: string): Observable<void>;
+    getTemplates(appId?: string): Observable<ApprovalTemplateSummaryDto[]>;
+    getTemplate(id: number): Observable<ApprovalTemplateDto>;
+    createTemplate(request: CreateApprovalTemplateRequest): Observable<ApprovalTemplateDto>;
+    updateTemplate(id: number, request: UpdateApprovalTemplateRequest): Observable<ApprovalTemplateDto>;
+    deleteTemplate(id: number): Observable<void>;
+    createApproval(request: CreateApprovalRequest): Observable<CreateApprovalResponseDto>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaApprovalService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MaApprovalService>;
+}
+
+declare class MaArvContainerComponent implements OnInit, OnDestroy {
+    title: string;
+    description?: string;
+    referenceId: string;
+    templateId?: number;
+    callbackUrl?: string;
+    deadlineHours?: number;
+    approvalSubmitted: EventEmitter<ApprovalSubmitResult>;
+    approvalSubmiting: EventEmitter<void>;
+    cancelled: EventEmitter<void>;
+    contentBody: ElementRef<HTMLElement>;
+    routingMode: 'template' | 'adhoc';
+    templates: ApprovalTemplateSummaryDto[];
+    selectedTemplateId: number | null;
+    adHocSteps: ApprovalStepRequest[];
+    referenceUserIds: string[];
+    refSearchQuery: string;
+    refSearchResults: any[];
+    userSearchQuery: string[];
+    userSearchResults: any[][];
+    submitting: boolean;
+    isSubmitted: boolean;
+    errorMessage: string;
+    userLabelMap: Record<string, string>;
+    private destroy$;
+    private mesAuth;
+    private approvalSvc;
+    private http;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private loadTemplates;
+    onTemplateChange(event: Event): void;
+    addStep(): void;
+    removeStep(i: number): void;
+    addApprover(stepIndex: number, userId: string): void;
+    removeApprover(stepIndex: number, approverIndex: number): void;
+    addReference(userId: string): void;
+    private storeLabelFromResults;
+    removeReference(j: number): void;
+    onUserSearchInput(stepIndex: number, query: string): void;
+    onRefSearchInput(query: string): void;
+    private searchUsers;
+    submit(): Promise<void>;
+    onCancel(): void;
+    captureContent(): Promise<string>;
+    private captureThumbnail;
+    private getStyleProperties;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaArvContainerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MaArvContainerComponent, "ma-arv-container", never, { "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "referenceId": { "alias": "referenceId"; "required": false; }; "templateId": { "alias": "templateId"; "required": false; }; "callbackUrl": { "alias": "callbackUrl"; "required": false; }; "deadlineHours": { "alias": "deadlineHours"; "required": false; }; }, { "approvalSubmitted": "approvalSubmitted"; "approvalSubmiting": "approvalSubmiting"; "cancelled": "cancelled"; }, never, ["*"], true, never>;
+}
+
+export { ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, MES_AUTH_CONFIG, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, MaUserComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, mesAuthInterceptor, provideMesAuth };
+export type { ApprovalDashboardDto, ApprovalDocumentDto, ApprovalDocumentSummaryDto, ApprovalHistoryDto, ApprovalReferenceDto, ApprovalStepDto, ApprovalStepRequest, ApprovalSubmitResult, ApprovalTemplateDto, ApprovalTemplateStepDto, ApprovalTemplateSummaryDto, ApproveRejectRequest, CreateApprovalRequest, CreateApprovalResponseDto, CreateApprovalTemplateRequest, DelegateRequest, FrontEndRoute, IUser, MesAuthConfig, NotificationDto, PagedList, RealTimeNotificationDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "mesauth-angular",
-  "version": "1.4.0",
+  "version": "1.5.5",
   "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",
     "signalr",
     "notifications",
     "auth",
+    "approval",
     "mes"
   ],
   "license": "MIT",