feat(upload): exibir restrições de arquivos

Novo subcomponente interno que exibe informações referente às restrições dos arquivos.

Fixes DTHFUI-788

Author: Aline Cristina Bastos Godoi Lariguet

projects/ui/src/lib/components/po-field/po-field.module.ts

@@ -36,6 +36,7 @@ import { PoPasswordComponent } from './po-password/po-password.component';
 import { PoRadioGroupComponent } from './po-radio-group/po-radio-group.component';
 import { PoSelectComponent } from './po-select/po-select.component';
 import { PoSelectOptionTemplateDirective } from './po-select/po-select-option-template/po-select-option-template.directive';
+import { PoServicesModule } from '../../services/services.module';
 import { PoSwitchComponent } from './po-switch/po-switch.component';
 import { PoTextareaComponent } from './po-textarea/po-textarea.component';
 import { PoUploadComponent } from './po-upload/po-upload.component';
@@ -45,6 +46,7 @@ import {
   PoUploadDragDropAreaOverlayComponent
 } from './po-upload/po-upload-drag-drop/po-upload-drag-drop-area-overlay/po-upload-drag-drop-area-overlay.component';
 import { PoUploadDragDropAreaComponent } from './po-upload/po-upload-drag-drop/po-upload-drag-drop-area/po-upload-drag-drop-area.component';
+import { PoUploadFileRestrictionsComponent } from './po-upload/po-upload-file-restrictions/po-upload-file-restrictions.component';
 import { PoUrlComponent } from './po-url/po-url.component';
 
 /**
@@ -58,12 +60,13 @@ import { PoUrlComponent } from './po-url/po-url.component';
     CommonModule,
     FormsModule,
     HttpClientModule,
+    PoButtonGroupModule,
     PoButtonModule,
     PoDisclaimerModule,
     PoLoadingModule,
     PoModalModule,
+    PoServicesModule,
     PoTableModule,
-    PoButtonGroupModule
   ],
   exports: [
     PoCheckboxGroupComponent,
@@ -123,6 +126,7 @@ import { PoUrlComponent } from './po-url/po-url.component';
     PoUploadDragDropDirective,
     PoUploadDragDropAreaOverlayComponent,
     PoUploadDragDropAreaComponent,
+    PoUploadFileRestrictionsComponent,
     PoUrlComponent
   ],
   providers: [],

projects/ui/src/lib/components/po-field/po-upload/interfaces/po-upload-file-restriction.interface.ts

@@ -3,34 +3,40 @@
  *
  * @description
  *
- * Os arquivos a serem selecionados podem ser restritos com base em regras pré definidas
- * para o seu tamanho e / ou extensão.
+ * Interface que define as restrições dos arquivos a serem selecionados com base em regras predefinidas
+ * para o seu tamanho, extensão e quantidade.
  */
 export interface PoUploadFileRestrictions {
 
   /**
-   * Tamanho minimo do arquivo a ser enviado ao servidor. Deve ser informado o valor em bytes.
-   * Por padrão o valor é 0.
+   * Extensões permitidas de arquivos que serão enviados ao servidor, devendo ser informada uma coleção de extensões, por exemplo:
+   * ```
+   *  allowedExtensions = ['.png', '.jpg', '.pdf'];
+   * ```
    */
-  minFileSize?: number;
+  allowedExtensions?: Array<string>;
 
   /**
    * Quantidade máxima de arquivos para o *upload*.
-   * Este valor deve ser maior que zero, caso contrário será desconsiderado e a funcionalidade não será habilitada.
    *
-   * > Esta propriedade somente será válida se a propriedade `p-multiple` estiver habilitada.
+   * > Esta propriedade será válida somente se a propriedade `p-multiple` estiver habilitada e seu valor for maior do que zero.
    */
   maxFiles?: number;
 
   /**
-   * Tamanho máximo do arquivo a ser enviado ao servidor. Deve ser informado o valor em bytes,
-   * Por exemplo: 31457280 (30MB).
+   * Tamanho máximo do arquivo a ser enviado ao servidor.
+   *
+   * Deve ser informado um valor em *bytes*, por exemplo: `31457280` (30MB).
+   *
+   * > Por padrão o valor é `30 MB`.
    */
   maxFileSize?: number;
 
   /**
-   * Extensões permitidas a serem enviadas ao servidor, deve ser informado uma coleção de extensões.
-   * Exemplo de valores válidos: ['.png', '.jpg', '.pdf'].
+   * Tamanho mínimo em *bytes* do arquivo que será enviado ao servidor.
+   *
+   * > Por padrão o valor é `0`.
    */
-  allowedExtensions?: Array<string>;
+  minFileSize?: number;
+
 }

projects/ui/src/lib/components/po-field/po-upload/po-upload-base.component.spec.ts

@@ -26,6 +26,8 @@ class PoUploadComponent extends PoUploadBaseComponent {
   constructor(uploadService: PoUploadService) {
     super(uploadService);
   }
+
+  sendFeedback() {}
 }
 
 describe('PoUploadBaseComponent:', () => {
@@ -291,6 +293,32 @@ describe('PoUploadBaseComponent:', () => {
         expect(component['parseFiles'](<any>files)).toEqual(<any>files);
       });
 
+      it('should set `quantityNotAllowed` with `filesLength - fileRestrictions.maxFiles` if `isExceededFileLimit` returns `true`', () => {
+
+        const files = [
+          { name: 'file1' },
+          { name: 'file2' },
+          { name: 'file3' }
+        ];
+
+        component.fileRestrictions = { maxFiles: 2 };
+
+        spyOn(component, <any>'isExceededFileLimit').and.returnValue(true);
+
+        component['parseFiles'](<any>files);
+
+        expect(component['quantityNotAllowed']).toBe(1);
+      });
+
+      it('should call `sendFeedback`', () => {
+
+        spyOn(component, 'sendFeedback');
+
+        component['parseFiles'](<any>[{ name: 'file1' }]);
+
+        expect(component.sendFeedback).toHaveBeenCalled();
+      });
+
     });
 
     it('checkRestrictions: should be check restrictions', () => {
@@ -323,6 +351,48 @@ describe('PoUploadBaseComponent:', () => {
       expect(restrictionsOk).toBeTruthy();
     });
 
+    it('checkRestrictions: should sum `sizeNotAllowed` if `file.size` is less than `minFileSize`', () => {
+
+      const mockFile = {
+        size: 2
+      };
+
+      component['sizeNotAllowed'] = 2;
+      component['fileRestrictions'] = { minFileSize: 3 };
+
+      component['checkRestrictions'](<any>mockFile);
+
+      expect(component['sizeNotAllowed']).toBe(3);
+    });
+
+    it('checkRestrictions: should sum `sizeNotAllowed` if `file.size` is greater than `maxFileSize`', () => {
+
+      const mockFile = {
+        size: 3
+      };
+
+      component['sizeNotAllowed'] = 2;
+      component['fileRestrictions'] = { maxFileSize: 2 };
+
+      component['checkRestrictions'](<any>mockFile);
+
+      expect(component['sizeNotAllowed']).toBe(3);
+    });
+
+    it('checkRestrictions: shouldn`t sum `sizeNotAllowed` if `isAcceptSize` is `true`', () => {
+
+      const mockFile = {
+        size: 2
+      };
+
+      component['sizeNotAllowed'] = 2;
+      component['fileRestrictions'] = { maxFileSize: 2 };
+
+      component['checkRestrictions'](<any>mockFile);
+
+      expect(component['sizeNotAllowed']).toBe(2);
+    });
+
     it('existsFileSameName: ', () => {
       expect(component['existsFileSameName'](file, [file])).toBeTruthy();
     });
@@ -377,6 +447,36 @@ describe('PoUploadBaseComponent:', () => {
       expect(files.splice).not.toHaveBeenCalled();
     });
 
+    describe('initRestrictions:', () => {
+
+      it('should return falsy if restrictions is undefined', () => {
+        const restrictions = undefined;
+
+        expect(component['initRestrictions'](restrictions)).toBeFalsy();
+      });
+
+      it('should return default `minFileSize`', () => {
+        const restrictions = { maxFileSize: 1 };
+        const expectedResult = { maxFileSize: 1, minFileSize: 0 };
+
+        expect(component['initRestrictions'](restrictions)).toEqual(expectedResult);
+      });
+
+      it('should return default `maxFileSize`', () => {
+        const restrictions = { minFileSize: 2 };
+        const expectedResult =  { minFileSize: 2, maxFileSize: 31457280 };
+
+        expect(component['initRestrictions'](restrictions)).toEqual(expectedResult);
+      });
+
+      it('should concat default values with file restrictions', () => {
+        const restrictions = { allowedExtensions: ['pdf'], maxFiles: 2 };
+        const expectedResult = { ...restrictions, minFileSize: 0, maxFileSize: 31457280 };
+
+        expect(component['initRestrictions'](restrictions)).toEqual(expectedResult);
+      });
+    });
+
     it('isAllowedExtension: should allowed extensions', () => {
       const isAllowed = component['isAllowedExtension']('.pdf', ['.txt', '.PDF']);
       expect(isAllowed).toBeTruthy();
@@ -448,6 +548,33 @@ describe('PoUploadBaseComponent:', () => {
       expectPropertiesValues(component, 'disabled', invalidValues, false);
     });
 
+    it('fileRestrictions: should set `fileRestrictions` calling `initRestrictions` and call `setAllowedExtensions`', () => {
+
+      const restrictions = { minFileSize: 2 };
+      const expectedResult =  { minFileSize: 2, maxFileSize: 31457280 };
+
+      spyOn(component, <any>'initRestrictions').and.callThrough();
+      spyOn(component, <any>'setAllowedExtensions');
+
+      component.fileRestrictions = restrictions;
+
+      expect(component.fileRestrictions).toEqual(expectedResult);
+      expect(component['initRestrictions']).toHaveBeenCalled();
+      expect(component['setAllowedExtensions']).toHaveBeenCalled();
+    });
+
+    it('hideRestrictionsInfo: should set `hideRestrictionsInfo` with valid values', () => {
+      const validValues = ['', true, 1, [], {}, 'true'];
+
+      expectPropertiesValues(component, 'hideRestrictionsInfo', validValues, true);
+    });
+
+    it('hideRestrictionsInfo: should set `hideRestrictionsInfo` to false with invalid values', () => {
+      const invalidValues = [null, undefined, NaN, false, 0, 'false', 'teste'];
+
+      expectPropertiesValues(component, 'hideRestrictionsInfo', invalidValues, false);
+    });
+
     it('p-literals: should be in portuguese if browser is setted with an unsupported language', () => {
       spyOn(utilsFunctions, <any>'browserLanguage').and.returnValue('ru');