@arsedizioni/ars-utils 22.5.8 → 22.5.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,7 @@
1
1
  import * as i0 from '@angular/core';
2
2
  import { Signal, WritableSignal } from '@angular/core';
3
- import { NameValueItem, Folder, QueryModel, QueryResultModel, LoginOAuthType, LoginResult, ApiResult, UpdateResultModel, FolderTree } from '@arsedizioni/ars-utils/core';
4
- import { SendToDialogResult, ResetPasswordDialogResult, RecoverPasswordDialogResult } from '@arsedizioni/ars-utils/ui';
5
- import * as _angular_common_http from '@angular/common/http';
3
+ import { NameValueItem, LoginOAuthType, LoginResult, ApiResult, FolderTree } from '@arsedizioni/ars-utils/core';
4
+ import { SendToDialogResult } from '@arsedizioni/ars-utils/ui';
6
5
  import { HttpInterceptorFn } from '@angular/common/http';
7
6
  import * as rxjs from 'rxjs';
8
7
 
@@ -26,13 +25,8 @@ declare const ClipperMessages: {
26
25
  DOCUMENT_SELECTED: string;
27
26
  DOCUMENT_SELECTED_INNER: string;
28
27
  SETTINGS_CHANGED: string;
29
- COMMAND_ARCHIVE_ADD: string;
30
- COMMAND_CALENDAR_ADD: string;
31
28
  COMMAND_WORKING_OPEN: string;
32
29
  COMMAND_WORKING_ADD: string;
33
- COMMAND_NOTES_ADD: string;
34
- COMMAND_NOTES_DELETE: string;
35
- COMMAND_NOTES_UPDATE: string;
36
30
  COMMAND_SEARCH_RESTORED: string;
37
31
  COMMAND_SEARCH_EXECUTED: string;
38
32
  COMMAND_SEARCH_EMPTY_RESULT: string;
@@ -52,29 +46,12 @@ interface EditedEventArgs<T> {
52
46
  data: T;
53
47
  isNew?: boolean;
54
48
  }
55
- interface EditDialogData<T> {
56
- currentItem?: T;
57
- isEditable?: boolean;
58
- parentId?: number;
59
- }
60
- interface EditDialogCompleted<T> {
61
- data: T;
62
- dismissed?: boolean;
63
- isNew?: boolean;
64
- preview?: boolean;
65
- }
66
49
  declare enum ClipperServiceFlags {
67
50
  None = 0,
68
51
  NotifySystemErrors = 1,
69
52
  DisplayConnectionStateMessages = 2,
70
53
  Embedded = 4
71
54
  }
72
- declare enum ClipperRecurrenceType {
73
- Year = 1,
74
- Month = 2,
75
- Day = 3
76
- }
77
- declare const ClipperRecurrenceTypes: NameValueItem<ClipperRecurrenceType>[];
78
55
  declare enum ClipperSelectionMode {
79
56
  None = 0,
80
57
  Single = 1,
@@ -149,17 +126,6 @@ declare const ClipperSectors: SectorInfo[];
149
126
  declare const ClipperSectorTypes: NameValueItem<string>[];
150
127
  declare const ClipperAuthors: SectorInfo[];
151
128
  declare const ClipperSources: NameValueItem<string>[];
152
- interface ClipperSettingsInfo {
153
- lastUpdated?: Date;
154
- enableNotifications: boolean;
155
- channels?: ClipperChannelSettings[];
156
- bulletinTaxonomy?: string[];
157
- bulletinOrigins?: string[];
158
- enableBulletinFilter: boolean;
159
- }
160
- declare class ClipperUpdateChannelsStateParams {
161
- activeChannels: ClipperChannel[];
162
- }
163
129
  interface ClipperChannelSettingsItem<T> {
164
130
  name: string;
165
131
  value: T;
@@ -212,10 +178,6 @@ interface ClipperUserInfo {
212
178
  isAuthenticated: boolean;
213
179
  isTemporary: boolean;
214
180
  hasTrial: boolean;
215
- hasTeam: boolean;
216
- hasSharedNotes: boolean;
217
- hasSharedArchive: boolean;
218
- hasSharedCalendar: boolean;
219
181
  hasBulletin: boolean;
220
182
  hasAI: boolean;
221
183
  hasAIAssistant: boolean;
@@ -357,44 +319,6 @@ interface ClipperDocumentRelevants {
357
319
  hit: number;
358
320
  chunks: number;
359
321
  }
360
- interface ClipperDocumentNoteTracking {
361
- id: string;
362
- userMailId: number;
363
- email?: string;
364
- sentDate: Date;
365
- openDate?: Date;
366
- }
367
- interface ClipperDocumentNote {
368
- id?: number;
369
- teamId?: string;
370
- teamTitle?: string;
371
- documentId?: string;
372
- documentTitle?: string;
373
- color?: string;
374
- name?: string;
375
- note?: string;
376
- trackings?: ClipperDocumentNoteTracking[];
377
- trackingsCount?: number;
378
- trackingsOpenedCount?: number;
379
- expiringDate?: Date;
380
- isExpired?: boolean;
381
- isTroubled?: boolean;
382
- isMenuOpen?: boolean;
383
- isOver?: boolean;
384
- created?: Date;
385
- }
386
- interface ClipperNotesSearchParams extends QueryModel {
387
- documentId?: string;
388
- teamId?: string;
389
- teamTitle?: string;
390
- color?: string;
391
- fromDate?: Date;
392
- toDate?: Date;
393
- state?: number;
394
- }
395
- interface ClipperNotesSearchResult extends QueryResultModel<ClipperDocumentNote> {
396
- teams: NameValueItem<string>[];
397
- }
398
322
  interface ClipperDocumentInfo {
399
323
  id?: string;
400
324
  documentId?: string;
@@ -422,7 +346,6 @@ interface ClipperDocumentInfo {
422
346
  originDescription?: string;
423
347
  author?: string;
424
348
  anchors?: ClipperDocumentAnchorInfo[];
425
- notes?: ClipperDocumentNote[];
426
349
  chunks?: ClipperDocumentAnchorInfo[];
427
350
  chunksList?: string;
428
351
  taxonomy?: string;
@@ -557,14 +480,7 @@ interface ClipperExportDocumentsParams {
557
480
  }
558
481
  interface ClipperSendDocumentsByEmailParams extends SendToDialogResult {
559
482
  ids?: string[];
560
- isCalendar?: boolean;
561
483
  public?: string;
562
- userNoteId?: number;
563
- }
564
- interface ClipperNotifyDocumentNoteParams extends SendToDialogResult {
565
- userNoteId?: number;
566
- notifyIfNotOpen?: boolean;
567
- resend?: boolean;
568
484
  }
569
485
  interface ClipperDocumentStructure {
570
486
  id: string;
@@ -604,51 +520,11 @@ interface ClipperDeleteWorkingDocumentsParams {
604
520
  documentIds: string[];
605
521
  deleteAll: boolean;
606
522
  }
607
- interface ClipperUserLink {
608
- id?: number;
609
- userId: number;
610
- userName?: string;
611
- key: string;
612
- }
613
523
  interface ClipperUserTrialInfo {
614
524
  channelName: string;
615
525
  expiringDate: Date;
616
526
  remainingDocuments: number;
617
527
  }
618
- interface ClipperArsEventInfo {
619
- id: number;
620
- location?: string;
621
- title?: string;
622
- pictureId?: string;
623
- date?: string;
624
- endDate?: string;
625
- startTime?: string;
626
- endTime?: string;
627
- hours?: number;
628
- days?: number;
629
- dateIntervalDescription?: string;
630
- durationDescription?: string;
631
- group?: string;
632
- address?: string;
633
- city?: string;
634
- isOver?: boolean;
635
- }
636
- interface ClipperSearchArsEventsParams {
637
- group?: string;
638
- group1?: string;
639
- collectGroups?: boolean;
640
- collectBundles?: boolean;
641
- fromDate?: string;
642
- untilDate?: string;
643
- text?: string;
644
- sortBy?: string;
645
- count: number;
646
- }
647
- interface ClipperSearchArsEventsResult {
648
- interval?: string;
649
- items?: ClipperArsEventInfo[];
650
- total?: number;
651
- }
652
528
  interface ClipperDocumentUpdateStateParams {
653
529
  documentIds: string[];
654
530
  isRead: boolean;
@@ -665,14 +541,6 @@ interface ClipperDashboardItem {
665
541
  unreadItems: number;
666
542
  lastUpdated?: string;
667
543
  }
668
- interface ClipperDashboardResult {
669
- items?: ClipperDashboardItem[];
670
- isTrial?: boolean;
671
- expiredDeadlines?: number;
672
- expiringDeadlines?: number;
673
- documentUpdates?: number;
674
- channels?: ClipperChannelSettings[];
675
- }
676
544
  declare class ClipperDashboard {
677
545
  items: i0.WritableSignal<ClipperDashboardItem[]>;
678
546
  isTrial?: boolean;
@@ -702,99 +570,10 @@ declare class ClipperDashboard {
702
570
  */
703
571
  getTotalUnreadItems(): number;
704
572
  }
705
- interface ClipperDayItem {
706
- day: string;
707
- label: string;
708
- items: ClipperDayGroup[];
709
- count: number;
710
- }
711
- interface ClipperDayGroup {
712
- model: ClipperModel;
713
- label: string;
714
- items: ClipperDocumentInfo[];
715
- }
716
- interface ClipperLastDaysResult {
717
- items: ClipperDayItem[];
718
- }
719
573
  interface ClipperTopicInfo {
720
574
  id: string;
721
575
  name: string;
722
576
  }
723
- interface ClipperTeamMemberInfo {
724
- id: number;
725
- teamId?: string;
726
- teamTitle?: string;
727
- name?: string;
728
- email?: string;
729
- isAdmin?: boolean;
730
- isDisabled?: boolean;
731
- hasPermission55?: boolean;
732
- hasPermission56?: boolean;
733
- hasPermission57?: boolean;
734
- isMenuOpen?: boolean;
735
- isOver?: boolean;
736
- }
737
- declare enum ClipperTeamProduct {
738
- SharedArchive = 1004676,
739
- SharedCalendar = 1004683,
740
- SharedNotes = 1013721
741
- }
742
- declare enum ClipperTeamProductPermission {
743
- SharedNotes = 55,
744
- SharedArchive = 56,
745
- SharedCalendar = 57
746
- }
747
- interface ClipperTeamProductInfo {
748
- permissionId: ClipperTeamProductPermission;
749
- name: string;
750
- maxMembers: number;
751
- usedMembers: number;
752
- }
753
- interface ClipperTeamMembersSearchResult {
754
- teamId?: string;
755
- teamTitle?: string;
756
- total?: number;
757
- customerId?: number;
758
- canEdit?: boolean;
759
- products?: ClipperTeamProductInfo[];
760
- items?: ClipperTeamMemberInfo[];
761
- }
762
- interface ClipperTeamsSearchParams {
763
- teamId?: string;
764
- permissionId?: number;
765
- productId?: number;
766
- adminsOnly?: boolean;
767
- activeMembersOnly?: boolean;
768
- includeRSTeams?: boolean;
769
- }
770
- interface ClipperTeamsSearchResult {
771
- total: number;
772
- items: NameValueItem<string>[];
773
- }
774
- declare class ClipperTeamInfo {
775
- id?: string;
776
- customerId?: number;
777
- title?: string;
778
- isDisabled?: boolean;
779
- created?: string;
780
- lastModified?: string;
781
- }
782
- interface ClipperContactsSearchParams extends QueryModel {
783
- teamId?: string;
784
- name?: string;
785
- includeDisabled?: boolean;
786
- }
787
- interface ClipperContactInfo {
788
- id?: number;
789
- teamId?: string;
790
- teamTitle?: string;
791
- userId?: number;
792
- name?: string;
793
- emails?: string;
794
- disabled?: boolean;
795
- created?: Date;
796
- lastUpdated?: Date;
797
- }
798
577
  declare enum ClipperCalendarState {
799
578
  Open = 101,
800
579
  Expired = 102,
@@ -816,199 +595,6 @@ declare class ClipperCalendarSearchParams {
816
595
  first?: number;
817
596
  count?: number;
818
597
  }
819
- interface ClipperCalendarSearchResult {
820
- interval: string;
821
- items: ClipperDeadlineInfo[];
822
- days: number[];
823
- teams: NameValueItem<string>[];
824
- total: number;
825
- }
826
- interface ClipperDeadlineInfo {
827
- id?: string;
828
- companyId?: number;
829
- userId?: number;
830
- teamId: string;
831
- teamName?: string;
832
- group?: string;
833
- description?: string;
834
- documentTitle?: string;
835
- documentId?: string;
836
- documentNumber?: string;
837
- documentDate?: Date;
838
- emails?: string;
839
- expiringDate?: Date;
840
- expiredAlertSent?: boolean;
841
- expiringInfo?: string;
842
- expiringDescription?: string;
843
- nextExpiringDate?: Date;
844
- alarmDays?: number;
845
- alarmDate?: Date;
846
- alarmMemo?: string;
847
- alarmSent?: boolean;
848
- hasAlarm?: boolean;
849
- isMenuOpen?: boolean;
850
- isOver?: boolean;
851
- isExpired?: boolean;
852
- isExpiring?: boolean;
853
- isClosed?: boolean;
854
- isClosable?: boolean;
855
- isPrivate?: boolean;
856
- isRecurrent?: boolean;
857
- recurrencePatternType?: ClipperRecurrenceType;
858
- recurrenceFrequency?: number;
859
- recurrenceEndOfMonth?: boolean;
860
- recurrenceNewId?: string;
861
- outlookAppointmentId?: string;
862
- created?: Date;
863
- lastModified?: Date;
864
- }
865
- interface ClipperCalendarSaveDeadlineParams {
866
- deadline: ClipperDeadlineInfo;
867
- teamIds?: string[];
868
- }
869
- declare enum ClipperCalendarCopyMode {
870
- Duplicate = 1,
871
- Move = 2
872
- }
873
- interface ClipperCalendarCopyDeadlinesParams {
874
- ids: string[];
875
- teamId: string;
876
- mode: ClipperCalendarCopyMode;
877
- }
878
- declare enum ClipperArchiveFileType {
879
- None = 0,
880
- Procedure = 1,
881
- OperatingInstructions = 2,
882
- TechnicalReport = 3,
883
- AdministrativeDocument = 4,
884
- Document = 5,
885
- OtherApplicableRules = 6,
886
- Other = 7,
887
- File = 101,
888
- Image = 102
889
- }
890
- declare const ClipperArchiveFileTypes: NameValueItem<ClipperArchiveFileType>[];
891
- declare enum ClipperArchiveFileStorageType {
892
- ArsCloud = 2,
893
- OtherCloud = 3
894
- }
895
- declare const ClipperArchiveFileStorageTypes: NameValueItem<ClipperArchiveFileStorageType>[];
896
- interface ClipperArchiveFileInfo {
897
- id?: string;
898
- parentFolderId?: string;
899
- isFolder?: boolean;
900
- folderId?: string;
901
- folderName?: string;
902
- folderItemsCount?: number;
903
- teamId: string;
904
- teamName?: string;
905
- topicId?: string;
906
- topicPath?: string;
907
- topicName?: string;
908
- topics?: string[];
909
- tags?: string;
910
- isPrivate?: boolean;
911
- isFile?: boolean;
912
- fileName?: string;
913
- storageType?: ClipperArchiveFileStorageType;
914
- isBinary?: boolean;
915
- binaryId?: number;
916
- binaryFilePath?: string;
917
- isPermalink?: boolean;
918
- fileType?: ClipperArchiveFileType;
919
- file?: any;
920
- notes?: string;
921
- position?: number;
922
- documentIds?: string;
923
- documentLastChangedBy?: string;
924
- documentLastChangedById?: string;
925
- documentLastChangedReasonDescription?: string;
926
- documentLastChanged?: Date;
927
- documentUpdateState?: number;
928
- isDocumentChanged?: boolean;
929
- canPreview?: boolean;
930
- canEmbed?: boolean;
931
- channelName?: string;
932
- model?: ClipperModel;
933
- modelName?: string;
934
- title1?: string;
935
- title2?: string;
936
- date?: Date;
937
- number?: string;
938
- origin?: string;
939
- originDescription?: string;
940
- documentId?: string;
941
- documentCode?: string;
942
- isDocument?: boolean;
943
- isRead?: boolean;
944
- isJuris?: boolean;
945
- isMenuOpen?: boolean;
946
- isOver?: boolean;
947
- validityState?: number;
948
- validUntilDate?: Date;
949
- expiringDate?: Date;
950
- expiringInfo?: string;
951
- uniqueId: string;
952
- }
953
- interface ClipperArchiveFolderTree extends Folder {
954
- subFolders: ClipperArchiveFolderTree[];
955
- }
956
- declare class ClipperArchiveFoldersSearchParams {
957
- teamId?: string;
958
- privateOnly?: boolean;
959
- }
960
- interface ClipperArchiveFoldersSearchResult {
961
- name: string;
962
- teams: NameValueItem<string>[];
963
- files: ClipperArchiveFileInfo[];
964
- subFolders: ClipperArchiveFolderTree[];
965
- }
966
- declare class ClipperArchiveFilesSearchParams {
967
- teamId?: string;
968
- folderId?: string;
969
- folderName?: string;
970
- fileType?: ClipperArchiveFileType;
971
- fromDate?: Date;
972
- toDate?: Date;
973
- topicPath?: string;
974
- topicId?: string;
975
- topicName?: string;
976
- titlesOnly?: boolean;
977
- text?: string;
978
- documentNumber?: string;
979
- documentYear?: number;
980
- first?: number;
981
- count?: number;
982
- }
983
- interface ClipperArchiveFilesSearchResult {
984
- items: ClipperArchiveFileInfo[];
985
- folderName?: string;
986
- total: number;
987
- }
988
- interface ClipperArchiveFoldersImportParams {
989
- teamId: string;
990
- destFolderId?: string;
991
- sourcePath?: string;
992
- sourceFileName?: string;
993
- file?: any;
994
- overwrite?: boolean;
995
- version?: number;
996
- }
997
- declare enum ClipperArchiveCopyMode {
998
- Duplicate = 1,
999
- Move = 2
1000
- }
1001
- interface ClipperArchiveFilesCopyParams {
1002
- destTeamId: string;
1003
- destFolderId?: string;
1004
- files?: ClipperArchiveFileInfo[];
1005
- mode?: ClipperArchiveCopyMode;
1006
- }
1007
- interface ClipperArchiveFilesDeleteParams {
1008
- sourceFolderId?: string;
1009
- destFolderId?: string;
1010
- files?: ClipperArchiveFileInfo[];
1011
- }
1012
598
  declare class ClipperUtils {
1013
599
  /**
1014
600
  * Returns `true` when the given model corresponds to a readable document type
@@ -1099,8 +685,6 @@ declare class ClipperSearchUtils {
1099
685
  static getRankFromChar(value: string): number;
1100
686
  }
1101
687
 
1102
- declare const NotesColors: NameValueItem<string>[];
1103
-
1104
688
  /**
1105
689
  * Builds the Clipper auth HTTP interceptor.
1106
690
  *
@@ -1121,91 +705,26 @@ declare const NotesColors: NameValueItem<string>[];
1121
705
  declare function clipperAuthInterceptor(serviceUri: string, flags?: ClipperServiceFlags): HttpInterceptorFn;
1122
706
 
1123
707
  /**
1124
- * Account management: password reset/recovery, settings, channel activation, trial info
1125
- * and user links. Channel state lives in `ClipperCoreService`; the channel-mutating
1126
- * helpers (`setChannels`, `setChannelsState`, `updateChannels`) live here.
708
+ * The two pieces of account state the document views actually move: which channels are
709
+ * active, and the unread counters on the dashboard.
710
+ *
711
+ * Everything else an account can do — password reset and recovery, settings, channel
712
+ * activation towards the server, trial info, user links, loading the dashboard — belongs to
713
+ * the application that owns the account, not to a library whose job is showing documents.
714
+ * It was removed on 2026-08-25 together with the archive, calendar and collaboration worlds;
715
+ * a product that needs those endpoints calls them itself.
716
+ *
717
+ * What is left touches no HTTP: both methods only mutate the shared state in
718
+ * `ClipperCoreService` and announce the change on the broadcast bus.
1127
719
  */
1128
720
  declare class ClipperAccountService {
1129
- private readonly httpClient;
1130
721
  private readonly broadcastService;
1131
722
  private readonly core;
1132
- /**
1133
- * Resets the user's password using the provided parameters.
1134
- * @param params - The new password and confirmation data.
1135
- * @returns An observable emitting the API result wrapping the reset password payload.
1136
- */
1137
- resetPassword(params: ResetPasswordDialogResult): rxjs.Observable<ApiResult<ResetPasswordDialogResult>>;
1138
- /**
1139
- * Initiates a password recovery flow by sending a reset link to the user's email.
1140
- * @param params - The password recovery request data.
1141
- * @returns An observable emitting the API result wrapping a boolean success flag.
1142
- */
1143
- recoverPassword(params: RecoverPasswordDialogResult): rxjs.Observable<ApiResult<boolean>>;
1144
- /**
1145
- * Gets the current user account settings.
1146
- * @returns An observable emitting the API result wrapping the account settings.
1147
- */
1148
- getSettings(): rxjs.Observable<ApiResult<ClipperSettingsInfo>>;
1149
- /**
1150
- * Updates user account settings and applies any channel configuration changes.
1151
- * @param params - A map of settings key-value pairs to update.
1152
- * @returns An observable emitting the API result wrapping a boolean success flag.
1153
- */
1154
- updateSettings(params: ClipperSettingsInfo): rxjs.Observable<ApiResult<boolean>>;
1155
- /**
1156
- * Saves updated channel activation states to the server and applies the new dashboard result.
1157
- * @param params - The channel state update parameters.
1158
- * @returns An observable emitting the API result wrapping the dashboard result.
1159
- */
1160
- updateChannelsState(params: ClipperUpdateChannelsStateParams): rxjs.Observable<ApiResult<ClipperDashboardResult>>;
1161
- /**
1162
- * Applies a new dashboard result: updates channel settings, dashboard counters, and
1163
- * re-initialises the available-channels signal.
1164
- * @param value - The dashboard result containing updated channel and counter data.
1165
- */
1166
- setChannelsState(value: ClipperDashboardResult): void;
1167
- /**
1168
- * Replaces the stored channel settings and re-initialises the available-channels signal.
1169
- * @param channels - The new channel settings to store and activate.
1170
- */
1171
- setChannels(channels: ClipperChannelSettings[]): void;
1172
723
  /**
1173
724
  * Toggles the active state of available channels based on the supplied selection list.
1174
725
  * @param values - The selected channel items; channels absent from this list are deactivated.
1175
726
  */
1176
727
  updateChannels(values: NameValueItem<ClipperChannel>[]): void;
1177
- /**
1178
- * Gets the trial info for the current account.
1179
- * @returns An observable emitting the API result wrapping the trial info.
1180
- */
1181
- private getTrialInfo;
1182
- /**
1183
- * Refreshes the trial status from the server and updates the stored login context.
1184
- */
1185
- updateTrialInfo(): void;
1186
- /**
1187
- * Creates or updates a user link record.
1188
- * @param item - The user link data to save.
1189
- * @returns An observable emitting the API result wrapping a boolean success flag.
1190
- */
1191
- saveLink(item: ClipperUserLink): rxjs.Observable<ApiResult<boolean>>;
1192
- /**
1193
- * Deletes a user link record.
1194
- * @param item - The user link to remove.
1195
- * @returns An observable emitting the API result wrapping a boolean success flag.
1196
- */
1197
- deleteLink(item: ClipperUserLink): rxjs.Observable<ApiResult<boolean>>;
1198
- /**
1199
- * Retrieves the current dashboard and applies its counters to the shared dashboard state.
1200
- * @returns The subscription to the dashboard request.
1201
- */
1202
- loadDashboard(): rxjs.Subscription;
1203
- /**
1204
- * Retrieves documents updated in the last 15 days for the given search parameters.
1205
- * @param params - The search parameters to filter results.
1206
- * @returns An observable emitting the API result wrapping the last-days result.
1207
- */
1208
- last15Days(params: ClipperSearchParams): rxjs.Observable<ApiResult<ClipperLastDaysResult>>;
1209
728
  /**
1210
729
  * Adjusts the unread-item counter for the given module and broadcasts a dashboard update.
1211
730
  * @param module - The Clipper module whose counter should be adjusted.
@@ -1217,228 +736,6 @@ declare class ClipperAccountService {
1217
736
  static ɵprov: i0.ɵɵInjectableDeclaration<ClipperAccountService>;
1218
737
  }
1219
738
 
1220
- /**
1221
- * Document archive: folders and files search, save, copy, delete, import/export and download.
1222
- */
1223
- declare class ClipperArchiveService {
1224
- private readonly httpClient;
1225
- private readonly core;
1226
- /**
1227
- * Retrieves all archive folders matching the given search parameters and stores the
1228
- * returned teams in the shared state.
1229
- * @param params - The folder search parameters.
1230
- * @returns An observable emitting the API result wrapping the folders search result.
1231
- */
1232
- getArchiveFolders(params: ClipperArchiveFoldersSearchParams): rxjs.Observable<ApiResult<ClipperArchiveFoldersSearchResult>>;
1233
- /**
1234
- * Creates or updates an archive folder.
1235
- * @param params - The folder data to save.
1236
- * @returns An observable emitting the API result wrapping the saved folder.
1237
- */
1238
- saveArchiveFolder(params: Folder): rxjs.Observable<ApiResult<Folder>>;
1239
- /**
1240
- * Exports archive folders as a downloadable file.
1241
- * @param id - The folder ID to export, or `undefined` to export all folders.
1242
- * @param teamId - The optional team ID. Defaults to `undefined` (personal workspace).
1243
- * @returns An observable emitting the exported folders content as a blob.
1244
- */
1245
- exportArchiveFolders(id?: string, teamId?: string): rxjs.Observable<Blob>;
1246
- /**
1247
- * Uploads and imports archive folders from a file.
1248
- * @param params - The import parameters including the source file and destination folder.
1249
- * @returns An observable of HTTP events reporting upload progress and the final response.
1250
- */
1251
- importArchiveFolders(params: ClipperArchiveFoldersImportParams): rxjs.Observable<_angular_common_http.HttpEvent<unknown>>;
1252
- /**
1253
- * Retrieves archive files and folders matching the given search parameters.
1254
- * @param params - The archive files search parameters.
1255
- * @returns An observable emitting the API result wrapping the files search result.
1256
- */
1257
- queryArchiveItems(params: ClipperArchiveFilesSearchParams): rxjs.Observable<ApiResult<ClipperArchiveFilesSearchResult>>;
1258
- /**
1259
- * Deletes one or more archive files or folders.
1260
- * @param params - The delete operation parameters.
1261
- * @returns An observable emitting the API result wrapping the number of deleted items.
1262
- */
1263
- deleteArchiveItems(params: ClipperArchiveFilesDeleteParams): rxjs.Observable<ApiResult<number>>;
1264
- /**
1265
- * Copies archive files or folders to a destination folder.
1266
- * @param params - The copy operation parameters.
1267
- * @returns An observable emitting the API result wrapping the number of copied items.
1268
- */
1269
- copyArchiveItems(params: ClipperArchiveFilesCopyParams): rxjs.Observable<ApiResult<number>>;
1270
- /**
1271
- * Uploads and saves an archive file using multipart form data.
1272
- * @param params - The file metadata and binary content to save.
1273
- * @returns An observable of HTTP events reporting upload progress and the final response.
1274
- */
1275
- saveArchiveFile(params: ClipperArchiveFileInfo): rxjs.Observable<_angular_common_http.HttpEvent<unknown>>;
1276
- /**
1277
- * Retrieves the metadata for a single archive file.
1278
- * @param id - The ID of the archive file to retrieve.
1279
- * @returns An observable emitting the API result wrapping the archive file info.
1280
- */
1281
- getArchiveFile(id: string): rxjs.Observable<ApiResult<ClipperArchiveFileInfo>>;
1282
- /**
1283
- * Downloads the binary content of an archive file.
1284
- * @param id - The binary ID of the file to download.
1285
- * @param otp - An optional one-time password for authenticated downloads.
1286
- * @returns An observable emitting the file binary content as a blob.
1287
- */
1288
- downloadArchiveFile(id: number, otp?: string): rxjs.Observable<Blob>;
1289
- static ɵfac: i0.ɵɵFactoryDeclaration<ClipperArchiveService, never>;
1290
- static ɵprov: i0.ɵɵInjectableDeclaration<ClipperArchiveService>;
1291
- }
1292
-
1293
- /**
1294
- * Calendar deadlines: search, snapshot, save/copy/close/delete and iCalendar export.
1295
- */
1296
- declare class ClipperCalendarService {
1297
- private readonly httpClient;
1298
- private readonly core;
1299
- /**
1300
- * Queries the calendar and stores the returned teams in the shared state.
1301
- * @param params - The calendar search parameters.
1302
- * @returns An observable emitting the API result wrapping the calendar search result.
1303
- */
1304
- queryCalendar(params: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperCalendarSearchResult>>;
1305
- /**
1306
- * Gets the calendar snapshot.
1307
- * @param params - The calendar search parameters.
1308
- * @returns An observable emitting the API result wrapping the calendar snapshot result.
1309
- */
1310
- calendarSnapshot(params: ClipperCalendarSearchParams): rxjs.Observable<ApiResult<ClipperSearchCalendarSnapshotResult>>;
1311
- /**
1312
- * Deletes one or more calendar deadlines by ID.
1313
- * @param ids - The IDs of the deadlines to delete.
1314
- * @returns An observable emitting the API result wrapping the number of deleted deadlines.
1315
- */
1316
- deleteCalendarDeadlines(ids: string[]): rxjs.Observable<ApiResult<number>>;
1317
- /**
1318
- * Copies one or more calendar deadlines using the given parameters.
1319
- * @param params - The copy operation parameters.
1320
- * @returns An observable emitting the API result wrapping the number of copied deadlines.
1321
- */
1322
- copyCalendarDeadlines(params: ClipperCalendarCopyDeadlinesParams): rxjs.Observable<ApiResult<number>>;
1323
- /**
1324
- * Marks the given calendar deadline as closed.
1325
- * @param id - The ID of the deadline to close.
1326
- * @returns An observable emitting the API result wrapping the updated deadline.
1327
- */
1328
- closeCalendarDeadline(id: string): rxjs.Observable<ApiResult<ClipperDeadlineInfo>>;
1329
- /**
1330
- * Creates or updates a calendar deadline.
1331
- * @param params - The deadline data to save.
1332
- * @returns An observable emitting the API result wrapping the saved deadlines.
1333
- */
1334
- saveCalendarDeadline(params: ClipperCalendarSaveDeadlineParams): rxjs.Observable<ApiResult<ClipperDeadlineInfo[]>>;
1335
- /**
1336
- * Retrieves a single calendar deadline by its ID.
1337
- * @param id - The ID of the deadline to retrieve.
1338
- * @returns An observable emitting the API result wrapping the deadline.
1339
- */
1340
- getCalendarDeadline(id: string): rxjs.Observable<ApiResult<ClipperDeadlineInfo>>;
1341
- /**
1342
- * Exports the selected deadlines in iCalendar (.ics) format.
1343
- * @param ids - The IDs of the deadlines to export.
1344
- * @returns An observable emitting the iCalendar content as a blob.
1345
- */
1346
- exportCalendarDeadlines(ids: string[]): rxjs.Observable<Blob>;
1347
- static ɵfac: i0.ɵɵFactoryDeclaration<ClipperCalendarService, never>;
1348
- static ɵprov: i0.ɵɵInjectableDeclaration<ClipperCalendarService>;
1349
- }
1350
-
1351
- /**
1352
- * Collaboration: teams and team members, contacts and shared document notes.
1353
- */
1354
- declare class ClipperCollaborationService {
1355
- private readonly httpClient;
1356
- private readonly core;
1357
- /**
1358
- * Renames the current user's team.
1359
- * @param newName - The new display name for the team.
1360
- * @returns An observable emitting the API result wrapping the updated team info.
1361
- */
1362
- renameTeam(newName: string): rxjs.Observable<ApiResult<ClipperTeamInfo>>;
1363
- /**
1364
- * Retrieves the list of teams available to the current user. When not querying
1365
- * admins only, the result is also stored in the shared teams state.
1366
- * @param params - The teams search parameters.
1367
- * @returns An observable emitting the API result wrapping the teams search result.
1368
- */
1369
- getTeams(params: ClipperTeamsSearchParams): rxjs.Observable<ApiResult<ClipperTeamsSearchResult>>;
1370
- /**
1371
- * Retrieves the members of a team matching the given search parameters.
1372
- * @param params - The team members search parameters.
1373
- * @returns An observable emitting the API result wrapping the team members search result.
1374
- */
1375
- getTeamMembers(params: ClipperTeamsSearchParams): rxjs.Observable<ApiResult<ClipperTeamMembersSearchResult>>;
1376
- /**
1377
- * Removes the specified members from the team.
1378
- * @param teamId - The ID of the team.
1379
- * @param ids - The numeric IDs of the team members to remove.
1380
- * @returns An observable emitting the API result wrapping the number of removed members.
1381
- */
1382
- deleteTeamMembers(teamId: string, ids: number[]): rxjs.Observable<ApiResult<number>>;
1383
- /**
1384
- * Creates or updates a team member record.
1385
- * @param item - The team member data to save.
1386
- * @returns An observable emitting the API result wrapping the saved team member.
1387
- */
1388
- saveTeamMember(item: ClipperTeamMemberInfo): rxjs.Observable<ApiResult<ClipperTeamMemberInfo>>;
1389
- /**
1390
- * Retrieves contacts matching the given search parameters.
1391
- * @param params - The contacts search parameters.
1392
- * @returns An observable emitting the API result wrapping the contacts query result.
1393
- */
1394
- queryContacts(params: ClipperContactsSearchParams): rxjs.Observable<ApiResult<QueryResultModel<ClipperContactInfo>>>;
1395
- /**
1396
- * Deletes the specified contacts.
1397
- * @param ids - The numeric IDs of the contacts to remove.
1398
- * @returns An observable emitting the API result wrapping the number of deleted contacts.
1399
- */
1400
- deleteContacts(ids: number[]): rxjs.Observable<ApiResult<number>>;
1401
- /**
1402
- * Creates or updates a contact record.
1403
- * @param item - The contact data to save.
1404
- * @returns An observable emitting the API result wrapping the saved contact.
1405
- */
1406
- saveContact(item: ClipperContactInfo): rxjs.Observable<ApiResult<ClipperContactInfo>>;
1407
- /**
1408
- * Retrieves document notes matching the given search parameters and stores the
1409
- * returned teams in the shared state.
1410
- * @param params - The notes search parameters.
1411
- * @returns An observable emitting the API result wrapping the notes search result.
1412
- */
1413
- queryNotes(params: ClipperNotesSearchParams): rxjs.Observable<ApiResult<ClipperNotesSearchResult>>;
1414
- /**
1415
- * Deletes the specified document notes.
1416
- * @param ids - The numeric IDs of the notes to remove.
1417
- * @returns An observable emitting the API result wrapping the number of deleted notes.
1418
- */
1419
- deleteNotes(ids: number[]): rxjs.Observable<ApiResult<number>>;
1420
- /**
1421
- * Creates or updates a document note.
1422
- * @param item - The note data to save.
1423
- * @returns An observable emitting the API result wrapping the saved note.
1424
- */
1425
- saveNote(item: ClipperDocumentNote): rxjs.Observable<ApiResult<ClipperDocumentNote>>;
1426
- /**
1427
- * Retrieves the tracking history for the given document note.
1428
- * @param id - The numeric ID of the note whose tracking records to retrieve.
1429
- * @returns An observable emitting the API result wrapping the note tracking records.
1430
- */
1431
- getNoteTrackings(id: number): rxjs.Observable<ApiResult<ClipperDocumentNoteTracking[]>>;
1432
- /**
1433
- * Gets the count of troubled tracking notifications for document notes,
1434
- * which can be used to display an unread counter in the UI.
1435
- * @returns An observable emitting the API result wrapping the troubled tracking count.
1436
- */
1437
- countNotesTrackingsTroubled(): rxjs.Observable<ApiResult<number>>;
1438
- static ɵfac: i0.ɵɵFactoryDeclaration<ClipperCollaborationService, never>;
1439
- static ɵprov: i0.ɵɵInjectableDeclaration<ClipperCollaborationService>;
1440
- }
1441
-
1442
739
  /**
1443
740
  * Document search, references, export and metadata, plus the dashboard counters,
1444
741
  * taxonomy/topics/tags lookups, the working-documents "bag" and saved searches.
@@ -1483,12 +780,6 @@ declare class ClipperDocumentsService {
1483
780
  * @returns An observable emitting the API result wrapping the number of sent items.
1484
781
  */
1485
782
  sendTo(params: ClipperSendDocumentsByEmailParams): rxjs.Observable<ApiResult<number>>;
1486
- /**
1487
- * Sends an email notification about a document note update to the specified recipients.
1488
- * @param params - The notification parameters including recipients and note details.
1489
- * @returns An observable emitting the API result wrapping the note tracking update.
1490
- */
1491
- notifyNoteTo(params: ClipperNotifyDocumentNoteParams): rxjs.Observable<ApiResult<UpdateResultModel<ClipperDocumentNoteTracking>>>;
1492
783
  /**
1493
784
  * Retrieves the full document report page.
1494
785
  * @param id - The ID of the document.
@@ -1516,11 +807,10 @@ declare class ClipperDocumentsService {
1516
807
  /**
1517
808
  * Gets the last-update metadata for a document.
1518
809
  * @param id - The ID of the document.
1519
- * @returns An observable emitting the API result wrapping the last update string and its notes.
810
+ * @returns An observable emitting the API result wrapping the last update string.
1520
811
  */
1521
812
  metadata(id: string): rxjs.Observable<ApiResult<{
1522
813
  item1?: string;
1523
- item2?: ClipperDocumentNote[];
1524
814
  }>>;
1525
815
  /**
1526
816
  * Queries document references, changes or jurisprudence depending on the requested mode.
@@ -1696,8 +986,8 @@ declare class ClipperLoginService {
1696
986
  *
1697
987
  * Exposes the feature services as named properties and re-exports the shared state
1698
988
  * declared in `ClipperCoreService`. Inject `ClipperService` and reach a feature via
1699
- * its property, e.g. `clipper.login.login(...)`, `clipper.documents.query(...)`,
1700
- * `clipper.calendar.queryCalendar(...)`.
989
+ * its property, e.g. `clipper.session.login(...)`, `clipper.documents.query(...)`,
990
+ * `clipper.account.updateUnreadItems(...)`.
1701
991
  */
1702
992
  declare class ClipperService {
1703
993
  private readonly core;
@@ -1705,14 +995,8 @@ declare class ClipperService {
1705
995
  readonly session: ClipperLoginService;
1706
996
  /** Document search, references, export, working-documents bag and saved searches. */
1707
997
  readonly documents: ClipperDocumentsService;
1708
- /** Account settings, dashboard, password, channels, trial info and user links. */
998
+ /** The account state the document views move: active channels and unread counters. */
1709
999
  readonly account: ClipperAccountService;
1710
- /** Archive folders and files. */
1711
- readonly archive: ClipperArchiveService;
1712
- /** Calendar deadlines. */
1713
- readonly calendar: ClipperCalendarService;
1714
- /** Teams, contacts and shared notes. */
1715
- readonly collaboration: ClipperCollaborationService;
1716
1000
  /** @returns The URI of the Clipper web application, or `undefined` if not set. */
1717
1001
  get appUri(): string | undefined;
1718
1002
  /** @returns The base URI of the Clipper REST API. */
@@ -1739,16 +1023,12 @@ declare class ClipperService {
1739
1023
  get bagTotal(): Signal<number>;
1740
1024
  /** @returns A signal controlling the Clipper UI visibility. */
1741
1025
  get visible(): WritableSignal<boolean>;
1742
- /** @returns The shared teams collection. */
1743
- get teams(): NameValueItem<string>[];
1744
1026
  /** @returns A signal holding the available channels. */
1745
1027
  get availableChannels(): WritableSignal<ClipperAvailableChannel[]>;
1746
1028
  /** @returns A computed signal with the currently active channels. */
1747
1029
  get activeChannels(): Signal<ClipperAvailableChannel[]>;
1748
1030
  /** @returns A signal indicating whether tagging is allowed. */
1749
1031
  get allowTags(): WritableSignal<boolean>;
1750
- /** @returns A signal with the number of pending notes, or `undefined` if unknown. */
1751
- get pendingNotes(): WritableSignal<number | undefined>;
1752
1032
  /**
1753
1033
  * Initialises the application with the API base URI, optional app URI, and feature flags.
1754
1034
  * @param serviceUri - The base URI of the Clipper REST API.
@@ -1768,8 +1048,8 @@ declare class ClipperService {
1768
1048
  * Shared state and bootstrap for the Clipper application.
1769
1049
  *
1770
1050
  * Holds every piece of state used by more than one feature service (service URI,
1771
- * flags, login context, teams, dashboard, working-documents bag, channels and the
1772
- * various UI signals) plus the low-level helpers that mutate that state.
1051
+ * flags, login context, dashboard, working-documents bag, channels and the various
1052
+ * UI signals) plus the low-level helpers that mutate that state.
1773
1053
  *
1774
1054
  * The feature services (`ClipperLoginService`, `ClipperDocumentsService`, ...) inject
1775
1055
  * this service to read shared state and call shared helpers. `ClipperService` (the
@@ -1807,13 +1087,9 @@ declare class ClipperCoreService {
1807
1087
  readonly bag: i0.WritableSignal<ClipperDocumentInfo[]>;
1808
1088
  readonly bagTotal: Signal<number>;
1809
1089
  readonly visible: i0.WritableSignal<boolean>;
1810
- private _teams;
1811
- /** @returns The shared teams collection. */
1812
- get teams(): NameValueItem<string>[];
1813
1090
  readonly availableChannels: i0.WritableSignal<ClipperAvailableChannel[]>;
1814
1091
  readonly activeChannels: Signal<ClipperAvailableChannel[]>;
1815
1092
  readonly allowTags: i0.WritableSignal<boolean>;
1816
- readonly pendingNotes: i0.WritableSignal<number>;
1817
1093
  /**
1818
1094
  * Ensures a login-info object exists and returns it for further mutation.
1819
1095
  * Replaces the inline `if (!this._loginInfo) { ... }` guards now that the field
@@ -1827,12 +1103,6 @@ declare class ClipperCoreService {
1827
1103
  * @param value - The new logged-in state.
1828
1104
  */
1829
1105
  setLoggedIn(value: boolean): void;
1830
- /**
1831
- * Replaces the shared teams collection (populated by the calendar, archive and
1832
- * collaboration queries).
1833
- * @param teams - The teams to store.
1834
- */
1835
- setTeams(teams: NameValueItem<string>[]): void;
1836
1106
  /**
1837
1107
  * Persists the current login context to `localStorage`.
1838
1108
  */
@@ -1870,5 +1140,5 @@ declare class ClipperCoreService {
1870
1140
  static ɵprov: i0.ɵɵInjectableDeclaration<ClipperCoreService>;
1871
1141
  }
1872
1142
 
1873
- export { ClipperAccountService, ClipperArchiveCopyMode, ClipperArchiveFileStorageType, ClipperArchiveFileStorageTypes, ClipperArchiveFileType, ClipperArchiveFileTypes, ClipperArchiveFilesSearchParams, ClipperArchiveFoldersSearchParams, ClipperArchiveService, ClipperAuthors, ClipperCalendarCopyMode, ClipperCalendarSearchParams, ClipperCalendarService, ClipperCalendarState, ClipperCalendarStates, ClipperChannel, ClipperChannelSettings, ClipperChannels, ClipperCollaborationService, ClipperCoreService, 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, clipperAuthInterceptor };
1874
- 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 };
1143
+ export { ClipperAccountService, ClipperAuthors, ClipperCalendarSearchParams, ClipperCalendarState, ClipperCalendarStates, ClipperChannel, ClipperChannelSettings, ClipperChannels, ClipperCoreService, ClipperDashboard, ClipperDocumentChangeReasons, ClipperDocumentContainer, ClipperDocumentsService, ClipperExportDocumentsFormat, ClipperFacet, ClipperLoginService, ClipperMessages, ClipperModel, ClipperModels, ClipperModule, ClipperModuleGroup, ClipperModuleGroups, ClipperModules, ClipperQueryDocumentFlags, ClipperQueryReferencesMode, ClipperRegions, ClipperSearchCalendarSnapshotResult, ClipperSearchFacetsSnapshot, ClipperSearchParams, ClipperSearchResult, ClipperSearchUtils, ClipperSectorTypes, ClipperSectors, ClipperSelectionMode, ClipperService, ClipperServiceFlags, ClipperSort, ClipperSources, ClipperUtils, clipperAuthInterceptor };
1144
+ export type { ClipperAvailableChannel, ClipperChannelSettingsItem, ClipperDashboardItem, ClipperDashboardModelItem, ClipperDeleteWorkingDocumentsParams, ClipperDocumentAnchorInfo, ClipperDocumentInfo, ClipperDocumentRelevantChunkHit, ClipperDocumentRelevants, ClipperDocumentStructure, ClipperDocumentUpdateStateParams, ClipperExportDocumentsParams, ClipperLoginInfo, ClipperLoginResult, ClipperOTPInfo, ClipperReferencesSearchParams, ClipperSearchCalendarSnapshotMonth, ClipperSearchFacet, ClipperSearchFacetGroup, ClipperSearchFacetsResult, ClipperSearchFilter, ClipperSendDocumentsByEmailParams, ClipperTaxonomyParams, ClipperTopicInfo, ClipperUserChannelInfo, ClipperUserInfo, ClipperUserSearch, ClipperUserTrialInfo, ClipperUserWorkingDocument, EditedEventArgs, SectorInfo };