@arsedizioni/ars-utils 22.0.48 → 22.0.50

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

@@ -1,6 +1,6 @@
 import { HttpClient, HttpHeaders, HttpErrorResponse } from '@angular/common/http';
 import * as i0 from '@angular/core';
-import { inject, DestroyRef, signal, Service, Injectable } from '@angular/core';
+import { inject, signal, Service, DestroyRef, Injectable } from '@angular/core';
 import { BroadcastService, SystemUtils } from '@arsedizioni/ars-utils/core';
 import { EMPTY, throwError, of, catchError as catchError$1 } from 'rxjs';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
@@ -484,16 +484,20 @@ class EvolutionComplianceContextInfo {
 }
 
 /**
- * Core service for the Evolution compliance module.
- * Manages authentication (login / logout / MFA), session persistence,
- * and HTTP access to all Evolution API endpoints.
+ * @internal
+ * Private state container for the Evolution session.
+ *
+ * Intentionally NOT exported from the barrel: it must never be injected by
+ * application code. Its state and pure mutations are re-published through
+ * {@link EvolutionService} (and partly {@link LoginService}). The feature
+ * services inject it ONLY to read {@link serviceUri}.
+ *
+ * Owns the back-end URI, feature flags, persisted login info and the session
+ * signals. No HTTP, no auth orchestration.
  */
-class EvolutionService {
+class CoreService {
     constructor() {
-        this.httpClient = inject(HttpClient);
         this.broadcastService = inject(BroadcastService);
-        this.destroyRef = inject(DestroyRef);
-        this.broadcastInitialized = false;
         this._flags = EvolutionServiceFlags.None;
         this._loggedIn = signal(false, /* @ts-ignore */
         ...(ngDevMode ? [{ debugName: "_loggedIn" }] : /* istanbul ignore next */ []));
@@ -503,17 +507,40 @@ class EvolutionService {
         this.loggingIn = signal(false, /* @ts-ignore */
         ...(ngDevMode ? [{ debugName: "loggingIn" }] : /* istanbul ignore next */ []));
     }
-    /** Base URI of the Evolution back-end service. */
+    /**
+     * Gets the base URI of the Evolution back-end service.
+     * @returns The configured service URI, or undefined before initialize().
+     */
     get serviceUri() {
         return this._serviceUri;
     }
-    /** Feature flags controlling service behaviour (notifications, embedded mode, etc.). */
+    /**
+     * Sets the base URI of the Evolution back-end service.
+     * @param uri - The base URL.
+     * @returns void
+     */
+    setServiceUri(uri) {
+        this._serviceUri = uri;
+    }
+    /**
+     * Gets the active feature flags.
+     * @returns The active {@link EvolutionServiceFlags} bitmask.
+     */
     get flags() {
         return this._flags;
     }
     /**
-     * Returns the current login info, hydrating it from `localStorage` on first access
-     * when no in-memory value is available.
+     * Sets the active feature flags.
+     * @param flags - The flags bitmask to apply.
+     * @returns void
+     */
+    setFlags(flags) {
+        this._flags = flags;
+    }
+    /**
+     * Gets the current login info, hydrating it from `localStorage` on first
+     * access when no in-memory value is available.
+     * @returns The current {@link EvolutionLoginInfo}, or undefined.
      */
     get loginInfo() {
         if (!this._loginInfo) {
@@ -527,11 +554,263 @@ class EvolutionService {
         }
         return this._loginInfo;
     }
+    /**
+     * Sets the logged-in state.
+     * @param value - The new logged-in value.
+     * @returns void
+     */
+    setLoggedIn(value) {
+        this._loggedIn.set(value);
+    }
+    /**
+     * Records the OAuth provider / remember flag on the login info, creating the
+     * container if needed.
+     * @param oauth - The OAuth provider type, if any.
+     * @param remember - Whether the session should persist across restarts.
+     * @returns void
+     */
+    setAuthMeta(oauth, remember) {
+        if (!this._loginInfo) {
+            this._loginInfo = { context: undefined };
+        }
+        this._loginInfo.oauth = oauth;
+        this._loginInfo.remember = remember;
+    }
+    /**
+     * Persists the current login info to `localStorage`.
+     * @returns void
+     */
+    storeContext() {
+        localStorage.setItem('evolution_context', JSON.stringify(this._loginInfo));
+    }
+    /**
+     * Merges a login result into the stored login info and persists it.
+     * @param result - The login result returned by the login endpoint.
+     * @returns void
+     */
+    updateContext(result) {
+        if (!this._loginInfo) {
+            this._loginInfo = { context: undefined };
+        }
+        this._loginInfo.context = result.context;
+        this.storeContext();
+    }
+    /**
+     * Resets the in-memory login state and broadcasts a logout-completed event.
+     * Does NOT touch storage; call {@link clear} for a full cleanup.
+     * @returns void
+     */
+    reset() {
+        this._loginInfo = undefined;
+        this._loggedIn.set(false);
+        this.broadcastService.sendMessage(EvolutionMessages.LOGOUT_COMPLETED);
+    }
+    /**
+     * Removes Evolution session data from `sessionStorage` and calls {@link reset}.
+     * @param clearOAuthToken - When true, also removes the stored OAuth2 access token.
+     * @returns void
+     */
+    clear(clearOAuthToken = false) {
+        sessionStorage.removeItem('evolution_auth');
+        sessionStorage.removeItem('evolution_refresh');
+        sessionStorage.removeItem('evolution_oauth');
+        if (clearOAuthToken) {
+            sessionStorage.removeItem('evolution_oauth_token');
+        }
+        this.reset();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: CoreService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: CoreService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: CoreService, decorators: [{
+            type: Service
+        }] });
+
+/** Account endpoints (the `Links` section): user links management. */
+class AccountService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.core = inject(CoreService);
+    }
+    /**
+     * 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.core.serviceUri + '/account/links/save', item);
+    }
+    /**
+     * 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.core.serviceUri + '/account/links/delete', item);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: AccountService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: AccountService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: AccountService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Compliance endpoints: taxonomy & groups, context, registers, laws and
+ * activities (the `Context` / `Registers` / `Laws` / `Activities` sections,
+ * plus the general taxonomy/groups lookups). Pure HTTP; injects the private
+ * {@link CoreService} only to read the back-end URI.
+ */
+class ComplianceService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.core = inject(CoreService);
+    }
+    // ── Taxonomy & groups ───────────────────────────────────────────────────────
+    /**
+     * Retrieves the taxonomy tree from the back end.
+     * @returns An observable that emits `ApiResult<FolderTree>`.
+     */
+    getTaxonomy() {
+        return this.httpClient.get(this.core.serviceUri + '/taxonomy');
+    }
+    /**
+     * 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) {
+        const path = register
+            ? `/compliance/groups/?group=${group}&register=${register}`
+            : `/compliance/groups/?group=${group}`;
+        return this.httpClient.get(this.core.serviceUri + path);
+    }
+    // ── 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.core.serviceUri + '/compliance/context', params);
+    }
+    // ── Registers ────────────────────────────────────────────────────────────────
+    /**
+     * 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.core.serviceUri + '/compliance/registers/' + id);
+    }
+    /**
+     * 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.core.serviceUri + '/compliance/registers/profiles/collect', params);
+    }
+    // ── Laws ─────────────────────────────────────────────────────────────────────
+    /**
+     * 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.core.serviceUri + '/compliance/laws/add', params);
+    }
+    /**
+     * 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.core.serviceUri + '/compliance/laws/export', params, { responseType: 'blob' });
+    }
+    // ── Activities ─────────────────────────────────────────────────────────────────
+    /**
+     * 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.core.serviceUri + '/compliance/activities/add', params);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ComplianceService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ComplianceService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ComplianceService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Authentication service for the Evolution module: login / logout / MFA,
+ * session bootstrap, connectivity ping and the broadcast handler.
+ * All session state lives in the private {@link CoreService}; this service
+ * orchestrates the HTTP flows and re-publishes the parts of core that
+ * consumers need.
+ */
+class LoginService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.broadcastService = inject(BroadcastService);
+        this.destroyRef = inject(DestroyRef);
+        this.core = inject(CoreService);
+        this.broadcastInitialized = false;
+    }
+    // ── Re-published core state (CoreService stays private) ─────────────────────
+    /**
+     * Gets the base URI of the Evolution back-end service.
+     * @returns The configured service URI, or undefined before initialize().
+     */
+    get serviceUri() { return this.core.serviceUri; }
+    /**
+     * Gets the active feature flags.
+     * @returns The active {@link EvolutionServiceFlags} bitmask.
+     */
+    get flags() { return this.core.flags; }
+    /**
+     * Gets the current login info.
+     * @returns The current {@link EvolutionLoginInfo}, or undefined.
+     */
+    get loginInfo() { return this.core.loginInfo; }
+    /** `true` when the user has an active (non-temporary) session. */
+    get loggedIn() { return this.core.loggedIn; }
+    /** `true` while a login request is in flight. */
+    get loggingIn() { return this.core.loggingIn; }
+    // ── Re-published core operations ────────────────────────────────────────────
+    /**
+     * Persists the current login info to `localStorage` (delegates to core).
+     * @returns void
+     */
+    storeContext() { this.core.storeContext(); }
+    /**
+     * Merges a login result into the stored login info (delegates to core).
+     * @param result - The login result returned by the login endpoint.
+     * @returns void
+     */
+    updateContext(result) { this.core.updateContext(result); }
+    /**
+     * Resets the in-memory login state and broadcasts logout-completed (delegates to core).
+     * @returns void
+     */
+    reset() { this.core.reset(); }
+    /**
+     * Removes Evolution session data and resets the state (delegates to core).
+     * @param clearOAuthToken - When true, also removes the stored OAuth2 access token.
+     * @returns void
+     */
+    clear(clearOAuthToken = false) { this.core.clear(clearOAuthToken); }
+    // ── Lifecycle ───────────────────────────────────────────────────────────────
     /**
      * 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`).
+     * @param serviceUri - Base URL of the Evolution service.
+     * @param flags - Bitmask of `EvolutionServiceFlags` (default: `None`).
+     * @returns void
      */
     initialize(serviceUri, flags = EvolutionServiceFlags.None) {
         // Create a unique per-tab client ID if not already set
@@ -540,8 +819,8 @@ class EvolutionService {
                 ? 'embedded'
                 : SystemUtils.generateUUID());
         }
-        this._serviceUri = serviceUri;
-        this._flags = flags;
+        this.core.setServiceUri(serviceUri);
+        this.core.setFlags(flags);
         // Subscribe to broadcast messages (only once)
         if (!this.broadcastInitialized) {
             this.broadcastInitialized = true;
@@ -553,14 +832,15 @@ class EvolutionService {
             });
         }
         // If a session is already active (e.g. after an F5 page refresh), notify consumers
-        if (this.loggedIn()) {
-            this.loggingIn.set(false);
+        if (this.core.loggedIn()) {
+            this.core.loggingIn.set(false);
             this.broadcastService.sendMessage(EvolutionMessages.LOGIN_COMPLETED);
         }
     }
     /**
      * Dispatches an incoming broadcast message to the appropriate handler.
      * @param message - The message received from the broadcast channel.
+     * @returns void
      */
     handleBroadcastMessage(message) {
         if (message.id === EvolutionMessages.LOGIN_CHANGED) {
@@ -568,13 +848,13 @@ class EvolutionService {
             this.login(undefined, undefined, true, data?.['oauth'], data?.['oauthAccessToken']).subscribe({
                 next: r => {
                     if (!r.success) {
-                        if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
+                        if ((this.core.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
                             this.broadcastService.sendMessage(EvolutionMessages.ERROR, { message: "Le credenziali di accesso sono cambiate o non sono più valide. Esegui un nuovo accesso." });
                         }
                         this.broadcastService.sendMessage(EvolutionMessages.LOGIN_FAILED);
                     }
                     else {
-                        if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
+                        if ((this.core.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
                             this.broadcastService.sendMessage(EvolutionMessages.SUCCESS_TOAST, { message: 'Connesso a Evolution', icon: 'power', duration: 1500 });
                         }
                     }
@@ -583,7 +863,7 @@ class EvolutionService {
             });
         }
         else if (message.id === EvolutionMessages.LOGOUT) {
-            if (this.loggedIn()) {
+            if (this.core.loggedIn()) {
                 this.logout().subscribe(r => {
                     if (!r.success) {
                         if (r.message) {
@@ -591,46 +871,29 @@ class EvolutionService {
                         }
                     }
                     else {
-                        if ((this.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
+                        if ((this.core.flags & EvolutionServiceFlags.DisplayConnectionStateMessages) > 0) {
                             this.broadcastService.sendMessage(EvolutionMessages.SUCCESS_TOAST, { message: 'Disconnesso da Evolution', icon: 'power_off', duration: 1500 });
                         }
                     }
                 });
             }
             else {
-                this.clear();
+                this.core.clear();
             }
         }
     }
     /**
      * Sends a one-shot ping to the back end to verify connectivity.
+     * @returns void
      */
     ping() {
         this.httpClient
-            .get(this._serviceUri + '/ping?nocache=' + SystemUtils.generateUUID())
+            .get(this.core.serviceUri + '/ping?nocache=' + SystemUtils.generateUUID())
             .pipe(catchError(() => EMPTY))
             .subscribe();
     }
-    /**
-     * Persists the current login info to `localStorage`.
-     */
-    storeContext() {
-        localStorage.setItem('evolution_context', JSON.stringify(this._loginInfo));
-    }
-    /**
-     * 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) {
-            this._loginInfo = { context: undefined };
-        }
-        this._loginInfo.context = result.context;
-        this.storeContext();
-    }
     /**
      * 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.
      */
@@ -655,6 +918,7 @@ class EvolutionService {
     /**
      * Performs an automatic logout, notifying the user when the session ends.
      * @param onSuccess - Optional callback invoked after the logout completes.
+     * @returns void
      */
     autoLogout(onSuccess) {
         this.logout().subscribe({
@@ -676,18 +940,17 @@ class EvolutionService {
         });
     }
     /**
-     * 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.
+     * Authenticates the user against the Evolution back end (credential or OAuth2).
+     * @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) {
         return this.httpClient
-            .post(this._serviceUri + '/login2', {
+            .post(this.core.serviceUri + '/login2', {
             user: oauth ? null : email,
             password: oauth ? null : password,
             remember,
@@ -699,11 +962,7 @@ class EvolutionService {
         })
             .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;
+                this.core.setAuthMeta(oauth, remember);
                 if (!oauth && r.value?.requiresMfa) {
                     this.broadcastService.sendMessage(EvolutionMessages.LOGIN_PENDING, {});
                 }
@@ -717,11 +976,12 @@ class EvolutionService {
     /**
      * Finalises a successful login by updating the stored context and notifying consumers.
      * @param result - The login result payload from the server.
+     * @returns void
      */
     completeLogin(result) {
-        this.updateContext(result);
-        this._loggedIn.set(!result.context?.isTemporary);
-        this.loggingIn.set(false);
+        this.core.updateContext(result);
+        this.core.setLoggedIn(!result.context?.isTemporary);
+        this.core.loggingIn.set(false);
         this.broadcastService.sendMessage(EvolutionMessages.LOGIN_COMPLETED);
     }
     /**
@@ -731,7 +991,7 @@ class EvolutionService {
      */
     confirmIdentity(code) {
         return this.httpClient
-            .post(this._serviceUri + '/login/confirm/' + code, {})
+            .post(this.core.serviceUri + '/login/confirm/' + code, {})
             .pipe(catchError(err => throwError(() => err)), map((r) => {
             if (r.success) {
                 this.completeLogin(r.value);
@@ -746,9 +1006,9 @@ class EvolutionService {
      */
     logout(forget = false) {
         return this.httpClient
-            .post(this._serviceUri + '/logout/?forget=' + forget, {})
+            .post(this.core.serviceUri + '/logout/?forget=' + forget, {})
             .pipe(finalize(() => {
-            this.clear();
+            this.core.clear();
             localStorage.removeItem('evolution_context');
         }), catchError(() => of({ success: false, value: undefined, message: undefined })));
     }
@@ -759,7 +1019,7 @@ class EvolutionService {
      */
     loginSwitch(id) {
         return this.httpClient
-            .post(this._serviceUri + '/login/switch', { userId: id })
+            .post(this.core.serviceUri + '/login/switch', { userId: id })
             .pipe(catchError(err => throwError(() => err)), map((r) => {
             if (r.success) {
                 this.completeLogin(r.value);
@@ -767,149 +1027,73 @@ class EvolutionService {
             return r;
         }));
     }
-    /**
-     * 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() {
-        this._loginInfo = undefined;
-        this._loggedIn.set(false);
-        this.broadcastService.sendMessage(EvolutionMessages.LOGOUT_COMPLETED);
-    }
-    /**
-     * Removes Evolution session data from `sessionStorage` and calls `reset()`.
-     * @param clearOAuthToken - When `true`, also removes the stored OAuth2 access token.
-     */
-    clear(clearOAuthToken = false) {
-        sessionStorage.removeItem('evolution_auth');
-        sessionStorage.removeItem('evolution_refresh');
-        sessionStorage.removeItem('evolution_oauth');
-        if (clearOAuthToken) {
-            sessionStorage.removeItem('evolution_oauth_token');
-        }
-        this.reset();
-    }
-    /**
-     * 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, undefined);
-    }
-    /**
-     * 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) {
-        const nodes = [];
-        for (const n of folders) {
-            const node = {
-                id: n.id,
-                name: n.name,
-                count: n.count,
-                parent,
-                children: undefined,
-                bag: n,
-            };
-            node.children = n.children && n.children.length > 0
-                ? this._toNodes(n.children, node)
-                : [];
-            nodes.push(node);
-        }
-        return nodes;
-    }
-    /**
-     * Retrieves the taxonomy tree from the back end.
-     * @returns An observable that emits `ApiResult<FolderTree>`.
-     */
-    getTaxonomy() {
-        return this.httpClient.get(this._serviceUri + '/taxonomy');
-    }
-    /**
-     * 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) {
-        const path = register
-            ? `/compliance/groups/?group=${group}&register=${register}`
-            : `/compliance/groups/?group=${group}`;
-        return this.httpClient.get(this._serviceUri + path);
-    }
-    // ── 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 ──────────────────────────────────────────────────────────────
-    /**
-     * 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);
-    }
-    /**
-     * 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);
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: LoginService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: LoginService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: LoginService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Public entry point for the Evolution compliance module.
+ *
+ * The private {@link CoreService} is never exposed; its state and operations
+ * are re-published here. All endpoint operations are reached through the
+ * namespaced sub-services:
+ *   - `evolution.session`    — authentication / session lifecycle
+ *   - `evolution.compliance` — taxonomy, context, registers, laws, activities
+ *   - `evolution.account`    — user links
+ *
+ * The facade itself exposes ONLY the re-published core state/operations plus
+ * `initialize` and `ping` — it intentionally does NOT flatten the sub-service
+ * methods (use the namespaces for those).
+ */
+class EvolutionService {
+    constructor() {
+        /** Private: never exposed to consumers. */
+        this.core = inject(CoreService);
+        /** Authentication / session lifecycle sub-service. */
+        this.session = inject(LoginService);
+        /** Compliance endpoints: taxonomy, groups, context, registers, laws, activities. */
+        this.compliance = inject(ComplianceService);
+        /** Account endpoints: user links management. */
+        this.account = inject(AccountService);
     }
-    // ── Laws ───────────────────────────────────────────────────────────────────
+    // ── Re-published core state ─────────────────────────────────────────────────
     /**
-     * Adds one or more compliance laws.
-     * @param params - The laws to add.
-     * @returns An observable that emits `ApiResult<EvolutionComplianceLaw[]>`.
+     * Gets the base URI of the Evolution back-end service.
+     * @returns The configured service URI, or undefined before initialize().
      */
-    addLaws(params) {
-        return this.httpClient.post(this._serviceUri + '/compliance/laws/add', params);
-    }
-    // ── Activities ─────────────────────────────────────────────────────────────
+    get serviceUri() { return this.core.serviceUri; }
     /**
-     * Adds one or more compliance activities.
-     * @param params - The activities to add.
-     * @returns An observable that emits `ApiResult<EvolutionComplianceActivity>`.
+     * Gets the active feature flags.
+     * @returns The active {@link EvolutionServiceFlags} bitmask.
      */
-    addActivities(params) {
-        return this.httpClient.post(this._serviceUri + '/compliance/activities/add', params);
-    }
+    get flags() { return this.core.flags; }
     /**
-     * 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.
+     * Gets the current login info.
+     * @returns The current {@link EvolutionLoginInfo}, or undefined.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    exportLaws(params) {
-        return this.httpClient.post(this._serviceUri + '/compliance/laws/export', params, { responseType: 'blob' });
-    }
-    // ── Links ──────────────────────────────────────────────────────────────────
+    get loginInfo() { return this.core.loginInfo; }
+    /** `true` when the user has an active (non-temporary) session. */
+    get loggedIn() { return this.core.loggedIn; }
+    /** `true` while a login request is in flight. */
+    get loggingIn() { return this.core.loggingIn; }
+    // ── Lifecycle (the only flattened sub-service methods) ──────────────────────
     /**
-     * Persists a user link on the server.
-     * @param item - The user link to save.
-     * @returns An observable that emits `ApiResult<boolean>`.
+     * Initialises the service with the back-end URI and optional feature flags.
+     * @param serviceUri - Base URL of the Evolution service.
+     * @param flags - Bitmask of `EvolutionServiceFlags` (default: `None`).
+     * @returns void
      */
-    saveLink(item) {
-        return this.httpClient.post(this._serviceUri + '/account/links/save', item);
+    initialize(serviceUri, flags = EvolutionServiceFlags.None) {
+        this.session.initialize(serviceUri, flags);
     }
     /**
-     * Deletes a user link from the server.
-     * @param item - The user link to delete.
-     * @returns An observable that emits `ApiResult<boolean>`.
+     * Sends a one-shot ping to the back end to verify connectivity.
+     * @returns void
      */
-    deleteLink(item) {
-        return this.httpClient.post(this._serviceUri + '/account/links/delete', item);
-    }
+    ping() { this.session.ping(); }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: EvolutionService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
     static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: EvolutionService }); }
 }
@@ -1007,6 +1191,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImpor
             type: Injectable
         }] });
 
+// Public barrel for the Evolution services.
+//
+// CoreService is intentionally NOT exported: it is private/internal and must
+// never be injected directly. Consumers use EvolutionService (the full facade,
+// with both namespaced sub-services and the backward-compatible flat methods)
+// or, in size-sensitive code, the specific sub-service they need.
+
 /*
  * Public API Surface of ars-utils
  */
@@ -1015,5 +1206,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { ERPComplianceActivityState, ERPComplianceLawOrigin, ERPComplianceLawState, ERPComplianceLawsSelectionType, ERPComplianceNotificationLimit, ERPComplianceProfileFlags, ERPComplianceProfileRole, ERPComplianceRegisterNotificationType, ERPComplianceRegisterSiteImportOptions, ERPComplianceScope, ERPExportFormat, ERPExportPart, ERPExportSource, ERPExportType, ERPModule, ERPPlace, ERPPlacePermission, ERPRecurrenceFrequencyType, EvolutionAuthInterceptor, EvolutionComplianceActivityStates, EvolutionComplianceContextInfo, EvolutionComplianceLawChangeStates, EvolutionComplianceLawOrigins, EvolutionComplianceLawStates, EvolutionComplianceNotificationLimits, EvolutionComplianceNotifications, EvolutionComplianceObligationAuthorities, EvolutionComplianceObligationTypes, EvolutionComplianceProfileFlags, EvolutionComplianceProfileRoles, EvolutionComplianceScopes, EvolutionMessages, EvolutionRecurrenceFrequencyTypes, EvolutionService, EvolutionServiceFlags };
+export { AccountService, ComplianceService, ERPComplianceActivityState, ERPComplianceLawOrigin, ERPComplianceLawState, ERPComplianceLawsSelectionType, ERPComplianceNotificationLimit, ERPComplianceProfileFlags, ERPComplianceProfileRole, ERPComplianceRegisterNotificationType, ERPComplianceRegisterSiteImportOptions, ERPComplianceScope, ERPExportFormat, ERPExportPart, ERPExportSource, ERPExportType, ERPModule, ERPPlace, ERPPlacePermission, ERPRecurrenceFrequencyType, EvolutionAuthInterceptor, EvolutionComplianceActivityStates, EvolutionComplianceContextInfo, EvolutionComplianceLawChangeStates, EvolutionComplianceLawOrigins, EvolutionComplianceLawStates, EvolutionComplianceNotificationLimits, EvolutionComplianceNotifications, EvolutionComplianceObligationAuthorities, EvolutionComplianceObligationTypes, EvolutionComplianceProfileFlags, EvolutionComplianceProfileRoles, EvolutionComplianceScopes, EvolutionMessages, EvolutionRecurrenceFrequencyTypes, EvolutionService, EvolutionServiceFlags, LoginService };
 //# sourceMappingURL=arsedizioni-ars-utils-evolution.common.mjs.map