bytekit 2.2.0 → 2.4.3

package/dist/utils/helpers/CryptoUtils.js

@@ -40,6 +40,7 @@ export class CryptoUtils {
             return globalThis.crypto.randomUUID();
         }
         // Check if we can use getRandomValues for fallback
+        /* v8 ignore start */
         if (typeof globalThis !== "undefined" &&
             globalThis.crypto?.getRandomValues) {
             const bytes = new Uint8Array(16);
@@ -52,12 +53,15 @@ export class CryptoUtils {
                 .join("");
             return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
         }
+        /* v8 ignore end */
+        /* v8 ignore next 3 */
         throw new Error("Secure random generation unavailable. crypto API required.");
     }
     /**
      * Base64 encode
      */
     static base64Encode(str) {
+        /* v8 ignore next */
         if (typeof globalThis !== "undefined" && globalThis.btoa) {
             // Encode to UTF-8 bytes first to handle Unicode characters
             const encoder = new TextEncoder();
@@ -65,13 +69,15 @@ export class CryptoUtils {
             const binaryString = Array.from(bytes, (byte) => String.fromCharCode(byte)).join("");
             return globalThis.btoa(binaryString);
         }
-        // Node.js fallback
+        // Node.js fallback (unreachable: btoa is available in Node.js 18+)
+        /* v8 ignore next */
         return Buffer.from(str, "utf-8").toString("base64");
     }
     /**
      * Base64 decode
      */
     static base64Decode(str) {
+        /* v8 ignore next */
         if (typeof globalThis !== "undefined" && globalThis.atob) {
             // Decode from binary string to UTF-8 to handle Unicode characters
             const binaryString = globalThis.atob(str);
@@ -82,7 +88,8 @@ export class CryptoUtils {
             const decoder = new TextDecoder();
             return decoder.decode(bytes);
         }
-        // Node.js fallback
+        // Node.js fallback (unreachable: atob is available in Node.js 18+)
+        /* v8 ignore next */
         return Buffer.from(str, "base64").toString("utf-8");
     }
     /**
@@ -118,6 +125,7 @@ export class CryptoUtils {
      * Hash string using SubtleCrypto (browser) or crypto (Node.js)
      */
     static async hash(str, algorithm = "SHA-256") {
+        /* v8 ignore next */
         if (typeof globalThis !== "undefined" && globalThis.crypto?.subtle) {
             // Browser
             const encoder = new TextEncoder();
@@ -128,7 +136,8 @@ export class CryptoUtils {
                 .map((b) => b.toString(16).padStart(2, "0"))
                 .join("");
         }
-        // Node.js fallback
+        // Node.js fallback (unreachable: SubtleCrypto is available in Node.js 18+)
+        /* v8 ignore start */
         if (typeof process !== "undefined" && process.versions?.node) {
             try {
                 const crypto = await import("crypto");
@@ -143,6 +152,7 @@ export class CryptoUtils {
         }
         // Browser without SubtleCrypto fallback
         return this.simpleHash(str);
+        /* v8 ignore end */
     }
     /**
      * Create HMAC signature
@@ -159,6 +169,7 @@ export class CryptoUtils {
                 .join("");
         }
         // Node.js fallback
+        /* v8 ignore start */
         if (typeof process !== "undefined" && process.versions?.node) {
             try {
                 const crypto = await import("crypto");
@@ -172,6 +183,7 @@ export class CryptoUtils {
         }
         // Browser without SubtleCrypto fallback
         return "";
+        /* v8 ignore end */
     }
     /**
      * Check if string matches hash

package/dist/utils/helpers/CryptoUtils.js.map

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

package/dist/utils/helpers/EnvManager.d.ts

@@ -1,7 +1,53 @@
+/**
+ * Isomorphic environment variable accessor.
+ *
+ * Reads from `import.meta.env` in browser environments (Vite / bundlers)
+ * and from `process.env` in Node.js, providing a unified API across runtimes.
+ *
+ * @example
+ * ```typescript
+ * const env = new EnvManager();
+ * const apiUrl = env.require('API_URL');
+ * console.log(env.isProd()); // true in production
+ * ```
+ */
 export declare class EnvManager {
     private readonly isBrowser;
+    /**
+     * Reads an environment variable by name.
+     *
+     * @param name - The environment variable name (e.g., `"API_URL"`).
+     * @returns The variable's string value, or `undefined` if not set.
+     */
     get(name: string): string | undefined;
+    /**
+     * Reads a required environment variable, throwing if absent.
+     *
+     * @param name - The environment variable name.
+     * @returns The variable's string value.
+     * @throws {Error} If the variable is not set in the current environment.
+     *
+     * @example
+     * ```typescript
+     * const secret = env.require('API_SECRET');
+     * ```
+     */
     require(name: string): string;
+    /**
+     * Returns `true` when running in production mode.
+     *
+     * Checks `NODE_ENV` (Node.js) or `MODE` (Vite) for the value
+     * `"production"`.
+     *
+     * @returns `true` if the environment is production, `false` otherwise.
+     *
+     * @example
+     * ```typescript
+     * if (env.isProd()) {
+     *     logger.setLevel('warn');
+     * }
+     * ```
+     */
     isProd(): boolean;
 }
 //# sourceMappingURL=EnvManager.d.ts.map

package/dist/utils/helpers/EnvManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvManager.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/EnvManager.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM7B,MAAM;CAIT"}
+{"version":3,"file":"EnvManager.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/EnvManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUrC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM7B;;;;;;;;;;;;;;OAcG;IACH,MAAM;CAIT"}

package/dist/utils/helpers/EnvManager.js

@@ -1,3 +1,16 @@
+/**
+ * Isomorphic environment variable accessor.
+ *
+ * Reads from `import.meta.env` in browser environments (Vite / bundlers)
+ * and from `process.env` in Node.js, providing a unified API across runtimes.
+ *
+ * @example
+ * ```typescript
+ * const env = new EnvManager();
+ * const apiUrl = env.require('API_URL');
+ * console.log(env.isProd()); // true in production
+ * ```
+ */
 export class EnvManager {
     constructor() {
         Object.defineProperty(this, "isBrowser", {
@@ -7,6 +20,12 @@ export class EnvManager {
             value: typeof window !== "undefined"
         });
     }
+    /**
+     * Reads an environment variable by name.
+     *
+     * @param name - The environment variable name (e.g., `"API_URL"`).
+     * @returns The variable's string value, or `undefined` if not set.
+     */
     get(name) {
         if (this.isBrowser) {
             const meta = import.meta;
@@ -14,12 +33,39 @@ export class EnvManager {
         }
         return process?.env?.[name];
     }
+    /**
+     * Reads a required environment variable, throwing if absent.
+     *
+     * @param name - The environment variable name.
+     * @returns The variable's string value.
+     * @throws {Error} If the variable is not set in the current environment.
+     *
+     * @example
+     * ```typescript
+     * const secret = env.require('API_SECRET');
+     * ```
+     */
     require(name) {
         const value = this.get(name);
         if (!value)
             throw new Error(`Missing environment variable: ${name}`);
         return value;
     }
+    /**
+     * Returns `true` when running in production mode.
+     *
+     * Checks `NODE_ENV` (Node.js) or `MODE` (Vite) for the value
+     * `"production"`.
+     *
+     * @returns `true` if the environment is production, `false` otherwise.
+     *
+     * @example
+     * ```typescript
+     * if (env.isProd()) {
+     *     logger.setLevel('warn');
+     * }
+     * ```
+     */
     isProd() {
         const mode = this.get("NODE_ENV") || this.get("MODE");
         return mode === "production";

package/dist/utils/helpers/EnvManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"EnvManager.js","sourceRoot":"","sources":["../../../src/utils/helpers/EnvManager.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAU;IAAvB;QACqB;;;;mBAAY,OAAO,MAAM,KAAK,WAAW;WAAC;IAsB/D,CAAC;IApBG,GAAG,CAAC,IAAY;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,CAAC,IAEnB,CAAC;YACF,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,IAAY;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,KAAK,YAAY,CAAC;IACjC,CAAC;CACJ"}
+{"version":3,"file":"EnvManager.js","sourceRoot":"","sources":["../../../src/utils/helpers/EnvManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,UAAU;IAAvB;QACqB;;;;mBAAY,OAAO,MAAM,KAAK,WAAW;WAAC;IAuD/D,CAAC;IArDG;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,CAAC,IAEnB,CAAC;YACF,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,IAAY;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,KAAK,YAAY,CAAC;IACjC,CAAC;CACJ"}

package/dist/utils/helpers/EventEmitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/EventEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3E,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,IAAI,CAC9C,IAAI,EAAE,CAAC,EACP,KAAK,CAAC,EAAE,KAAK,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,YAAY,CACrB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEhE,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,aAAa,CAA0C;gBAEnD,OAAO,GAAE,mBAAwB;IAK7C;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EACrB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAkBP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EACvB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAsBP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EACtB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAiCP;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAW3D;;OAEG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAC7B,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,OAAO,CAAC,OAAO,CAAC;IAqCnB;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO;IAqBpE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAK/C;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAKvD;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;IAO1E;;OAEG;IACH,UAAU,IAAI,CAAC,MAAM,MAAM,CAAC,EAAE;IAI9B;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,eAAe,IAAI,MAAM;CAG5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAAC,MAAM,CAAC,CAErD"}
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/EventEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3E,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,IAAI,CAC9C,IAAI,EAAE,CAAC,EACP,KAAK,CAAC,EAAE,KAAK,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,YAAY,CACrB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEhE,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,aAAa,CAA0C;gBAEnD,OAAO,GAAE,mBAAwB;IAK7C;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EACrB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAkBP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EACvB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAmBP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EACtB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI;IAiCP;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAW3D;;OAEG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAC7B,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,OAAO,CAAC,OAAO,CAAC;IAqCnB;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO;IAqBpE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAK/C;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAKvD;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;IAO1E;;OAEG;IACH,UAAU,IAAI,CAAC,MAAM,MAAM,CAAC,EAAE;IAI9B;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,eAAe,IAAI,MAAM;CAG5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAAC,MAAM,CAAC,CAErD"}

package/dist/utils/helpers/EventEmitter.js

@@ -68,9 +68,6 @@ export class EventEmitter {
         };
         // Attach original listener to allow removal by off()
         onceListener._originalListener = listener;
-        if (!this.onceMap.has(event)) {
-            this.onceMap.set(event, new Set());
-        }
         this.onceMap.get(event).add(onceListener);
         return this.on(event, onceListener);
     }

package/dist/utils/helpers/EventEmitter.js.map

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

package/dist/utils/helpers/FileUploadHelper.d.ts

@@ -4,17 +4,61 @@ export interface UploadProgress {
     percentage: number;
 }
 export interface FileUploadOptions {
+    /** Called after each chunk completes with cumulative bytes loaded so far. */
     onProgress?: (progress: UploadProgress) => void;
+    /**
+     * Size of each chunk in bytes.
+     * Values <= 0 fall back to the default.
+     * @default 5242880 (5 MB)
+     */
     chunkSize?: number;
+    /**
+     * Maximum retry attempts per chunk on failure.
+     * @default 3
+     */
     maxRetries?: number;
+    /**
+     * Per-chunk request timeout in milliseconds.
+     * @default 30000
+     */
     timeout?: number;
+    /** Additional headers sent with every chunk request. */
     headers?: Record<string, string>;
+    /**
+     * 0-based chunk index to start uploading from, skipping all prior chunks.
+     * Pass the `uploadedChunks` value from a previous failed {@link UploadResponse}
+     * to resume an interrupted upload. Negative values are clamped to 0.
+     * @default 0
+     */
+    resumeFrom?: number;
+    /**
+     * Maximum number of chunks to upload concurrently.
+     * Chunks are processed in sequential batches of this size.
+     * Values < 1 are clamped to 1 (sequential).
+     * @default 1
+     */
+    concurrency?: number;
 }
 export interface UploadResponse {
+    /** Whether the upload completed successfully (all chunks sent). */
     success: boolean;
+    /** Server-assigned file identifier (currently generated client-side as a UUID). */
     fileId?: string;
+    /** URL of the uploaded file, if returned by the server. */
     url?: string;
+    /** Error message when `success` is `false`. */
     error?: string;
+    /**
+     * Number of chunks successfully uploaded (absolute count including any skipped
+     * by `resumeFrom`). On success equals `totalChunks`. On failure reflects chunks
+     * completed before the error — safe to pass as `resumeFrom` on the next call.
+     */
+    uploadedChunks?: number;
+    /**
+     * Total number of chunks the file was divided into at the given `chunkSize`.
+     * Useful for computing resume progress or verifying chunk arithmetic.
+     */
+    totalChunks?: number;
 }
 export declare class FileUploadHelper {
     /**
@@ -22,7 +66,30 @@ export declare class FileUploadHelper {
      */
     private static uploadChunkWithRetry;
     /**
-     * Upload a file with progress tracking and chunking support
+     * Upload a file with chunking, progress tracking, resume support, and concurrency control.
+     *
+     * @param file - The file or blob to upload.
+     * @param endpoint - Destination URL (absolute or relative).
+     * @param options - Upload configuration. All fields are optional.
+     * @returns Result including `uploadedChunks` and `totalChunks` for resume support.
+     *
+     * @example
+     * ```typescript
+     * // Basic chunked upload
+     * const result = await FileUploadHelper.uploadFile(file, "/api/upload", {
+     *   chunkSize: 1_048_576,
+     *   onProgress: (p) => console.log(`${p.percentage}%`),
+     * });
+     *
+     * // Resume an interrupted upload
+     * if (!result.success) {
+     *   const resumed = await FileUploadHelper.uploadFile(file, "/api/upload", {
+     *     chunkSize: 1_048_576,
+     *     resumeFrom: result.uploadedChunks,
+     *     concurrency: 3,
+     *   });
+     * }
+     * ```
      */
     static uploadFile(file: File | Blob, endpoint: string, options?: FileUploadOptions): Promise<UploadResponse>;
     /**

package/dist/utils/helpers/FileUploadHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileUploadHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/FileUploadHelper.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IACzB;;OAEG;mBACkB,oBAAoB;IAoCzC;;OAEG;WACU,UAAU,CACnB,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,cAAc,CAAC;IAuD1B;;OAEG;mBACkB,WAAW;IAgChC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAI/B;;OAEG;IACH,MAAM,CAAC,YAAY,CACf,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,GACP;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAoCxC"}
+{"version":3,"file":"FileUploadHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/FileUploadHelper.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC3B,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,gBAAgB;IACzB;;OAEG;mBACkB,oBAAoB;IAoCzC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACU,UAAU,CACnB,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,cAAc,CAAC;IA8G1B;;OAEG;mBACkB,WAAW;IAgChC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAI/B;;OAEG;IACH,MAAM,CAAC,YAAY,CACf,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,GACP;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAoCxC"}

package/dist/utils/helpers/FileUploadHelper.js

@@ -22,41 +22,94 @@ export class FileUploadHelper {
         }
     }
     /**
-     * Upload a file with progress tracking and chunking support
+     * Upload a file with chunking, progress tracking, resume support, and concurrency control.
+     *
+     * @param file - The file or blob to upload.
+     * @param endpoint - Destination URL (absolute or relative).
+     * @param options - Upload configuration. All fields are optional.
+     * @returns Result including `uploadedChunks` and `totalChunks` for resume support.
+     *
+     * @example
+     * ```typescript
+     * // Basic chunked upload
+     * const result = await FileUploadHelper.uploadFile(file, "/api/upload", {
+     *   chunkSize: 1_048_576,
+     *   onProgress: (p) => console.log(`${p.percentage}%`),
+     * });
+     *
+     * // Resume an interrupted upload
+     * if (!result.success) {
+     *   const resumed = await FileUploadHelper.uploadFile(file, "/api/upload", {
+     *     chunkSize: 1_048_576,
+     *     resumeFrom: result.uploadedChunks,
+     *     concurrency: 3,
+     *   });
+     * }
+     * ```
      */
     static async uploadFile(file, endpoint, options = {}) {
-        const { onProgress, chunkSize = 5 * 1024 * 1024, // 5MB default
-        maxRetries = 3, timeout = 30000, headers = {}, } = options;
+        const { onProgress, chunkSize = 5 * 1024 * 1024, maxRetries = 3, timeout = 30000, headers = {}, resumeFrom = 0, concurrency = 1, } = options;
+        // Clamp and validate options (D5: non-breaking defaults)
+        const resolvedChunkSize = chunkSize > 0 ? chunkSize : 5 * 1024 * 1024;
+        const resolvedConcurrency = Math.max(1, concurrency);
         const totalSize = file.size;
-        const chunks = Math.ceil(totalSize / chunkSize);
+        const totalChunks = Math.ceil(totalSize / resolvedChunkSize);
+        const resolvedResumeFrom = Math.max(0, Math.min(resumeFrom, totalChunks));
         const uploadId = this.generateUploadId();
+        // Nothing left to upload — all chunks already on the server
+        if (resolvedResumeFrom >= totalChunks) {
+            return {
+                success: true,
+                fileId: uploadId,
+                uploadedChunks: totalChunks,
+                totalChunks,
+            };
+        }
+        // Pre-initialize progress baseline from already-uploaded (skipped) chunks
+        let loadedBytes = Math.min(resolvedResumeFrom * resolvedChunkSize, totalSize);
+        let uploadedChunksCount = resolvedResumeFrom;
         try {
-            for (let i = 0; i < chunks; i++) {
-                const start = i * chunkSize;
-                const end = Math.min(start + chunkSize, totalSize);
-                const chunk = file.slice(start, end);
-                const chunkHeaders = {
-                    ...headers,
-                    ...(chunks > 1 ? { "X-Upload-ID": uploadId } : {}),
-                };
-                await this.uploadChunkWithRetry(chunk, endpoint, i, chunks, chunkHeaders, timeout, maxRetries);
-                if (onProgress) {
-                    onProgress({
-                        loaded: end,
-                        total: totalSize,
-                        percentage: Math.round((end / totalSize) * 100),
-                    });
+            for (let batchStart = resolvedResumeFrom; batchStart < totalChunks; batchStart += resolvedConcurrency) {
+                const batchEnd = Math.min(batchStart + resolvedConcurrency, totalChunks);
+                const batchPromises = [];
+                for (let i = batchStart; i < batchEnd; i++) {
+                    const start = i * resolvedChunkSize;
+                    const end = Math.min(start + resolvedChunkSize, totalSize);
+                    const chunk = file.slice(start, end);
+                    const chunkBytes = end - start;
+                    const chunkHeaders = {
+                        ...headers,
+                        ...(totalChunks > 1 ? { "X-Upload-ID": uploadId } : {}),
+                    };
+                    batchPromises.push(this.uploadChunkWithRetry(chunk, endpoint, i, totalChunks, chunkHeaders, timeout, maxRetries).then(() => {
+                        // Fires per-chunk (not per-batch) even under concurrency
+                        loadedBytes += chunkBytes;
+                        uploadedChunksCount++;
+                        if (onProgress) {
+                            onProgress({
+                                loaded: loadedBytes,
+                                total: totalSize,
+                                percentage: parseFloat(((loadedBytes / totalSize) *
+                                    100).toFixed(2)),
+                            });
+                        }
+                    }));
                 }
+                await Promise.all(batchPromises);
             }
             return {
                 success: true,
                 fileId: uploadId,
+                uploadedChunks: uploadedChunksCount,
+                totalChunks,
             };
         }
         catch (error) {
             return {
                 success: false,
                 error: error instanceof Error ? error.message : "Upload failed",
+                uploadedChunks: uploadedChunksCount,
+                totalChunks,
             };
         }
     }

package/dist/utils/helpers/FileUploadHelper.js.map

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

package/dist/utils/helpers/StorageUtils.d.ts

@@ -1,9 +1,71 @@
+/**
+ * JSON-serialising wrapper around the browser `Storage` API with optional
+ * time-to-live (TTL) support.
+ *
+ * Works with any `Storage`-compatible object (`localStorage`,
+ * `sessionStorage`, or a custom in-memory implementation).
+ *
+ * @example
+ * ```typescript
+ * const store = new StorageManager();
+ * store.set('user', { id: 1, name: 'Alice' }, 3_600_000); // expires in 1 h
+ * const user = store.get<{ id: number; name: string }>('user');
+ * ```
+ */
 export declare class StorageManager {
     private storage;
+    /**
+     * Creates a new `StorageManager` instance.
+     *
+     * @param storage - The `Storage` backend to use. Defaults to
+     *   `localStorage`.
+     */
     constructor(storage?: Storage);
+    /**
+     * Serialises a value to JSON and stores it under the given key.
+     *
+     * @template T - Type of the value to store.
+     * @param key - Storage key.
+     * @param value - Value to serialise and store.
+     * @param ttlMs - Optional time-to-live in milliseconds. When set, the
+     *   entry is automatically invalidated after this duration.
+     *
+     * @example
+     * ```typescript
+     * store.set('token', 'abc123', 60_000); // expires in 60 s
+     * ```
+     */
     set<T>(key: string, value: T, ttlMs?: number): void;
+    /**
+     * Retrieves and deserialises a stored value.
+     *
+     * Returns `null` when the key does not exist, the stored JSON is malformed,
+     * or the entry's TTL has expired (expired entries are removed automatically).
+     *
+     * @template T - Expected type of the stored value.
+     * @param key - Storage key to retrieve.
+     * @returns The deserialised value, or `null` on miss or expiry.
+     *
+     * @example
+     * ```typescript
+     * const token = store.get<string>('token');
+     * ```
+     */
     get<T>(key: string): T | null;
+    /**
+     * Removes a single entry from storage.
+     *
+     * @param key - Storage key to remove.
+     */
     remove(key: string): void;
+    /**
+     * Removes all entries from the underlying storage backend.
+     *
+     * @example
+     * ```typescript
+     * store.clear(); // clears all localStorage entries
+     * ```
+     */
     clear(): void;
 }
 //# sourceMappingURL=StorageUtils.d.ts.map