cat-documents-ng 1.0.6 → 1.0.7

package/src/lib/document/components/document-upload/document-upload.component.ts

@@ -1,668 +0,0 @@
-import { ChangeDetectorRef, Component, Input, ViewChild, ViewEncapsulation, OnDestroy, Output, EventEmitter, OnInit, OnChanges, SimpleChanges } from '@angular/core';
-import { FileUpload } from 'primeng/fileupload';
-import { MessageService } from 'primeng/api';
-import { PrimeNGConfig } from 'primeng/api';
-import { SHARED } from '../../../../Shared/constant/SHARED';
-import { FileFormatService } from '../../services/file-format.service';
-import { DocumentService } from '../../state/document.service';
-import { DocumentUploadService } from '../../services/document-upload.service';
-import { DocumentUploadBusinessService, UploadedFile } from '../../services/document-upload-business.service';
-import { DocumentUploadFormService } from '../../services/document-upload-form.service';
-import { DocumentUploadDataService } from '../../services/document-upload-data.service';
-import { UserListModel } from '../../models/user-list.model';
-import { DocumentCategory } from '../../models/document-category.model';
-import { DocumentTypeModel } from '../../models/document-type.model';
-import { Subject, takeUntil } from 'rxjs';
-
-/**
- * Component responsible for handling document uploads with templated metadata.
- * Provides a comprehensive interface for uploading documents with assignment types,
- * categories, document types, and applicant selection.
- */
-@Component({
-  selector: 'lib-document-upload',
-  templateUrl: './document-upload.component.html',
-  styleUrls: ['./document-upload.component.scss'],
-  standalone: false,
-  encapsulation: ViewEncapsulation.None
-})
-export class DocumentUploadComponent implements OnInit, OnChanges, OnDestroy {
-  /** The context ID for the document upload operation */
-  @Input() contextId: string = SHARED.EMPTY;
-
-  /** Indicates if the document save button has been clicked */
-  @Input() isDocumentSaveBtnClicked: boolean = false;
-
-  /** Indicates if the document sidebar is closed */
-  @Input() isDocumentSidebarClosed: boolean = false;
-
-  /** Whether there are unsaved changes in the form */
-  hasUnsavedChanges: boolean = false;
-  /** Whether to hide the form and show only upload functionality */
-  @Input() isFormHide: boolean = false;
-  
-  /** Whether to hide the multi-attachment button */
-  @Input() isMultiAttachmentHidden: boolean = false;
-  
-  /** Reference to the file upload component */
-  @ViewChild('fileUploader') fileUploader!: FileUpload;
-  
-  /** Event emitted when form validation state changes */
-  @Output() onFormValidationChange = new EventEmitter<void>();
-  
-  /** Event emitted when upload is successful */
-  @Output() onUploadSuccess = new EventEmitter<void>();
-  
-  /** Event emitted when files are uploaded (for form-hidden mode) */
-  @Output() onFilesUploaded = new EventEmitter<UploadedFile[]>();
-  @Output() hasUnsavedChangesChange = new EventEmitter<boolean>();
-  
-  /** Event emitted when a file is removed (for form-hidden mode) */
-  @Output() onFileRemoved = new EventEmitter<{file: File, index: number}>();
-  
-  /** Currently selected assignment type (Applicant or Application) */
-  selectedAssignmentType: 'Applicant' | 'Application' | null = null;
-  
-  /** Currently selected applicant ID */
-  selectedApplicant: string = SHARED.EMPTY;
-  
-  /** Currently selected document category */
-  selectedCategory: string = SHARED.EMPTY;
-  
-  /** Currently selected document type */
-  selectedDocumentType: string = SHARED.EMPTY;
-  
-  /** List of available applicants */
-  applicantList: UserListModel[] = SHARED.EMPTY_ARRAY;
-  
-  /** Filtered list of applicants based on current selection */
-  filteredApplicantList: UserListModel[] = SHARED.EMPTY_ARRAY;
-  
-  /** Available document categories for the selected assignment type */
-  categoryOptions: DocumentCategory[] = SHARED.EMPTY_ARRAY;
-  
-  /** Available document types for the selected category */
-  documentTypeOptions: DocumentTypeModel[] = SHARED.EMPTY_ARRAY;
-  
-  /** Array of files that have been uploaded */
-  uploadedFiles: UploadedFile[] = SHARED.EMPTY_ARRAY;
-  
-  /** Map tracking upload progress for each file */
-  fileProgress: Map<File, number> = new Map();
-  
-  /** Loading state for applicants data */
-  isLoadingApplicants: boolean = false;
-  
-  /** Loading state for categories data */
-  isLoadingCategories: boolean = false;
-  
-  /** Loading state for document types data */
-  isLoadingDocumentTypes: boolean = false;
-  
-  /** Loading state for save operation */
-  isSaving: boolean = false;
-  
-  /** Current form validation state */
-  isFormValid: boolean = false;
-
-  /** File size property for testing */
-  fileSize: string = '';
-
-  /** Subject for managing component lifecycle and unsubscribing from observables */
-  private destroy$ = new Subject<void>();
-
-  /**
-   * Creates an instance of DocumentUploadComponent.
-   * @param documentUpload - Service for handling document upload operations
-   * @param uploadService - Service for document-related operations
-   * @param config - PrimeNG configuration service
-   * @param fileFormatService - Service for file format validation
-   * @param messageService - Service for displaying messages
-   * @param cdr - Change detector reference for manual change detection
-   * @param businessService - Service for business logic operations
-   * @param formService - Service for form validation and handling
-   * @param dataService - Service for data loading operations
-   */
-  constructor(
-    public documentUpload: DocumentUploadService, 
-    public uploadService: DocumentService, 
-    private config: PrimeNGConfig, 
-    public fileFormatService: FileFormatService, 
-    public messageService: MessageService, 
-    public cdr: ChangeDetectorRef,
-    private businessService: DocumentUploadBusinessService,
-    private formService: DocumentUploadFormService,
-    private dataService: DocumentUploadDataService
-  ) { }
-
-  /**
-   * Lifecycle hook called after inputs are initialized.
-   * Ensures no stale uploads are shown when navigating back.
-   */
-  ngOnInit(): void {
-    this.resetForm();
-  }
-
-  ngOnChanges(changes: SimpleChanges): void {
-    if (changes['isDocumentSaveBtnClicked'] && changes['isDocumentSaveBtnClicked'].currentValue) {
-      this.saveDocumentUpload();
-    }
-
-    if(changes['isDocumentSidebarClosed'] && changes['isDocumentSidebarClosed'].currentValue) {
-      if(this.isDocumentSidebarClosed) {
-        this.resetForm();
-      }
-    }
-  }
-
-  /**
-   * Handles changes in assignment type selection.
-   * Resets form selections, loads categories, and handles applicant loading.
-   */
-  onAssignmentTypeChange(): void {
-    this.resetSelections();
-    this.loadCategories();
-    this.handleApplicantLoading();
-    this.validateForm(); // Validate form after assignment type change
-    this.emitFormValidationChange();
-  }
-
-  private checkForUnsavedChanges(): boolean {
-    // Check if files are uploaded
-    const hasFiles = Boolean(this.uploadedFiles && this.uploadedFiles.length > 0);
-
-    // Check if any form fields have been changed
-    const hasFormChanges = Boolean(
-      (this.selectedAssignmentType && this.selectedAssignmentType !== SHARED.EMPTY) || 
-      (this.selectedApplicant && this.selectedApplicant !== SHARED.EMPTY) || 
-      (this.selectedCategory && this.selectedCategory !== SHARED.EMPTY) || 
-      (this.selectedDocumentType && this.selectedDocumentType !== SHARED.EMPTY)
-    );
-
-    // Set and return the combined result
-    this.hasUnsavedChanges = hasFiles || hasFormChanges;
-    return this.hasUnsavedChanges;
-  }
-
-  /**
-   * Handles changes in category selection.
-   * Resets document type and loads available document types if category is selected.
-   */
-  onCategoryChange(): void {
-    this.resetDocumentType();
-    if (this.selectedCategory) this.loadDocumentTypes();
-    this.validateForm(); // Validate form after category change
-    this.validateAndEmit();
-  }
-
-  /**
-   * Handles changes in document type selection.
-   * Validates form and emits validation change event.
-   */
-  onDocumentTypeChange(): void { this.validateAndEmit(); }
-  
-  /**
-   * Handles changes in applicant selection.
-   * Validates form and emits validation change event.
-   */
-  onApplicantSelectionChange(): void { this.validateAndEmit(); }
-
-  /**
-   * Handles file selection from the file upload component.
-   * Processes each selected file for templated upload sequentially.
-   * @param event - Event containing the selected files
-   */
-  async onSelectedFiles(event: { currentFiles: File[] }): Promise<void> {
-    // Filter out files with unsupported extensions
-    const validFiles = event.currentFiles.filter(file => 
-      this.fileFormatService.isAllowedFileType(file.name)
-    );
-    
-    if (validFiles.length !== event.currentFiles.length) {
-      const invalidFiles = event.currentFiles.filter(file => 
-        !this.fileFormatService.isAllowedFileType(file.name)
-      );
-      const invalidFileNames = invalidFiles.map(file => file.name).join(', ');
-      this.messageService.add({
-        severity: 'warn',
-        summary: 'Invalid File Type',
-        detail: `The following files have unsupported formats and will be skipped: ${invalidFileNames}`
-      });
-    }
-    
-    if (validFiles.length > 0) {
-      await this.processFilesSequentially(validFiles);
-    }
-    
-    this.fileUploader.clear();
-  }
-
-  /**
-   * Processes files sequentially for upload
-   * @param files - Array of files to process
-   */
-  private async processFilesSequentially(files: File[]): Promise<void> {
-    if (!this.formService.validateContextId(this.contextId, 'Context ID is required for upload.')) {
-      return;
-    }
-    await this.documentUpload.uploadFilesSequentiallyWithProgress(
-      files, 
-      this.contextId,
-      (currentFile, currentIndex, totalFiles) => {
-        this.fileProgress.set(currentFile, SHARED.UPLOAD_PROGRESS_10);
-        this.setupFileUploadListener(currentFile);
-        const formattedSize = this.businessService.formatFileSize(currentFile.size, this.config);
-        const uploadedFile = this.businessService.createUploadedFile(currentFile, formattedSize);
-        uploadedFile.progress = SHARED.UPLOAD_PROGRESS_10;
-        this.uploadedFiles.push(uploadedFile);
-        
-        // Only validate form if not in form-hidden mode
-        if (!this.isFormHide) {
-          this.validateForm();
-        }
-        
-        this.cdr.detectChanges();
-      }
-    );
-  }
-
-  /**
-   * Loads the list of applicants for the current context.
-   * Sets loading state and handles success/error responses.
-   */
-  loadApplicants(): void {
-    this.isLoadingApplicants = true;
-    this.dataService.loadApplicants(
-      this.contextId,
-      (applicants) => this.handleApplicantsLoaded(applicants),
-      (error) => this.handleError('Failed to Load Applicants', error, () => this.isLoadingApplicants = false)
-    ).pipe(takeUntil(this.destroy$)).subscribe({
-      next: (applicants) => this.handleApplicantsLoaded(applicants),
-      error: (error) => this.handleError('Failed to Load Applicants', error, () => this.isLoadingApplicants = false)
-    });
-  }
-
-  /**
-   * Loads document categories based on the selected assignment type.
-   * Sets loading state and handles success/error responses.
-   */
-  loadCategories(): void {
-    this.isLoadingCategories = true;
-    this.dataService.loadCategories(
-      this.selectedAssignmentType!,
-      (categories) => this.handleCategoriesLoaded(categories),
-      (error) => this.handleError('Failed to Load Categories', error, () => this.isLoadingCategories = false)
-    ).pipe(takeUntil(this.destroy$)).subscribe({
-      next: (categories) => this.handleCategoriesLoaded(categories),
-      error: (error) => this.handleError('Failed to Load Categories', error, () => this.isLoadingCategories = false)
-    });
-  }
-
-  /**
-   * Loads document types based on the selected category.
-   * Sets loading state and handles success/error responses.
-   */
-  loadDocumentTypes(): void {
-    this.isLoadingDocumentTypes = true;
-    this.dataService.loadDocumentTypes(
-      this.selectedCategory,
-      (documentTypes) => this.handleDocumentTypesLoaded(documentTypes),
-      (error) => this.handleError('Failed to Load Document Types', error, () => this.isLoadingDocumentTypes = false)
-    ).pipe(takeUntil(this.destroy$)).subscribe({
-      next: (documentTypes) => this.handleDocumentTypesLoaded(documentTypes),
-      error: (error) => this.handleError('Failed to Load Document Types', error, () => this.isLoadingDocumentTypes = false)
-    });
-  }
-
-  /**
-   * Saves the document upload with all metadata.
-   * Validates payload and required fields before proceeding with upload.
-   */
-  saveDocumentUpload(): void {
-    const payloadValidation = this.businessService.validatePayload(
-      this.selectedAssignmentType, this.selectedCategory, this.selectedDocumentType, 
-      this.selectedApplicant, this.uploadedFiles
-    );
-    
-    if (!payloadValidation.isValid) {
-      this.formService.showWarningMessage('Incomplete Form', payloadValidation.message);
-      return;
-    }
-    
-    if (!this.formService.validateRequiredFields(
-      this.selectedAssignmentType, this.selectedApplicant, this.selectedCategory, 
-      this.selectedDocumentType, this.uploadedFiles
-    )) return;
-    
-    this.isSaving = true;
-    this.saveDocumentMetadata();
-  }
-
-
-
-  /**
-   * Removes a document from the uploaded files list.
-   * Updates progress tracking and validates form.
-   * @param file - The file to be removed
-   * @param index - The index of the file in the uploaded files array
-   */
-  handleDocumentRemove(file: File, index: number): void {
-    this.uploadedFiles.splice(index, 1);
-    this.fileProgress.delete(file);
-    
-    // Emit file removed event for form-hidden mode
-    if (this.isFormHide) {
-      this.onFileRemoved.emit({file, index});
-    } else {
-      this.validateAndEmit();
-    }
-    
-    this.cdr.detectChanges();
-  }
-
-  /**
-   * Utility method for file upload component integration.
-   * @param event - The file upload event
-   * @param callback - Callback function to execute
-   */
-  choose(event: any, callback: () => void): void { callback(); }
-  
-  /**
-   * Triggers the file upload dialog.
-   */
-  triggerFileUpload(): void { this.fileUploader.choose(); }
-  
-  /**
-   * Determines if the save button should be disabled.
-   * @returns True if the save button should be disabled, false otherwise
-   */
-  getSaveButtonDisabled(): boolean {
-    const isDisabled = this.businessService.isSaveButtonDisabled(
-      this.selectedAssignmentType, this.selectedCategory, this.selectedDocumentType,
-      this.selectedApplicant, this.uploadedFiles, this.isSaving
-    )
-    return isDisabled;
-  }
-
-  /**
-   * Gets the upload progress for a specific file.
-   * @param file - The file to get progress for
-   * @returns The upload progress percentage (0-100)
-   */
-  getProgress(file: File): number { return this.fileProgress.get(file) || 0; }
-
-  /**
-   * Checks if a file is currently uploading.
-   * @param file - The file to check
-   * @returns True if the file is uploading, false otherwise
-   */
-  isFileUploading(file: File): boolean { 
-    const progress = this.fileProgress.get(file);
-    return progress !== undefined && progress > 0 && progress < SHARED.UPLOAD_PROGRESS_100;
-  }
-  
-  /**
-   * Checks if a file has been successfully uploaded.
-   * @param file - The file to check
-   * @returns True if the file is uploaded, false otherwise
-   */
-  isFileUploaded(file: File): boolean { return this.fileProgress.get(file) === SHARED.UPLOAD_PROGRESS_100; }
-  
-  /**
-   * Checks if a file upload encountered an error.
-   * @param file - The file to check
-   * @returns True if the file has an error, false otherwise
-   */
-  isFileError(file: File): boolean { return this.fileProgress.get(file) === -1; }
-
-  /**
-   * Resets the form to its initial state.
-   * Clears all selections, uploaded files, and progress tracking.
-   */
-  resetForm(): void {
-    const initialState = this.businessService.getInitialFormState();
-    Object.assign(this, initialState);
-    this.fileProgress.clear();
-    this.filteredApplicantList = [];
-    this.categoryOptions = [];
-    this.documentTypeOptions = [];
-    this.cdr.detectChanges();
-  }
-
-  /**
-   * Resets form selections (applicant, category, document type).
-   * Clears document type options.
-   */
-  resetSelections(): void {
-    this.selectedApplicant = this.selectedCategory = this.selectedDocumentType = SHARED.EMPTY;
-    this.documentTypeOptions = SHARED.EMPTY_ARRAY;
-  }
-
-  /**
-   * Resets document type selection and clears document type options.
-   */
-  resetDocumentType(): void {
-    this.selectedDocumentType = SHARED.EMPTY;
-    this.documentTypeOptions = SHARED.EMPTY_ARRAY;
-  }
-
-  /**
-   * Handles applicant loading based on assignment type.
-   * Loads applicants if type is 'Applicant', otherwise filters existing list.
-   */
-  handleApplicantLoading(): void {
-    if (this.selectedAssignmentType === SHARED.APPLICANT) {
-      this.loadApplicants();
-    } else {
-      this.filterApplicants();
-    }
-  }
-
-  /**
-   * Handles successful loading of applicants data.
-   * Updates applicant list, filters applicants, and validates form.
-   * @param applicants - Array of loaded applicants
-   */
-  handleApplicantsLoaded(applicants: UserListModel[]): void {
-    this.applicantList = this.documentUpload.sortListByProperty(applicants, 'name');
-    this.filterApplicants();
-    this.isLoadingApplicants = false;
-    this.validateForm();
-  }
-
-  /**
-   * Handles successful loading of categories data.
-   * Updates category options and validates form.
-   * @param categories - Array of loaded categories
-   */
-  handleCategoriesLoaded(categories: DocumentCategory[]): void {
-    this.categoryOptions = this.documentUpload.sortListByProperty(categories, 'label');
-    this.isLoadingCategories = false;
-    this.validateForm();
-  }
-
-  /**
-   * Handles successful loading of document types data.
-   * Updates document type options and validates form.
-   * @param documentTypes - Array of loaded document types
-   */
-  handleDocumentTypesLoaded(documentTypes: DocumentTypeModel[]): void {
-    this.documentTypeOptions = this.documentUpload.sortListByProperty(documentTypes, 'label', 'name');
-    this.isLoadingDocumentTypes = false;
-    this.validateForm();
-  }
-
-  /**
-   * Handles successful upload completion.
-   * Resets form and emits upload success event.
-   * @param response - The upload response from the server
-   */
-  handleUploadSuccess(response: any): void {
-    this.isSaving = false;
-    this.resetForm();
-    this.onUploadSuccess.emit();
-  }
-
-  /**
-   * Handles upload error.
-   * Resets saving state.
-   * @param error - The error that occurred during upload
-   */
-  handleUploadError(error: any): void {
-    this.isSaving = false;
-  }
-
-  /**
-   * Filters applicants based on the selected assignment type.
-   * Updates the filtered applicant list.
-   */
-  filterApplicants(): void {
-    this.filteredApplicantList = this.dataService.handleApplicantsLoaded(
-      this.applicantList, this.selectedAssignmentType
-    );
-  }
-
-  /**
-   * Validates the current form state.
-   * Checks payload validation and emits form validation change if state changed.
-   */
-  validateForm(): void {
-    const payloadValidation = this.businessService.validatePayload(
-      this.selectedAssignmentType, this.selectedCategory, this.selectedDocumentType,
-      this.selectedApplicant, this.uploadedFiles
-    );
-    
-    const previousValidationState = this.isFormValid;
-    this.isFormValid = payloadValidation.isValid;
-
-    const hasUnsavedChanges = this.checkForUnsavedChanges();
-    this.hasUnsavedChangesChange.emit(hasUnsavedChanges);
-    if (previousValidationState !== this.isFormValid) {
-      this.onFormValidationChange.emit();
-    }
-  }
-
-  /**
-   * Saves document metadata to the server.
-   * Prepares upload payload and calls business service to save.
-   */
-  saveDocumentMetadata(): void {
-    const contextId = this.selectedApplicant || this.contextId;
-    const payload = this.businessService.prepareUploadPayload(
-      this.selectedAssignmentType!, this.selectedCategory, this.selectedDocumentType,
-      this.selectedApplicant, this.uploadedFiles, contextId
-    );
-
-    this.businessService.saveDocumentUpload(payload)
-      .pipe(takeUntil(this.destroy$))
-      .subscribe({
-        next: (response) => this.handleUploadSuccess(response),
-        error: (error) => this.handleUploadError(error)
-      });
-  }
-
-  /**
-   * Sets up a listener for file upload completion.
-   * Updates progress tracking and emits validation change when upload completes.
-   * @param file - The file to monitor for upload completion
-   */
-  setupFileUploadListener(file: File): void {
-    this.documentUpload.uploadCompleted.pipe(takeUntil(this.destroy$)).subscribe(({file: uploadedFile, response}) => {
-      if (uploadedFile === file) {
-        this.fileProgress.set(file, SHARED.UPLOAD_PROGRESS_100);
-        const uploadedFileObj = this.uploadedFiles.find(uf => uf.file === file);
-        if (uploadedFileObj) {
-          uploadedFileObj.uploadResponse = response;
-          uploadedFileObj.progress = SHARED.UPLOAD_PROGRESS_100;
-          uploadedFileObj.url = response?.url;
-          uploadedFileObj.contentType = response?.contentType;
-        }
-        this.cdr.detectChanges();
-        
-        // Emit files uploaded event for form-hidden mode
-        if (this.isFormHide) {
-          this.onFilesUploaded.emit([...this.uploadedFiles]);
-        } else {
-          this.onFormValidationChange.emit();
-        }
-      }
-    });
-  }
-
-  /**
-   * Handles errors during data loading operations.
-   * Resets loading state and can be extended for error logging.
-   * @param title - Error title for display
-   * @param error - The error object
-   * @param resetLoading - Callback to reset loading state
-   */
-  handleError(title: string, error: any, resetLoading: () => void): void {
-    resetLoading();
-  }
-
-  /**
-   * Validates form and emits validation change event.
-   */
-  validateAndEmit(): void {
-    this.validateForm();
-    this.onFormValidationChange.emit();
-  }
-
-  /**
-   * Emits form validation change event.
-   */
-  emitFormValidationChange(): void {
-    this.onFormValidationChange.emit();
-  }
-
-  /**
-   * Formats file size for testing purposes.
-   * @param size - The file size in bytes
-   */
-  formatSize(size: number): void {
-    this.fileSize = this.businessService.formatFileSize(size, this.config);
-  }
-
-
-
-  /**
-   * Gets the accept string for the file upload component
-   * @returns String with file extensions for the accept attribute
-   */
-  getFileUploadAcceptString(): string {
-    return this.fileFormatService.getAllowedFileExtensions()
-      .map(ext => `.${ext}`)
-      .join(SHARED.COMMA);
-  }
-
-  /**
-   * Gets the uploaded files data for external use (useful when form is hidden)
-   * @returns Array of uploaded files with their metadata
-   */
-  getUploadedFiles(): UploadedFile[] {
-    return [...this.uploadedFiles];
-  }
-
-  /**
-   * Resets the upload component to its initial state (useful when form is hidden)
-   */
-  resetUpload(): void {
-    this.uploadedFiles = [];
-    this.fileProgress.clear();
-    this.cdr.detectChanges();
-  }
-
-  /**
-   * Lifecycle hook that is called when component is destroyed.
-   * Cleans up subscriptions and destroys services.
-   */
-  ngOnDestroy(): void {
-    console.log("destroyed")
-    this.resetUpload()
-    this.destroy$.next();
-    this.destroy$.complete();
-    this.businessService.destroy();
-    this.dataService.destroy();
-  }
-}
-