@herowcode/utils 1.0.2 → 1.1.1

package/README.md

@@ -1,6 +1,6 @@
 # @herowcode/utils
 
-A lightweight collection of utility functions for everyday JavaScript/TypeScript development. Built with dayjs for powerful date manipulation.
+A lightweight collection of utility functions for everyday JavaScript/TypeScript development. Built with dayjs for powerful date manipulation and React hooks for YouTube integration.
 
 ## Features
 
@@ -10,6 +10,7 @@ A lightweight collection of utility functions for everyday JavaScript/TypeScript
 - 📱 **Universal** - Works in Node.js and browsers
 - 🎯 **Tree-shakable** - Only import what you need
 - 📂 **Scoped exports** - Import from specific modules
+- 🎥 **YouTube utilities** - Extract video IDs, generate URLs, and get video durations
 
 ## Installation
 
@@ -23,7 +24,7 @@ yarn add @herowcode/utils
 
 ### Import everything:
 ```typescript
-import { formatDate, capitalize, debounce } from '@herowcode/utils';
+import { formatDate, capitalize, debounce, extractYouTubeId } from '@herowcode/utils';
 ```
 
 ### Import by scope:
@@ -32,6 +33,7 @@ import { formatDate, addDays } from '@herowcode/utils/date';
 import { capitalize, camelCase } from '@herowcode/utils/string';
 import { randomInt } from '@herowcode/utils/number';
 import { debounce, throttle } from '@herowcode/utils/function';
+import { extractYouTubeId, generateYoutubeURL } from '@herowcode/utils/youtube';
 ```
 
 ### Examples:
@@ -47,137 +49,297 @@ console.log(kebabCase('helloWorld')); // "hello-world"
 
 // Function utilities
 const debouncedFn = debounce(() => console.log('Called!'), 300);
+
+// YouTube utilities
+const videoId = extractYouTubeId('https://youtu.be/dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+const embedUrl = generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  embed: true, 
+  autoplay: true 
+}); // "https://www.youtube.com/embed/abc123?autoplay=1"
 ```
 
 ## API Reference
 
+### Array Utilities
+
+#### `shuffle<T>(array: T[]): T[]`
+Returns a new array with the elements shuffled in random order.
+
+```typescript
+shuffle([1, 2, 3, 4]); // e.g., [3, 1, 4, 2]
+```
+
+#### `unique<T>(array: T[]): T[]`
+Removes duplicate values from an array, preserving the first occurrence.
+
+```typescript
+unique([1, 2, 2, 3, 1]); // [1, 2, 3]
+```
+
 ### Date Utilities
 
-#### `formatDate(date: Date, format: string): string`
+#### `formatDate(date: Date | string | number, locale?: string, opts?: Intl.DateTimeFormatOptions): string`
+Formats a date using the specified locale and options.
 
-Formats a date according to the specified format.
+```typescript
+formatDate(new Date('2023-12-25'), 'en-US'); // "December 25, 2023"
+```
+
+#### `fixTimezoneOffset(utcDate: Date | string): Dayjs`
+Adjusts a UTC date string or Date object for the local timezone offset.
+
+```typescript
+fixTimezoneOffset('2025-09-08T12:00:00Z');
+```
 
-**Supported format tokens:**
-- `YYYY` - 4-digit year
-- `YY` - 2-digit year
-- `MM` - 2-digit month (01-12)
-- `DD` - 2-digit day (01-31)
-- `HH` - 2-digit hours (00-23)
-- `mm` - 2-digit minutes (00-59)
-- `ss` - 2-digit seconds (00-59)
+#### `getCurrentDateInUTC(): Dayjs`
+Returns the current date/time as a Dayjs object in UTC.
 
 ```typescript
-formatDate(new Date('2023-12-25'), 'YYYY-MM-DD'); // "2023-12-25"
-formatDate(new Date('2023-12-25'), 'DD/MM/YYYY'); // "25/12/2023"
-formatDate(new Date('2023-12-25T10:30:45'), 'DD/MM/YYYY HH:mm:ss'); // "25/12/2023 10:30:45"
+getCurrentDateInUTC();
 ```
 
-#### `addDays(date: Date, amount: number): Date`
+#### `getDateInUTC(date: Date): Dayjs`
+Converts a Date to a Dayjs object in UTC.
 
-Adds a specified number of days to a date. Returns a new Date object.
+```typescript
+getDateInUTC(new Date());
+```
+
+#### `parseTimeSpent(initialDate: string | Date, finalDate: string | Date, locale?: string): string`
+Returns a human-readable string describing the time difference between two dates, localized.
 
 ```typescript
-const date = new Date('2023-12-25');
-addDays(date, 5); // 2023-12-30
-addDays(date, -5); // 2023-12-20
+parseTimeSpent('2020-01-01', '2022-04-16', 'en-US'); // "2 years, 3 months, and 15 days"
 ```
 
-#### `diffInDays(date1: Date, date2: Date): number`
+### Files Utilities
 
-Calculates the difference in days between two dates.
+#### `compressImage({ file, maxWidth, maxHeight, quality, allowedFileTypes }): Promise<File>`
+Compresses an image file to WebP format, optionally resizing and restricting file types.
 
 ```typescript
-const date1 = new Date('2023-12-30');
-const date2 = new Date('2023-12-25');
-diffInDays(date1, date2); // 5
-diffInDays(date2, date1); // -5
+await compressImage({ file, maxWidth: 800, maxHeight: 600, quality: 0.8 });
 ```
 
-#### `isBefore(date1: Date, date2: Date): boolean`
+#### `downloadUrl(url: string): Promise<boolean>`
+Downloads a file from a URL in the browser, returning true if successful.
 
-Checks if the first date is before the second date.
+```typescript
+await downloadUrl('https://example.com/file.pdf');
+```
+
+#### `formatBytes(bytes: number): string`
+Formats a byte count as a human-readable string (e.g., "1.23 MB").
 
 ```typescript
-const date1 = new Date('2023-12-20');
-const date2 = new Date('2023-12-25');
-isBefore(date1, date2); // true
-isBefore(date2, date1); // false
+formatBytes(1234567); // "1.18 MB"
 ```
 
-#### `isAfter(date1: Date, date2: Date): boolean`
+### Function Utilities
+
+#### `debounce<T>(fn: T, delay: number): (...args: Parameters<T>) => void`
+Creates a debounced function that delays invoking `fn` until after `delay` ms have elapsed since the last call.
+
+```typescript
+const debounced = debounce(() => { /* ... */ }, 300);
+```
 
-Checks if the first date is after the second date.
+#### `throttle<T>(fn: T, delay: number): (...args: Parameters<T>) => void`
+Creates a throttled function that only invokes `fn` at most once per `delay` ms.
 
 ```typescript
-const date1 = new Date('2023-12-30');
-const date2 = new Date('2023-12-25');
-isAfter(date1, date2); // true
-isAfter(date2, date1); // false
+const throttled = throttle(() => { /* ... */ }, 100);
+```
+
+#### `tryCatch<T, E = Error, D = null>(fn: Promise<T> | (() => Promise<T> | T), defaultData?: D): Promise<{ data: T | D; error: E | null }>`
+Executes a function or promise and returns an object with `data` or `error`.
+
+```typescript
+const result = await tryCatch(() => fetchData());
+if (result.error) { /* handle error */ }
 ```
 
 ### String Utilities
 
+#### `camelCase(str: string): string`
+Converts a string to camelCase.
+
+```typescript
+camelCase('hello world'); // "helloWorld"
+```
+
 #### `capitalize(str: string): string`
+Capitalizes the first letter and lowercases the rest.
 
-Capitalizes the first letter of a string and converts the rest to lowercase.
+```typescript
+capitalize('hELLO'); // "Hello"
+```
+
+#### `formatHMSToSeconds(val?: number | string): number | null`
+Converts HMS time format or numeric strings to seconds. Supports formats like "90", "01:30", "1:02:03".
 
 ```typescript
-capitalize('hello world'); // "Hello world"
-capitalize('HELLO WORLD'); // "Hello world"
-capitalize('hELLo WoRLd'); // "Hello world"
+formatHMSToSeconds("1:30"); // 90
+formatHMSToSeconds("1:02:03"); // 3723
+formatHMSToSeconds(120); // 120
 ```
 
-#### `camelCase(str: string): string`
+#### `formatSecondsToFragment(secs: number): string`
+Converts seconds to YouTube-style fragment format (e.g., "1h2m3s").
+
+```typescript
+formatSecondsToFragment(3723); // "1h2m3s"
+formatSecondsToFragment(90); // "1m30s"
+formatSecondsToFragment(42); // "42s"
+```
 
-Converts a string to camelCase by removing special characters and capitalizing words.
+#### `formatSecondsToHMS(totalSeconds: number): string`
+Formats a number of seconds into an HH:MM:SS string, rounding and clamping negatives to zero.
 
 ```typescript
-camelCase('hello world'); // "helloWorld"
-camelCase('hello-world'); // "helloWorld"
-camelCase('hello_world_test'); // "helloWorldTest"
-camelCase('The Quick Brown Fox'); // "theQuickBrownFox"
+formatSecondsToHMS(3661); // "01:01:01"
+formatSecondsToHMS(5); // "00:05"
 ```
 
-### Number Utilities
+#### `formatStringToTime(str: string): string`
+Parses a numeric time string (or a string containing digits) into MM:SS or HH:MM:SS format. Non-digits are removed before formatting. Short inputs are zero-padded.
 
-#### `randomInt(min: number, max: number): number`
+```typescript
+formatStringToTime('123'); // "01:23"
+formatStringToTime('12345'); // "01:23:45"
+formatStringToTime(' 12:34 '); // "12:34"
+```
 
-Generates a random integer between min and max (inclusive).
+#### `kebabCase(str: string): string`
+Converts a string to kebab-case.
 
 ```typescript
-randomInt(1, 10); // Random integer between 1 and 10
-randomInt(0, 100); // Random integer between 0 and 100
-randomInt(-5, 5); // Random integer between -5 and 5
+kebabCase('Hello World'); // "hello-world"
 ```
 
-### Function Utilities
+#### `removeHtmlTags(input: string): string`
+Removes all HTML tags from a string.
+
+```typescript
+removeHtmlTags('<p>Hello</p>'); // "Hello"
+```
+
+#### `slugify(text: string): string`
+Converts a string to a URL-friendly slug.
+
+```typescript
+slugify('Hello World!'); // "hello-world"
+```
+
+#### `snakeCase(str: string): string`
+Converts a string to snake_case.
+
+```typescript
+snakeCase('Hello World'); // "hello_world"
+```
 
-#### `debounce<T>(fn: T, delay: number): T`
+#### `toSentenceCase(str: string): string`
+Converts a string to sentence case.
 
-Creates a debounced function that delays invoking `fn` until after `delay` milliseconds have elapsed since the last time it was invoked.
+```typescript
+toSentenceCase('helloWorld'); // "Hello world"
+```
+
+#### `truncate(str: string, length: number, suffix = "..."): string`
+Truncates a string to a specified length, appending a suffix if truncated.
 
 ```typescript
-const debouncedSearch = debounce((query: string) => {
-  console.log('Searching for:', query);
-}, 300);
+truncate('Hello world', 5); // "He..."
+```
 
-// Will only execute once after 300ms of no new calls
-debouncedSearch('a');
-debouncedSearch('ab');
-debouncedSearch('abc'); // Only this will execute
+### YouTube Utilities
+
+#### `extractYouTubeId(urlString: string | null): string | null`
+Extracts the video ID from various YouTube URL formats.
+
+```typescript
+extractYouTubeId('https://youtu.be/dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+extractYouTubeId('https://www.youtube.com/watch?v=dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+extractYouTubeId('https://www.youtube.com/embed/dQw4w9WgXcQ'); // "dQw4w9WgXcQ"
+extractYouTubeId('invalid-url'); // null
 ```
 
-#### `throttle<T>(fn: T, delay: number): T`
+#### `generateYoutubeURL(options: TCreateYoutubeLinkOptions): string | null`
+Generates YouTube URLs with various options for watch, embed, or short formats.
 
-Creates a throttled function that only invokes `fn` at most once per every `delay` milliseconds.
+```typescript
+// Basic watch URL
+generateYoutubeURL({ videoURL: 'https://youtu.be/abc123' });
+// "https://www.youtube.com/watch?v=abc123"
+
+// Embed URL with autoplay
+generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  embed: true, 
+  autoplay: true 
+});
+// "https://www.youtube.com/embed/abc123?autoplay=1"
+
+// Short URL with timestamp
+generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  short: true, 
+  start: "1:30" 
+});
+// "https://youtu.be/abc123?t=90"
+
+// URL with fragment timestamp
+generateYoutubeURL({ 
+  videoURL: 'https://youtu.be/abc123', 
+  start: "1:30", 
+  useFragment: true 
+});
+// "https://www.youtube.com/watch?v=abc123#t=1m30s"
+```
+
+**Options:**
+- `videoURL` (required): YouTube URL to process
+- `start`/`end`: Start/end times as seconds (number) or HMS strings ("90", "01:30", "1:02:03")
+- `embed`: Generate embed URL format
+- `short`: Generate youtu.be short URL format
+- `useFragment`: Use #t=1m2s style fragment for timestamps
+- `autoplay`, `controls`, `rel`, `loop`, `mute`, `modestbranding`: Player options
+- `origin`, `playlist`: Additional parameters
+- `params`: Custom query parameters
+
+#### `useGetYoutubeVideoDuration(): (videoUrl: string) => Promise<string | null>`
+React hook that returns a function to get YouTube video duration using the YouTube IFrame API.
 
 ```typescript
-const throttledScroll = throttle(() => {
-  console.log('Scroll event handled');
-}, 100);
+import { useGetYoutubeVideoDuration } from '@herowcode/utils/youtube';
+
+function VideoComponent() {
+  const getVideoDuration = useGetYoutubeVideoDuration();
+  
+  const handleGetDuration = async () => {
+    const duration = await getVideoDuration('https://youtu.be/dQw4w9WgXcQ');
+    console.log(duration); // "03:32" or null if failed
+  };
+  
+  return <button onClick={handleGetDuration}>Get Duration</button>;
+}
+```
+
+**Features:**
+- Automatically loads YouTube IFrame API if not present
+- Creates offscreen iframe for duration detection
+- Handles retry logic for videos that don't immediately report duration
+- 10-second timeout with automatic cleanup
+- Returns formatted duration string (HH:MM:SS) or null on failure
+
+#### `validateYoutubeLink(videoUrl: string): Promise<boolean>`
+Checks whether a YouTube video exists by probing thumbnails and falling back to the oEmbed endpoint. Returns `true` for found/public videos and `false` otherwise.
 
-// Will execute immediately, then at most once every 100ms
-window.addEventListener('scroll', throttledScroll);
+```typescript
+const ok = await validateYoutubeLink('https://youtu.be/dQw4w9WgXcQ');
+// true | false
 ```
 
 ## Browser Support
@@ -187,6 +349,8 @@ This library supports all modern browsers and Node.js environments. It uses ES20
 - Node.js 10+
 - Modern browsers (Chrome 63+, Firefox 58+, Safari 12+, Edge 79+)
 
+The YouTube utilities require a browser environment with DOM support.
+
 ## Development
 
 ```bash
@@ -212,13 +376,4 @@ MIT © [HerowCode](https://github.com/herowcode)
 
 ## Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## Changelog
-
-### 1.0.0
-- Initial release
-- Date utilities: `formatDate`, `addDays`, `diffInDays`, `isBefore`, `isAfter`
-- String utilities: `capitalize`, `camelCase`
-- Number utilities: `randomInt`
-- Function utilities: `debounce`, `throttle`
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/files/compress-image.d.ts

@@ -0,0 +1,10 @@
+interface ICompressImageParams {
+    file: File;
+    maxWidth?: number;
+    maxHeight?: number;
+    quality?: number;
+    allowedFileTypes?: string[];
+}
+export declare function compressImage({ file, maxWidth, maxHeight, quality, allowedFileTypes, }: ICompressImageParams): Promise<File>;
+export {};
+//# sourceMappingURL=compress-image.d.ts.map

package/dist/files/compress-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-image.d.ts","sourceRoot":"","sources":["../../src/files/compress-image.ts"],"names":[],"mappings":"AAAA,UAAU,oBAAoB;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B;AAYD,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAmC,EACnC,SAAoC,EACpC,OAAW,EACX,gBAAyE,GAC1E,EAAE,oBAAoB,iBAiEtB"}

package/dist/files/compress-image.esm.js

@@ -0,0 +1,57 @@
+function convertToWebp(filename) {
+    const lastDotIndex = filename.lastIndexOf(".");
+    if (lastDotIndex === -1) {
+        return `${filename}.webp`;
+    }
+    return `${filename.substring(0, lastDotIndex)}.webp`;
+}
+export function compressImage({ file, maxWidth = Number.POSITIVE_INFINITY, maxHeight = Number.POSITIVE_INFINITY, quality = 1, allowedFileTypes = ["image/jpg", "image/jpeg", "image/png", "image/webp"], }) {
+    if (!allowedFileTypes.includes(file.type)) {
+        throw new Error("Image format not supported");
+    }
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = (event) => {
+            var _a;
+            const compressed = new Image();
+            compressed.onload = () => {
+                const canvas = document.createElement("canvas");
+                let width = compressed.width;
+                let height = compressed.height;
+                if (width > height) {
+                    if (width > maxWidth) {
+                        height *= maxWidth / width;
+                        width = maxWidth;
+                    }
+                }
+                else {
+                    if (height > maxHeight) {
+                        width *= maxHeight / height;
+                        height = maxHeight;
+                    }
+                }
+                canvas.width = width;
+                canvas.height = height;
+                const context = canvas.getContext("2d");
+                if (!context) {
+                    reject(new Error("Failed to get canvas context"));
+                    return;
+                }
+                context.drawImage(compressed, 0, 0, width, height);
+                canvas.toBlob((blob) => {
+                    if (!blob) {
+                        reject(new Error("Failed to compress image."));
+                        return;
+                    }
+                    const compressedFile = new File([blob], convertToWebp(file.name), {
+                        type: "image/webp",
+                        lastModified: Date.now(),
+                    });
+                    resolve(compressedFile);
+                }, "image/webp", quality);
+            };
+            compressed.src = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
+        };
+        reader.readAsDataURL(file);
+    });
+}

package/dist/files/compress-image.js

@@ -0,0 +1,57 @@
+function convertToWebp(filename) {
+    const lastDotIndex = filename.lastIndexOf(".");
+    if (lastDotIndex === -1) {
+        return `${filename}.webp`;
+    }
+    return `${filename.substring(0, lastDotIndex)}.webp`;
+}
+export function compressImage({ file, maxWidth = Number.POSITIVE_INFINITY, maxHeight = Number.POSITIVE_INFINITY, quality = 1, allowedFileTypes = ["image/jpg", "image/jpeg", "image/png", "image/webp"], }) {
+    if (!allowedFileTypes.includes(file.type)) {
+        throw new Error("Image format not supported");
+    }
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = (event) => {
+            var _a;
+            const compressed = new Image();
+            compressed.onload = () => {
+                const canvas = document.createElement("canvas");
+                let width = compressed.width;
+                let height = compressed.height;
+                if (width > height) {
+                    if (width > maxWidth) {
+                        height *= maxWidth / width;
+                        width = maxWidth;
+                    }
+                }
+                else {
+                    if (height > maxHeight) {
+                        width *= maxHeight / height;
+                        height = maxHeight;
+                    }
+                }
+                canvas.width = width;
+                canvas.height = height;
+                const context = canvas.getContext("2d");
+                if (!context) {
+                    reject(new Error("Failed to get canvas context"));
+                    return;
+                }
+                context.drawImage(compressed, 0, 0, width, height);
+                canvas.toBlob((blob) => {
+                    if (!blob) {
+                        reject(new Error("Failed to compress image."));
+                        return;
+                    }
+                    const compressedFile = new File([blob], convertToWebp(file.name), {
+                        type: "image/webp",
+                        lastModified: Date.now(),
+                    });
+                    resolve(compressedFile);
+                }, "image/webp", quality);
+            };
+            compressed.src = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
+        };
+        reader.readAsDataURL(file);
+    });
+}

package/dist/files/compress-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-image.js","sourceRoot":"","sources":["../../src/files/compress-image.ts"],"names":[],"mappings":"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"}

package/dist/files/download-url.d.ts

@@ -0,0 +1,2 @@
+export declare const downloadUrl: (url: string) => Promise<boolean>;
+//# sourceMappingURL=download-url.d.ts.map

package/dist/files/download-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-url.d.ts","sourceRoot":"","sources":["../../src/files/download-url.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAyB9D,CAAA"}

package/dist/files/download-url.esm.js

@@ -0,0 +1,24 @@
+export const downloadUrl = async (url) => {
+    try {
+        const urlObj = new URL(url);
+        const pathname = urlObj.pathname;
+        const segments = pathname.split("/").filter((segment) => segment.length > 0);
+        const filename = segments.length > 0 ? segments[segments.length - 1] : null;
+        if (!filename || !filename.includes(".")) {
+            throw new Error("URL does not contain a valid filename");
+        }
+        const response = await fetch(url, { mode: "cors" });
+        const blob = await response.blob();
+        const link = document.createElement("a");
+        link.href = window.URL.createObjectURL(blob);
+        link.download = filename;
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        return true;
+    }
+    catch (error) {
+        console.error("Error downloading the file", error);
+        return false;
+    }
+};

package/dist/files/download-url.js

@@ -0,0 +1,24 @@
+export const downloadUrl = async (url) => {
+    try {
+        const urlObj = new URL(url);
+        const pathname = urlObj.pathname;
+        const segments = pathname.split("/").filter((segment) => segment.length > 0);
+        const filename = segments.length > 0 ? segments[segments.length - 1] : null;
+        if (!filename || !filename.includes(".")) {
+            throw new Error("URL does not contain a valid filename");
+        }
+        const response = await fetch(url, { mode: "cors" });
+        const blob = await response.blob();
+        const link = document.createElement("a");
+        link.href = window.URL.createObjectURL(blob);
+        link.download = filename;
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        return true;
+    }
+    catch (error) {
+        console.error("Error downloading the file", error);
+        return false;
+    }
+};

package/dist/files/download-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-url.js","sourceRoot":"","sources":["../../src/files/download-url.ts"],"names":[],"mappings":";;;AAAO,MAAM,WAAW,GAAG,KAAK,EAAE,GAAW,EAAoB,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;QAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC5E,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAE3E,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAElC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAA;QAClD,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAzBY,QAAA,WAAW,eAyBvB"}

package/dist/files/format-bytes.d.ts

@@ -0,0 +1,2 @@
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=format-bytes.d.ts.map

package/dist/files/format-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.d.ts","sourceRoot":"","sources":["../../src/files/format-bytes.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAejD"}

package/dist/files/format-bytes.esm.js

@@ -0,0 +1,13 @@
+export function formatBytes(bytes) {
+    if (bytes < 0) {
+        throw new Error("Size in bytes cannot be negative");
+    }
+    const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+    let size = bytes;
+    let index = 0;
+    while (size >= 1024 && index < units.length - 1) {
+        size /= 1024;
+        index++;
+    }
+    return `${size.toFixed(2)} ${units[index]}`;
+}

package/dist/files/format-bytes.js

@@ -0,0 +1,13 @@
+export function formatBytes(bytes) {
+    if (bytes < 0) {
+        throw new Error("Size in bytes cannot be negative");
+    }
+    const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+    let size = bytes;
+    let index = 0;
+    while (size >= 1024 && index < units.length - 1) {
+        size /= 1024;
+        index++;
+    }
+    return `${size.toFixed(2)} ${units[index]}`;
+}

package/dist/files/format-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.js","sourceRoot":"","sources":["../../src/files/format-bytes.ts"],"names":[],"mappings":";;AAAA,kCAeC;AAfD,SAAgB,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACjD,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,IAAI,CAAA;QACZ,KAAK,EAAE,CAAA;IACT,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAA;AAC7C,CAAC"}