@futdevpro/fsm-dynamo 1.15.8 → 1.15.10

package/src/_collections/utils/data.util.spec.ts

@@ -0,0 +1,345 @@
+import { DyFM_Data } from './data.util';
+import { DyFM_Math } from './math/math.util';
+
+describe('| DyFM_Data', (): void => {
+
+  describe('| constants', (): void => {
+    it('| should have correct kilobyte value', (): void => {
+      expect(DyFM_Data.kilobyte).toBe(1024);
+    });
+
+    it('| should have correct megabyte value', (): void => {
+      expect(DyFM_Data.megabyte).toBe(1024 * 1024);
+    });
+
+    it('| should have correct gigabyte value', (): void => {
+      expect(DyFM_Data.gigabyte).toBe(1024 * 1024 * 1024);
+    });
+
+    it('| should have correct terabyte value', (): void => {
+      expect(DyFM_Data.terabyte).toBe(1024 * 1024 * 1024 * 1024);
+    });
+  });
+
+  describe('| getSizeString', (): void => {
+    it('| should return "0B" for zero size', (): void => {
+      expect(DyFM_Data.getSizeString(0)).toBe('0B');
+    });
+
+    it('| should return "N/A" for null or undefined size', (): void => {
+      expect(DyFM_Data.getSizeString(null as any)).toBe('N/A');
+      expect(DyFM_Data.getSizeString(undefined as any)).toBe('N/A');
+    });
+
+    it('| should format bytes less than 1KB', (): void => {
+      expect(DyFM_Data.getSizeString(512)).toBe('512B');
+      expect(DyFM_Data.getSizeString(1023)).toBe('1023B');
+    });
+
+    it('| should format kilobytes', (): void => {
+      expect(DyFM_Data.getSizeString(1536)).toBe('1.5KB');
+      expect(DyFM_Data.getSizeString(2048)).toBe('2KB');
+      expect(DyFM_Data.getSizeString(1024 * 10)).toBe('10KB');
+    });
+
+    it('| should format megabytes', (): void => {
+      expect(DyFM_Data.getSizeString(1024 * 1024)).toBe('1MB');
+      expect(DyFM_Data.getSizeString(1024 * 1024 * 1.5)).toBe('1.5MB');
+      expect(DyFM_Data.getSizeString(1024 * 1024 * 10)).toBe('10MB');
+    });
+
+    it('| should format gigabytes', (): void => {
+      expect(DyFM_Data.getSizeString(1024 * 1024 * 1024)).toBe('1GB');
+      expect(DyFM_Data.getSizeString(1024 * 1024 * 1024 * 1.5)).toBe('1.5GB');
+    });
+
+    it('| should format terabytes', (): void => {
+      expect(DyFM_Data.getSizeString(1024 * 1024 * 1024 * 1024)).toBe('1TB');
+    });
+
+    it('| should handle negative values', (): void => {
+      expect(DyFM_Data.getSizeString(-512)).toBe('-512B');
+      expect(DyFM_Data.getSizeString(-1536)).toBe('-1.5KB');
+    });
+
+    it('| should use custom decimals when provided', (): void => {
+      expect(DyFM_Data.getSizeString(1536, 1)).toBe('1.5KB');
+      expect(DyFM_Data.getSizeString(1536, 3)).toBe('1.5KB');
+      expect(DyFM_Data.getSizeString(1536, 0)).toBe('2KB');
+    });
+
+    it('| should show full format with remainder when full=true', (): void => {
+      const result = DyFM_Data.getSizeString(1536, 0, true);
+      expect(result).toContain('KB');
+      expect(result).toContain('B');
+    });
+
+    it('| should show full format for megabytes with remainder', (): void => {
+      const size = DyFM_Data.megabyte + DyFM_Data.kilobyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('MB');
+      expect(result).toContain('KB');
+    });
+
+    it('| should show full format for gigabytes with remainder', (): void => {
+      const size = DyFM_Data.gigabyte + DyFM_Data.megabyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('GB');
+      expect(result).toContain('MB');
+    });
+
+    it('| should handle very large sizes', (): void => {
+      const petabyte = DyFM_Data.petabyte;
+      expect(DyFM_Data.getSizeString(petabyte)).toContain('PB');
+    });
+
+    it('| should format petabytes', (): void => {
+      expect(DyFM_Data.getSizeString(DyFM_Data.petabyte)).toBe('1PB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.petabyte * 1.5)).toBe('1.5PB');
+    });
+
+    it('| should format exabytes', (): void => {
+      expect(DyFM_Data.getSizeString(DyFM_Data.exabyte)).toBe('1EB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.exabyte * 2.5)).toBe('2.5EB');
+    });
+
+    it('| should format zettabytes', (): void => {
+      expect(DyFM_Data.getSizeString(DyFM_Data.zettabyte)).toBe('1ZB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.zettabyte * 3.7)).toBe('3.7ZB');
+    });
+
+    it('| should format yottabytes', (): void => {
+      expect(DyFM_Data.getSizeString(DyFM_Data.yottabyte)).toBe('1YB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.yottabyte * 4.2)).toBe('4.2YB');
+    });
+
+    it('| should handle edge case at exact unit boundaries', (): void => {
+      expect(DyFM_Data.getSizeString(DyFM_Data.kilobyte)).toBe('1KB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.megabyte)).toBe('1MB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.gigabyte)).toBe('1GB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.terabyte)).toBe('1TB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.petabyte)).toBe('1PB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.exabyte)).toBe('1EB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.zettabyte)).toBe('1ZB');
+      expect(DyFM_Data.getSizeString(DyFM_Data.yottabyte)).toBe('1YB');
+    });
+
+    it('| should not show remainder in full format when remainder is zero', (): void => {
+      const result = DyFM_Data.getSizeString(DyFM_Data.kilobyte, 0, true);
+      expect(result).toBe('1KB');
+      expect(result).not.toContain('0B');
+    });
+
+    it('| should show full format for terabytes with remainder', (): void => {
+      const size = DyFM_Data.terabyte + DyFM_Data.gigabyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('TB');
+      expect(result).toContain('GB');
+    });
+
+    it('| should show full format for petabytes with remainder', (): void => {
+      const size = DyFM_Data.petabyte + DyFM_Data.terabyte * 512;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('PB');
+      expect(result).toContain('TB');
+    });
+
+    it('| should handle negative values with full format', (): void => {
+      const result = DyFM_Data.getSizeString(-1536, 0, true);
+      expect(result).toContain('-');
+      expect(result).toContain('KB');
+    });
+
+    it('| should handle very large negative values', (): void => {
+      const result = DyFM_Data.getSizeString(-DyFM_Data.gigabyte);
+      expect(result).toContain('-');
+      expect(result).toContain('GB');
+    });
+
+    it('| should handle custom decimals for large sizes', (): void => {
+      const size = DyFM_Data.terabyte * 1.234;
+      const result = DyFM_Data.getSizeString(size, 3);
+      expect(result).toContain('TB');
+      expect(result).toMatch(/1\.\d{3}TB/);
+    });
+
+    it('| should show full format for exabytes with remainder', (): void => {
+      const size = DyFM_Data.exabyte + DyFM_Data.petabyte * 512;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('EB');
+      expect(result).toContain('PB');
+    });
+
+    it('| should show full format for zettabytes with remainder', (): void => {
+      const size = DyFM_Data.zettabyte + DyFM_Data.exabyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('ZB');
+      expect(result).toContain('EB');
+    });
+
+    it('| should show full format for yottabytes with remainder', (): void => {
+      const size = DyFM_Data.yottabyte + DyFM_Data.zettabyte * 128;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('YB');
+      expect(result).toContain('ZB');
+    });
+
+    it('| should not show remainder in full format for exabytes when remainder is zero', (): void => {
+      const result = DyFM_Data.getSizeString(DyFM_Data.exabyte, 0, true);
+      expect(result).toBe('1EB');
+      expect(result).not.toContain('0PB');
+    });
+
+    it('| should not show remainder in full format for zettabytes when remainder is zero', (): void => {
+      const result = DyFM_Data.getSizeString(DyFM_Data.zettabyte, 0, true);
+      expect(result).toBe('1ZB');
+      expect(result).not.toContain('0EB');
+    });
+
+    it('| should not show remainder in full format for yottabytes when remainder is zero', (): void => {
+      const result = DyFM_Data.getSizeString(DyFM_Data.yottabyte, 0, true);
+      expect(result).toBe('1YB');
+      expect(result).not.toContain('0ZB');
+    });
+
+    it('| should handle KB with remainder in full format', (): void => {
+      const size = DyFM_Data.kilobyte + 512;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('KB');
+      expect(result).toContain('B');
+    });
+
+    it('| should handle negative KB with remainder in full format', (): void => {
+      const size = -(DyFM_Data.kilobyte + 512);
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('-');
+      expect(result).toContain('KB');
+    });
+
+    it('| should handle PB without remainder in full format', (): void => {
+      // Test case for line 169-170: PB without remainder case
+      const size = DyFM_Data.petabyte; // Exactly 1 PB
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toBe('1PB');
+      expect(result).not.toContain('TB');
+    });
+
+    it('| should handle PB with remainder in full format', (): void => {
+      // Test case for line 166-167: PB with remainder
+      const size = DyFM_Data.petabyte + DyFM_Data.terabyte * 512;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('PB');
+      expect(result).toContain('TB');
+    });
+
+    it('| should handle all size ranges with full format - KB', (): void => {
+      const size = DyFM_Data.kilobyte + 512;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('KB');
+      expect(result).toContain('B');
+    });
+
+    it('| should handle all size ranges with full format - MB', (): void => {
+      const size = DyFM_Data.megabyte + DyFM_Data.kilobyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('MB');
+      expect(result).toContain('KB');
+    });
+
+    it('| should handle all size ranges with full format - GB', (): void => {
+      const size = DyFM_Data.gigabyte + DyFM_Data.megabyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('GB');
+      expect(result).toContain('MB');
+    });
+
+    it('| should handle all size ranges with full format - TB', (): void => {
+      const size = DyFM_Data.terabyte + DyFM_Data.gigabyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('TB');
+      expect(result).toContain('GB');
+    });
+
+    it('| should handle all size ranges with full format - PB', (): void => {
+      const size = DyFM_Data.petabyte + DyFM_Data.terabyte * 512;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('PB');
+      expect(result).toContain('TB');
+    });
+
+    it('| should handle all size ranges with full format - EB', (): void => {
+      const size = DyFM_Data.exabyte + DyFM_Data.petabyte * 512;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('EB');
+      expect(result).toContain('PB');
+    });
+
+    it('| should handle all size ranges with full format - ZB', (): void => {
+      const size = DyFM_Data.zettabyte + DyFM_Data.exabyte * 256;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('ZB');
+      expect(result).toContain('EB');
+    });
+
+    it('| should handle all size ranges with full format - YB', (): void => {
+      const size = DyFM_Data.yottabyte + DyFM_Data.zettabyte * 128;
+      const result = DyFM_Data.getSizeString(size, 0, true);
+      expect(result).toContain('YB');
+      expect(result).toContain('ZB');
+    });
+
+    it('| should handle negative values with full format for all ranges', (): void => {
+      const sizes = [
+        -(DyFM_Data.kilobyte + 512),
+        -(DyFM_Data.megabyte + DyFM_Data.kilobyte * 256),
+        -(DyFM_Data.gigabyte + DyFM_Data.megabyte * 256),
+        -(DyFM_Data.terabyte + DyFM_Data.gigabyte * 256),
+        -(DyFM_Data.petabyte + DyFM_Data.terabyte * 512),
+      ];
+      
+      sizes.forEach(size => {
+        const result = DyFM_Data.getSizeString(size, 0, true);
+        expect(result).toContain('-');
+      });
+    });
+
+    it('| should handle exact boundaries with full format', (): void => {
+      // Test exact unit boundaries with full format
+      const boundaries = [
+        DyFM_Data.kilobyte,
+        DyFM_Data.megabyte,
+        DyFM_Data.gigabyte,
+        DyFM_Data.terabyte,
+        DyFM_Data.petabyte,
+        DyFM_Data.exabyte,
+        DyFM_Data.zettabyte,
+        DyFM_Data.yottabyte,
+      ];
+      
+      boundaries.forEach(size => {
+        const result = DyFM_Data.getSizeString(size, 0, true);
+        expect(result).toMatch(/^\d+(KB|MB|GB|TB|PB|EB|ZB|YB)$/);
+        expect(result).not.toMatch(/\s/); // No space means no remainder
+      });
+    });
+  });
+
+  describe('| constants - all units', (): void => {
+    it('| should have correct petabyte value', (): void => {
+      expect(DyFM_Data.petabyte).toBe(1024 * 1024 * 1024 * 1024 * 1024);
+    });
+
+    it('| should have correct exabyte value', (): void => {
+      expect(DyFM_Data.exabyte).toBe(1024 * 1024 * 1024 * 1024 * 1024 * 1024);
+    });
+
+    it('| should have correct zettabyte value', (): void => {
+      expect(DyFM_Data.zettabyte).toBe(1024 * 1024 * 1024 * 1024 * 1024 * 1024 * 1024);
+    });
+
+    it('| should have correct yottabyte value', (): void => {
+      expect(DyFM_Data.yottabyte).toBe(1024 * 1024 * 1024 * 1024 * 1024 * 1024 * 1024 * 1024);
+    });
+  });
+});
+