@arsedizioni/ars-utils 22.0.34 → 22.0.36

package/types/arsedizioni-ars-utils-clipper.common.d.ts

@@ -1,6 +1,6 @@
-import * as _angular_core from '@angular/core';
-import { Signal } from '@angular/core';
-import { NameValueItem, Folder, QueryModel, LoginResult, QueryResultModel, ApiResult, UpdateResultModel, FolderTree } from '@arsedizioni/ars-utils/core';
+import * as i0 from '@angular/core';
+import { Signal, WritableSignal } from '@angular/core';
+import { NameValueItem, Folder, QueryModel, QueryResultModel, LoginResult, ApiResult, UpdateResultModel, FolderTree } from '@arsedizioni/ars-utils/core';
 import { SendToDialogResult } from '@arsedizioni/ars-utils/ui.application';
 import { LoginOAuthType } from '@arsedizioni/ars-utils/ui.oauth';
 import * as _angular_common_http from '@angular/common/http';
@@ -679,7 +679,7 @@ interface ClipperDashboardResult {
     channels?: ClipperChannelSettings[];
 }
 declare class ClipperDashboard {
-    items: _angular_core.WritableSignal<ClipperDashboardItem[]>;
+    items: i0.WritableSignal<ClipperDashboardItem[]>;
     isTrial?: boolean;
     expiredDeadlines?: number;
     expiringDeadlines?: number;
@@ -1127,108 +1127,56 @@ declare class ClipperAuthInterceptor implements HttpInterceptor {
     /**
      * 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.
      */
     private handleError;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperAuthInterceptor, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClipperAuthInterceptor>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperAuthInterceptor, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperAuthInterceptor>;
 }
 
-declare class ClipperService {
+/**
+ * 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.
+ */
+declare class ClipperAccountService {
     private readonly httpClient;
-    private readonly destroyRef;
     private readonly broadcastService;
-    private readonly splashService;
-    private broadcastInitialized;
-    private _appUri?;
-    get appUri(): string | undefined;
-    private _serviceUri;
-    get serviceUri(): string;
-    private _flags;
-    get flags(): ClipperServiceFlags;
-    private _loginInfo?;
-    get loginInfo(): ClipperLoginInfo | undefined;
-    private readonly _loggedIn;
-    readonly loggedIn: Signal<boolean>;
-    readonly loggingIn: _angular_core.WritableSignal<boolean>;
-    readonly snapshot: _angular_core.WritableSignal<ClipperSearchResult>;
-    readonly supportsRS: _angular_core.WritableSignal<boolean>;
-    readonly referencesSnapshot: _angular_core.WritableSignal<ClipperSearchResult>;
-    readonly dashboard: ClipperDashboard;
-    readonly bag: _angular_core.WritableSignal<ClipperDocumentInfo[]>;
-    readonly bagTotal: Signal<number>;
-    readonly visible: _angular_core.WritableSignal<boolean>;
-    private _teams;
-    get teams(): NameValueItem<string>[];
-    readonly availableChannels: _angular_core.WritableSignal<ClipperAvailableChannel[]>;
-    readonly activeChannels: Signal<ClipperAvailableChannel[]>;
-    readonly allowTags: _angular_core.WritableSignal<boolean>;
-    readonly pendingNotes: _angular_core.WritableSignal<number>;
-    /**
-     * 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: string, appUri?: string, flags?: ClipperServiceFlags): void;
-    /**
-   * Ping
-   */
-    ping(): void;
-    /**
-     * Persists the current login context to `localStorage`.
-     */
-    storeContext(): void;
-    /**
-     * 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: ClipperLoginResult): void;
+    private readonly core;
     /**
-     * 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?: (value?: any) => void): void;
-    /**
-     * Performs an automatic logout and clears the stored session.
-     * @param onSuccess - Optional callback invoked after a successful logout.
-     */
-    autoLogout(onSuccess?: () => void): void;
-    /**
-     * 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.
+     * 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.
      */
-    login(email?: string, password?: string, remember?: boolean, oauth?: LoginOAuthType, oauthAccessToken?: string | undefined): rxjs.Observable<ApiResult<ClipperLoginResult>>;
+    resetPassword(params: ResetPasswordDialogResult): rxjs.Observable<ApiResult<ResetPasswordDialogResult>>;
     /**
-     * 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.
+     * 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.
      */
-    private completeLogin;
+    recoverPassword(params: RecoverPasswordDialogResult): rxjs.Observable<ApiResult<boolean>>;
     /**
-     * Submits the MFA confirmation code to complete a two-factor login flow.
-     * @param code - The one-time confirmation code provided to the user.
+     * Gets the current user account settings.
+     * @returns An observable emitting the API result wrapping the account settings.
      */
-    confirmIdentity(code: string): rxjs.Observable<ApiResult<ClipperLoginResult>>;
-    /**
-     * Logs the user out and clears the current session.
-     * @param forget - When `true`, all stored user credentials are also removed.
-     */
-    logout(forget?: boolean): rxjs.Observable<any>;
+    getSettings(): rxjs.Observable<ApiResult<ClipperSettingsInfo>>;
     /**
-     * Resets the login state, clears the stored login info, and broadcasts `LOGOUT_COMPLETED`.
+     * 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.
      */
-    reset(): void;
+    updateSettings(params: ClipperSettingsInfo): rxjs.Observable<ApiResult<boolean>>;
     /**
-     * Clears all session-storage authentication keys and resets the login state.
-     * @param clearOAuthToken - When `true`, the OAuth bearer token is also removed.
+     * 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.
      */
-    clear(clearOAuthToken?: boolean): void;
+    updateChannelsState(params: ClipperUpdateChannelsStateParams): rxjs.Observable<ApiResult<ClipperDashboardResult>>;
     /**
      * Applies a new dashboard result: updates channel settings, dashboard counters, and
      * re-initialises the available-channels signal.
@@ -1240,119 +1188,41 @@ declare class ClipperService {
      * @param channels - The new channel settings to store and activate.
      */
     setChannels(channels: ClipperChannelSettings[]): void;
-    /**
-     * Rebuilds the `availableChannels` signal from the current login context.
-     */
-    private initializeChannels;
     /**
      * 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: NameValueItem<ClipperChannel>[]): void;
     /**
-     * Requests a new one-time password for the given repository.
-     * @param id - The repository ID for which the OTP should be generated.
-     */
-    newOTP(id: string): rxjs.Observable<ApiResult<ClipperOTPInfo>>;
-    /**
-     * Load Ars events calendar
-     */
-    events(params: ClipperSearchArsEventsParams): rxjs.Observable<ApiResult<ClipperSearchArsEventsResult>>;
-    /**
-     * Query documents
-     */
-    query(params: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperSearchResult>>;
-    /**
-     * Get facets for a query
-     */
-    queryFacets(params: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperSearchFacetsResult>>;
-    /**
-    * Update document state
-    */
-    updateState(params: ClipperDocumentUpdateStateParams): rxjs.Observable<ApiResult<number>>;
-    /**
-     * Export a document in pdf format
-     */
-    exportPdf(id: string): rxjs.Observable<Blob>;
-    /**
-   * Export document list (query or selected items) or export deadlines as ics
-   */
-    export(params: ClipperExportDocumentsParams): rxjs.Observable<Blob>;
-    /**
-     * Send documents link by email
-     */
-    sendTo(params: ClipperSendDocumentsByEmailParams): rxjs.Observable<ApiResult<number>>;
-    /**
-     * Sends an email notification about a document note update to the specified recipients.
-     * @param params - The notification parameters including recipients and note details.
+     * Gets the trial info for the current account.
+     * @returns An observable emitting the API result wrapping the trial info.
      */
-    notifyNoteTo(params: ClipperNotifyDocumentNoteParams): rxjs.Observable<ApiResult<UpdateResultModel<ClipperDocumentNoteTracking>>>;
-    /**
-     * Display a page the full document report
-     */
-    report(id: string): rxjs.Observable<Blob>;
-    /**
-     * Get document comment
-     */
-    comment(id: string): rxjs.Observable<ApiResult<string>>;
-    /**
-     * Get document info
-     */
-    info(id: string): rxjs.Observable<ApiResult<ClipperDocumentInfo>>;
-    /**
-     * Get document structure
-     */
-    index(id: string): rxjs.Observable<ApiResult<ClipperDocumentStructure>>;
-    /**
-     * Get document last update
-     */
-    metadata(id: string): rxjs.Observable<ApiResult<{
-        item1?: string;
-        item2?: ClipperDocumentNote[];
-    }>>;
-    /**
-     * Query document references
-     */
-    references(params: ClipperReferencesSearchParams): rxjs.Observable<ApiResult<ClipperSearchResult>>;
-    /**
-     * Get facets for a document references
-     */
-    referencesFacets(params: ClipperReferencesSearchParams): rxjs.Observable<ApiResult<ClipperSearchFacetsResult>>;
-    /**
-     * Wrap document rendering to allow token refresh
-     */
-    preRender(): rxjs.Observable<ApiResult<boolean>>;
+    private getTrialInfo;
     /**
-     * Get document juris articles
+     * Refreshes the trial status from the server and updates the stored login context.
      */
-    jurisArticles(params: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperSearchResult>>;
-    /**
-    * Get deadlines snapshot based on the deadlines
-    */
-    deadlinesSnapshot(params: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperSearchCalendarSnapshotResult>>;
+    updateTrialInfo(): void;
     /**
-     * Retrieve the taxonomy
+     * 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.
      */
-    getTaxonomy(params?: ClipperTaxonomyParams): rxjs.Observable<ApiResult<FolderTree>>;
+    saveLink(item: ClipperUserLink): rxjs.Observable<ApiResult<boolean>>;
     /**
-     * Retrieve topics
+     * Deletes a user link record.
+     * @param item - The user link to remove.
+     * @returns An observable emitting the API result wrapping a boolean success flag.
      */
-    getTopics(): rxjs.Observable<ApiResult<NameValueItem<string>[]>>;
-    /**
-    * Retrieve topics as tree
-    */
-    getTopicsAsTree(): rxjs.Observable<ApiResult<FolderTree>>;
+    deleteLink(item: ClipperUserLink): rxjs.Observable<ApiResult<boolean>>;
     /**
-     * Retrieve tags
+     * Retrieves the current dashboard and applies its counters to the shared dashboard state.
+     * @returns The subscription to the dashboard request.
      */
-    getTags(): rxjs.Observable<ApiResult<NameValueItem<string>[]>>;
-    /**
-    * Retrieve current dashboard
-    */
     loadDashboard(): rxjs.Subscription;
     /**
      * 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: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperLastDaysResult>>;
     /**
@@ -1362,240 +1232,539 @@ declare class ClipperService {
      * @param increment - The signed increment to apply (use negative values to decrement).
      */
     updateUnreadItems(module: ClipperModule, model?: ClipperModel, increment?: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperAccountService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperAccountService>;
+}
+
+/**
+ * Document archive: folders and files search, save, copy, delete, import/export and download.
+ */
+declare class ClipperArchiveService {
+    private readonly httpClient;
+    private readonly core;
     /**
-     * Load working documents
-     */
-    loadBag(): rxjs.Subscription;
-    /**
-     * Adds one or more documents to the working documents bag.
-     * @param documentIds - The IDs of the documents to add.
-     */
-    addToBag(documentIds: string[]): rxjs.Subscription;
-    /**
-     * Removes a document from the working documents bag.
-     * @param documentId - The ID of the document to remove.
-     */
-    removeFromBag(documentId: string): rxjs.Subscription;
-    /**
-     * Clear all working documents
-     */
-    clearBag(): rxjs.Subscription;
-    /**
-     * Retrieves the saved searches for the given module.
-     * @param module - The Clipper module whose saved searches to load.
-     */
-    loadSearches(module: ClipperModule): rxjs.Observable<ApiResult<ClipperUserSearch[]>>;
-    /**
-     * Persists a user search configuration on the server.
-     * @param params - The search configuration to save.
-     */
-    saveSearch(params: ClipperUserSearch): rxjs.Observable<ApiResult<ClipperUserSearch>>;
-    /**
-     * Deletes a saved search by its ID.
-     * @param id - The ID of the saved search to remove.
-     */
-    deleteSearch(id: number): rxjs.Observable<ApiResult<number>>;
-    /**
-     * Query calendar
-     */
-    queryCalendar(params: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperCalendarSearchResult>>;
-    /**
-     * Get the calendar snapshot
-     */
-    calendarSnapshot(params: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperSearchCalendarSnapshotResult>>;
-    /**
-     * Deletes one or more calendar deadlines by ID.
-     * @param ids - The IDs of the deadlines to delete.
-     */
-    deleteCalendarDeadlines(ids: string[]): rxjs.Observable<ApiResult<number>>;
-    /**
-     * Copies one or more calendar deadlines using the given parameters.
-     * @param params - The copy operation parameters.
-     */
-    copyCalendarDeadlines(params: ClipperCalendarCopyDeadlinesParams): rxjs.Observable<ApiResult<number>>;
-    /**
-     * Marks the given calendar deadline as closed.
-     * @param id - The ID of the deadline to close.
-     */
-    closeCalendarDeadline(id: string): rxjs.Observable<ApiResult<ClipperDeadlineInfo>>;
-    /**
-     * Creates or updates a calendar deadline.
-     * @param params - The deadline data to save.
-     */
-    saveCalendarDeadline(params: ClipperCalendarSaveDeadlineParams): rxjs.Observable<ApiResult<ClipperDeadlineInfo[]>>;
-    /**
-     * Retrieves a single calendar deadline by its ID.
-     * @param id - The ID of the deadline to retrieve.
-     */
-    getCalendarDeadline(id: string): rxjs.Observable<ApiResult<ClipperDeadlineInfo>>;
-    /**
-     * Exports the selected deadlines in iCalendar (.ics) format.
-     * @param ids - The IDs of the deadlines to export.
-     */
-    exportCalendarDeadlines(ids: string[]): rxjs.Observable<Blob>;
-    /**
-     * 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: ClipperArchiveFoldersSearchParams): rxjs.Observable<ApiResult<ClipperArchiveFoldersSearchResult>>;
     /**
      * 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: Folder): rxjs.Observable<ApiResult<Folder>>;
     /**
      * 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?: string, teamId?: string): rxjs.Observable<Blob>;
     /**
      * 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: ClipperArchiveFoldersImportParams): rxjs.Observable<_angular_common_http.HttpEvent<unknown>>;
     /**
      * 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: ClipperArchiveFilesSearchParams): rxjs.Observable<ApiResult<ClipperArchiveFilesSearchResult>>;
     /**
      * 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: ClipperArchiveFilesDeleteParams): rxjs.Observable<ApiResult<number>>;
     /**
      * 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: ClipperArchiveFilesCopyParams): rxjs.Observable<ApiResult<number>>;
     /**
      * 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: ClipperArchiveFileInfo): rxjs.Observable<_angular_common_http.HttpEvent<unknown>>;
     /**
      * 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: string): rxjs.Observable<ApiResult<ClipperArchiveFileInfo>>;
     /**
      * 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: number, otp?: string): rxjs.Observable<Blob>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperArchiveService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperArchiveService>;
+}
+
+/**
+ * Calendar deadlines: search, snapshot, save/copy/close/delete and iCalendar export.
+ */
+declare class ClipperCalendarService {
+    private readonly httpClient;
+    private readonly core;
     /**
-     * Resets the user's password using the provided parameters.
-     * @param params - The new password and confirmation data.
-     */
-    resetPassword(params: ResetPasswordDialogResult): rxjs.Observable<ApiResult<ResetPasswordDialogResult>>;
-    /**
-     * 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: RecoverPasswordDialogResult): rxjs.Observable<ApiResult<boolean>>;
+    queryCalendar(params: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperCalendarSearchResult>>;
     /**
-     * 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(): rxjs.Observable<ApiResult<ClipperSettingsInfo>>;
+    calendarSnapshot(params: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperSearchCalendarSnapshotResult>>;
     /**
-     * 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: ClipperSettingsInfo): rxjs.Observable<ApiResult<boolean>>;
+    deleteCalendarDeadlines(ids: string[]): rxjs.Observable<ApiResult<number>>;
     /**
-     * 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: ClipperUpdateChannelsStateParams): rxjs.Observable<ApiResult<ClipperDashboardResult>>;
+    copyCalendarDeadlines(params: ClipperCalendarCopyDeadlinesParams): rxjs.Observable<ApiResult<number>>;
     /**
-     * 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.
      */
-    private getTrialInfo;
+    closeCalendarDeadline(id: string): rxjs.Observable<ApiResult<ClipperDeadlineInfo>>;
     /**
-     * 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(): void;
+    saveCalendarDeadline(params: ClipperCalendarSaveDeadlineParams): rxjs.Observable<ApiResult<ClipperDeadlineInfo[]>>;
     /**
-     * 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: ClipperUserLink): rxjs.Observable<ApiResult<boolean>>;
+    getCalendarDeadline(id: string): rxjs.Observable<ApiResult<ClipperDeadlineInfo>>;
     /**
-     * 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: ClipperUserLink): rxjs.Observable<ApiResult<boolean>>;
+    exportCalendarDeadlines(ids: string[]): rxjs.Observable<Blob>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperCalendarService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperCalendarService>;
+}
+
+/**
+ * Collaboration: teams and team members, contacts and shared document notes.
+ */
+declare class ClipperCollaborationService {
+    private readonly httpClient;
+    private readonly core;
     /**
      * 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: string): rxjs.Observable<ApiResult<ClipperTeamInfo>>;
     /**
-     * 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: ClipperTeamsSearchParams): rxjs.Observable<ApiResult<ClipperTeamsSearchResult>>;
     /**
      * 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: ClipperTeamsSearchParams): rxjs.Observable<ApiResult<ClipperTeamMembersSearchResult>>;
     /**
      * 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: string, ids: number[]): rxjs.Observable<ApiResult<number>>;
     /**
      * 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: ClipperTeamMemberInfo): rxjs.Observable<ApiResult<ClipperTeamMemberInfo>>;
     /**
      * 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: ClipperContactsSearchParams): rxjs.Observable<ApiResult<QueryResultModel<ClipperContactInfo>>>;
     /**
      * 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: number[]): rxjs.Observable<ApiResult<number>>;
     /**
      * 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: ClipperContactInfo): rxjs.Observable<ApiResult<ClipperContactInfo>>;
     /**
-     * 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: ClipperNotesSearchParams): rxjs.Observable<ApiResult<ClipperNotesSearchResult>>;
     /**
      * 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: number[]): rxjs.Observable<ApiResult<number>>;
     /**
      * 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: ClipperDocumentNote): rxjs.Observable<ApiResult<ClipperDocumentNote>>;
     /**
      * 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: number): rxjs.Observable<ApiResult<ClipperDocumentNoteTracking[]>>;
     /**
      * 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(): rxjs.Observable<ApiResult<number>>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClipperService>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperCollaborationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperCollaborationService>;
+}
+
+/**
+ * Document search, references, export and metadata, plus the dashboard counters,
+ * taxonomy/topics/tags lookups, the working-documents "bag" and saved searches.
+ */
+declare class ClipperDocumentsService {
+    private readonly httpClient;
+    private readonly broadcastService;
+    private readonly core;
+    /**
+     * 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: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperSearchResult>>;
+    /**
+     * 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: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperSearchFacetsResult>>;
+    /**
+     * 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: ClipperDocumentUpdateStateParams): rxjs.Observable<ApiResult<number>>;
+    /**
+     * 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: string): rxjs.Observable<Blob>;
+    /**
+     * 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.
+     */
+    export(params: ClipperExportDocumentsParams): rxjs.Observable<Blob>;
+    /**
+     * 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: ClipperSendDocumentsByEmailParams): rxjs.Observable<ApiResult<number>>;
+    /**
+     * 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.
+     */
+    notifyNoteTo(params: ClipperNotifyDocumentNoteParams): rxjs.Observable<ApiResult<UpdateResultModel<ClipperDocumentNoteTracking>>>;
+    /**
+     * Retrieves the full document report page.
+     * @param id - The ID of the document.
+     * @returns An observable emitting the report content as a blob.
+     */
+    report(id: string): rxjs.Observable<Blob>;
+    /**
+     * 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.
+     */
+    comment(id: string): rxjs.Observable<ApiResult<string>>;
+    /**
+     * Gets the info for a document.
+     * @param id - The ID of the document.
+     * @returns An observable emitting the API result wrapping the document info.
+     */
+    info(id: string): rxjs.Observable<ApiResult<ClipperDocumentInfo>>;
+    /**
+     * 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.
+     */
+    index(id: string): rxjs.Observable<ApiResult<ClipperDocumentStructure>>;
+    /**
+     * 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.
+     */
+    metadata(id: string): rxjs.Observable<ApiResult<{
+        item1?: string;
+        item2?: ClipperDocumentNote[];
+    }>>;
+    /**
+     * 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: ClipperReferencesSearchParams): rxjs.Observable<ApiResult<ClipperSearchResult>>;
+    /**
+     * 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: ClipperReferencesSearchParams): rxjs.Observable<ApiResult<ClipperSearchFacetsResult>>;
+    /**
+     * Wraps document rendering to allow token refresh.
+     * @returns An observable emitting the API result wrapping a boolean readiness flag.
+     */
+    preRender(): rxjs.Observable<ApiResult<boolean>>;
+    /**
+     * 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: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperSearchResult>>;
+    /**
+     * 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: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperSearchCalendarSnapshotResult>>;
+    /**
+     * 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?: ClipperTaxonomyParams): rxjs.Observable<ApiResult<FolderTree>>;
+    /**
+     * Retrieves the topics as a flat list.
+     * @returns An observable emitting the API result wrapping the list of topics.
+     */
+    getTopics(): rxjs.Observable<ApiResult<NameValueItem<string>[]>>;
+    /**
+     * Retrieves the topics as a tree.
+     * @returns An observable emitting the API result wrapping the topics folder tree.
+     */
+    getTopicsAsTree(): rxjs.Observable<ApiResult<FolderTree>>;
+    /**
+     * Retrieves the tags.
+     * @returns An observable emitting the API result wrapping the list of tags.
+     */
+    getTags(): rxjs.Observable<ApiResult<NameValueItem<string>[]>>;
+    /**
+     * Loads the working documents and populates the shared bag.
+     * @returns The subscription to the working-documents request.
+     */
+    loadBag(): rxjs.Subscription;
+    /**
+     * 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: string[]): rxjs.Subscription;
+    /**
+     * 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: string): rxjs.Subscription;
+    /**
+     * Clears all working documents from the bag.
+     * @returns The subscription to the clear-bag request.
+     */
+    clearBag(): rxjs.Subscription;
+    /**
+     * 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: ClipperModule): rxjs.Observable<ApiResult<ClipperUserSearch[]>>;
+    /**
+     * 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: ClipperUserSearch): rxjs.Observable<ApiResult<ClipperUserSearch>>;
+    /**
+     * 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: number): rxjs.Observable<ApiResult<number>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperDocumentsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperDocumentsService>;
+}
+
+/**
+ * Authentication: credential / OAuth2 login, MFA confirmation, logout and OTP.
+ * Shared login context, channels and the logged-in flag live in `ClipperCoreService`.
+ */
+declare class ClipperLoginService {
+    private readonly httpClient;
+    private readonly broadcastService;
+    private readonly splashService;
+    private readonly core;
+    /**
+     * 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?: (value?: any) => void): void;
+    /**
+     * Performs an automatic logout and clears the stored session.
+     * @param onSuccess - Optional callback invoked after a successful logout.
+     */
+    autoLogout(onSuccess?: () => void): void;
+    /**
+     * 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?: string, password?: string, remember?: boolean, oauth?: LoginOAuthType, oauthAccessToken?: string | undefined): rxjs.Observable<ApiResult<ClipperLoginResult>>;
+    /**
+     * 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.
+     */
+    private completeLogin;
+    /**
+     * 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: string): rxjs.Observable<ApiResult<ClipperLoginResult>>;
+    /**
+     * 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?: boolean): rxjs.Observable<any>;
+    /**
+     * 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: string): rxjs.Observable<ApiResult<ClipperOTPInfo>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperLoginService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperLoginService>;
+}
+
+/**
+ * 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(...)`.
+ */
+declare class ClipperService {
+    private readonly core;
+    /** Authentication: login/logout, MFA, OTP. */
+    readonly session: ClipperLoginService;
+    /** Document search, references, export, working-documents bag and saved searches. */
+    readonly documents: ClipperDocumentsService;
+    /** Account settings, dashboard, password, channels, trial info and user links. */
+    readonly account: ClipperAccountService;
+    /** Archive folders and files. */
+    readonly archive: ClipperArchiveService;
+    /** Calendar deadlines. */
+    readonly calendar: ClipperCalendarService;
+    /** Teams, contacts and shared notes. */
+    readonly collaboration: ClipperCollaborationService;
+    /** @returns The URI of the Clipper web application, or `undefined` if not set. */
+    get appUri(): string | undefined;
+    /** @returns The base URI of the Clipper REST API. */
+    get serviceUri(): string;
+    /** @returns The active feature flags. */
+    get flags(): ClipperServiceFlags;
+    /** @returns The current login context, or `undefined` if not authenticated. */
+    get loginInfo(): ClipperLoginInfo | undefined;
+    /** @returns A read-only signal indicating whether the user is logged in. */
+    get loggedIn(): Signal<boolean>;
+    /** @returns A signal indicating whether a login is in progress. */
+    get loggingIn(): WritableSignal<boolean>;
+    /** @returns A signal holding the current documents search snapshot. */
+    get snapshot(): WritableSignal<ClipperSearchResult | undefined>;
+    /** @returns A signal indicating whether reference search is supported. */
+    get supportsRS(): WritableSignal<boolean>;
+    /** @returns A signal holding the current references search snapshot. */
+    get referencesSnapshot(): WritableSignal<ClipperSearchResult | undefined>;
+    /** @returns The shared dashboard state object. */
+    get dashboard(): ClipperDashboard;
+    /** @returns A signal holding the working-documents bag. */
+    get bag(): WritableSignal<ClipperDocumentInfo[]>;
+    /** @returns A computed signal with the number of items in the bag. */
+    get bagTotal(): Signal<number>;
+    /** @returns A signal controlling the Clipper UI visibility. */
+    get visible(): WritableSignal<boolean>;
+    /** @returns The shared teams collection. */
+    get teams(): NameValueItem<string>[];
+    /** @returns A signal holding the available channels. */
+    get availableChannels(): WritableSignal<ClipperAvailableChannel[]>;
+    /** @returns A computed signal with the currently active channels. */
+    get activeChannels(): Signal<ClipperAvailableChannel[]>;
+    /** @returns A signal indicating whether tagging is allowed. */
+    get allowTags(): WritableSignal<boolean>;
+    /** @returns A signal with the number of pending notes, or `undefined` if unknown. */
+    get pendingNotes(): WritableSignal<number | undefined>;
+    /**
+     * 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: string, appUri?: string, flags?: ClipperServiceFlags): void;
+    /**
+     * Pings the Clipper REST API to keep the session/token alive.
+     */
+    ping(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClipperService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClipperService>;
 }
 
-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 };
 export type { ClipperArchiveFileInfo, ClipperArchiveFilesCopyParams, ClipperArchiveFilesDeleteParams, ClipperArchiveFilesSearchResult, ClipperArchiveFolderTree, ClipperArchiveFoldersImportParams, ClipperArchiveFoldersSearchResult, ClipperArsEventInfo, ClipperAvailableChannel, ClipperCalendarCopyDeadlinesParams, ClipperCalendarSaveDeadlineParams, ClipperCalendarSearchResult, ClipperChannelSettingsItem, ClipperContactInfo, ClipperContactsSearchParams, ClipperDashboardItem, ClipperDashboardModelItem, ClipperDashboardResult, ClipperDayGroup, ClipperDayItem, ClipperDeadlineInfo, ClipperDeleteWorkingDocumentsParams, ClipperDocumentAnchorInfo, ClipperDocumentInfo, ClipperDocumentNote, ClipperDocumentNoteTracking, ClipperDocumentRelevantChunkHit, ClipperDocumentRelevants, ClipperDocumentStructure, ClipperDocumentUpdateStateParams, ClipperExportDocumentsParams, ClipperLastDaysResult, ClipperLoginInfo, ClipperLoginResult, ClipperNotesSearchParams, ClipperNotesSearchResult, ClipperNotifyDocumentNoteParams, ClipperOTPInfo, ClipperReferencesSearchParams, ClipperSearchArsEventsParams, ClipperSearchArsEventsResult, ClipperSearchCalendarSnapshotMonth, ClipperSearchFacet, ClipperSearchFacetGroup, ClipperSearchFacetsResult, ClipperSearchFilter, ClipperSendDocumentsByEmailParams, ClipperSettingsInfo, ClipperTaxonomyParams, ClipperTeamMemberInfo, ClipperTeamMembersSearchResult, ClipperTeamProductInfo, ClipperTeamsSearchParams, ClipperTeamsSearchResult, ClipperTopicInfo, ClipperUserChannelInfo, ClipperUserInfo, ClipperUserLink, ClipperUserSearch, ClipperUserTrialInfo, ClipperUserWorkingDocument, EditDialogCompleted, EditDialogData, EditedEventArgs, SectorInfo };