cat-documents-ng 1.0.2 → 1.0.4

package/lib/document/services/excel-parser.service.d.ts

@@ -0,0 +1,169 @@
+import * as XLSX from 'xlsx';
+import * as i0 from "@angular/core";
+/**
+ * Interface for Excel cell styling information
+ */
+export interface ExcelCellStyle {
+    backgroundColor?: string;
+    fontColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    border?: {
+        top?: string;
+        bottom?: string;
+        left?: string;
+        right?: string;
+    };
+}
+/**
+ * Interface for Excel cell data with styling
+ */
+export interface ExcelCellData {
+    value: any;
+    style?: ExcelCellStyle;
+}
+/**
+ * Interface for Excel row data
+ */
+export interface ExcelRowData {
+    cells: ExcelCellData[];
+}
+/**
+ * Interface for parsed Excel data
+ */
+export interface ParsedExcelData {
+    sheets: string[];
+    currentSheet: string;
+    styledData: ExcelRowData[];
+    tableData: any[][];
+    hasStyling: boolean;
+    workbook: XLSX.WorkBook;
+}
+/**
+ * Service for parsing Excel files and extracting styling information
+ */
+export declare class ExcelParserService {
+    private workbookColors;
+    /**
+     * Parses Excel data from ArrayBuffer
+     */
+    parseExcelData(data: ArrayBuffer): ParsedExcelData | null;
+    /**
+     * Creates workbook from ArrayBuffer
+     */
+    private createWorkbook;
+    /**
+     * Gets sheet names from workbook
+     */
+    private getSheetNames;
+    /**
+     * Gets the first sheet name
+     */
+    private getFirstSheet;
+    /**
+     * Parses sheet data with styling
+     */
+    parseSheetData(workbook: XLSX.WorkBook, sheetName: string): ExcelRowData[];
+    /**
+     * Gets worksheet from workbook
+     */
+    private getWorksheet;
+    /**
+     * Gets worksheet range
+     */
+    private getWorksheetRange;
+    /**
+     * Processes worksheet rows
+     */
+    private processWorksheetRows;
+    /**
+     * Processes a single row
+     */
+    private processRow;
+    /**
+     * Gets cell from worksheet
+     */
+    private getCell;
+    /**
+     * Creates cell data with styling
+     */
+    private createCellData;
+    /**
+     * Checks if row has content
+     */
+    private hasRowContent;
+    /**
+     * Creates no data row
+     */
+    private createNoDataRow;
+    /**
+     * Creates error row
+     */
+    private createErrorRow;
+    /**
+     * Extracts styling from cell
+     */
+    extractCellStyle(cell: XLSX.CellObject): ExcelCellStyle | undefined;
+    /**
+     * Extracts background color
+     */
+    private extractBackgroundColor;
+    /**
+     * Extracts font color
+     */
+    private extractFontColor;
+    /**
+     * Extracts font formatting
+     */
+    private extractFontFormatting;
+    /**
+     * Extracts borders
+     */
+    private extractBorders;
+    /**
+     * Gets color value from color object
+     */
+    private getColorValue;
+    /**
+     * Converts RGB to hex
+     */
+    private rgbToHex;
+    /**
+     * Extracts theme color dynamically from Excel
+     */
+    private extractThemeColor;
+    /**
+     * Generates a theme color based on index (fallback)
+     */
+    private generateThemeColor;
+    /**
+     * Extracts indexed color dynamically from Excel
+     */
+    private extractIndexedColor;
+    /**
+     * Generates an indexed color based on index (fallback)
+     */
+    private generateIndexedColor;
+    /**
+     * Extracts color palette from Excel workbook
+     */
+    private extractWorkbookColors;
+    /**
+     * Checks if workbook has styling
+     */
+    hasWorkbookStyling(workbook: XLSX.WorkBook): boolean;
+    /**
+     * Checks if worksheet has styling
+     */
+    private hasWorksheetStyling;
+    /**
+     * Converts styled data to legacy format
+     */
+    convertToLegacyFormat(styledData: ExcelRowData[]): any[][];
+    /**
+     * Ensures data consistency
+     */
+    ensureDataConsistency(styledData: ExcelRowData[]): ExcelRowData[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExcelParserService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ExcelParserService>;
+}

package/lib/document/services/file-format.service.d.ts

@@ -0,0 +1,34 @@
+import { PrimeNGConfig } from 'primeng/api';
+import * as i0 from "@angular/core";
+/**
+ * Description placeholder
+ * @class FileFormatService
+ * @typedef {FileFormatService}
+ */
+export declare class FileFormatService {
+    /**
+     * Creates an instance of FileFormatService.
+     * @constructor
+     */
+    constructor();
+    /**
+     * Description placeholder
+     * @param {number} bytes
+     * @param {PrimeNGConfig} config
+     * @returns {string}
+     */
+    formatFileSize(bytes: number, config: PrimeNGConfig): string;
+    /**
+     * Validates if a file has an allowed extension
+     * @param fileName - The name of the file to validate
+     * @returns True if the file extension is allowed, false otherwise
+     */
+    isAllowedFileType(fileName: string): boolean;
+    /**
+     * Gets the list of allowed file extensions
+     * @returns Array of allowed file extensions
+     */
+    getAllowedFileExtensions(): string[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileFormatService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FileFormatService>;
+}

package/lib/document/services/status-calculator.service.d.ts

@@ -0,0 +1,20 @@
+import * as i0 from "@angular/core";
+export interface StatusData {
+    status: string;
+    count: number;
+    color?: string;
+    icon?: string;
+    _id?: string;
+}
+export interface CalculatedStatusData extends StatusData {
+    percentage: number;
+    isSelected: boolean;
+    statusClass: string;
+    iconClass: string;
+}
+export declare class StatusCalculatorService {
+    calculateTotalCount(statusData: StatusData[]): number;
+    calculateStatusDataWithPercentages(statusData: StatusData[], selectedStatus: string | null): CalculatedStatusData[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<StatusCalculatorService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<StatusCalculatorService>;
+}

package/lib/document/services/user-list.service.d.ts

@@ -0,0 +1,29 @@
+import { UserListModel } from '../models/user-list.model';
+import { DocumentStore } from '../state/document.store';
+import { DocumentQuery } from '../state/document.query';
+import { DocumentCategory } from '../models/document-category.model';
+import * as i0 from "@angular/core";
+export declare class UserListService {
+    private documentStore;
+    private documentQuery;
+    constructor(documentStore: DocumentStore, documentQuery: DocumentQuery);
+    getInitials(name: string): string;
+    getColorByIndex(index: number): string;
+    getColorValue(colorName: string): string;
+    processUserData(userList: UserListModel[]): UserListModel[];
+    /**
+     * Filters user list based on selected menu item category
+     * @param userList - The complete user list
+     * @param categories - The document categories
+     * @returns Filtered user list
+     */
+    filterUsersByCategory(userList: UserListModel[], categories: DocumentCategory[]): UserListModel[];
+    selectUser(userId: string, userData: UserListModel[]): {
+        selectedUser: string | undefined;
+        name: string | undefined;
+    };
+    unselectUser(): void;
+    isUserSelected(userId: string, userData: UserListModel[], selectedUser: string | undefined): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UserListService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UserListService>;
+}

package/lib/document/state/document.query.d.ts

@@ -0,0 +1,243 @@
+import { QueryEntity } from '@datorama/akita';
+import { DocumentStore } from './document.store';
+import { DocumentState } from './document.state';
+import { Observable } from 'rxjs';
+import { Message } from 'primeng/api';
+import { DocumentModel } from '../models/document.model';
+import { DocumentCategory } from '../models/document-category.model';
+import { UserListModel } from '../models/user-list.model';
+import { StatusDataModel } from '../models/status-data.model';
+import { DocumentListResponse } from '../models/document-list-response.model';
+import { DocumentListItem } from '../models/document-list-response.model';
+import { DocumentHistorySection } from '../models/document-history.model';
+import * as i0 from "@angular/core";
+/**
+ * Query service for managing document state.
+ * This class extends Akita's `QueryEntity` to provide additional functionality for querying document data.
+ * @class DocumentQuery
+ * @typedef {DocumentQuery}
+ * @augments {QueryEntity<DocumentState>}
+ */
+export declare class DocumentQuery extends QueryEntity<DocumentState> {
+    protected store: DocumentStore;
+    constructor(store: DocumentStore);
+    /**
+     * Selects the currently selected folder ID from the document state.
+     * @returns {Observable<string | null>} Observable that emits the currently selected folder ID.
+     */
+    getParentDocumentTypeId(): string | null;
+    /**
+     * Selects the currently selected folder ID from the document state.
+     * @returns {Observable<string | null>} Observable that emits the currently selected folder ID.
+     */
+    selectParentDocumentTypeId(): Observable<string | null>;
+    /**
+     * Selects the set messages.
+     * @returns {Observable<Message>} Observable that emits the current Message.
+     */
+    selectMessages(): Observable<Message[]>;
+    /**
+     * Selects the set documents.
+     * @returns {Observable<DocumentModel[]>} Observable that emits the documets.
+     */
+    selectDocumets(): Observable<DocumentModel[]>;
+    /**
+     * Selects the document categories.
+     * @returns {Observable<DocumentCategory[]>} Observable that emits the document categories.
+     */
+    selectDocumentCategories(): Observable<DocumentCategory[]>;
+    /**
+     * Selects the currently selected menu item.
+     * @returns {Observable<string | null>} Observable that emits the currently selected menu item _id (not the label).
+     */
+    selectSelectedMenuItem(): Observable<string | null>;
+    /**
+     * Selects the currently selected user ID.
+     * @returns {Observable<string | null>} Observable that emits the currently selected user ID.
+     */
+    selectSelectedUserId(): Observable<string | null>;
+    /**
+     * Selects the currently selected status.
+     * @returns {Observable<string | null>} Observable that emits the currently selected status.
+     */
+    selectSelectedStatus(): Observable<string | null>;
+    /**
+     * Selects the current search key.
+     * @returns {Observable<string | null>} Observable that emits the current search key.
+     */
+    selectSearchKey(): Observable<string | null>;
+    /**
+     * Selects all selection state properties (menu item, user ID, status, search key).
+     * @returns {Observable<{menuItem: string | null, userId: string | null, status: string | null, searchKey: string | null}>} Observable that emits the current selection state.
+     * Note: menuItem is the _id of the selected menu item, not the label.
+     */
+    selectSelectionState(): Observable<{
+        menuItem: string | null;
+        userId: string | null;
+        status: string | null;
+        searchKey: string | null;
+    }>;
+    /**
+     * Gets the current selection state values (synchronous).
+     * @returns {Object} The current selection state values.
+     * Note: menuItem is the _id of the selected menu item, not the label.
+     */
+    getSelectionState(): {
+        menuItem: string | null;
+        userId: string | null;
+        status: string | null;
+        searchKey: string | null;
+    };
+    /**
+     * Selects the user list visibility state.
+     * @returns {Observable<boolean>} Observable that emits the current user list visibility.
+     */
+    selectShowUserList(): Observable<boolean>;
+    /**
+     * Gets the current user list visibility value (synchronous).
+     * @returns {boolean} The current user list visibility.
+     */
+    getShowUserList(): boolean;
+    /**
+     * Selects the current document.
+     * @returns {Observable<DocumentModel | null>} Observable that emits the current document.
+     */
+    selectCurrentDocument(): Observable<DocumentModel | null>;
+    /**
+     * Gets the current document value (synchronous).
+     * @returns {DocumentModel | null} The current document.
+     */
+    getCurrentDocument(): DocumentModel | null;
+    /**
+     * Selects the user list.
+     * @returns {Observable<UserListModel[]>} Observable that emits the user list.
+     */
+    selectUserList(): Observable<UserListModel[]>;
+    /**
+     * Gets the current user list value (synchronous).
+     * @returns {UserListModel[]} The current user list.
+     */
+    getUserList(): UserListModel[];
+    /**
+     * Selects the status data.
+     * @returns {Observable<StatusDataModel[]>} Observable that emits the status data.
+     */
+    selectStatusData(): Observable<StatusDataModel[]>;
+    /**
+     * Gets the current status data value (synchronous).
+     * @returns {StatusDataModel[]} The current status data.
+     */
+    getStatusData(): StatusDataModel[];
+    /**
+     * Selects the document list response.
+     * @returns {Observable<DocumentListResponse[] | null>} Observable that emits the document list response.
+     */
+    selectDocumentListResponse(): Observable<DocumentListResponse[] | null>;
+    /**
+     * Gets the current document list response value (synchronous).
+     * @returns {DocumentListResponse[] | null} The current document list response.
+     */
+    getDocumentListResponse(): DocumentListResponse[] | null;
+    /**
+     * Selects the selected document for viewing.
+     * @returns {Observable<DocumentListItem | undefined>} Observable that emits the selected document.
+     */
+    selectSelectedDocument(): Observable<DocumentListItem | undefined>;
+    /**
+     * Gets the current selected document value (synchronous).
+     * @returns {DocumentListItem | undefined} The current selected document.
+     */
+    getSelectedDocument(): DocumentListItem | undefined;
+    /**
+     * Selects the document history.
+     * @returns {Observable<DocumentHistorySection[]>} Observable that emits the document history.
+     */
+    selectDocumentHistory(): Observable<DocumentHistorySection[]>;
+    /**
+     * Gets the current document history value (synchronous).
+     * @returns {DocumentHistorySection[]} The current document history.
+     */
+    getDocumentHistory(): DocumentHistorySection[];
+    /**
+     * Selects the document history visibility state.
+     * @returns {Observable<boolean>} Observable that emits the current document history visibility.
+     */
+    selectShowDocumentHistory(): Observable<boolean>;
+    /**
+     * Gets the current document history visibility value (synchronous).
+     * @returns {boolean} The current document history visibility.
+     */
+    getShowDocumentHistory(): boolean;
+    /**
+     * Selects the action loading state.
+     * @returns {Observable<boolean>} Observable that emits the current action loading state.
+     */
+    selectIsActionLoading(): Observable<boolean>;
+    /**
+     * Gets the current action loading value (synchronous).
+     * @returns {boolean} The current action loading state.
+     */
+    getIsActionLoading(): boolean;
+    /**
+     * Selects the document status.
+     * @returns {Observable<'pending' | 'accepted' | 'rejected'>} Observable that emits the current document status.
+     */
+    selectDocumentStatus(): Observable<'pending' | 'accepted' | 'rejected'>;
+    /**
+     * Gets the current document status value (synchronous).
+     * @returns {'pending' | 'accepted' | 'rejected'} The current document status.
+     */
+    getDocumentStatus(): 'pending' | 'accepted' | 'rejected';
+    /**
+     * Selects the document uploaded state.
+     * @returns {Observable<boolean>} Observable that emits the current document uploaded state.
+     */
+    selectDocumentIsUploaded(): Observable<boolean>;
+    /**
+     * Gets the current document uploaded value (synchronous).
+     * @returns {boolean} The current document uploaded state.
+     */
+    getDocumentIsUploaded(): boolean;
+    /**
+     * Selects the alert data.
+     * @returns {Observable<any>} Observable that emits the current alert data.
+     */
+    selectAlertData(): Observable<any>;
+    /**
+     * Gets the current alert data value (synchronous).
+     * @returns {any} The current alert data.
+     */
+    getAlertData(): any;
+    /**
+     * Selects all document viewer state properties.
+     * @returns {Observable<{selectedDocument?: DocumentListItem, documentHistory: DocumentHistorySection[], showDocumentHistory: boolean, isActionLoading: boolean, documentStatus: 'pending' | 'accepted' | 'rejected', documentIsUploaded: boolean, alertData: any, deleteError: any, deleteSuccess: boolean}>} Observable that emits the current document viewer state.
+     */
+    selectDocumentViewerState(): Observable<{
+        selectedDocument?: DocumentListItem;
+        documentHistory: DocumentHistorySection[];
+        showDocumentHistory: boolean;
+        isActionLoading: boolean;
+        documentStatus: 'pending' | 'accepted' | 'rejected';
+        documentIsUploaded: boolean;
+        alertData: any;
+        deleteError: any;
+        deleteSuccess: boolean;
+    }>;
+    /**
+     * Gets the current document viewer state values (synchronous).
+     * @returns {Object} The current document viewer state values.
+     */
+    getDocumentViewerState(): {
+        selectedDocument?: DocumentListItem;
+        documentHistory: DocumentHistorySection[];
+        showDocumentHistory: boolean;
+        isActionLoading: boolean;
+        documentStatus: 'pending' | 'accepted' | 'rejected';
+        documentIsUploaded: boolean;
+        alertData: any;
+        deleteError: any;
+        deleteSuccess: boolean;
+    };
+    static ɵfac: i0.ɵɵFactoryDeclaration<DocumentQuery, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DocumentQuery>;
+}

package/{projects/cat-document-lib/src/lib/document/state/document.service.ts → lib/document/state/document.service.d.ts}

@@ -1,11 +1,9 @@
-import { Injectable } from '@angular/core';
 import { HttpClient } from '@angular/common/http';
 import { DocumentStore } from './document.store';
-import { Observable, tap } from 'rxjs';
+import { Observable } from 'rxjs';
 import { AppConfigService } from '../../../Shared/services/app-config.service';
-import { URLS } from '../../../Shared/constant/URLS';
 import { DocumentModel } from '../models/document.model';
-
+import * as i0 from "@angular/core";
 /**
  * Service for managing document-related operations.
  * The `DocumentService` acts as a bridge between the application and the backend API for handling document-related data.
@@ -14,82 +12,53 @@ import { DocumentModel } from '../models/document.model';
  * @param {DocumentStore} documentStore - The store that manages the state of documents.
  * @param {HttpClient} http - The Angular HTTP client for making API requests.
  */
-@Injectable({ providedIn: 'root' })
-export class DocumentService {
-
+export declare class DocumentService {
+    documentStore: DocumentStore;
+    private http;
+    appConfigService: AppConfigService;
     /**
      * Creates an instance of DocumentService.
      * @param {DocumentStore} documentStore - Store managing the state of documents.
      * @param {HttpClient} http - Angular HTTP client for making API requests.
      * @param {AppConfigService} appConfigService - Service for retrieving application configuration, such as API base URL.
      */
-    constructor(
-        public documentStore: DocumentStore,
-        private http: HttpClient,
-        public appConfigService: AppConfigService
-    ) { }
-
+    constructor(documentStore: DocumentStore, http: HttpClient, appConfigService: AppConfigService);
     /**
      * Get api url from appConfigService.
      * @readonly
      * @type {string}
      */
-    get apiUrl(): string {
-        return this.appConfigService.apiBaseUrl;
-    }
-
+    get apiUrl(): string;
     /**
      * Sends a request to create a new document.
      * @param {*} entity - The data of the document to be created.
      * @returns {Observable<any>} Observable that emits the newly created document.
      */
-    create(entity: any): Observable<any> {
-        return this.http.post<any>(`${this.apiUrl}${URLS.DOCUMENT_UPLOAD}`, entity).pipe(
-            tap((newEntity: any) => this.documentStore.add(newEntity))
-        );
-    }
-
+    create(entity: any): Observable<any>;
     /**
      * Fetches all documents from the backend.
      * @returns {Observable<DocumentModel[]>} Observable that emits an array of documents.
      */
-    getAll(): Observable<DocumentModel[]> {
-        return this.http.get<DocumentModel[]>(`${this.apiUrl}${URLS.DOCUMENT_UPLOAD}`).pipe(
-            tap((entities: DocumentModel[]) => this.documentStore.set(entities))
-        );
-    }
-
+    getAll(): Observable<DocumentModel[]>;
     /**
      * Fetches a document by its ID.
      * @param {string} id - The unique identifier of the document.
      * @returns {Observable<any>} Observable that emits the retrieved document.
      */
-    getById(id: string): Observable<any> {
-        return this.http.get<any>(`${this.apiUrl}${URLS.DOCUMENT_UPLOAD}/${id}`).pipe(
-            tap((entity: any) => this.documentStore.upsert(id, entity))
-        );
-    }
-
+    getById(id: string): Observable<any>;
     /**
      * Updates an existing document by its ID.
      * @param {string} id - The unique identifier of the document.
      * @param {DocumentModel} entity - The updated data of the document.
      * @returns {Observable<DocumentModel>} Observable that emits the updated document.
      */
-    update(id: string, entity: DocumentModel): Observable<DocumentModel> {
-        return this.http.put<DocumentModel>(`${this.apiUrl}${URLS.DOCUMENT_UPLOAD}/${id}`, entity).pipe(
-            tap((updatedEntity: DocumentModel) => this.documentStore.update(id, updatedEntity))
-        );
-    }
-
+    update(id: string, entity: DocumentModel): Observable<DocumentModel>;
     /**
      * Deletes a document by its ID.
      * @param {string} id - The unique identifier of the document to be deleted.
      * @returns {Observable<void>} Observable that completes when the document is deleted.
      */
-    delete(id: string): Observable<void> {
-        return this.http.delete<void>(`${this.apiUrl}${URLS.DOCUMENT_UPLOAD}/${id}`).pipe(
-            tap(() => this.documentStore.remove(id))
-        );
-    }
+    delete(id: string): Observable<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DocumentService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DocumentService>;
 }

package/lib/document/state/document.state.d.ts

@@ -0,0 +1,61 @@
+import { EntityState } from '@datorama/akita';
+import { DocumentModel } from '../models/document.model';
+import { DocumentTypeModel } from '../models/document-type.model';
+import { DocumentAlertModel } from '../models/document-alert.model';
+import { FolderBlockModel } from '../models/folder.model';
+import { DocumentCategory } from '../models/document-category.model';
+import { Message } from 'primeng/api';
+import { UserListModel } from '../models/user-list.model';
+import { StatusDataModel } from '../models/status-data.model';
+import { DocumentListResponse } from '../models/document-list-response.model';
+import { DocumentListItem } from '../models/document-list-response.model';
+import { DocumentHistorySection } from '../models/document-history.model';
+/**
+ * Represents the state of the documents in the application.
+ * This interface extends Akita's `EntityState` to include additional properties
+ * for managing document-specific data, such as `records`, `filteredRecords` and `folderId`.
+ * @interface DocumentState
+ * @property {any[]} records - A collection of records related to documents.
+ * @property {any[]} filteredRecords - A collection of filteredRecords related to documents.
+ * @property {string | null} folderId - The ID of the currently selected folder, or `null` if no folder is selected.
+ * @property {boolean} isDialogOpen - A flag indicating whether a dialog is open.
+ */
+export interface DocumentState extends EntityState<DocumentModel, string> {
+    records: DocumentModel[];
+    folderId: string | null;
+    isDialogOpen: boolean;
+    filteredRecords: DocumentModel[];
+    dropdownOptions: DocumentTypeModel[];
+    uploadedDocumentFiles: DocumentModel[];
+    parentDocumentTypeId: string | null;
+    documentAlert: DocumentAlertModel;
+    folders: FolderBlockModel[];
+    messages: Message[];
+    documentList: DocumentModel[];
+    documentCategories: DocumentCategory[];
+    selectedMenuItem: string | null;
+    selectedUserId: string | null;
+    selectedStatus: string | null;
+    searchKey: string | null;
+    showUserList: boolean;
+    currentDocument: DocumentModel | null;
+    userList: UserListModel[];
+    statusData: StatusDataModel[];
+    documentListResponse: DocumentListResponse[] | null;
+    selectedDocument?: DocumentListItem;
+    documentHistory: DocumentHistorySection[];
+    showDocumentHistory: boolean;
+    isActionLoading: boolean;
+    documentStatus: 'pending' | 'accepted' | 'rejected';
+    documentIsUploaded: boolean;
+    alertData: any;
+    deleteError: any;
+    deleteSuccess: boolean;
+}
+/**
+ * Creates the initial state for the `DocumentState` store.
+ * This function provides default values for all properties in the `DocumentState` interface,
+ * ensuring the store starts with a consistent initial structure.
+ * @returns {DocumentState} The initial state of the document store.
+ */
+export declare function createInitialState(): DocumentState;