cat-documents-ng 0.3.19 → 0.3.21

package/lib/document/components/document-content-viewer/document-content-viewer.component.d.ts

@@ -0,0 +1,184 @@
+import { OnChanges, SimpleChanges, OnInit } from '@angular/core';
+import { ExcelParserService, ExcelRowData } from '../../services/excel-parser.service';
+import { DocumentHttpService } from '../../services/document-http.service';
+import * as i0 from "@angular/core";
+/**
+ * Component for viewing different types of document content.
+ * Supports PDF, images, and other document formats.
+ * @class DocumentContentViewerComponent
+ * @typedef {DocumentContentViewerComponent}
+ */
+export declare class DocumentContentViewerComponent implements OnChanges, OnInit {
+    private excelParserService;
+    private documentHttpService;
+    /**
+     * The document URL to display
+     * @type {string}
+     */
+    documentUrl?: string;
+    /**
+     * The content type of the document
+     * @type {string}
+     */
+    contentType?: string;
+    /**
+     * The document name for display purposes
+     * @type {string}
+     */
+    documentName?: string;
+    /**
+     * Excel data for display
+     * @type {any}
+     */
+    excelData: any;
+    /**
+     * Parsed Excel data as table rows
+     * @type {any[][]}
+     */
+    excelTableData: any[][];
+    /**
+     * Enhanced Excel data with styling information
+     * @type {ExcelRowData[]}
+     */
+    excelStyledData: ExcelRowData[];
+    /**
+     * Excel sheet names
+     * @type {string[]}
+     */
+    excelSheets: string[];
+    /**
+     * Current active sheet
+     * @type {string}
+     */
+    currentSheet: string;
+    /**
+     * Loading state for Excel files
+     * @type {boolean}
+     */
+    isLoadingExcel: boolean;
+    /**
+     * Error state for Excel files
+     * @type {string | null}
+     */
+    excelError: string | null;
+    /**
+     * Loading state specifically for Word documents
+     * @type {boolean}
+     */
+    isLoadingWordDocument: boolean;
+    /**
+     * Configuration for the document viewer
+     * @type {any}
+     */
+    docViewerConfig: any;
+    /**
+       * Constructor
+       * @param {ExcelParserService} excelParserService - Service for parsing Excel files
+       * @param {DocumentHttpService} documentHttpService - Service for making HTTP requests with authentication
+       */
+    constructor(excelParserService: ExcelParserService, documentHttpService: DocumentHttpService);
+    /**
+     * Computed property to determine if the document is an image
+     * @type {boolean}
+     */
+    get isImage(): boolean;
+    /**
+     * Computed property to determine if the document is a PDF
+     * @type {boolean}
+     */
+    get isPdf(): boolean;
+    /**
+     * Computed property to determine if the document is an Excel file
+     * @type {boolean}
+     */
+    get isExcel(): boolean;
+    /**
+     * Computed property to determine if the document is a Word file
+     * @type {boolean}
+     */
+    get isWord(): boolean;
+    /**
+     * Computed property to determine if the document is a CSV file
+     * @type {boolean}
+     */
+    get isCsv(): boolean;
+    /**
+     * Computed property to determine if the document is an email file
+     * @type {boolean}
+     */
+    get isEmail(): boolean;
+    /**
+     * Computed property to determine if the document is an OpenDocument file
+     * @type {boolean}
+     */
+    get isOpenDocument(): boolean;
+    /**
+     * Computed property to determine if the document has an unsupported content type
+     * @type {boolean}
+     */
+    get isUnsupported(): boolean;
+    /**
+     * Computed property to get the appropriate icon for the document type
+     * @type {string}
+     */
+    get documentIcon(): string;
+    /**
+     * Computed property to get the display text for the document type
+     * @type {string}
+     */
+    get documentTypeText(): string;
+    /**
+     * Safely gets the styled Excel data for display
+     * @type {ExcelRowData[]}
+     */
+    get safeExcelStyledData(): ExcelRowData[];
+    /**
+     * Handles changes to input properties
+     * @param {SimpleChanges} changes - The changes object
+     */
+    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Initializes the component
+     */
+    ngOnInit(): void;
+    /**
+     * Downloads the document
+     */
+    downloadDocument(): void;
+    /**
+     * Opens the document in a new tab
+     */
+    openInNewTab(): void;
+    /**
+     * Loads Excel data for display
+     */
+    private loadExcelData;
+    /**
+     * Parses Excel data using the service
+     * @param {ArrayBuffer} data - Excel file data
+     */
+    private parseExcelData;
+    /**
+     * Changes the active Excel sheet
+     * @param {string} sheetName - Name of the sheet to activate
+     */
+    changeSheet(sheetName: string): void;
+    /**
+     * Resets Excel data to initial state
+     */
+    private resetExcelData;
+    /**
+     * Handles the beforeLoad event from ngx-doc-viewer
+     */
+    onWordDocumentBeforeLoad(): void;
+    /**
+     * Handles the load event from ngx-doc-viewer
+     */
+    onWordDocumentLoad(): void;
+    /**
+     * Handles the error event from ngx-doc-viewer
+     */
+    onWordDocumentError(error: any): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DocumentContentViewerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DocumentContentViewerComponent, "document-content-viewer", never, { "documentUrl": { "alias": "documentUrl"; "required": false; }; "contentType": { "alias": "contentType"; "required": false; }; "documentName": { "alias": "documentName"; "required": false; }; }, {}, never, never, false, never>;
+}

package/lib/document/components/document-viewer/document-viewer.component.d.ts

@@ -64,21 +64,6 @@ export declare class DocumentViewerComponent implements OnChanges, OnDestroy {
      * @type {DocumentViewerState}
      */
     currentState: DocumentViewerState;
-    /**
-     * Computed property to determine if the selected document is an image
-     * @type {boolean}
-     */
-    get isSelectedDocumentImage(): boolean;
-    /**
-     * Computed property to determine if the selected document is a PDF
-     * @type {boolean}
-     */
-    get isSelectedDocumentPdf(): boolean;
-    /**
-     * Computed property to determine if the selected document has an unsupported content type
-     * @type {boolean}
-     */
-    get isSelectedDocumentUnsupported(): boolean;
     /**
      * Holds the subscription to manage observable cleanup.
      * @private
@@ -102,12 +87,6 @@ export declare class DocumentViewerComponent implements OnChanges, OnDestroy {
      * @param document The selected document
      */
     handleSelectedDocument(document: DocumentListItem): void;
-    /**
-     * Determines if the given content type is an image.
-     * @param {string | undefined} contentType - The MIME type of the content.
-     * @returns {boolean} `true` if the content type is an image; otherwise, `false`.
-     */
-    isImage(contentType?: string): boolean;
     /**
      * Handles document actions from the actions component
      * @param {DocumentAction} action - The action performed

package/lib/document/document.module.d.ts

@@ -7,41 +7,43 @@ import * as i5 from "./components/document-list-item/document-list-item.componen
 import * as i6 from "./components/document-upload/document-upload.component";
 import * as i7 from "./components/document-viewer/document-viewer.component";
 import * as i8 from "./components/document-history/document-history.component";
-import * as i9 from "./directives/document.directive";
-import * as i10 from "./components/linked-document/linked-document.component";
-import * as i11 from "./components/documents-menu/documents-menu.component";
-import * as i12 from "./components/user-list/user-list.component";
-import * as i13 from "./components/document-status/document-status.component";
-import * as i14 from "./components/document-actions/document-actions.component";
-import * as i15 from "./components/document-search/document-search.component";
-import * as i16 from "./components/sidebar/sidebar.component";
-import * as i17 from "@angular/common";
-import * as i18 from "primeng/accordion";
-import * as i19 from "@angular/common/http";
-import * as i20 from "primeng/button";
-import * as i21 from "primeng/sidebar";
-import * as i22 from "primeng/fileupload";
-import * as i23 from "primeng/progressbar";
-import * as i24 from "primeng/badge";
-import * as i25 from "primeng/listbox";
-import * as i26 from "primeng/checkbox";
-import * as i27 from "primeng/radiobutton";
-import * as i28 from "primeng/timeline";
-import * as i29 from "primeng/inputtextarea";
-import * as i30 from "@angular/forms";
-import * as i31 from "ng2-pdf-viewer";
-import * as i32 from "primeng/dialog";
-import * as i33 from "primeng/dropdown";
-import * as i34 from "primeng/inputtext";
-import * as i35 from "primeng/menu";
-import * as i36 from "primeng/panelmenu";
-import * as i37 from "primeng/card";
-import * as i38 from "primeng/table";
-import * as i39 from "../../Shared/shared.module";
-import * as i40 from "primeng/toast";
-import * as i41 from "primeng/tooltip";
-import * as i42 from "primeng/messages";
-import * as i43 from "primeng/message";
+import * as i9 from "./components/document-content-viewer/document-content-viewer.component";
+import * as i10 from "./directives/document.directive";
+import * as i11 from "./components/linked-document/linked-document.component";
+import * as i12 from "./components/documents-menu/documents-menu.component";
+import * as i13 from "./components/user-list/user-list.component";
+import * as i14 from "./components/document-status/document-status.component";
+import * as i15 from "./components/document-actions/document-actions.component";
+import * as i16 from "./components/document-search/document-search.component";
+import * as i17 from "./components/sidebar/sidebar.component";
+import * as i18 from "@angular/common";
+import * as i19 from "primeng/accordion";
+import * as i20 from "@angular/common/http";
+import * as i21 from "primeng/button";
+import * as i22 from "primeng/sidebar";
+import * as i23 from "primeng/fileupload";
+import * as i24 from "primeng/progressbar";
+import * as i25 from "primeng/badge";
+import * as i26 from "primeng/listbox";
+import * as i27 from "primeng/checkbox";
+import * as i28 from "primeng/radiobutton";
+import * as i29 from "primeng/timeline";
+import * as i30 from "primeng/inputtextarea";
+import * as i31 from "@angular/forms";
+import * as i32 from "ng2-pdf-viewer";
+import * as i33 from "ngx-doc-viewer";
+import * as i34 from "primeng/dialog";
+import * as i35 from "primeng/dropdown";
+import * as i36 from "primeng/inputtext";
+import * as i37 from "primeng/menu";
+import * as i38 from "primeng/panelmenu";
+import * as i39 from "primeng/card";
+import * as i40 from "primeng/table";
+import * as i41 from "../../Shared/shared.module";
+import * as i42 from "primeng/toast";
+import * as i43 from "primeng/tooltip";
+import * as i44 from "primeng/messages";
+import * as i45 from "primeng/message";
 /**
  * @module DocumentModule
  *
@@ -51,6 +53,6 @@ import * as i43 from "primeng/message";
  */
 export declare class DocumentModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DocumentModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<DocumentModule, [typeof i1.DocumentContainerComponent, typeof i2.FolderContainerComponent, typeof i3.FolderBlockComponent, typeof i4.DocumentListComponent, typeof i5.DocumentListItemComponent, typeof i6.DocumentUploadComponent, typeof i7.DocumentViewerComponent, typeof i8.DocumentHistoryComponent, typeof i9.DocumentDirective, typeof i10.LinkedDocumentComponent, typeof i11.DocumentsMenuComponent, typeof i12.UserListComponent, typeof i13.DocumentStatusComponent, typeof i14.DocumentActionsComponent, typeof i15.DocumentSearchComponent, typeof i16.SidebarComponent], [typeof i17.CommonModule, typeof i18.AccordionModule, typeof i19.HttpClientModule, typeof i20.ButtonModule, typeof i21.SidebarModule, typeof i22.FileUploadModule, typeof i23.ProgressBarModule, typeof i24.BadgeModule, typeof i25.ListboxModule, typeof i26.CheckboxModule, typeof i27.RadioButtonModule, typeof i28.TimelineModule, typeof i29.InputTextareaModule, typeof i30.FormsModule, typeof i31.PdfViewerModule, typeof i32.DialogModule, typeof i33.DropdownModule, typeof i34.InputTextModule, typeof i35.MenuModule, typeof i36.PanelMenuModule, typeof i37.CardModule, typeof i38.TableModule, typeof i39.SharedModule, typeof i29.InputTextareaModule, typeof i40.ToastModule, typeof i41.TooltipModule, typeof i42.MessagesModule, typeof i43.MessageModule], [typeof i1.DocumentContainerComponent, typeof i7.DocumentViewerComponent, typeof i14.DocumentActionsComponent, typeof i4.DocumentListComponent, typeof i9.DocumentDirective, typeof i15.DocumentSearchComponent, typeof i16.SidebarComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<DocumentModule, [typeof i1.DocumentContainerComponent, typeof i2.FolderContainerComponent, typeof i3.FolderBlockComponent, typeof i4.DocumentListComponent, typeof i5.DocumentListItemComponent, typeof i6.DocumentUploadComponent, typeof i7.DocumentViewerComponent, typeof i8.DocumentHistoryComponent, typeof i9.DocumentContentViewerComponent, typeof i10.DocumentDirective, typeof i11.LinkedDocumentComponent, typeof i12.DocumentsMenuComponent, typeof i13.UserListComponent, typeof i14.DocumentStatusComponent, typeof i15.DocumentActionsComponent, typeof i16.DocumentSearchComponent, typeof i17.SidebarComponent], [typeof i18.CommonModule, typeof i19.AccordionModule, typeof i20.HttpClientModule, typeof i21.ButtonModule, typeof i22.SidebarModule, typeof i23.FileUploadModule, typeof i24.ProgressBarModule, typeof i25.BadgeModule, typeof i26.ListboxModule, typeof i27.CheckboxModule, typeof i28.RadioButtonModule, typeof i29.TimelineModule, typeof i30.InputTextareaModule, typeof i31.FormsModule, typeof i32.PdfViewerModule, typeof i33.NgxDocViewerModule, typeof i34.DialogModule, typeof i35.DropdownModule, typeof i36.InputTextModule, typeof i37.MenuModule, typeof i38.PanelMenuModule, typeof i39.CardModule, typeof i40.TableModule, typeof i41.SharedModule, typeof i30.InputTextareaModule, typeof i42.ToastModule, typeof i43.TooltipModule, typeof i44.MessagesModule, typeof i45.MessageModule], [typeof i1.DocumentContainerComponent, typeof i7.DocumentViewerComponent, typeof i9.DocumentContentViewerComponent, typeof i15.DocumentActionsComponent, typeof i4.DocumentListComponent, typeof i10.DocumentDirective, typeof i16.DocumentSearchComponent, typeof i17.SidebarComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<DocumentModule>;
 }

package/lib/document/services/document-content-type.service.d.ts

@@ -0,0 +1,85 @@
+import * as i0 from "@angular/core";
+/**
+ * Service for handling document content types and their mappings.
+ * Supports the content types: "xlsx","xls","doc","docx","pdf","jpg","jpeg","odt","csv","png","msg","eml"
+ * @class DocumentContentTypeService
+ * @typedef {DocumentContentTypeService}
+ */
+export declare class DocumentContentTypeService {
+    /**
+     * Mapping of file extensions to MIME types
+     * @type {Record<string, string>}
+     */
+    private readonly extensionToMimeType;
+    /**
+     * Mapping of MIME types to file extensions
+     * @type {Record<string, string>}
+     */
+    private readonly mimeTypeToExtension;
+    /**
+     * List of all supported file extensions
+     * @type {string[]}
+     */
+    readonly supportedExtensions: string[];
+    /**
+     * List of all supported MIME types
+     * @type {string[]}
+     */
+    readonly supportedMimeTypes: string[];
+    /**
+     * Gets the MIME type for a given file extension
+     * @param {string} extension - The file extension (with or without dot)
+     * @returns {string | undefined} The MIME type or undefined if not supported
+     */
+    getMimeType(extension: string): string | undefined;
+    /**
+     * Gets the file extension for a given MIME type
+     * @param {string} mimeType - The MIME type
+     * @returns {string | undefined} The file extension or undefined if not supported
+     */
+    getExtension(mimeType: string): string | undefined;
+    /**
+     * Checks if a file extension is supported
+     * @param {string} extension - The file extension (with or without dot)
+     * @returns {boolean} True if the extension is supported
+     */
+    isExtensionSupported(extension: string): boolean;
+    /**
+     * Checks if a MIME type is supported
+     * @param {string} mimeType - The MIME type
+     * @returns {boolean} True if the MIME type is supported
+     */
+    isMimeTypeSupported(mimeType: string): boolean;
+    /**
+     * Gets the file extension from a filename
+     * @param {string} filename - The filename
+     * @returns {string | undefined} The file extension or undefined if no extension found
+     */
+    getExtensionFromFilename(filename: string): string | undefined;
+    /**
+     * Gets the MIME type from a filename
+     * @param {string} filename - The filename
+     * @returns {string | undefined} The MIME type or undefined if not supported
+     */
+    getMimeTypeFromFilename(filename: string): string | undefined;
+    /**
+     * Validates if a file can be uploaded based on its extension
+     * @param {string} filename - The filename to validate
+     * @returns {boolean} True if the file can be uploaded
+     */
+    canUploadFile(filename: string): boolean;
+    /**
+     * Gets a human-readable description for a content type
+     * @param {string} contentType - The content type (MIME type or extension)
+     * @returns {string} Human-readable description
+     */
+    getContentTypeDescription(contentType: string): string;
+    /**
+     * Gets a human-readable description for a file extension
+     * @param {string} extension - The file extension
+     * @returns {string} Human-readable description
+     */
+    private getExtensionDescription;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DocumentContentTypeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DocumentContentTypeService>;
+}

package/lib/document/services/document-http.service.d.ts

@@ -13,6 +13,7 @@ import { DocumentHistorySection } from '../models/document-history.model';
 import * as i0 from "@angular/core";
 /**
  * Service for making HTTP requests related to documents.
+ * Authentication is handled automatically by the HTTP interceptor in the main project.
  * @class DocumentHttpService
  * @typedef {DocumentHttpService}
  */
@@ -146,6 +147,13 @@ export declare class DocumentHttpService {
      * @returns {Observable<any>} Observable that emits the delete response
      */
     deleteDocument(documentId: string, contextId: string): Observable<any>;
+    /**
+     * Downloads an Excel file with proper authentication headers
+     * Authentication is handled automatically by the HTTP interceptor
+     * @param {string} documentUrl - The URL of the Excel file to download
+     * @returns {Observable<ArrayBuffer>} Observable that emits the file data as ArrayBuffer
+     */
+    downloadExcelFile(documentUrl: string): Observable<ArrayBuffer>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DocumentHttpService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<DocumentHttpService>;
 }

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cat-documents-ng",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "peerDependencies": {
     "@angular/common": "^19.0.0",
     "@angular/core": "^19.0.0"

package/public-api.d.ts

@@ -1,6 +1,7 @@
 export * from './lib/document/document.module';
 export * from './lib/document/components/document-container/document-container.component';
 export * from './lib/document/components/document-viewer/document-viewer.component';
+export * from './lib/document/components/document-content-viewer/document-content-viewer.component';
 export * from './lib/document/components/document-actions/document-actions.component';
 export * from './lib/document/components/document-history/document-history.component';
 export * from './lib/document/components/document-list/document-list.component';
@@ -9,6 +10,7 @@ export * from './lib/document/components/sidebar/sidebar.component';
 export * from './lib/document/models/document-history.model';
 export * from './lib/document/models/uploaded-file-response.model';
 export * from './lib/document/services/document-table-builder.service';
+export * from './lib/document/services/document-content-type.service';
 export * from './lib/document/directives/document.directive';
 export * from './lib/document/directives/permission.directive';
 export * from './Shared/components/confirmation-dialog/confirmation-dialog.component';