@arsedizioni/ars-utils 21.2.209 → 21.2.221

package/fesm2022/arsedizioni-ars-utils-evolution.common.mjs

@@ -1,8 +1,8 @@
 import * as i0 from '@angular/core';
 import { inject, signal, Injectable, NgModule } from '@angular/core';
+import { HttpClient, HttpHeaders, HttpErrorResponse } from '@angular/common/http';
 import { BroadcastService, SystemUtils } from '@arsedizioni/ars-utils/core';
 import { EMPTY, throwError, of, catchError as catchError$1 } from 'rxjs';
-import { HttpClient, HttpHeaders } from '@angular/common/http';
 import { DialogService } from '@arsedizioni/ars-utils/ui';
 import { catchError, finalize, map } from 'rxjs/operators';
 
@@ -481,121 +481,140 @@ var ERPPlace;
 class EvolutionComplianceContextInfo {
 }
 
+/**
+ * Core service for the Evolution compliance module.
+ * Manages authentication (login / logout / MFA), session persistence,
+ * and HTTP access to all Evolution API endpoints.
+ */
 class EvolutionService {
     constructor() {
         this.httpClient = inject(HttpClient);
         this.broadcastService = inject(BroadcastService);
         this.dialogService = inject(DialogService);
-        this._serviceUri = undefined;
         this._flags = EvolutionServiceFlags.None;
+        /** `true` when the user has an active (non-temporary) session. */
         this.loggedIn = signal(false, ...(ngDevMode ? [{ debugName: "loggedIn" }] : /* istanbul ignore next */ []));
+        /** `true` while a login request is in flight. */
         this.loggingIn = signal(false, ...(ngDevMode ? [{ debugName: "loggingIn" }] : /* istanbul ignore next */ []));
     }
+    /** Base URI of the Evolution back-end service. */
     get serviceUri() {
         return this._serviceUri;
     }
+    /** Feature flags controlling service behaviour (notifications, embedded mode, etc.). */
     get flags() {
         return this._flags;
     }
+    /**
+     * Returns the current login info, hydrating it from `localStorage` on first access
+     * when no in-memory value is available.
+     */
     get loginInfo() {
         if (!this._loginInfo) {
-            const loginInfo = localStorage.getItem('evolution_context');
-            if (loginInfo) {
+            const raw = localStorage.getItem('evolution_context');
+            if (raw) {
                 try {
-                    this._loginInfo = JSON.parse(loginInfo);
+                    this._loginInfo = JSON.parse(raw);
                 }
-                catch { }
+                catch { /* invalid JSON — ignore and leave undefined */ }
             }
         }
         return this._loginInfo;
     }
     ngOnDestroy() {
-        if (this.broadcastServiceSubscription) {
-            this.broadcastServiceSubscription.unsubscribe();
-        }
+        this.broadcastServiceSubscription?.unsubscribe();
     }
     /**
-     * Initialize service
-     * @param serviceUri : the service uri
-     * @param flags: the service flags. Default is none.
+     * Initialises the service with the back-end URI and optional feature flags.
+     * Must be called once during application bootstrap before any other method.
+     * @param serviceUri - Base URL of the Evolution service (e.g. `'https://api.example.com/evolution'`).
+     * @param flags      - Bitmask of `EvolutionServiceFlags` (default: `None`).
      */
     initialize(serviceUri, flags = EvolutionServiceFlags.None) {
-        // Create unique client id and machine id
+        // Create a unique per-tab client ID if not already set
         if (!sessionStorage.getItem('evolution_client_id')) {
-            sessionStorage.setItem('evolution_client_id', (flags && EvolutionServiceFlags.Embedded) > 0
+            sessionStorage.setItem('evolution_client_id', (flags & EvolutionServiceFlags.Embedded) > 0
                 ? 'embedded'
                 : SystemUtils.generateUUID());
         }
-        // Initialize
         this._serviceUri = serviceUri;
         this._flags = flags;
-        // React to message broadcasting
+        // Subscribe to broadcast messages (only once)
         if (!this.broadcastServiceSubscription) {
-            this.broadcastServiceSubscription = this.broadcastService.getMessage().subscribe((message) => {
-                if (message.id === EvolutionMessages.LOGIN_CHANGED) {
-                    this.login(null, null, true, message.data?.oauth ?? null, message.data?.oauthAccessToken ?? null).subscribe({
-                        next: r => {
-                            if (!r.success) {
-                                if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
-                                    this.dialogService.error("Le credenziali di accesso sono cambiate o non sono più valide. Esegui un nuovo accesso.", undefined, "Errore di Evolution");
-                                }
-                                this.broadcastService.sendMessage(EvolutionMessages.LOGIN_FAILED);
-                            }
-                            else {
-                                if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
-                                    this.dialogService.toast('Connesso a Evolution', 1500, 'power');
-                                }
-                            }
-                        },
-                        error: () => { console.error("Evolution non disponibile."); } // Avoid unwanted errors on client
-                    });
-                }
-                else if (message.id === EvolutionMessages.LOGOUT) {
-                    if (this.loggedIn()) {
-                        this.logout().subscribe(r => {
-                            if (!r.success) {
-                                if (r.message) {
-                                    this.dialogService.error("<p>" + r.message + "</p><br><br><hr><p class='small'><i>Per eliminare la configurazione di Evolution accedere a:<br><b>menu > personalizza > collegamenti</b></i></p>", null, "Errore di Evolution");
-                                }
-                            }
-                            else {
-                                if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
-                                    this.dialogService.toast('Disconnesso da Evolution', 1500, 'power_off');
-                                }
-                            }
-                        });
-                    }
-                    else {
-                        this.clear();
-                    }
-                }
+            this.broadcastServiceSubscription = this.broadcastService
+                .getMessage()
+                .subscribe((message) => {
+                this.handleBroadcastMessage(message);
             });
         }
-        // Eveluate current session storage in case of page refresh (F5)
+        // If a session is already active (e.g. after an F5 page refresh), notify consumers
         if (this.loggedIn()) {
-            // Auto login
             this.loggingIn.set(false);
-            // Notify 
             this.broadcastService.sendMessage(EvolutionMessages.LOGIN_COMPLETED);
         }
     }
     /**
-   * Ping
-   */
+     * Dispatches an incoming broadcast message to the appropriate handler.
+     * @param message - The message received from the broadcast channel.
+     */
+    handleBroadcastMessage(message) {
+        if (message.id === EvolutionMessages.LOGIN_CHANGED) {
+            const data = message.data;
+            this.login(undefined, undefined, true, data?.['oauth'], data?.['oauthAccessToken']).subscribe({
+                next: r => {
+                    if (!r.success) {
+                        if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
+                            this.dialogService.error("Le credenziali di accesso sono cambiate o non sono più valide. Esegui un nuovo accesso.", undefined, "Errore di Evolution");
+                        }
+                        this.broadcastService.sendMessage(EvolutionMessages.LOGIN_FAILED);
+                    }
+                    else {
+                        if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
+                            this.dialogService.toast('Connesso a Evolution', 1500, 'power');
+                        }
+                    }
+                },
+                error: () => { console.error('Evolution non disponibile.'); }
+            });
+        }
+        else if (message.id === EvolutionMessages.LOGOUT) {
+            if (this.loggedIn()) {
+                this.logout().subscribe(r => {
+                    if (!r.success) {
+                        if (r.message) {
+                            this.dialogService.error("<p>" + r.message + "</p><br><br><hr><p class='small'><i>Per eliminare la configurazione di Evolution accedere a:<br><b>menu > personalizza > collegamenti</b></i></p>", undefined, "Errore di Evolution");
+                        }
+                    }
+                    else {
+                        if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
+                            this.dialogService.toast('Disconnesso da Evolution', 1500, 'power_off');
+                        }
+                    }
+                });
+            }
+            else {
+                this.clear();
+            }
+        }
+    }
+    /**
+     * Sends a one-shot ping to the back end to verify connectivity.
+     */
     ping() {
-        this.httpClient.get(this._serviceUri + '/ping?nocache=' + SystemUtils.generateUUID())
-            .pipe(catchError(() => { return EMPTY; }))
+        this.httpClient
+            .get(this._serviceUri + '/ping?nocache=' + SystemUtils.generateUUID())
+            .pipe(catchError(() => EMPTY))
             .subscribe();
     }
     /**
-    * Store login info
-    */
+     * Persists the current login info to `localStorage`.
+     */
     storeContext() {
         localStorage.setItem('evolution_context', JSON.stringify(this._loginInfo));
     }
     /**
-     * Update context
-     * @param result: the new context
+     * Merges a login result into the stored login info and persists it.
+     * @param result - The `EvolutionLoginResult` returned by the login endpoint.
      */
     updateContext(result) {
         if (!this._loginInfo) {
@@ -605,24 +624,24 @@ class EvolutionService {
         this.storeContext();
     }
     /**
-    * Perform auto login using current link data
-    * @param onSuccess: function to execute on seccess
-    */
+     * Performs an automatic login using the credentials already stored in the session.
+     * Shows a busy indicator and handles success/failure dialogs.
+     * @param onSuccess - Optional callback invoked after a successful login.
+     * @returns `true` (always) — the result is handled via the subscription callbacks.
+     */
     autoLogin(onSuccess) {
-        this.login(null, null, true)
+        this.login(undefined, undefined, true)
             .pipe(finalize(() => this.dialogService.clearBusy()))
             .subscribe({
             next: r => {
                 if (!r.success) {
-                    this.dialogService.error(r.message, null, "Errore in Evolution");
+                    this.dialogService.error(r.message, undefined, "Errore in Evolution");
                 }
                 else {
-                    if (!r.value.requiresMfa) {
+                    if (!r.value?.requiresMfa) {
                         this.dialogService.toast('Connesso ad Evolution', 1500, 'power');
                     }
-                    if (onSuccess) {
-                        onSuccess();
-                    }
+                    onSuccess?.();
                 }
             },
             error: () => { this.dialogService.error("Evolution non disponibile."); }
@@ -630,16 +649,15 @@ class EvolutionService {
         return true;
     }
     /**
-     * Perform auto logout
-     * @param onSuccess: function to execute on seccess
+     * Performs an automatic logout, notifying the user when the session ends.
+     * @param onSuccess - Optional callback invoked after the logout completes.
      */
     autoLogout(onSuccess) {
-        this.logout()
-            .subscribe({
+        this.logout().subscribe({
             next: r => {
                 if (!r.success) {
                     if (r.message) {
-                        this.dialogService.error(r.message, null, "Errore in Evolution");
+                        this.dialogService.error(r.message, undefined, "Errore in Evolution");
                     }
                     this.broadcastService.sendMessage(EvolutionMessages.LOGIN_CHANGED);
                 }
@@ -650,48 +668,43 @@ class EvolutionService {
             error: () => { },
             complete: () => {
                 this.dialogService.clearBusy();
-                if (onSuccess) {
-                    onSuccess();
-                }
+                onSuccess?.();
             }
         });
     }
     /**
-     * Perform login
-     * @param email: the optional email if using OAuth2
-     * @parma password: the optional password if using OAuth2
-     * @param remember: remember credentials
-     * @param oauth: the optional open authentication supported
-     * @param oauthAccessToken: the optional OAuth2 access token
+     * Authenticates the user against the Evolution back end.
+     * Supports both credential-based and OAuth2 login flows.
+     * @param email            - User e-mail (credential login only; omit for OAuth2).
+     * @param password         - User password (credential login only; omit for OAuth2).
+     * @param remember         - Whether to persist the session across browser restarts.
+     * @param oauth            - OAuth2 provider type, when using federated login.
+     * @param oauthAccessToken - Bearer token from the OAuth2 provider.
+     * @returns An observable that emits the `ApiResult<EvolutionLoginResult>`.
      */
-    login(email, password, remember, oauth, oauthAccessToken = sessionStorage.getItem("evolution_oauth_token") ?? undefined) {
+    login(email, password, remember, oauth, oauthAccessToken = sessionStorage.getItem('evolution_oauth_token') ?? undefined) {
         return this.httpClient
             .post(this._serviceUri + '/login2', {
             user: oauth ? null : email,
             password: oauth ? null : password,
-            remember: remember,
-            oauth: oauth
+            remember,
+            oauth
         }, {
-            headers: !oauth || !oauthAccessToken
-                ? new HttpHeaders()
+            headers: oauth && oauthAccessToken
+                ? new HttpHeaders().set('Authorization', oauthAccessToken)
                 : new HttpHeaders()
-                    .set("Authorization", oauthAccessToken ?? '')
         })
-            .pipe(catchError(err => {
-            return throwError(() => err);
-        }), map((r) => {
+            .pipe(catchError(err => throwError(() => err)), map((r) => {
             if (r.success) {
                 if (!this._loginInfo) {
                     this._loginInfo = { context: undefined };
                 }
                 this._loginInfo.oauth = oauth;
                 this._loginInfo.remember = remember;
-                if (!oauth && r.value.requiresMfa) {
-                    // Notify login is pending
+                if (!oauth && r.value?.requiresMfa) {
                     this.broadcastService.sendMessage(EvolutionMessages.LOGIN_PENDING, {});
                 }
                 else {
-                    // Complete login
                     this.completeLogin(r.value);
                 }
             }
@@ -699,289 +712,304 @@ class EvolutionService {
         }));
     }
     /**
-     * Complete login
-     * @param result : the login result
+     * Finalises a successful login by updating the stored context and notifying consumers.
+     * @param result - The login result payload from the server.
      */
     completeLogin(result) {
-        // Update context info            
         this.updateContext(result);
         this.loggedIn.set(!result.context?.isTemporary);
         this.loggingIn.set(false);
-        // Keep alive
-        // Notify
         this.broadcastService.sendMessage(EvolutionMessages.LOGIN_COMPLETED);
     }
     /**
-     * Confirm MFA procedure
-     * @param code: the confirm code
+     * Confirms a multi-factor authentication challenge and completes the login.
+     * @param code - The one-time MFA code entered by the user.
+     * @returns An observable that emits the `ApiResult<EvolutionLoginResult>`.
      */
     confirmIdentity(code) {
         return this.httpClient
             .post(this._serviceUri + '/login/confirm/' + code, {})
-            .pipe(catchError((err) => {
-            return throwError(() => err);
-        }), map((r) => {
+            .pipe(catchError(err => throwError(() => err)), map((r) => {
             if (r.success) {
-                // Complete login
                 this.completeLogin(r.value);
             }
             return r;
         }));
     }
     /**
-       * Perform logout
-       * @param forget: true to dispose all user informations
-       */
+     * Logs the current user out of the back end and clears local session data.
+     * @param forget - When `true`, instructs the server to discard all stored credentials.
+     * @returns An observable that emits `ApiResult<unknown>`.
+     */
     logout(forget = false) {
-        return this.httpClient.post(this._serviceUri + '/logout/?forget=' + forget, {})
+        return this.httpClient
+            .post(this._serviceUri + '/logout/?forget=' + forget, {})
             .pipe(finalize(() => {
             this.clear();
-            // Clean up
             localStorage.removeItem('evolution_context');
-        }), catchError((_e) => {
-            return of([]);
-        }));
+        }), catchError(() => of({ success: false, value: undefined, message: undefined })));
     }
     /**
-    * Switch the current login to a new one with the same credentials except role possibly (context change)
-    * @param id : new user id
-    */
+     * Switches the active session to a different user account while retaining credentials.
+     * @param id - The user ID to switch to.
+     * @returns An observable that emits the `ApiResult<EvolutionLoginResult>`.
+     */
     loginSwitch(id) {
         return this.httpClient
-            .post(this._serviceUri + '/login/switch', {
-            userId: id,
-        })
-            .pipe(catchError((err) => {
-            return throwError(() => err);
-        }), map((r) => {
+            .post(this._serviceUri + '/login/switch', { userId: id })
+            .pipe(catchError(err => throwError(() => err)), map((r) => {
             if (r.success) {
-                // Update login
                 this.completeLogin(r.value);
             }
             return r;
         }));
     }
     /**
-     * Reset login refresh timer and login state
+     * Resets the in-memory login state and broadcasts a logout-completed event.
+     * Does **not** touch `sessionStorage` or `localStorage`; call `clear()` for a full cleanup.
      */
     reset() {
-        // Clear login info
         this._loginInfo = undefined;
-        // Logged out
         this.loggedIn.set(false);
-        // Notify
         this.broadcastService.sendMessage(EvolutionMessages.LOGOUT_COMPLETED);
     }
     /**
-     * Clear login data
-     * @param clearOAuthToken: true to clear oauth token also
+     * Removes Evolution session data from `sessionStorage` and calls `reset()`.
+     * @param clearOAuthToken - When `true`, also removes the stored OAuth2 access token.
      */
     clear(clearOAuthToken = false) {
-        // Clear local storage
         sessionStorage.removeItem('evolution_auth');
         sessionStorage.removeItem('evolution_refresh');
         sessionStorage.removeItem('evolution_oauth');
         if (clearOAuthToken) {
             sessionStorage.removeItem('evolution_oauth_token');
         }
-        // Reset login
         this.reset();
     }
     /**
-     * Convert folders in a tree of Node object.
-     * @param folders : the subfolders group or null to root
+     * Converts a flat list of `INode` items into a hierarchical tree structure.
+     * @param folders - The root-level nodes to convert.
+     * @returns An array of `INode` objects with nested `children`.
      */
     toNodes(folders) {
-        return this._toNodes(folders, null);
+        return this._toNodes(folders, undefined);
     }
     /**
-     * Convert folders in a tree of Node object.
-     * @param folders : the children group or null to root
+     * Recursive helper for `toNodes`.
+     * @param folders - The nodes to process at the current depth level.
+     * @param parent  - The parent node, or `undefined` at the root level.
+     * @returns An array of `INode` objects with nested `children`.
      */
     _toNodes(folders, parent) {
-        let nodes = [];
-        folders.forEach(n => {
-            let node = {
+        const nodes = [];
+        for (const n of folders) {
+            const node = {
                 id: n.id,
                 name: n.name,
                 count: n.count,
-                parent: parent,
-                children: null,
+                parent,
+                children: undefined,
                 bag: n,
             };
-            node.children =
-                n.children && n.children.length > 0
-                    ? this._toNodes(n.children, node)
-                    : [];
+            node.children = n.children && n.children.length > 0
+                ? this._toNodes(n.children, node)
+                : [];
             nodes.push(node);
-        });
+        }
         return nodes;
     }
     /**
-     * Retrieve the taxonomy
+     * Retrieves the taxonomy tree from the back end.
+     * @returns An observable that emits `ApiResult<FolderTree>`.
      */
     getTaxonomy() {
         return this.httpClient.get(this._serviceUri + '/taxonomy');
     }
     /**
-    * Retrieve groups
-    * @param group: the group number
-    * @param register: the optional register id. Default is null.
-    */
+     * Retrieves the compliance groups for a register.
+     * @param group    - Group index to retrieve (default: `1`).
+     * @param register - Optional register ID to scope the query.
+     * @returns An observable that emits `ApiResult<string[]>`.
+     */
     getGroups(group = 1, register) {
-        return this.httpClient.get(this._serviceUri +
-            (register
-                ? '/compliance/groups/?group=' +
-                    group +
-                    '&register=' +
-                    register
-                : '/compliance/groups/?group=' + group));
-    }
-    ////
-    // CONTEXT
-    ////
+        const path = register
+            ? `/compliance/groups/?group=${group}&register=${register}`
+            : `/compliance/groups/?group=${group}`;
+        return this.httpClient.get(this._serviceUri + path);
+    }
+    // ── Context ────────────────────────────────────────────────────────────────
     /**
-     * Change context
+     * Sends a context-change request to the back end.
+     * @param params - The context model describing the desired switch.
+     * @returns An observable that emits `ApiResult<EvolutionChangeContextResultModel>`.
      */
     changeContext(params) {
         return this.httpClient.post(this._serviceUri + '/compliance/context', params);
     }
-    ////
-    // REGISTERS
-    ////
+    // ── Registers ──────────────────────────────────────────────────────────────
     /**
-     * Retrieve a register
-     * @param id the register id
+     * Retrieves a single compliance register by ID.
+     * @param id - The register ID.
+     * @returns An observable that emits `ApiResult<EvolutionComplianceRegister>`.
      */
     getRegister(id) {
-        return this.httpClient.get(this._serviceUri +
-            '/compliance/registers/' + id);
+        return this.httpClient.get(this._serviceUri + '/compliance/registers/' + id);
     }
     /**
-     * Collect register profiles
-     * @param params parameters
+     * Collects register profiles matching the given query parameters.
+     * @param params - Query parameters defining the filter criteria.
+     * @returns An observable that emits `ApiResult<EvolutionComplianceRegisterProfile[]>`.
      */
     collectRegisterProfiles(params) {
-        return this.httpClient.post(this._serviceUri +
-            '/compliance/registers/profiles/collect', params);
+        return this.httpClient.post(this._serviceUri + '/compliance/registers/profiles/collect', params);
     }
-    ////
-    // LAWS
-    ////
+    // ── Laws ───────────────────────────────────────────────────────────────────
     /**
-     * Add one or more laws
-     * @param params parameters
+     * Adds one or more compliance laws.
+     * @param params - The laws to add.
+     * @returns An observable that emits `ApiResult<EvolutionComplianceLaw[]>`.
      */
     addLaws(params) {
         return this.httpClient.post(this._serviceUri + '/compliance/laws/add', params);
     }
-    ////
-    // ACTIVITIES
-    ////
+    // ── Activities ─────────────────────────────────────────────────────────────
     /**
-     * Add one or more activities
-     * @param params parameters
+     * Adds one or more compliance activities.
+     * @param params - The activities to add.
+     * @returns An observable that emits `ApiResult<EvolutionComplianceActivity>`.
      */
     addActivities(params) {
         return this.httpClient.post(this._serviceUri + '/compliance/activities/add', params);
     }
     /**
-    * Export laws
-    * @param params parameters
-    */
+     * Exports compliance laws in the format expected by the server.
+     * @param params - Export parameters (model shape is server-defined).
+     * @returns An observable that emits the binary blob response.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     exportLaws(params) {
         return this.httpClient.post(this._serviceUri + '/compliance/laws/export', params, { responseType: 'blob' });
     }
-    ///
-    // LINKS
-    ///
+    // ── Links ──────────────────────────────────────────────────────────────────
     /**
-    * Save a user link
-    * @param item: the user link
-    */
+     * Persists a user link on the server.
+     * @param item - The user link to save.
+     * @returns An observable that emits `ApiResult<boolean>`.
+     */
     saveLink(item) {
         return this.httpClient.post(this._serviceUri + '/account/links/save', item);
     }
     /**
-     * Delete a user link
-     * @param item: the user link
+     * Deletes a user link from the server.
+     * @param item - The user link to delete.
+     * @returns An observable that emits `ApiResult<boolean>`.
      */
     deleteLink(item) {
         return this.httpClient.post(this._serviceUri + '/account/links/delete', item);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
                 }]
         }] });
 
+/** Minimum milliseconds between consecutive error broadcasts (debounce guard). */
+const ERROR_DEBOUNCE_MS = 5000;
+/**
+ * HTTP interceptor that attaches Evolution authentication headers to every request
+ * targeting the Evolution service, and broadcasts user-friendly error messages
+ * when the server returns an error response.
+ */
 class EvolutionAuthInterceptor {
     constructor() {
         this.evolutionService = inject(EvolutionService);
         this.broadcastService = inject(BroadcastService);
         this.lastErrorTime = -1;
     }
+    /**
+     * Intercepts every outgoing HTTP request.
+     * When the request targets the Evolution service URI, attaches credentials and
+     * a client-ID header, then pipes the response through an error handler.
+     * @param request - The outgoing HTTP request.
+     * @param next    - The next handler in the interceptor chain.
+     * @returns An observable of the HTTP event stream.
+     */
     intercept(request, next) {
-        if (request.url.startsWith(this.evolutionService.serviceUri ?? '')) {
-            request = request.clone({
-                withCredentials: true,
-                setHeaders: {
-                    'ngsw-bypass': 'ngsw-bypass',
-                    'X-Client-Id': sessionStorage.getItem('evolution_client_id') ?? ''
-                }
-            });
-            return next.handle(request)
-                .pipe(catchError$1(error => {
-                if (error.url.startsWith(this.evolutionService.serviceUri)) {
-                    const errorStatus = parseInt(error.status ?? "0");
-                    if ((errorStatus > 0 && errorStatus < 500) || (this.evolutionService.flags & EvolutionServiceFlags.NotifySystemErrors) > 0) {
-                        const errorTime = new Date().getTime();
-                        if (errorTime - this.lastErrorTime > 5000) {
-                            this.lastErrorTime = errorTime;
-                            let message = "";
-                            switch (errorStatus) {
-                                case 0:
-                                    message = "In questo momento Evolution non è disponibile. Riprova tra qualche minuto.";
-                                    break;
-                                case 403:
-                                    message = "Non hai i permessi necessari per eseguire l'operazione richiesta.";
-                                    break;
-                                default:
-                                    message = (error.error?.message ?? error.message ?? "Impossibile eseguire l'operazione richiesta.").replaceAll("\r\n", "</p><p>");
-                                    break;
-                            }
-                            this.broadcastService.sendMessage(EvolutionMessages.ERROR, {
-                                invalidateSession: errorStatus === 405 || errorStatus === 410,
-                                message: message,
-                                title: "Errore in Clipper",
-                                errorStatus: errorStatus,
-                                service: this.evolutionService.serviceUri
-                            });
-                        }
-                    }
-                }
-                return throwError(() => error);
-            }));
+        const serviceUri = this.evolutionService.serviceUri ?? '';
+        if (!serviceUri || !request.url.startsWith(serviceUri)) {
+            return next.handle(request);
         }
-        return next.handle(request);
+        const authenticatedRequest = request.clone({
+            withCredentials: true,
+            setHeaders: {
+                'ngsw-bypass': 'ngsw-bypass',
+                'X-Client-Id': sessionStorage.getItem('evolution_client_id') ?? ''
+            }
+        });
+        return next.handle(authenticatedRequest).pipe(catchError$1((error) => {
+            this.handleError(error);
+            return throwError(() => error);
+        }));
+    }
+    /**
+     * Processes an HTTP error, broadcasting a user-friendly message when appropriate.
+     * Errors are debounced: only one message is sent per `ERROR_DEBOUNCE_MS` window.
+     * @param error - The raw error value thrown by the HTTP layer.
+     */
+    handleError(error) {
+        if (!(error instanceof HttpErrorResponse))
+            return;
+        const serviceUri = this.evolutionService.serviceUri ?? '';
+        if (!serviceUri || !error.url?.startsWith(serviceUri))
+            return;
+        const errorStatus = error.status;
+        const shouldNotify = (errorStatus > 0 && errorStatus < 500) ||
+            (this.evolutionService.flags & EvolutionServiceFlags.NotifySystemErrors) > 0;
+        if (!shouldNotify)
+            return;
+        const now = Date.now();
+        if (now - this.lastErrorTime <= ERROR_DEBOUNCE_MS)
+            return;
+        this.lastErrorTime = now;
+        let message;
+        switch (errorStatus) {
+            case 0:
+                message = "In questo momento Evolution non è disponibile. Riprova tra qualche minuto.";
+                break;
+            case 403:
+                message = "Non hai i permessi necessari per eseguire l'operazione richiesta.";
+                break;
+            default:
+                message = (error.error?.['message'] ??
+                    error.message ??
+                    "Impossibile eseguire l'operazione richiesta.").replaceAll('\r\n', '</p><p>');
+                break;
+        }
+        this.broadcastService.sendMessage(EvolutionMessages.ERROR, {
+            invalidateSession: errorStatus === 405 || errorStatus === 410,
+            message,
+            title: "Errore in Evolution",
+            errorStatus,
+            service: this.evolutionService.serviceUri
+        });
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionAuthInterceptor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionAuthInterceptor }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionAuthInterceptor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionAuthInterceptor }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionAuthInterceptor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionAuthInterceptor, decorators: [{
             type: Injectable
         }] });
 
 class EvolutionCommonModule {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionCommonModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: EvolutionCommonModule }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionCommonModule }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionCommonModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.10", ngImport: i0, type: EvolutionCommonModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionCommonModule }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: EvolutionCommonModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: EvolutionCommonModule, decorators: [{
             type: NgModule
         }] });