mesauth-angular 1.7.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mesauth-angular",
-  "version": "1.7.0",
+  "version": "1.8.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

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, NgZone, EnvironmentProviders, OnDestroy, OnInit, EventEmitter, ChangeDetectorRef, AfterViewInit, ElementRef } from '@angular/core';
+import { InjectionToken, NgZone, EnvironmentProviders, OnDestroy, OnInit, EventEmitter, ChangeDetectorRef, AfterViewInit, ElementRef, OnChanges, SimpleChanges } from '@angular/core';
 import { HttpClient, HttpInterceptorFn, HttpResponse, HttpParams } from '@angular/common/http';
 import { Observable, OperatorFunction } from 'rxjs';
 import { Router } from '@angular/router';
@@ -9,6 +9,12 @@ interface MesAuthConfig {
     apiBaseUrl: string;
     withCredentials?: boolean;
     userBaseUrl?: string;
+    /**
+     * Base URL for hosted UI assets (CSS themes, icons, manifest).
+     * Defaults to `{apiBaseUrl}/mesauth-angular/v1` when omitted.
+     * Allows updating themes, icons, and labels without republishing the npm package.
+     */
+    uiAssetsUrl?: string;
 }
 /** Injection token for MesAuth configuration */
 declare const MES_AUTH_CONFIG: InjectionToken<MesAuthConfig>;
@@ -136,6 +142,7 @@ declare class MesAuthService {
     private ngZone;
     constructor();
     init(config: MesAuthConfig, httpClient: HttpClient, router?: Router, ngZone?: NgZone): void;
+    private injectThemeStylesheet;
     getConfig(): MesAuthConfig | null;
     private fetchCurrentUser;
     getUnreadCount(): Observable<any>;
@@ -598,6 +605,7 @@ declare class MaArvContainerComponent implements OnInit, OnDestroy {
     description?: string;
     referenceId: string;
     templateId?: number;
+    templateIds?: number[];
     callbackUrl?: string;
     deadlineHours?: number;
     approvalSubmitted: EventEmitter<ApprovalSubmitResult>;
@@ -652,7 +660,7 @@ declare class MaArvContainerComponent implements OnInit, OnDestroy {
     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"; "approvalSubmitting": "approvalSubmitting"; "cancelled": "cancelled"; }, never, ["*"], true, 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; }; "templateIds": { "alias": "templateIds"; "required": false; }; "callbackUrl": { "alias": "callbackUrl"; "required": false; }; "deadlineHours": { "alias": "deadlineHours"; "required": false; }; }, { "approvalSubmitted": "approvalSubmitted"; "approvalSubmitting": "approvalSubmitting"; "cancelled": "cancelled"; }, never, ["*"], true, never>;
 }
 
 interface PermissionHeader {
@@ -675,5 +683,107 @@ declare function xMaResource<T>(request: () => RequestConfig): i0.ResourceRef<{
     allowedActions: string[];
 }>;
 
-export { ALL_ACTIONS, ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, MES_AUTH_CONFIG, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, 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, MesAuthConfig, NotificationDto, PagedList, PermissionHeader, RealTimeNotificationDto, RequestConfig, RolePreviewUserDto, StepRoleDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };
+interface MaUiManifest {
+    /** Version of the package that created this manifest. */
+    version: string;
+    /** Latest published package version — library logs a warning if installed version is older. */
+    latestPackageVersion?: string;
+    /** Set true to show an upgrade banner inside components. */
+    updateRequired?: boolean;
+    /** URL override for the theme CSS (defaults to themes/default.css relative to assetsUrl). */
+    themeUrl?: string;
+    /** URL override for the SVG icon sprite. */
+    iconSpriteUrl?: string;
+    /** UI string overrides — keys match component label identifiers. */
+    labels?: Record<string, string>;
+    /** Feature flags read by components at runtime. */
+    features?: Record<string, boolean>;
+}
+/**
+ * Provides server-driven UI configuration loaded from the hosted manifest.
+ * Components read `labels()` and `features()` signals instead of hardcoded strings.
+ * Update manifest.json on the server to change labels or toggle features without
+ * republishing the npm package.
+ */
+declare class MaUiConfigService {
+    private _labels;
+    private _features;
+    private _updateRequired;
+    /** Reactive map of UI string overrides from the server manifest. */
+    readonly labels: i0.Signal<Record<string, string>>;
+    /** Reactive map of feature flags from the server manifest. */
+    readonly features: i0.Signal<Record<string, boolean>>;
+    /** True when the server signals that a package upgrade is needed. */
+    readonly updateRequired: i0.Signal<boolean>;
+    /**
+     * Returns a label by key, falling back to `defaultValue` when the server
+     * manifest has not provided an override.
+     */
+    label(key: string, defaultValue: string): string;
+    /**
+     * Returns a feature flag by key, falling back to `defaultValue`.
+     */
+    feature(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Called by MesAuthService.init() — fetches the manifest and applies any
+     * label/feature overrides. Failures are silently ignored so the library
+     * works without a manifest endpoint.
+     */
+    loadManifest(assetsUrl: string, http: HttpClient): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaUiConfigService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MaUiConfigService>;
+}
+
+/**
+ * MaIconComponent
+ * Renders an SVG icon from the server-hosted sprite.
+ * The sprite URL is derived from the stylesheet link injected by MesAuthService,
+ * so changing the sprite on the server updates icons without a package rebuild.
+ *
+ * Selector: <ma-icon name="bell" [size]="20" />
+ *
+ * When the sprite is not available, falls back to inline SVG definitions
+ * for the icons used internally by the library (bell, check, close, etc.).
+ *
+ * This component is intentionally lightweight — it is the single place where
+ * icon SVG is defined, replacing the repeated inline <svg> blocks that were
+ * scattered across every component template.
+ */
+declare class MaIconComponent implements OnChanges {
+    name: string;
+    size: number;
+    stroke: string;
+    strokeWidth: number;
+    svgContent: SafeHtml;
+    private sanitizer;
+    ngOnChanges(changes: SimpleChanges): void;
+    private buildSvg;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaIconComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MaIconComponent, "ma-icon", never, { "name": { "alias": "name"; "required": false; }; "size": { "alias": "size"; "required": false; }; "stroke": { "alias": "stroke"; "required": false; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * MaThemeDirective
+ * Apply `maTheme` to any element or component that needs automatic theme-class binding.
+ * Adds `theme-light` or `theme-dark` to the host element's class list and keeps it
+ * in sync with ThemeService, replacing the duplicated @HostBinding + subscription
+ * pattern that was repeated in every component.
+ *
+ * Usage:
+ *   <div maTheme> ... </div>
+ *
+ * Or as a hostDirective in a component:
+ *   @Component({ hostDirectives: [MaThemeDirective], ... })
+ */
+declare class MaThemeDirective implements OnInit, OnDestroy {
+    themeClass: string;
+    private themeService;
+    private destroy$;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaThemeDirective, never>;
+    static ɵdir: i0.ɵɵ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 };