@arsedizioni/ars-utils 22.0.34 → 22.0.35

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

@@ -1,10 +1,10 @@
 import * as i0 from '@angular/core';
-import { signal, computed, inject, DestroyRef, Service, Injectable } from '@angular/core';
+import { signal, computed, inject, Service, DestroyRef, Injector, Injectable } from '@angular/core';
 import { HttpClient, HttpHeaders, HttpRequest, HttpErrorResponse } from '@angular/common/http';
-import { BroadcastService, SplashService, SystemUtils } from '@arsedizioni/ars-utils/core';
-import { EMPTY, throwError, of, catchError as catchError$1 } from 'rxjs';
-import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { BroadcastService, SystemUtils, SplashService } from '@arsedizioni/ars-utils/core';
+import { throwError, of, EMPTY, catchError as catchError$1 } from 'rxjs';
 import { catchError, map, finalize } from 'rxjs/operators';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 
 const ClipperMessages = {
     /**
@@ -2191,486 +2191,119 @@ const NotesColors = [{ name: "Verde", value: "#2E8B74" },
     { name: "Indaco", value: "#5B6EBF" }
 ];
 
-class ClipperService {
+/**
+ * Document search, references, export and metadata, plus the dashboard counters,
+ * taxonomy/topics/tags lookups, the working-documents "bag" and saved searches.
+ */
+class ClipperDocumentsService {
     constructor() {
         this.httpClient = inject(HttpClient);
-        this.destroyRef = inject(DestroyRef);
         this.broadcastService = inject(BroadcastService);
-        this.splashService = inject(SplashService);
-        this.broadcastInitialized = false;
-        this._serviceUri = '';
-        this._flags = ClipperServiceFlags.None;
-        this._loggedIn = signal(sessionStorage.getItem("clipper_oauth_token") !== null, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "_loggedIn" }] : /* istanbul ignore next */ []));
-        this.loggedIn = this._loggedIn.asReadonly();
-        this.loggingIn = signal(false, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "loggingIn" }] : /* istanbul ignore next */ []));
-        this.snapshot = signal(undefined, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "snapshot" }] : /* istanbul ignore next */ []));
-        this.supportsRS = signal(false, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "supportsRS" }] : /* istanbul ignore next */ []));
-        this.referencesSnapshot = signal(undefined, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "referencesSnapshot" }] : /* istanbul ignore next */ []));
-        this.dashboard = new ClipperDashboard();
-        this.bag = signal([], /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "bag" }] : /* istanbul ignore next */ []));
-        this.bagTotal = computed(() => this.bag().length, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "bagTotal" }] : /* istanbul ignore next */ []));
-        this.visible = signal(false, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
-        this._teams = [];
-        this.availableChannels = signal([], /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "availableChannels" }] : /* istanbul ignore next */ []));
-        this.activeChannels = computed(() => {
-            return this.availableChannels()?.filter(x => !x.suspended && !x.disabled && x.active === true);
-        }, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "activeChannels" }] : /* istanbul ignore next */ []));
-        this.allowTags = signal(false, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "allowTags" }] : /* istanbul ignore next */ []));
-        this.pendingNotes = signal(undefined, /* @ts-ignore */
-        ...(ngDevMode ? [{ debugName: "pendingNotes" }] : /* istanbul ignore next */ []));
-    }
-    get appUri() {
-        return this._appUri;
+        this.core = inject(ClipperCoreService);
     }
-    get serviceUri() {
-        return this._serviceUri;
+    /////
+    // DOCUMENTS
+    /////
+    /**
+     * Queries documents matching the given search parameters.
+     * @param params - The document search parameters.
+     * @returns An observable emitting the API result wrapping the search result.
+     */
+    query(params) {
+        return this.httpClient.post(this.core.serviceUri + '/documents', params);
     }
-    get flags() {
-        return this._flags;
+    /**
+     * Retrieves the facets for a document query.
+     * @param params - The document search parameters.
+     * @returns An observable emitting the API result wrapping the search facets.
+     */
+    queryFacets(params) {
+        return this.httpClient.post(this.core.serviceUri + '/documents/facets', params);
     }
-    get loginInfo() {
-        if (!this._loginInfo) {
-            const loginInfo = localStorage.getItem('clipper_context');
-            if (loginInfo) {
-                try {
-                    this._loginInfo = JSON.parse(loginInfo);
-                }
-                catch { }
-            }
-        }
-        return this._loginInfo;
+    /**
+     * Updates the state of one or more documents.
+     * @param params - The document state update parameters.
+     * @returns An observable emitting the API result wrapping the number of updated documents.
+     */
+    updateState(params) {
+        return this.httpClient.post(this.core.serviceUri + '/documents/state/update', params);
     }
-    get teams() {
-        return this._teams;
+    /**
+     * Exports a single document in PDF format.
+     * @param id - The ID of the document to export.
+     * @returns An observable emitting the PDF binary content as a blob.
+     */
+    exportPdf(id) {
+        return this.httpClient.get(this.core.serviceUri + '/documents/export/' + id, { responseType: 'blob' });
     }
     /**
-     * Initialises the service with the API base URI, optional app URI, and feature flags.
-     * @param serviceUri - The base URI of the Clipper REST API.
-     * @param appUri - Optional URI of the Clipper web application (used to build document links).
-     * @param flags - Feature flags that control service behaviour. Defaults to `ClipperServiceFlags.None`.
+     * Exports a document list (query or selected items), or exports deadlines as ICS.
+     * @param params - The export parameters.
+     * @returns An observable emitting the exported content as a blob.
      */
-    initialize(serviceUri, appUri, flags = ClipperServiceFlags.None) {
-        // Create unique client and machine  id
-        if (!sessionStorage.getItem('clipper_client_id')) {
-            sessionStorage.setItem('clipper_client_id', (flags && ClipperServiceFlags.Embedded) > 0
-                ? 'embedded'
-                : SystemUtils.generateUUID());
-        }
-        // Initialize
-        this._serviceUri = serviceUri;
-        this._appUri = appUri;
-        this._flags = flags;
-        // React to message broadcasting
-        if (!this.broadcastInitialized) {
-            this.broadcastInitialized = true;
-            this.broadcastService.getMessage()
-                .pipe(takeUntilDestroyed(this.destroyRef))
-                .subscribe(message => {
-                if (message.id === ClipperMessages.LOGIN_CHANGED) {
-                    this.login(undefined, undefined, true, message.data?.oauth ?? undefined, message.data?.oauthAccessToken ?? undefined).subscribe({
-                        next: r => {
-                            if (!r.success) {
-                                if ((this.flags & ClipperServiceFlags.DisplayConnectionStateMessages) > 0) {
-                                    this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: "Le credenziali di accesso sono cambiate o non sono più valide. Esegui un nuovo accesso." });
-                                }
-                                this.broadcastService.sendMessage(ClipperMessages.LOGIN_FAILED);
-                            }
-                            else {
-                                if ((this.flags & ClipperServiceFlags.DisplayConnectionStateMessages) > 0) {
-                                    this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Connesso a Clipper", icon: 'power', duration: 1500 });
-                                }
-                                // Load bag
-                                this.loadBag();
-                            }
-                        },
-                        error: () => { console.error("Clipper non disponibile."); } // Avoid unwanted errors on client
-                    });
-                }
-                else if (message.id === ClipperMessages.LOGOUT) {
-                    if (this.loggedIn()) {
-                        this.logout().subscribe(r => {
-                            if (!r.success) {
-                                if (r.message) {
-                                    this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: "<p>" + r.message + "</p><br><br><hr><p class='small'><i>Per eliminare la configurazione di Clipper accedere a:<br><b>menu > personalizza > collegamenti</b></i></p>" });
-                                }
-                            }
-                            else {
-                                if ((this.flags & ClipperServiceFlags.DisplayConnectionStateMessages) > 0) {
-                                    this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Disconnesso da Clipper", icon: 'power_off', duration: 1500 });
-                                }
-                                // Empty bag
-                                this.bag.set([]);
-                            }
-                        });
-                    }
-                    else {
-                        this.clear();
-                    }
-                }
-            });
-        }
-        // Eveluate current session storage in case of page refresh (F5)
-        if (this.loggedIn()) {
-            // Auto login
-            this.loggingIn.set(false);
-            // Initialize channels
-            this.initializeChannels();
-            // Notify 
-            this.broadcastService.sendMessage(ClipperMessages.LOGIN_COMPLETED);
-        }
+    export(params) {
+        return this.httpClient.post(this.core.serviceUri + '/documents/export', params, { responseType: 'blob' });
     }
     /**
-   * Ping
-   */
-    ping() {
-        this.httpClient.get(this._serviceUri + '/ping?nocache=' + SystemUtils.generateUUID())
-            .pipe(catchError(() => { return EMPTY; }))
-            .subscribe();
+     * Sends document links by email.
+     * @param params - The send-by-email parameters including recipients and documents.
+     * @returns An observable emitting the API result wrapping the number of sent items.
+     */
+    sendTo(params) {
+        return this.httpClient.post(this.core.serviceUri + '/documents/send', params);
     }
     /**
-     * Persists the current login context to `localStorage`.
+     * Sends an email notification about a document note update to the specified recipients.
+     * @param params - The notification parameters including recipients and note details.
+     * @returns An observable emitting the API result wrapping the note tracking update.
      */
-    storeContext() {
-        localStorage.setItem('clipper_context', JSON.stringify(this._loginInfo));
+    notifyNoteTo(params) {
+        return this.httpClient.post(this.core.serviceUri + '/documents/notes/notify', params);
     }
     /**
-     * Updates the stored login context with the values from a fresh login result.
-     * @param result - The login result containing the new user context and channel settings.
+     * Retrieves the full document report page.
+     * @param id - The ID of the document.
+     * @returns An observable emitting the report content as a blob.
      */
-    updateContext(result) {
-        if (!this._loginInfo) {
-            this._loginInfo = { context: undefined };
-        }
-        this._loginInfo.context = result.context;
-        this._loginInfo.channels = result.settings;
-        this.storeContext();
+    report(id) {
+        return this.httpClient.get(this.core.serviceUri + '/documents/report/' + id, { responseType: 'blob' });
     }
     /**
-     * Attempts an automatic login using the credentials currently stored in session storage.
-     * @param onSuccess - Optional callback invoked with the login result value on success.
+     * Gets the comment associated with a document.
+     * @param id - The ID of the document.
+     * @returns An observable emitting the API result wrapping the comment text.
      */
-    autoLogin(onSuccess) {
-        this.login(undefined, undefined, true)
-            .subscribe({
-            next: r => {
-                if (!r.success) {
-                    this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
-                }
-                else {
-                    if (!r.value.requiresMfa) {
-                        this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Connesso a Clipper", icon: 'power', duration: 1500 });
-                    }
-                    if (onSuccess) {
-                        onSuccess(r.value);
-                    }
-                }
-            },
-            error: () => { this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: "Clipper non disponibile." }); }
-        });
+    comment(id) {
+        return this.httpClient.get(this.core.serviceUri + '/documents/comment/' + id);
     }
     /**
-     * Performs an automatic logout and clears the stored session.
-     * @param onSuccess - Optional callback invoked after a successful logout.
+     * Gets the info for a document.
+     * @param id - The ID of the document.
+     * @returns An observable emitting the API result wrapping the document info.
      */
-    autoLogout(onSuccess) {
-        this.logout()
-            .subscribe({
-            next: r => {
-                if (!r.success) {
-                    if (r.message) {
-                        this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
-                    }
-                    this.broadcastService.sendMessage(ClipperMessages.LOGIN_CHANGED);
-                }
-                else {
-                    this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Disconnesso da Clipper", icon: 'power_off', duration: 1500 });
-                }
-            },
-            error: () => { },
-            complete: () => {
-                if (onSuccess) {
-                    onSuccess();
-                }
-            }
-        });
+    info(id) {
+        return this.httpClient.get(this.core.serviceUri + '/documents/info/' + id);
     }
     /**
-     * Authenticates the user against the Clipper API, supporting both credential-based and
-     * OAuth2 login flows.
-     * @param email - The user's email address (credential login only).
-     * @param password - The user's password (credential login only).
-     * @param remember - When `true`, the session is remembered across browser restarts.
-     * @param oauth - The OAuth2 provider type, when authenticating via SSO.
-     * @param oauthAccessToken - The OAuth2 bearer token. Defaults to the value stored in session storage.
+     * Gets the structure (index) of a document.
+     * @param id - The ID of the document.
+     * @returns An observable emitting the API result wrapping the document structure.
      */
-    login(email, password, remember, oauth, oauthAccessToken = sessionStorage.getItem("clipper_oauth_token") ?? undefined) {
-        this.splashService.setMessage('Accesso in corso...');
-        return this.httpClient
-            .post(this._serviceUri + '/login2', {
-            user: oauth ? null : email,
-            password: oauth ? null : password,
-            remember: remember,
-            oauth: oauth
-        }, {
-            headers: !oauth || !oauthAccessToken
-                ? new HttpHeaders()
-                : new HttpHeaders()
-                    .set("Authorization", 'Bearer ' + oauthAccessToken)
-        })
-            .pipe(catchError(err => {
-            return 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
-                    this.broadcastService.sendMessage(ClipperMessages.LOGIN_PENDING);
-                }
-                else {
-                    // Complete login
-                    this.completeLogin(r.value);
-                }
-            }
-            return r;
-        }));
+    index(id) {
+        return this.httpClient.get(this.core.serviceUri + '/documents/structure/' + id);
     }
     /**
-     * Finalises the login flow by updating the stored context, setting the logged-in signal,
-     * initialising channels, and broadcasting `LOGIN_COMPLETED`.
-     * @param result - The login result returned by the API.
+     * Gets the last-update metadata for a document.
+     * @param id - The ID of the document.
+     * @returns An observable emitting the API result wrapping the last update string and its notes.
      */
-    completeLogin(result) {
-        // Update context info            
-        this.updateContext(result);
-        this._loggedIn.set(!result.context?.isTemporary);
-        this.loggingIn.set(false);
-        // Initialize channels
-        this.initializeChannels();
-        // Notify
-        this.broadcastService.sendMessage(ClipperMessages.LOGIN_COMPLETED);
+    metadata(id) {
+        return this.httpClient.get(this.core.serviceUri + '/documents/metadata/' + id);
     }
     /**
-     * Submits the MFA confirmation code to complete a two-factor login flow.
-     * @param code - The one-time confirmation code provided to the user.
-     */
-    confirmIdentity(code) {
-        return this.httpClient
-            .post(this._serviceUri + '/login/confirm/' + code, {})
-            .pipe(catchError((err) => {
-            return throwError(() => err);
-        }), map((r) => {
-            if (r.success) {
-                this.completeLogin(r.value);
-            }
-            return r;
-        }));
-    }
-    /**
-     * Logs the user out and clears the current session.
-     * @param forget - When `true`, all stored user credentials are also removed.
-     */
-    logout(forget = false) {
-        return this.httpClient.post(this._serviceUri + '/logout/?forget=' + forget, {})
-            .pipe(finalize(() => {
-            this.clear(true);
-            // Clean up
-            localStorage.removeItem('clipper_context');
-        }), catchError((_e) => {
-            return of([]);
-        }));
-    }
-    /**
-     * Resets the login state, clears the stored login info, and broadcasts `LOGOUT_COMPLETED`.
-     */
-    reset() {
-        // Clear login info
-        this._loginInfo = undefined;
-        // Logged out
-        this._loggedIn.set(false);
-        // Reset channels
-        this.availableChannels.set([]);
-        // Notify
-        this.broadcastService.sendMessage(ClipperMessages.LOGOUT_COMPLETED);
-    }
-    /**
-     * Clears all session-storage authentication keys and resets the login state.
-     * @param clearOAuthToken - When `true`, the OAuth bearer token is also removed.
-     */
-    clear(clearOAuthToken = false) {
-        // Clear local storage
-        sessionStorage.removeItem('clipper_auth');
-        sessionStorage.removeItem('clipper_oauth');
-        if (clearOAuthToken) {
-            sessionStorage.removeItem('clipper_oauth_token');
-        }
-        // Reset login
-        this.reset();
-    }
-    /**
-     * Applies a new dashboard result: updates channel settings, dashboard counters, and
-     * re-initialises the available-channels signal.
-     * @param value - The dashboard result containing updated channel and counter data.
-     */
-    setChannelsState(value) {
-        // Update channels
-        if (this._loginInfo) {
-            this._loginInfo.channels = value.channels ?? [];
-        }
-        // Update dashboard
-        this.dashboard.documentUpdates = value.documentUpdates;
-        this.dashboard.expiredDeadlines = value.expiredDeadlines;
-        this.dashboard.expiringDeadlines = value.expiringDeadlines;
-        this.dashboard.isTrial = value.isTrial;
-        this.dashboard.items.set(value.items ?? []);
-        this.broadcastService.sendMessage(ClipperMessages.COMMAND_DASHBOARD_UPDATED);
-        this.storeContext();
-        this.initializeChannels();
-    }
-    /**
-     * Replaces the stored channel settings and re-initialises the available-channels signal.
-     * @param channels - The new channel settings to store and activate.
-     */
-    setChannels(channels) {
-        if (this._loginInfo) {
-            this._loginInfo.channels = channels;
-            this.storeContext();
-            this.initializeChannels();
-        }
-    }
-    /**
-     * Rebuilds the `availableChannels` signal from the current login context.
-     */
-    initializeChannels() {
-        if (this.loginInfo) {
-            const channels = [];
-            this.loginInfo.channels?.forEach(n => {
-                const channelSubscription = this.loginInfo?.context?.channels?.find(x => x.channel === n.channelId);
-                n.isSuspended = channelSubscription?.isSuspended === true;
-                const channel = ClipperChannels.find(x => x.value === n.channelId);
-                if (channel) {
-                    channel.disabled = !n.isActive;
-                    channel.suspended = n.isSuspended === true;
-                    channel.active = n.isActive === true && n.isEnabled === true;
-                    channels.push(channel);
-                }
-            });
-            this.availableChannels.set(channels);
-        }
-    }
-    /**
-     * Toggles the active state of available channels based on the supplied selection list.
-     * @param values - The selected channel items; channels absent from this list are deactivated.
-     */
-    updateChannels(values) {
-        this.availableChannels().forEach(channel => {
-            if (!channel.disabled) {
-                channel.active = values?.findIndex(x => x.value === channel.value) !== -1;
-            }
-        });
-    }
-    /**
-     * Requests a new one-time password for the given repository.
-     * @param id - The repository ID for which the OTP should be generated.
-     */
-    newOTP(id) {
-        return this.httpClient.get(this._serviceUri + '/otp/new/?id=' + id);
-    }
-    /**
-     * Load Ars events calendar
-     */
-    events(params) {
-        return this.httpClient.post(this._serviceUri + '/ars/events', params);
-    }
-    /**
-     * Query documents
-     */
-    query(params) {
-        return this.httpClient.post(this._serviceUri + '/documents', params);
-    }
-    /**
-     * Get facets for a query
-     */
-    queryFacets(params) {
-        return this.httpClient.post(this._serviceUri + '/documents/facets', params);
-    }
-    /**
-    * Update document state
-    */
-    updateState(params) {
-        return this.httpClient.post(this._serviceUri + '/documents/state/update', params);
-    }
-    /**
-     * Export a document in pdf format
-     */
-    exportPdf(id) {
-        return this.httpClient.get(this._serviceUri + '/documents/export/' + id, { responseType: 'blob' });
-    }
-    /**
-   * Export document list (query or selected items) or export deadlines as ics
-   */
-    export(params) {
-        return this.httpClient.post(this._serviceUri + '/documents/export', params, { responseType: 'blob' });
-    }
-    /**
-     * Send documents link by email
-     */
-    sendTo(params) {
-        return this.httpClient.post(this._serviceUri + '/documents/send', params);
-    }
-    /**
-     * Sends an email notification about a document note update to the specified recipients.
-     * @param params - The notification parameters including recipients and note details.
-     */
-    notifyNoteTo(params) {
-        return this.httpClient.post(this._serviceUri + '/documents/notes/notify', params);
-    }
-    /**
-     * Display a page the full document report
-     */
-    report(id) {
-        return this.httpClient.get(this._serviceUri + '/documents/report/' + id, { responseType: 'blob' });
-    }
-    /**
-     * Get document comment
-     */
-    comment(id) {
-        return this.httpClient.get(this._serviceUri + '/documents/comment/' + id);
-    }
-    /**
-     * Get document info
-     */
-    info(id) {
-        return this.httpClient.get(this._serviceUri + '/documents/info/' + id);
-    }
-    /**
-     * Get document structure
-     */
-    index(id) {
-        return this.httpClient.get(this._serviceUri + '/documents/structure/' + id);
-    }
-    /**
-     * Get document last update
-     */
-    metadata(id) {
-        return this.httpClient.get(this._serviceUri + '/documents/metadata/' + id);
-    }
-    /**
-     * Query document references
+     * Queries document references, changes or jurisprudence depending on the requested mode.
+     * @param params - The references search parameters; `mode` defaults to `ReferencesIn`.
+     * @returns An observable emitting the API result wrapping the search result, or `null` for an unsupported mode.
      */
     references(params) {
         let mode = params.mode;
@@ -2680,18 +2313,20 @@ class ClipperService {
             case ClipperQueryReferencesMode.ReferencesIn:
             case ClipperQueryReferencesMode.ReferencesOut:
                 params.mode = mode;
-                return this.httpClient.post(this._serviceUri + '/documents/references', params);
+                return this.httpClient.post(this.core.serviceUri + '/documents/references', params);
             case ClipperQueryReferencesMode.ChangesIn:
             case ClipperQueryReferencesMode.ChangesOut:
-                return this.httpClient.post(this._serviceUri + '/documents/changes', params);
+                return this.httpClient.post(this.core.serviceUri + '/documents/changes', params);
             case ClipperQueryReferencesMode.Juris:
-                return this.httpClient.post(this._serviceUri + '/documents/juris', params);
+                return this.httpClient.post(this.core.serviceUri + '/documents/juris', params);
             default:
                 return null;
         }
     }
     /**
-     * Get facets for a document references
+     * Retrieves the facets for a document references query.
+     * @param params - The references search parameters; `mode` defaults to `ReferencesIn`.
+     * @returns An observable emitting the API result wrapping the search facets, or `null` for an unsupported mode.
      */
     referencesFacets(params) {
         let mode = params.mode ?? ClipperQueryReferencesMode.ReferencesIn;
@@ -2699,72 +2334,83 @@ class ClipperService {
             case ClipperQueryReferencesMode.ReferencesIn:
             case ClipperQueryReferencesMode.ReferencesOut:
                 params.mode = mode;
-                return this.httpClient.post(this._serviceUri + '/documents/references/facets', params);
+                return this.httpClient.post(this.core.serviceUri + '/documents/references/facets', params);
             case ClipperQueryReferencesMode.ChangesIn:
             case ClipperQueryReferencesMode.ChangesOut:
-                return this.httpClient.post(this._serviceUri + '/documents/changes/facets', params);
+                return this.httpClient.post(this.core.serviceUri + '/documents/changes/facets', params);
             case ClipperQueryReferencesMode.Juris:
-                return this.httpClient.post(this._serviceUri + '/documents/juris/facets', params);
+                return this.httpClient.post(this.core.serviceUri + '/documents/juris/facets', params);
             default: return null;
         }
     }
     /**
-     * Wrap document rendering to allow token refresh
+     * Wraps document rendering to allow token refresh.
+     * @returns An observable emitting the API result wrapping a boolean readiness flag.
      */
     preRender() {
-        return this.httpClient.get(this._serviceUri + '/documents/pre-render?nocache=' + SystemUtils.generateUUID());
+        return this.httpClient.get(this.core.serviceUri + '/documents/pre-render?nocache=' + SystemUtils.generateUUID());
     }
     /**
-     * Get document juris articles
+     * Gets the jurisprudence articles for a document query.
+     * @param params - The document search parameters.
+     * @returns An observable emitting the API result wrapping the search result.
      */
     jurisArticles(params) {
-        return this.httpClient.post(this._serviceUri + '/documents/juris/articles', params);
+        return this.httpClient.post(this.core.serviceUri + '/documents/juris/articles', params);
     }
     /**
-    * Get deadlines snapshot based on the deadlines
-    */
+     * Gets a deadlines snapshot based on the supplied deadlines.
+     * @param params - The calendar search parameters.
+     * @returns An observable emitting the API result wrapping the calendar snapshot result.
+     */
     deadlinesSnapshot(params) {
-        return this.httpClient.post(this._serviceUri + '/documents/calendar/snapshot', params);
+        return this.httpClient.post(this.core.serviceUri + '/documents/calendar/snapshot', params);
     }
     /**
-     * Retrieve the taxonomy
+     * Retrieves the taxonomy.
+     * @param params - Optional taxonomy parameters. Defaults to `{ model: 0, countItems: false }`.
+     * @returns An observable emitting the API result wrapping the taxonomy folder tree.
      */
     getTaxonomy(params) {
-        return this.httpClient.post(this._serviceUri + '/taxonomy', params ?? { model: 0, countItems: false });
+        return this.httpClient.post(this.core.serviceUri + '/taxonomy', params ?? { model: 0, countItems: false });
     }
     /**
-     * Retrieve topics
+     * Retrieves the topics as a flat list.
+     * @returns An observable emitting the API result wrapping the list of topics.
      */
     getTopics() {
-        return this.httpClient.get(this._serviceUri + '/topics');
+        return this.httpClient.get(this.core.serviceUri + '/topics');
     }
     /**
-    * Retrieve topics as tree
-    */
+     * Retrieves the topics as a tree.
+     * @returns An observable emitting the API result wrapping the topics folder tree.
+     */
     getTopicsAsTree() {
-        return this.httpClient.get(this._serviceUri + '/topics2');
+        return this.httpClient.get(this.core.serviceUri + '/topics2');
     }
     /**
-     * Retrieve tags
+     * Retrieves the tags.
+     * @returns An observable emitting the API result wrapping the list of tags.
      */
     getTags() {
-        return this.httpClient.get(this._serviceUri + '/tags');
+        return this.httpClient.get(this.core.serviceUri + '/tags');
     }
     ///
     // DASHBOARD
     ///
     /**
-    * Retrieve current dashboard
-    */
+     * Retrieves the current dashboard and applies its counters to the shared dashboard state.
+     * @returns The subscription to the dashboard request.
+     */
     loadDashboard() {
         return this.httpClient
-            .post(this._serviceUri + '/account/dashboard', { refreshing: true }).subscribe((r) => {
+            .post(this.core.serviceUri + '/account/dashboard', { refreshing: true }).subscribe((r) => {
             if (r.success) {
-                this.dashboard.documentUpdates = r.value.documentUpdates;
-                this.dashboard.expiredDeadlines = r.value.expiredDeadlines;
-                this.dashboard.expiringDeadlines = r.value.expiringDeadlines;
-                this.dashboard.isTrial = r.value.isTrial;
-                this.dashboard.items.set(r.value.items ?? []);
+                this.core.dashboard.documentUpdates = r.value.documentUpdates;
+                this.core.dashboard.expiredDeadlines = r.value.expiredDeadlines;
+                this.core.dashboard.expiringDeadlines = r.value.expiringDeadlines;
+                this.core.dashboard.isTrial = r.value.isTrial;
+                this.core.dashboard.items.set(r.value.items ?? []);
                 this.broadcastService.sendMessage(ClipperMessages.COMMAND_DASHBOARD_UPDATED);
             }
         });
@@ -2772,9 +2418,10 @@ class ClipperService {
     /**
      * Retrieves documents updated in the last 15 days for the given search parameters.
      * @param params - The search parameters to filter results.
+     * @returns An observable emitting the API result wrapping the last-days result.
      */
     last15Days(params) {
-        return this.httpClient.post(this._serviceUri + '/account/last-15-days', params);
+        return this.httpClient.post(this.core.serviceUri + '/account/last-15-days', params);
     }
     /**
      * Adjusts the unread-item counter for the given module and broadcasts a dashboard update.
@@ -2785,19 +2432,20 @@ class ClipperService {
     updateUnreadItems(module, model, increment) {
         increment ??= 0;
         if (increment !== 0) {
-            this.dashboard.updateUnreadItems(module, model, increment);
+            this.core.dashboard.updateUnreadItems(module, model, increment);
         }
         this.broadcastService.sendMessage(ClipperMessages.COMMAND_DASHBOARD_UPDATED);
     }
     ///
-    // BAG - WORKING DOCUMENTS
+    // BAG
     ///
     /**
-     * Load working documents
+     * Loads the working documents and populates the shared bag.
+     * @returns The subscription to the working-documents request.
      */
     loadBag() {
         return this.httpClient
-            .get(this.serviceUri + '/documents/working')
+            .get(this.core.serviceUri + '/documents/working')
             .subscribe(r => {
             if (!r.success) {
                 this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
@@ -2819,7 +2467,7 @@ class ClipperService {
                             items.push(n);
                         }
                     });
-                    this.bag.set(items);
+                    this.core.bag.set(items);
                 }
             }
         });
@@ -2827,10 +2475,11 @@ class ClipperService {
     /**
      * Adds one or more documents to the working documents bag.
      * @param documentIds - The IDs of the documents to add.
+     * @returns The subscription to the add-to-bag request.
      */
     addToBag(documentIds) {
         return this.httpClient
-            .post(this.serviceUri + '/documents/working/add', { documentIds: documentIds })
+            .post(this.core.serviceUri + '/documents/working/add', { documentIds: documentIds })
             .subscribe((r) => {
             if (!r.success) {
                 this.broadcastService.sendMessage(ClipperMessages.LOGIN_CHANGED);
@@ -2851,7 +2500,7 @@ class ClipperService {
                         }
                     });
                     if (newItems.length > 0) {
-                        this.bag.update((values) => [...values, ...newItems]);
+                        this.core.bag.update((values) => [...values, ...newItems]);
                     }
                     this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Operazione completata con successo.", icon: 'check', duration: 1500 });
                 }
@@ -2861,18 +2510,19 @@ class ClipperService {
     /**
      * Removes a document from the working documents bag.
      * @param documentId - The ID of the document to remove.
+     * @returns The subscription to the remove-from-bag request.
      */
     removeFromBag(documentId) {
         return this.httpClient
-            .post(this.serviceUri + '/documents/working/delete', { documentIds: [documentId] })
+            .post(this.core.serviceUri + '/documents/working/delete', { documentIds: [documentId] })
             .subscribe((r) => {
             if (!r.success) {
                 this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
             }
             else {
-                const p = this.bag().findIndex((n) => n.documentId === documentId);
+                const p = this.core.bag().findIndex((n) => n.documentId === documentId);
                 if (p !== -1) {
-                    this.bag.update((values) => {
+                    this.core.bag.update((values) => {
                         values.splice(p, 1);
                         return [...values];
                     });
@@ -2882,128 +2532,671 @@ class ClipperService {
         });
     }
     /**
-     * Clear all working documents
+     * Clears all working documents from the bag.
+     * @returns The subscription to the clear-bag request.
+     */
+    clearBag() {
+        return this.httpClient
+            .post(this.core.serviceUri + '/documents/working/delete', { deleteAll: true })
+            .subscribe((r) => {
+            if (!r.success) {
+                this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
+            }
+            else {
+                this.core.bag.set([]);
+                this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Operazione completata con successo.", icon: 'check', duration: 1500 });
+            }
+        });
+    }
+    /**
+     * Retrieves the saved searches for the given module.
+     * @param module - The Clipper module whose saved searches to load.
+     * @returns An observable emitting the API result wrapping the list of saved searches.
+     */
+    loadSearches(module) {
+        return this.httpClient
+            .get(this.core.serviceUri + '/documents/searches/?module=' + module);
+    }
+    /**
+     * Persists a user search configuration on the server.
+     * @param params - The search configuration to save.
+     * @returns An observable emitting the API result wrapping the saved search.
+     */
+    saveSearch(params) {
+        return this.httpClient
+            .post(this.core.serviceUri + '/documents/searches/save', params);
+    }
+    /**
+     * Deletes a saved search by its ID.
+     * @param id - The ID of the saved search to remove.
+     * @returns An observable emitting the API result wrapping the number of deleted searches.
+     */
+    deleteSearch(id) {
+        return this.httpClient
+            .post(this.core.serviceUri + '/documents/searches/delete', { id: id });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperDocumentsService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperDocumentsService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperDocumentsService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Authentication: credential / OAuth2 login, MFA confirmation, logout and OTP.
+ * Shared login context, channels and the logged-in flag live in `ClipperCoreService`.
+ */
+class ClipperLoginService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.broadcastService = inject(BroadcastService);
+        this.splashService = inject(SplashService);
+        this.core = inject(ClipperCoreService);
+    }
+    /**
+     * Attempts an automatic login using the credentials currently stored in session storage.
+     * @param onSuccess - Optional callback invoked with the login result value on success.
+     */
+    autoLogin(onSuccess) {
+        this.login(undefined, undefined, true)
+            .subscribe({
+            next: r => {
+                if (!r.success) {
+                    this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
+                }
+                else {
+                    if (!r.value.requiresMfa) {
+                        this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Connesso a Clipper", icon: 'power', duration: 1500 });
+                    }
+                    if (onSuccess) {
+                        onSuccess(r.value);
+                    }
+                }
+            },
+            error: () => { this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: "Clipper non disponibile." }); }
+        });
+    }
+    /**
+     * Performs an automatic logout and clears the stored session.
+     * @param onSuccess - Optional callback invoked after a successful logout.
+     */
+    autoLogout(onSuccess) {
+        this.logout()
+            .subscribe({
+            next: r => {
+                if (!r.success) {
+                    if (r.message) {
+                        this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
+                    }
+                    this.broadcastService.sendMessage(ClipperMessages.LOGIN_CHANGED);
+                }
+                else {
+                    this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Disconnesso da Clipper", icon: 'power_off', duration: 1500 });
+                }
+            },
+            error: () => { },
+            complete: () => {
+                if (onSuccess) {
+                    onSuccess();
+                }
+            }
+        });
+    }
+    /**
+     * Authenticates the user against the Clipper API, supporting both credential-based and
+     * OAuth2 login flows.
+     * @param email - The user's email address (credential login only).
+     * @param password - The user's password (credential login only).
+     * @param remember - When `true`, the session is remembered across browser restarts.
+     * @param oauth - The OAuth2 provider type, when authenticating via SSO.
+     * @param oauthAccessToken - The OAuth2 bearer token. Defaults to the value stored in session storage.
+     * @returns An observable emitting the API result wrapping the login result.
+     */
+    login(email, password, remember, oauth, oauthAccessToken = sessionStorage.getItem("clipper_oauth_token") ?? undefined) {
+        this.splashService.setMessage('Accesso in corso...');
+        return this.httpClient
+            .post(this.core.serviceUri + '/login2', {
+            user: oauth ? null : email,
+            password: oauth ? null : password,
+            remember: remember,
+            oauth: oauth
+        }, {
+            headers: !oauth || !oauthAccessToken
+                ? new HttpHeaders()
+                : new HttpHeaders()
+                    .set("Authorization", 'Bearer ' + oauthAccessToken)
+        })
+            .pipe(catchError(err => {
+            return throwError(() => err);
+        }), map((r) => {
+            if (r.success) {
+                const info = this.core.ensureLoginInfo();
+                info.oauth = oauth;
+                info.remember = remember;
+                if (!oauth && r.value.requiresMfa) {
+                    // Notify login is pending
+                    this.broadcastService.sendMessage(ClipperMessages.LOGIN_PENDING);
+                }
+                else {
+                    // Complete login
+                    this.completeLogin(r.value);
+                }
+            }
+            return r;
+        }));
+    }
+    /**
+     * Finalises the login flow by updating the stored context, setting the logged-in signal,
+     * initialising channels, and broadcasting `LOGIN_COMPLETED`.
+     * @param result - The login result returned by the API.
+     */
+    completeLogin(result) {
+        // Update context info
+        this.core.updateContext(result);
+        this.core.setLoggedIn(!result.context?.isTemporary);
+        this.core.loggingIn.set(false);
+        // Initialize channels
+        this.core.initializeChannels();
+        // Notify
+        this.broadcastService.sendMessage(ClipperMessages.LOGIN_COMPLETED);
+    }
+    /**
+     * Submits the MFA confirmation code to complete a two-factor login flow.
+     * @param code - The one-time confirmation code provided to the user.
+     * @returns An observable emitting the API result wrapping the login result.
+     */
+    confirmIdentity(code) {
+        return this.httpClient
+            .post(this.core.serviceUri + '/login/confirm/' + code, {})
+            .pipe(catchError((err) => {
+            return throwError(() => err);
+        }), map((r) => {
+            if (r.success) {
+                this.completeLogin(r.value);
+            }
+            return r;
+        }));
+    }
+    /**
+     * Logs the user out and clears the current session.
+     * @param forget - When `true`, all stored user credentials are also removed.
+     * @returns An observable that completes once the logout request has been processed.
+     */
+    logout(forget = false) {
+        return this.httpClient.post(this.core.serviceUri + '/logout/?forget=' + forget, {})
+            .pipe(finalize(() => {
+            this.core.clear(true);
+            // Clean up
+            localStorage.removeItem('clipper_context');
+        }), catchError((_e) => {
+            return of([]);
+        }));
+    }
+    /**
+     * Requests a new one-time password for the given repository.
+     * @param id - The repository ID for which the OTP should be generated.
+     * @returns An observable emitting the API result wrapping the generated OTP info.
+     */
+    newOTP(id) {
+        return this.httpClient.get(this.core.serviceUri + '/otp/new/?id=' + id);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperLoginService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperLoginService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperLoginService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Shared state and bootstrap for the Clipper application.
+ *
+ * Holds every piece of state used by more than one feature service (service URI,
+ * flags, login context, teams, dashboard, working-documents bag, channels and the
+ * various UI signals) plus the low-level helpers that mutate that state.
+ *
+ * The feature services (`ClipperLoginService`, `ClipperDocumentsService`, ...) inject
+ * this service to read shared state and call shared helpers. `ClipperService` (the
+ * barrel/facade) re-exports the state declared here.
+ */
+class ClipperCoreService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.destroyRef = inject(DestroyRef);
+        this.broadcastService = inject(BroadcastService);
+        /** Used to lazily resolve feature services inside `initialize`, avoiding circular DI. */
+        this.injector = inject(Injector);
+        this.broadcastInitialized = false;
+        this._serviceUri = '';
+        this._flags = ClipperServiceFlags.None;
+        this._loggedIn = signal(sessionStorage.getItem("clipper_oauth_token") !== null, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "_loggedIn" }] : /* istanbul ignore next */ []));
+        this.loggedIn = this._loggedIn.asReadonly();
+        this.loggingIn = signal(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "loggingIn" }] : /* istanbul ignore next */ []));
+        this.snapshot = signal(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "snapshot" }] : /* istanbul ignore next */ []));
+        this.supportsRS = signal(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "supportsRS" }] : /* istanbul ignore next */ []));
+        this.referencesSnapshot = signal(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "referencesSnapshot" }] : /* istanbul ignore next */ []));
+        this.dashboard = new ClipperDashboard();
+        this.bag = signal([], /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "bag" }] : /* istanbul ignore next */ []));
+        this.bagTotal = computed(() => this.bag().length, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "bagTotal" }] : /* istanbul ignore next */ []));
+        this.visible = signal(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
+        this._teams = [];
+        this.availableChannels = signal([], /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "availableChannels" }] : /* istanbul ignore next */ []));
+        this.activeChannels = computed(() => {
+            return this.availableChannels()?.filter(x => !x.suspended && !x.disabled && x.active === true);
+        }, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "activeChannels" }] : /* istanbul ignore next */ []));
+        this.allowTags = signal(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "allowTags" }] : /* istanbul ignore next */ []));
+        this.pendingNotes = signal(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "pendingNotes" }] : /* istanbul ignore next */ []));
+    }
+    /** @returns The URI of the Clipper web application, or `undefined` if not set. */
+    get appUri() {
+        return this._appUri;
+    }
+    /** @returns The base URI of the Clipper REST API. */
+    get serviceUri() {
+        return this._serviceUri;
+    }
+    /** @returns The active feature flags. */
+    get flags() {
+        return this._flags;
+    }
+    /**
+     * Lazily loads the login context from `localStorage` on first access.
+     * @returns The current login context, or `undefined` if not authenticated.
+     */
+    get loginInfo() {
+        if (!this._loginInfo) {
+            const loginInfo = localStorage.getItem('clipper_context');
+            if (loginInfo) {
+                try {
+                    this._loginInfo = JSON.parse(loginInfo);
+                }
+                catch { }
+            }
+        }
+        return this._loginInfo;
+    }
+    /** @returns The shared teams collection. */
+    get teams() {
+        return this._teams;
+    }
+    ////
+    // SHARED MUTATORS
+    ////
+    /**
+     * Ensures a login-info object exists and returns it for further mutation.
+     * Replaces the inline `if (!this._loginInfo) { ... }` guards now that the field
+     * is private to this service.
+     * @returns The existing login-info object, or a freshly created empty one.
+     */
+    ensureLoginInfo() {
+        if (!this._loginInfo) {
+            this._loginInfo = { context: undefined };
+        }
+        return this._loginInfo;
+    }
+    /**
+     * Sets the logged-in state. The backing signal is read-only to consumers, so the
+     * feature services use this method instead.
+     * @param value - The new logged-in state.
+     */
+    setLoggedIn(value) {
+        this._loggedIn.set(value);
+    }
+    /**
+     * Replaces the shared teams collection (populated by the calendar, archive and
+     * collaboration queries).
+     * @param teams - The teams to store.
+     */
+    setTeams(teams) {
+        this._teams = teams;
+    }
+    /**
+     * Persists the current login context to `localStorage`.
+     */
+    storeContext() {
+        localStorage.setItem('clipper_context', JSON.stringify(this._loginInfo));
+    }
+    /**
+     * Updates the stored login context with the values from a fresh login result.
+     * @param result - The login result containing the new user context and channel settings.
+     */
+    updateContext(result) {
+        const info = this.ensureLoginInfo();
+        info.context = result.context;
+        info.channels = result.settings;
+        this.storeContext();
+    }
+    /**
+     * Rebuilds the `availableChannels` signal from the current login context.
+     */
+    initializeChannels() {
+        if (this.loginInfo) {
+            const channels = [];
+            this.loginInfo.channels?.forEach(n => {
+                const channelSubscription = this.loginInfo?.context?.channels?.find(x => x.channel === n.channelId);
+                n.isSuspended = channelSubscription?.isSuspended === true;
+                const channel = ClipperChannels.find(x => x.value === n.channelId);
+                if (channel) {
+                    channel.disabled = !n.isActive;
+                    channel.suspended = n.isSuspended === true;
+                    channel.active = n.isActive === true && n.isEnabled === true;
+                    channels.push(channel);
+                }
+            });
+            this.availableChannels.set(channels);
+        }
+    }
+    /**
+     * Resets the login state, clears the stored login info, and broadcasts `LOGOUT_COMPLETED`.
+     */
+    reset() {
+        // Clear login info
+        this._loginInfo = undefined;
+        // Logged out
+        this._loggedIn.set(false);
+        // Reset channels
+        this.availableChannels.set([]);
+        // Notify
+        this.broadcastService.sendMessage(ClipperMessages.LOGOUT_COMPLETED);
+    }
+    /**
+     * Clears all session-storage authentication keys and resets the login state.
+     * @param clearOAuthToken - When `true`, the OAuth bearer token is also removed.
+     */
+    clear(clearOAuthToken = false) {
+        // Clear local storage
+        sessionStorage.removeItem('clipper_auth');
+        sessionStorage.removeItem('clipper_oauth');
+        if (clearOAuthToken) {
+            sessionStorage.removeItem('clipper_oauth_token');
+        }
+        // Reset login
+        this.reset();
+    }
+    ////
+    // BOOTSTRAP
+    ////
+    /**
+     * Initialises the service with the API base URI, optional app URI, and feature flags.
+     * @param serviceUri - The base URI of the Clipper REST API.
+     * @param appUri - Optional URI of the Clipper web application (used to build document links).
+     * @param flags - Feature flags that control service behaviour. Defaults to `ClipperServiceFlags.None`.
+     */
+    initialize(serviceUri, appUri, flags = ClipperServiceFlags.None) {
+        // Create unique client and machine  id
+        if (!sessionStorage.getItem('clipper_client_id')) {
+            sessionStorage.setItem('clipper_client_id', (flags && ClipperServiceFlags.Embedded) > 0
+                ? 'embedded'
+                : SystemUtils.generateUUID());
+        }
+        // Initialize
+        this._serviceUri = serviceUri;
+        this._appUri = appUri;
+        this._flags = flags;
+        // React to message broadcasting
+        if (!this.broadcastInitialized) {
+            this.broadcastInitialized = true;
+            this.broadcastService.getMessage()
+                .pipe(takeUntilDestroyed(this.destroyRef))
+                .subscribe(message => {
+                if (message.id === ClipperMessages.LOGIN_CHANGED) {
+                    this.injector.get(ClipperLoginService).login(undefined, undefined, true, message.data?.oauth ?? undefined, message.data?.oauthAccessToken ?? undefined).subscribe({
+                        next: r => {
+                            if (!r.success) {
+                                if ((this.flags & ClipperServiceFlags.DisplayConnectionStateMessages) > 0) {
+                                    this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: "Le credenziali di accesso sono cambiate o non sono più valide. Esegui un nuovo accesso." });
+                                }
+                                this.broadcastService.sendMessage(ClipperMessages.LOGIN_FAILED);
+                            }
+                            else {
+                                if ((this.flags & ClipperServiceFlags.DisplayConnectionStateMessages) > 0) {
+                                    this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Connesso a Clipper", icon: 'power', duration: 1500 });
+                                }
+                                // Load bag
+                                this.injector.get(ClipperDocumentsService).loadBag();
+                            }
+                        },
+                        error: () => { console.error("Clipper non disponibile."); } // Avoid unwanted errors on client
+                    });
+                }
+                else if (message.id === ClipperMessages.LOGOUT) {
+                    if (this.loggedIn()) {
+                        this.injector.get(ClipperLoginService).logout().subscribe(r => {
+                            if (!r.success) {
+                                if (r.message) {
+                                    this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: "<p>" + r.message + "</p><br><br><hr><p class='small'><i>Per eliminare la configurazione di Clipper accedere a:<br><b>menu > personalizza > collegamenti</b></i></p>" });
+                                }
+                            }
+                            else {
+                                if ((this.flags & ClipperServiceFlags.DisplayConnectionStateMessages) > 0) {
+                                    this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Disconnesso da Clipper", icon: 'power_off', duration: 1500 });
+                                }
+                                // Empty bag
+                                this.bag.set([]);
+                            }
+                        });
+                    }
+                    else {
+                        this.clear();
+                    }
+                }
+            });
+        }
+        // Eveluate current session storage in case of page refresh (F5)
+        if (this.loggedIn()) {
+            // Auto login
+            this.loggingIn.set(false);
+            // Initialize channels
+            this.initializeChannels();
+            // Notify
+            this.broadcastService.sendMessage(ClipperMessages.LOGIN_COMPLETED);
+        }
+    }
+    /**
+     * Ping
+     */
+    ping() {
+        this.httpClient.get(this._serviceUri + '/ping?nocache=' + SystemUtils.generateUUID())
+            .pipe(catchError(() => { return EMPTY; }))
+            .subscribe();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperCoreService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperCoreService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperCoreService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Account management: password reset/recovery, settings, channel activation, trial info
+ * and user links. Channel state lives in `ClipperCoreService`; the channel-mutating
+ * helpers (`setChannels`, `setChannelsState`, `updateChannels`) live here.
+ */
+class ClipperAccountService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.broadcastService = inject(BroadcastService);
+        this.core = inject(ClipperCoreService);
+    }
+    /**
+     * Resets the user's password using the provided parameters.
+     * @param params - The new password and confirmation data.
+     * @returns An observable emitting the API result wrapping the reset password payload.
      */
-    clearBag() {
-        return this.httpClient
-            .post(this.serviceUri + '/documents/working/delete', { deleteAll: true })
-            .subscribe((r) => {
-            if (!r.success) {
-                this.broadcastService.sendMessage(ClipperMessages.ERROR, { message: r.message });
-            }
-            else {
-                this.bag.set([]);
-                this.broadcastService.sendMessage(ClipperMessages.SUCCESS_TOAST, { message: "Operazione completata con successo.", icon: 'check', duration: 1500 });
-            }
-        });
+    resetPassword(params) {
+        return this.httpClient.post(this.core.serviceUri + '/account/password/reset', params);
     }
-    ///
-    // WORKING SEARCHES
-    ///
     /**
-     * Retrieves the saved searches for the given module.
-     * @param module - The Clipper module whose saved searches to load.
+     * Initiates a password recovery flow by sending a reset link to the user's email.
+     * @param params - The password recovery request data.
+     * @returns An observable emitting the API result wrapping a boolean success flag.
      */
-    loadSearches(module) {
-        return this.httpClient
-            .get(this.serviceUri + '/documents/searches/?module=' + module);
+    recoverPassword(params) {
+        return this.httpClient.post(this.core.serviceUri + '/account/password/recover', params);
     }
     /**
-     * Persists a user search configuration on the server.
-     * @param params - The search configuration to save.
+     * Gets the current user account settings.
+     * @returns An observable emitting the API result wrapping the account settings.
      */
-    saveSearch(params) {
-        return this.httpClient
-            .post(this.serviceUri + '/documents/searches/save', params);
+    getSettings() {
+        return this.httpClient.get(this.core.serviceUri + '/account/settings');
     }
     /**
-     * Deletes a saved search by its ID.
-     * @param id - The ID of the saved search to remove.
+     * Updates user account settings and applies any channel configuration changes.
+     * @param params - A map of settings key-value pairs to update.
+     * @returns An observable emitting the API result wrapping a boolean success flag.
      */
-    deleteSearch(id) {
-        return this.httpClient
-            .post(this.serviceUri + '/documents/searches/delete', { id: id });
+    updateSettings(params) {
+        return this.httpClient.post(this.core.serviceUri + '/account/settings/update', params).pipe(map(r => {
+            if (r.success) {
+                if (params.channels) {
+                    this.setChannels(params.channels);
+                }
+            }
+            return r;
+        }));
     }
-    ///
-    // CALENDAR
-    ///
     /**
-     * Query calendar
+     * Saves updated channel activation states to the server and applies the new dashboard result.
+     * @param params - The channel state update parameters.
+     * @returns An observable emitting the API result wrapping the dashboard result.
      */
-    queryCalendar(params) {
-        return this.httpClient.post(this._serviceUri + '/calendar', params)
-            .pipe(map((r) => {
-            // Store teams
+    updateChannelsState(params) {
+        return this.httpClient.post(this.core.serviceUri + '/account/settings/channels/update', params).pipe(map(r => {
             if (r.success) {
-                this._teams = r.value.teams;
+                this.setChannelsState(r.value);
             }
             return r;
         }));
     }
     /**
-     * Get the calendar snapshot
+     * Applies a new dashboard result: updates channel settings, dashboard counters, and
+     * re-initialises the available-channels signal.
+     * @param value - The dashboard result containing updated channel and counter data.
      */
-    calendarSnapshot(params) {
-        return this.httpClient.post(this._serviceUri + '/calendar/snapshot', params);
+    setChannelsState(value) {
+        // Update channels
+        const info = this.core.loginInfo;
+        if (info) {
+            info.channels = value.channels ?? [];
+        }
+        // Update dashboard
+        this.core.dashboard.documentUpdates = value.documentUpdates;
+        this.core.dashboard.expiredDeadlines = value.expiredDeadlines;
+        this.core.dashboard.expiringDeadlines = value.expiringDeadlines;
+        this.core.dashboard.isTrial = value.isTrial;
+        this.core.dashboard.items.set(value.items ?? []);
+        this.broadcastService.sendMessage(ClipperMessages.COMMAND_DASHBOARD_UPDATED);
+        this.core.storeContext();
+        this.core.initializeChannels();
     }
     /**
-     * Deletes one or more calendar deadlines by ID.
-     * @param ids - The IDs of the deadlines to delete.
+     * Replaces the stored channel settings and re-initialises the available-channels signal.
+     * @param channels - The new channel settings to store and activate.
      */
-    deleteCalendarDeadlines(ids) {
-        return this.httpClient.post(this._serviceUri + '/calendar/delete', { ids: ids });
+    setChannels(channels) {
+        const info = this.core.loginInfo;
+        if (info) {
+            info.channels = channels;
+            this.core.storeContext();
+            this.core.initializeChannels();
+        }
     }
     /**
-     * Copies one or more calendar deadlines using the given parameters.
-     * @param params - The copy operation parameters.
+     * Toggles the active state of available channels based on the supplied selection list.
+     * @param values - The selected channel items; channels absent from this list are deactivated.
      */
-    copyCalendarDeadlines(params) {
-        return this.httpClient.post(this._serviceUri + '/calendar/copy', params);
+    updateChannels(values) {
+        this.core.availableChannels().forEach(channel => {
+            if (!channel.disabled) {
+                channel.active = values?.findIndex(x => x.value === channel.value) !== -1;
+            }
+        });
     }
     /**
-     * Marks the given calendar deadline as closed.
-     * @param id - The ID of the deadline to close.
+     * Gets the trial info for the current account.
+     * @returns An observable emitting the API result wrapping the trial info.
      */
-    closeCalendarDeadline(id) {
-        return this.httpClient.post(this._serviceUri + '/calendar/close', { id: id });
+    getTrialInfo() {
+        return this.httpClient.get(this.core.serviceUri + '/account/trial');
     }
     /**
-     * Creates or updates a calendar deadline.
-     * @param params - The deadline data to save.
+     * Refreshes the trial status from the server and updates the stored login context.
      */
-    saveCalendarDeadline(params) {
-        return this.httpClient.post(this._serviceUri + '/calendar/save', params);
+    updateTrialInfo() {
+        const info = this.core.loginInfo;
+        if (!info || info?.context?.hasTrial === false)
+            return; // Not supported
+        this.getTrialInfo().subscribe((r) => {
+            if (r.success) {
+                if (info?.context) {
+                    if (r.value) {
+                        info.context.hasTrial = true;
+                        info.context.trialInfo = r.value;
+                    }
+                    else {
+                        info.context.hasTrial = false;
+                        info.context.trialInfo = undefined;
+                    }
+                }
+            }
+        });
     }
     /**
-     * Retrieves a single calendar deadline by its ID.
-     * @param id - The ID of the deadline to retrieve.
+     * Creates or updates a user link record.
+     * @param item - The user link data to save.
+     * @returns An observable emitting the API result wrapping a boolean success flag.
      */
-    getCalendarDeadline(id) {
-        return this.httpClient.get(this._serviceUri + '/calendar/' + id);
+    saveLink(item) {
+        return this.httpClient.post(this.core.serviceUri + '/account/links/save', item);
     }
     /**
-     * Exports the selected deadlines in iCalendar (.ics) format.
-     * @param ids - The IDs of the deadlines to export.
+     * Deletes a user link record.
+     * @param item - The user link to remove.
+     * @returns An observable emitting the API result wrapping a boolean success flag.
      */
-    exportCalendarDeadlines(ids) {
-        return this.httpClient.post(this._serviceUri + '/calendar/export', { ids: ids }, {
-            responseType: 'blob'
-        });
+    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: ClipperAccountService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperAccountService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperAccountService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Document archive: folders and files search, save, copy, delete, import/export and download.
+ */
+class ClipperArchiveService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.core = inject(ClipperCoreService);
     }
-    ///
-    // ARCHIVE
-    ///
     /**
-     * Retrieves all archive folders matching the given search parameters.
+     * Retrieves all archive folders matching the given search parameters and stores the
+     * returned teams in the shared state.
      * @param params - The folder search parameters.
+     * @returns An observable emitting the API result wrapping the folders search result.
      */
     getArchiveFolders(params) {
         return this.httpClient
-            .post(this._serviceUri + '/archive/folders', params)
+            .post(this.core.serviceUri + '/archive/folders', params)
             .pipe(map((r) => {
             // Store teams
             if (r.success) {
-                this._teams = r.value.teams;
+                this.core.setTeams(r.value.teams);
             }
             return r;
         }));
@@ -3011,17 +3204,19 @@ class ClipperService {
     /**
      * Creates or updates an archive folder.
      * @param params - The folder data to save.
+     * @returns An observable emitting the API result wrapping the saved folder.
      */
     saveArchiveFolder(params) {
-        return this.httpClient.post(this._serviceUri + '/archive/folders/save', params);
+        return this.httpClient.post(this.core.serviceUri + '/archive/folders/save', params);
     }
     /**
      * Exports archive folders as a downloadable file.
      * @param id - The folder ID to export, or `undefined` to export all folders.
      * @param teamId - The optional team ID. Defaults to `undefined` (personal workspace).
+     * @returns An observable emitting the exported folders content as a blob.
      */
     exportArchiveFolders(id, teamId) {
-        let url = this._serviceUri + '/archive/export/?';
+        let url = this.core.serviceUri + '/archive/export/?';
         if (id) {
             url += 'id=' + id;
         }
@@ -3041,6 +3236,7 @@ class ClipperService {
     /**
      * Uploads and imports archive folders from a file.
      * @param params - The import parameters including the source file and destination folder.
+     * @returns An observable of HTTP events reporting upload progress and the final response.
      */
     importArchiveFolders(params) {
         // Prepare form
@@ -3055,32 +3251,36 @@ class ClipperService {
             formData.append('teamId', params.teamId);
         }
         // Create request
-        return this.httpClient.request(new HttpRequest('POST', this._serviceUri + '/archive/import/', formData, { reportProgress: true }));
+        return this.httpClient.request(new HttpRequest('POST', this.core.serviceUri + '/archive/import/', formData, { reportProgress: true }));
     }
     /**
      * Retrieves archive files and folders matching the given search parameters.
      * @param params - The archive files search parameters.
+     * @returns An observable emitting the API result wrapping the files search result.
      */
     queryArchiveItems(params) {
-        return this.httpClient.post(this._serviceUri + '/archive/files', params);
+        return this.httpClient.post(this.core.serviceUri + '/archive/files', params);
     }
     /**
      * Deletes one or more archive files or folders.
      * @param params - The delete operation parameters.
+     * @returns An observable emitting the API result wrapping the number of deleted items.
      */
     deleteArchiveItems(params) {
-        return this.httpClient.post(this._serviceUri + '/archive/files/delete', params);
+        return this.httpClient.post(this.core.serviceUri + '/archive/files/delete', params);
     }
     /**
      * Copies archive files or folders to a destination folder.
      * @param params - The copy operation parameters.
+     * @returns An observable emitting the API result wrapping the number of copied items.
      */
     copyArchiveItems(params) {
-        return this.httpClient.post(this._serviceUri + '/archive/files/copy', params);
+        return this.httpClient.post(this.core.serviceUri + '/archive/files/copy', params);
     }
     /**
      * Uploads and saves an archive file using multipart form data.
      * @param params - The file metadata and binary content to save.
+     * @returns An observable of HTTP events reporting upload progress and the final response.
      */
     saveArchiveFile(params) {
         // Prepare form
@@ -3124,139 +3324,148 @@ class ClipperService {
         if (params.model)
             formData.append('model', params.model.toString());
         // Create request
-        return this.httpClient.request(new HttpRequest('POST', this._serviceUri + '/archive/files/save', formData, { reportProgress: true }));
+        return this.httpClient.request(new HttpRequest('POST', this.core.serviceUri + '/archive/files/save', formData, { reportProgress: true }));
     }
     /**
      * Retrieves the metadata for a single archive file.
      * @param id - The ID of the archive file to retrieve.
+     * @returns An observable emitting the API result wrapping the archive file info.
      */
     getArchiveFile(id) {
-        return this.httpClient.get(this._serviceUri + '/archive/files/' + id);
+        return this.httpClient.get(this.core.serviceUri + '/archive/files/' + id);
     }
     /**
      * Downloads the binary content of an archive file.
      * @param id - The binary ID of the file to download.
      * @param otp - An optional one-time password for authenticated downloads.
+     * @returns An observable emitting the file binary content as a blob.
      */
     downloadArchiveFile(id, otp) {
-        return this.httpClient.get(this._serviceUri + '/archive/files/download/?id=' + id + '&otp=' + (otp ?? ''), { responseType: 'blob' });
+        return this.httpClient.get(this.core.serviceUri + '/archive/files/download/?id=' + id + '&otp=' + (otp ?? ''), { responseType: 'blob' });
     }
-    ///
-    // ACCOUNT AND SETTINGS
-    ///
-    /**
-     * Resets the user's password using the provided parameters.
-     * @param params - The new password and confirmation data.
-     */
-    resetPassword(params) {
-        return this.httpClient.post(this._serviceUri + '/account/password/reset', params);
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperArchiveService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperArchiveService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperArchiveService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Calendar deadlines: search, snapshot, save/copy/close/delete and iCalendar export.
+ */
+class ClipperCalendarService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.core = inject(ClipperCoreService);
     }
     /**
-     * Initiates a password recovery flow by sending a reset link to the user's email.
-     * @param params - The password recovery request data.
+     * Queries the calendar and stores the returned teams in the shared state.
+     * @param params - The calendar search parameters.
+     * @returns An observable emitting the API result wrapping the calendar search result.
      */
-    recoverPassword(params) {
-        return this.httpClient.post(this._serviceUri + '/account/password/recover', params);
+    queryCalendar(params) {
+        return this.httpClient.post(this.core.serviceUri + '/calendar', params)
+            .pipe(map((r) => {
+            // Store teams
+            if (r.success) {
+                this.core.setTeams(r.value.teams);
+            }
+            return r;
+        }));
     }
     /**
-     * Gets the current user account settings
+     * Gets the calendar snapshot.
+     * @param params - The calendar search parameters.
+     * @returns An observable emitting the API result wrapping the calendar snapshot result.
      */
-    getSettings() {
-        return this.httpClient.get(this._serviceUri + '/account/settings');
+    calendarSnapshot(params) {
+        return this.httpClient.post(this.core.serviceUri + '/calendar/snapshot', params);
     }
     /**
-     * Updates user account settings and applies any channel configuration changes.
-     * @param params - A map of settings key-value pairs to update.
+     * Deletes one or more calendar deadlines by ID.
+     * @param ids - The IDs of the deadlines to delete.
+     * @returns An observable emitting the API result wrapping the number of deleted deadlines.
      */
-    updateSettings(params) {
-        return this.httpClient.post(this._serviceUri + '/account/settings/update', params).pipe(map(r => {
-            if (r.success) {
-                if (params.channels) {
-                    this.setChannels(params.channels);
-                }
-            }
-            return r;
-        }));
+    deleteCalendarDeadlines(ids) {
+        return this.httpClient.post(this.core.serviceUri + '/calendar/delete', { ids: ids });
     }
     /**
-     * Saves updated channel activation states to the server and applies the new dashboard result.
-     * @param params - The channel state update parameters.
+     * Copies one or more calendar deadlines using the given parameters.
+     * @param params - The copy operation parameters.
+     * @returns An observable emitting the API result wrapping the number of copied deadlines.
      */
-    updateChannelsState(params) {
-        return this.httpClient.post(this._serviceUri + '/account/settings/channels/update', params).pipe(map(r => {
-            if (r.success) {
-                this.setChannelsState(r.value);
-            }
-            return r;
-        }));
+    copyCalendarDeadlines(params) {
+        return this.httpClient.post(this.core.serviceUri + '/calendar/copy', params);
     }
-    ///
-    // TRIAL 
-    ///
     /**
-     * Get trial info
+     * Marks the given calendar deadline as closed.
+     * @param id - The ID of the deadline to close.
+     * @returns An observable emitting the API result wrapping the updated deadline.
      */
-    getTrialInfo() {
-        return this.httpClient.get(this._serviceUri + '/account/trial');
+    closeCalendarDeadline(id) {
+        return this.httpClient.post(this.core.serviceUri + '/calendar/close', { id: id });
     }
     /**
-     * Refreshes the trial status from the server and updates the stored login context.
+     * Creates or updates a calendar deadline.
+     * @param params - The deadline data to save.
+     * @returns An observable emitting the API result wrapping the saved deadlines.
      */
-    updateTrialInfo() {
-        if (!this._loginInfo || this._loginInfo?.context?.hasTrial === false)
-            return; // Not supported
-        this.getTrialInfo().subscribe((r) => {
-            if (r.success) {
-                if (this._loginInfo?.context) {
-                    if (r.value) {
-                        this._loginInfo.context.hasTrial = true;
-                        this._loginInfo.context.trialInfo = r.value;
-                    }
-                    else {
-                        this._loginInfo.context.hasTrial = false;
-                        this._loginInfo.context.trialInfo = undefined;
-                    }
-                }
-            }
-        });
+    saveCalendarDeadline(params) {
+        return this.httpClient.post(this.core.serviceUri + '/calendar/save', params);
     }
-    ///
-    // LINKS
-    ///
     /**
-     * Creates or updates a user link record.
-     * @param item - The user link data to save.
+     * Retrieves a single calendar deadline by its ID.
+     * @param id - The ID of the deadline to retrieve.
+     * @returns An observable emitting the API result wrapping the deadline.
      */
-    saveLink(item) {
-        return this.httpClient.post(this._serviceUri + '/account/links/save', item);
+    getCalendarDeadline(id) {
+        return this.httpClient.get(this.core.serviceUri + '/calendar/' + id);
     }
     /**
-     * Deletes a user link record.
-     * @param item - The user link to remove.
+     * Exports the selected deadlines in iCalendar (.ics) format.
+     * @param ids - The IDs of the deadlines to export.
+     * @returns An observable emitting the iCalendar content as a blob.
      */
-    deleteLink(item) {
-        return this.httpClient.post(this._serviceUri + '/account/links/delete', item);
+    exportCalendarDeadlines(ids) {
+        return this.httpClient.post(this.core.serviceUri + '/calendar/export', { ids: ids }, {
+            responseType: 'blob'
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperCalendarService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperCalendarService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperCalendarService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Collaboration: teams and team members, contacts and shared document notes.
+ */
+class ClipperCollaborationService {
+    constructor() {
+        this.httpClient = inject(HttpClient);
+        this.core = inject(ClipperCoreService);
     }
-    ///
-    // TEAMS
-    ///
     /**
      * Renames the current user's team.
      * @param newName - The new display name for the team.
+     * @returns An observable emitting the API result wrapping the updated team info.
      */
     renameTeam(newName) {
-        return this.httpClient.post(this._serviceUri + '/account/teams/update', { title: newName });
+        return this.httpClient.post(this.core.serviceUri + '/account/teams/update', { title: newName });
     }
     /**
-     * Retrieves the list of teams available to the current user.
+     * Retrieves the list of teams available to the current user. When not querying
+     * admins only, the result is also stored in the shared teams state.
      * @param params - The teams search parameters.
+     * @returns An observable emitting the API result wrapping the teams search result.
      */
     getTeams(params) {
-        return this.httpClient.post(this._serviceUri + '/account/teams', params)
+        return this.httpClient.post(this.core.serviceUri + '/account/teams', params)
             .pipe(map((r) => {
             // Store teams
             if (!params.adminsOnly) {
-                this._teams = r.value.items;
+                this.core.setTeams(r.value.items);
             }
             return r;
         }));
@@ -3264,61 +3473,63 @@ class ClipperService {
     /**
      * Retrieves the members of a team matching the given search parameters.
      * @param params - The team members search parameters.
+     * @returns An observable emitting the API result wrapping the team members search result.
      */
     getTeamMembers(params) {
-        return this.httpClient.post(this._serviceUri + '/account/teams/members', params);
+        return this.httpClient.post(this.core.serviceUri + '/account/teams/members', params);
     }
     /**
      * Removes the specified members from the team.
      * @param teamId - The ID of the team.
      * @param ids - The numeric IDs of the team members to remove.
+     * @returns An observable emitting the API result wrapping the number of removed members.
      */
     deleteTeamMembers(teamId, ids) {
-        return this.httpClient.post(this._serviceUri + '/account/teams/members/delete', { teamId: teamId, ids: ids });
+        return this.httpClient.post(this.core.serviceUri + '/account/teams/members/delete', { teamId: teamId, ids: ids });
     }
     /**
      * Creates or updates a team member record.
      * @param item - The team member data to save.
+     * @returns An observable emitting the API result wrapping the saved team member.
      */
     saveTeamMember(item) {
-        return this.httpClient.post(this._serviceUri + '/account/teams/members/save', item);
+        return this.httpClient.post(this.core.serviceUri + '/account/teams/members/save', item);
     }
-    ///
-    // CONTACTS
-    ///
     /**
      * Retrieves contacts matching the given search parameters.
      * @param params - The contacts search parameters.
+     * @returns An observable emitting the API result wrapping the contacts query result.
      */
     queryContacts(params) {
-        return this.httpClient.post(this._serviceUri + '/account/contacts', params);
+        return this.httpClient.post(this.core.serviceUri + '/account/contacts', params);
     }
     /**
      * Deletes the specified contacts.
      * @param ids - The numeric IDs of the contacts to remove.
+     * @returns An observable emitting the API result wrapping the number of deleted contacts.
      */
     deleteContacts(ids) {
-        return this.httpClient.post(this._serviceUri + '/account/contacts/delete', { ids: ids });
+        return this.httpClient.post(this.core.serviceUri + '/account/contacts/delete', { ids: ids });
     }
     /**
      * Creates or updates a contact record.
      * @param item - The contact data to save.
+     * @returns An observable emitting the API result wrapping the saved contact.
      */
     saveContact(item) {
-        return this.httpClient.post(this._serviceUri + '/account/contacts/save', item);
+        return this.httpClient.post(this.core.serviceUri + '/account/contacts/save', item);
     }
-    ///
-    // NOTES
-    ///
     /**
-     * Retrieves document notes matching the given search parameters.
+     * Retrieves document notes matching the given search parameters and stores the
+     * returned teams in the shared state.
      * @param params - The notes search parameters.
+     * @returns An observable emitting the API result wrapping the notes search result.
      */
     queryNotes(params) {
-        return this.httpClient.post(this._serviceUri + '/account/notes', params).pipe(map((r) => {
+        return this.httpClient.post(this.core.serviceUri + '/account/notes', params).pipe(map((r) => {
             // Store teams
             if (r.success) {
-                this._teams = r.value.teams;
+                this.core.setTeams(r.value.teams);
             }
             return r;
         }));
@@ -3326,30 +3537,122 @@ class ClipperService {
     /**
      * Deletes the specified document notes.
      * @param ids - The numeric IDs of the notes to remove.
+     * @returns An observable emitting the API result wrapping the number of deleted notes.
      */
     deleteNotes(ids) {
-        return this.httpClient.post(this._serviceUri + '/account/notes/delete', { ids: ids });
+        return this.httpClient.post(this.core.serviceUri + '/account/notes/delete', { ids: ids });
     }
     /**
      * Creates or updates a document note.
      * @param item - The note data to save.
+     * @returns An observable emitting the API result wrapping the saved note.
      */
     saveNote(item) {
-        return this.httpClient.post(this._serviceUri + '/account/notes/save', item);
+        return this.httpClient.post(this.core.serviceUri + '/account/notes/save', item);
     }
     /**
      * Retrieves the tracking history for the given document note.
      * @param id - The numeric ID of the note whose tracking records to retrieve.
+     * @returns An observable emitting the API result wrapping the note tracking records.
      */
     getNoteTrackings(id) {
-        return this.httpClient.get(this._serviceUri + '/account/notes/trackings/' + id);
+        return this.httpClient.get(this.core.serviceUri + '/account/notes/trackings/' + id);
     }
     /**
      * Gets the count of troubled tracking notifications for document notes,
      * which can be used to display an unread counter in the UI.
+     * @returns An observable emitting the API result wrapping the troubled tracking count.
      */
     countNotesTrackingsTroubled() {
-        return this.httpClient.get(this._serviceUri + '/account/notes/trackings/troubled');
+        return this.httpClient.get(this.core.serviceUri + '/account/notes/trackings/troubled');
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperCollaborationService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperCollaborationService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperCollaborationService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Barrel / facade for the Clipper application.
+ *
+ * Exposes the feature services as named properties and re-exports the shared state
+ * declared in `ClipperCoreService`. Inject `ClipperService` and reach a feature via
+ * its property, e.g. `clipper.login.login(...)`, `clipper.documents.query(...)`,
+ * `clipper.calendar.queryCalendar(...)`.
+ */
+class ClipperService {
+    constructor() {
+        this.core = inject(ClipperCoreService);
+        /** Authentication: login/logout, MFA, OTP. */
+        this.session = inject(ClipperLoginService);
+        /** Document search, references, export, dashboard, working-documents bag and saved searches. */
+        this.documents = inject(ClipperDocumentsService);
+        /** Account settings, password, channels, trial info and user links. */
+        this.account = inject(ClipperAccountService);
+        /** Archive folders and files. */
+        this.archive = inject(ClipperArchiveService);
+        /** Calendar deadlines. */
+        this.calendar = inject(ClipperCalendarService);
+        /** Teams, contacts and shared notes. */
+        this.collaboration = inject(ClipperCollaborationService);
+    }
+    ////
+    // RE-EXPORTED CORE STATE
+    ////
+    /** @returns The URI of the Clipper web application, or `undefined` if not set. */
+    get appUri() { return this.core.appUri; }
+    /** @returns The base URI of the Clipper REST API. */
+    get serviceUri() { return this.core.serviceUri; }
+    /** @returns The active feature flags. */
+    get flags() { return this.core.flags; }
+    /** @returns The current login context, or `undefined` if not authenticated. */
+    get loginInfo() { return this.core.loginInfo; }
+    /** @returns A read-only signal indicating whether the user is logged in. */
+    get loggedIn() { return this.core.loggedIn; }
+    /** @returns A signal indicating whether a login is in progress. */
+    get loggingIn() { return this.core.loggingIn; }
+    /** @returns A signal holding the current documents search snapshot. */
+    get snapshot() { return this.core.snapshot; }
+    /** @returns A signal indicating whether reference search is supported. */
+    get supportsRS() { return this.core.supportsRS; }
+    /** @returns A signal holding the current references search snapshot. */
+    get referencesSnapshot() { return this.core.referencesSnapshot; }
+    /** @returns The shared dashboard state object. */
+    get dashboard() { return this.core.dashboard; }
+    /** @returns A signal holding the working-documents bag. */
+    get bag() { return this.core.bag; }
+    /** @returns A computed signal with the number of items in the bag. */
+    get bagTotal() { return this.core.bagTotal; }
+    /** @returns A signal controlling the Clipper UI visibility. */
+    get visible() { return this.core.visible; }
+    /** @returns The shared teams collection. */
+    get teams() { return this.core.teams; }
+    /** @returns A signal holding the available channels. */
+    get availableChannels() { return this.core.availableChannels; }
+    /** @returns A computed signal with the currently active channels. */
+    get activeChannels() { return this.core.activeChannels; }
+    /** @returns A signal indicating whether tagging is allowed. */
+    get allowTags() { return this.core.allowTags; }
+    /** @returns A signal with the number of pending notes, or `undefined` if unknown. */
+    get pendingNotes() { return this.core.pendingNotes; }
+    ////
+    // BOOTSTRAP
+    ////
+    /**
+     * Initialises the application with the API base URI, optional app URI, and feature flags.
+     * @param serviceUri - The base URI of the Clipper REST API.
+     * @param appUri - Optional URI of the Clipper web application (used to build document links).
+     * @param flags - Feature flags that control service behaviour. Defaults to `ClipperServiceFlags.None`.
+     */
+    initialize(serviceUri, appUri, flags = ClipperServiceFlags.None) {
+        this.core.initialize(serviceUri, appUri, flags);
+    }
+    /**
+     * Pings the Clipper REST API to keep the session/token alive.
+     */
+    ping() {
+        this.core.ping();
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ClipperService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
     static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ClipperService }); }
@@ -3398,15 +3701,23 @@ class ClipperAuthInterceptor {
     /**
      * Processes an HTTP error, broadcasting a user-friendly message when appropriate.
      * Errors are debounced: only one message is sent per `ERROR_DEBOUNCE_MS` window.
+     *
+     * This handler only ever runs for requests already targeting the Clipper service
+     * (see `intercept`). A transport-level failure produces an `HttpErrorResponse`
+     * with status `0` and a `null` url, so the url is only validated when present —
+     * that way genuine network failures still surface the "service unavailable" message.
      * @param error - The raw error value thrown by the HTTP layer.
      */
     handleError(error) {
         if (!(error instanceof HttpErrorResponse))
             return;
-        if (!error.url?.startsWith(this.clipperService.serviceUri))
+        // Reject only errors that explicitly belong to a different service; a missing
+        // url (network failure on a Clipper request) is allowed through.
+        if (error.url && !error.url.startsWith(this.clipperService.serviceUri))
             return;
         const errorStatus = error.status;
-        const shouldNotify = (errorStatus > 0 && errorStatus < 500) ||
+        const shouldNotify = errorStatus === 0 ||
+            (errorStatus > 0 && errorStatus < 500) ||
             (this.clipperService.flags & ClipperServiceFlags.NotifySystemErrors) > 0;
         if (!shouldNotify)
             return;
@@ -3443,6 +3754,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImpor
             type: Injectable
         }] });
 
+// Public API surface for the Clipper services.
+//
+// `ClipperService` is the facade/barrel: inject it and reach a feature via its
+// property (e.g. `clipper.login.login(...)`, `clipper.documents.query(...)`).
+// The feature and core services are exported as well so they can be injected
+// directly or referenced as types where needed.
+
 /*
  * Public API Surface of ars-utils
  */
@@ -3451,5 +3769,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { ClipperArchiveCopyMode, ClipperArchiveFileStorageType, ClipperArchiveFileStorageTypes, ClipperArchiveFileType, ClipperArchiveFileTypes, ClipperArchiveFilesSearchParams, ClipperArchiveFoldersSearchParams, ClipperAuthInterceptor, ClipperAuthors, ClipperCalendarCopyMode, ClipperCalendarSearchParams, ClipperCalendarState, ClipperCalendarStates, ClipperChannel, ClipperChannelSettings, ClipperChannels, ClipperDashboard, ClipperDocumentChangeReasons, ClipperDocumentContainer, ClipperExportDocumentsFormat, ClipperFacet, ClipperMessages, ClipperModel, ClipperModels, ClipperModule, ClipperModuleGroup, ClipperModuleGroups, ClipperModules, ClipperQueryDocumentFlags, ClipperQueryReferencesMode, ClipperRecurrenceType, ClipperRecurrenceTypes, ClipperRegions, ClipperSearchCalendarSnapshotResult, ClipperSearchFacetsSnapshot, ClipperSearchParams, ClipperSearchResult, ClipperSearchUtils, ClipperSectorTypes, ClipperSectors, ClipperSelectionMode, ClipperService, ClipperServiceFlags, ClipperSort, ClipperSources, ClipperTeamInfo, ClipperTeamProduct, ClipperTeamProductPermission, ClipperUpdateChannelsStateParams, ClipperUtils, NotesColors };
+export { ClipperAccountService, ClipperArchiveCopyMode, ClipperArchiveFileStorageType, ClipperArchiveFileStorageTypes, ClipperArchiveFileType, ClipperArchiveFileTypes, ClipperArchiveFilesSearchParams, ClipperArchiveFoldersSearchParams, ClipperArchiveService, ClipperAuthInterceptor, ClipperAuthors, ClipperCalendarCopyMode, ClipperCalendarSearchParams, ClipperCalendarService, ClipperCalendarState, ClipperCalendarStates, ClipperChannel, ClipperChannelSettings, ClipperChannels, ClipperCollaborationService, ClipperDashboard, ClipperDocumentChangeReasons, ClipperDocumentContainer, ClipperDocumentsService, ClipperExportDocumentsFormat, ClipperFacet, ClipperLoginService, ClipperMessages, ClipperModel, ClipperModels, ClipperModule, ClipperModuleGroup, ClipperModuleGroups, ClipperModules, ClipperQueryDocumentFlags, ClipperQueryReferencesMode, ClipperRecurrenceType, ClipperRecurrenceTypes, ClipperRegions, ClipperSearchCalendarSnapshotResult, ClipperSearchFacetsSnapshot, ClipperSearchParams, ClipperSearchResult, ClipperSearchUtils, ClipperSectorTypes, ClipperSectors, ClipperSelectionMode, ClipperService, ClipperServiceFlags, ClipperSort, ClipperSources, ClipperTeamInfo, ClipperTeamProduct, ClipperTeamProductPermission, ClipperUpdateChannelsStateParams, ClipperUtils, NotesColors };
 //# sourceMappingURL=arsedizioni-ars-utils-clipper.common.mjs.map