@wlindabla/file_uploader 1.0.0 → 2.0.0

package/README.md

@@ -188,7 +188,7 @@ import {
   UploadStateChangedEvent,
   UploadProgressEvent,
   UploadMediaCompleteEvent
-} from '@wlindabla/file_uploader';
+} from '@wlindabla/file_uploader/events';
 
 import { BrowserEventDispatcher } from '@wlindabla/event_dispatcher';
 
@@ -1011,7 +1011,7 @@ You are responsible for adding them to your dispatcher instance.
 import {
   InitializeUploadSubscriber,
   FinalizeUploadSubscriber
-} from '@wlindabla/file_uploader';
+} from '@wlindabla/file_uploader/subscribers';
 
 import { BrowserEventDispatcher } from '@wlindabla/event_dispatcher';
 
@@ -1031,7 +1031,7 @@ dispatcher.addSubscriber(new FinalizeUploadSubscriber(dispatcher));
 import {
   InitializeUploadSubscriber,
   FinalizeUploadSubscriber
-} from '@wlindabla/file_uploader';
+} from '@wlindabla/file_uploader/subscribers';
 
 import { NodeEventDispatcher } from '@wlindabla/event_dispatcher';
 
@@ -1054,15 +1054,23 @@ dispatcher.addSubscriber(new FinalizeUploadSubscriber(dispatcher));
 
 ```typescript
 import {
-  ChunkedFileUploader,
-  InitializeUploadSubscriber,
-  FinalizeUploadSubscriber,
   HttpFileUploaderEvents,
   InitializeUploadSuccessEvent,
   InitializeUploadFailureEvent,
   FinalizeUploadFailureEvent,
   UploadMediaCompleteEvent
-} from '@wlindabla/file_uploader';
+} from '@wlindabla/file_uploader/events';
+
+import {
+  InitializeUploadSubscriber,
+  FinalizeUploadSubscriber
+} from
+ '@wlindabla/file_uploader/subscribers'
+
+import {
+  ChunkedFileUploader
+} from
+ '@wlindabla/file_uploader/core'
 
 import { BrowserEventDispatcher } from '@wlindabla/event_dispatcher';
 
@@ -1122,13 +1130,23 @@ await uploader
 
 ```typescript
 import {
-  ChunkedFileUploader,
-  InitializeUploadSubscriber,
-  FinalizeUploadSubscriber,
   HttpFileUploaderEvents,
   InitializeUploadSuccessEvent,
-  FinalizeUploadFailureEvent
-} from '@wlindabla/file_uploader';
+  InitializeUploadFailureEvent,
+  FinalizeUploadFailureEvent,
+  UploadMediaCompleteEvent
+} from '@wlindabla/file_uploader/events';
+
+import {
+  InitializeUploadSubscriber,
+  FinalizeUploadSubscriber
+} from
+ '@wlindabla/file_uploader/subscribers'
+
+import {
+  ChunkedFileUploader
+} from
+ '@wlindabla/file_uploader/core'
 
 import { NodeEventDispatcher } from '@wlindabla/event_dispatcher';
 
@@ -1762,14 +1780,17 @@ Complete browser example with progress bar and UI controls.
 
 ```typescript
 import {
-  ChunkedFileUploader,
   HttpFileUploaderEvents,
   UploadProgressEvent,
   UploadStateChangedEvent,
   UploadMediaCompleteEvent,
   UploadCancelledEvent,
-  ConsoleLogger
-} from '@wlindabla/file_uploader';
+} from '@wlindabla/file_uploader/events';
+
+import {
+  ChunkedFileUploader
+} from
+ '@wlindabla/file_uploader/core'
 
 import { BrowserEventDispatcher } from '@wlindabla/event_dispatcher';
 
@@ -1892,7 +1913,11 @@ import {
   UploadProgressEvent,
   UploadMediaCompleteEvent,
   ConsoleLogger
-} from '@wlindabla/file_uploader';
+} from '@wlindabla/file_uploader/events';
+
+import {
+  ChunkedFileUploader,
+} from '@wlindabla/file_uploader/core';
 
 import { NodeEventDispatcher } from '@wlindabla/event_dispatcher';
 import fs from 'fs';
@@ -2056,13 +2081,19 @@ uploadFile('/path/to/large-video.mp4').catch(console.error);
 
 ```typescript
 import {
-  ChunkedFileUploader,
-  HttpFileUploaderEvents,
-  InitializeUploadFailureEvent,
   FileUploadChunkError,
   InitializeUploadFailureException,
   UploadCancelledException
-} from '@wlindabla/file_uploader';
+} from '@wlindabla/file_uploader/exceptions';
+
+import {
+  HttpFileUploaderEvents,
+  InitializeUploadFailureEvent
+} from '@wlindabla/file_uploader/events';
+
+import {
+  ChunkedFileUploader
+} from '@wlindabla/file_uploader/core';
 
 // Listen to granular error events
 dispatcher.addListener(

package/dist/cjs/cache/index.d.ts

@@ -0,0 +1,198 @@
+import { ResumeData } from '../types/index.js';
+import '@wlindabla/http_client';
+
+/**
+ * Interface for caching upload resume data.
+ *
+ * This interface extends the base cache functionality to specifically
+ * handle resume data for file uploads, allowing uploads to be paused
+ * and resumed across browser sessions.
+ *
+ *
+ * @example
+ * ```typescript
+ * const cache: UploadResumeCacheInterface = new LocalStorageUploadResumeCache();
+ *
+ * // Save progress
+ * await cache.setItem('video.mp4', {
+ *   uploadedChunks: 45,
+ *   totalChunks: 100,
+ *   lastBytePosition: 47185920
+ * });
+ *
+ * // Resume later
+ * const data = await cache.getItem('video.mp4');
+ * console.log(`Resume from chunk ${data.uploadedChunks}`);
+ * ```
+ */
+interface UploadResumeCacheInterface {
+    /**
+     * Retrieves cached resume data for a specific upload.
+     *
+     * @param key - Unique identifier for the upload (typically filename or file hash)
+     * @returns Promise resolving to the cached resume data
+     * @throws {Error} If the key doesn't exist or data is corrupted
+     */
+    getItem(key: string): Promise<ResumeData>;
+    /**
+     * Stores resume data for an upload session.
+     *
+     * @param key - Unique identifier for the upload
+     * @param data - Resume data containing upload progress information
+     * @returns Promise that resolves when data is successfully cached
+     * @throws {Error} If storage quota is exceeded or data is invalid
+     */
+    setItem(key: string, data: ResumeData): Promise<void>;
+}
+/**
+ * Default adapter for caching resume data during file uploads.
+ *
+ * Implements an in-memory storage strategy with secure serialization,
+ * strict data validation, and comprehensive error handling.
+ *
+ * This implementation serves as a foundation for specialized adapters
+ * (localStorage, IndexedDB, sessionStorage, etc.).
+ *
+ * @implements {UploadResumeCacheInterface}
+ *
+ * @example
+ * ```typescript
+ * const adapter = new DefaultUploadResumeCacheAdapter();
+ *
+ * // Save resume data
+ * await adapter.setItem('upload-123', {
+ *   fileId: 'file-abc',
+ *   fileName: 'document.pdf',
+ *   fileSize: 5242880,
+ *   uploadedChunks: 12,
+ *   lastChunkIndex: 11,
+ *   lastBytePosition: 1258291,
+ *   chunkSize: 1048576
+ * });
+ *
+ * // Retrieve and resume
+ * const resumeData = await adapter.getItem('upload-123');
+ * console.log(`Resume from chunk ${resumeData.uploadedChunks}`);
+ *
+ * // Remove specific item
+ * await adapter.removeItem('upload-123');
+ *
+ * // Clear all cache
+ * await adapter.clear();
+ * ```
+ */
+declare class DefaultUploadResumeCacheAdapter implements UploadResumeCacheInterface {
+    private cache;
+    private readonly maxCacheSize;
+    constructor();
+    /**
+     * Validates that the runtime environment is appropriate.
+     *
+     * @private
+     * @throws {UploadCacheError} If the environment is incompatible
+     */
+    private validateEnvironment;
+    /**
+     * Validates resume data according to strict criteria.
+     *
+     * @private
+     * @param data - The data to validate
+     * @throws {UploadCacheError} If the data is invalid
+     */
+    private validateResumeData;
+    /**
+     * Retrieves resume data for a specific upload.
+     *
+     * @param key - Unique identifier for the upload
+     * @returns Promise resolved with the resume data
+     * @throws {UploadCacheError} If the key does not exist or data is corrupted
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const data = await adapter.getItem('upload-123');
+     *   console.log(`${data.uploadedChunks}/${Math.ceil(data.fileSize / data.chunkSize)} chunks`);
+     * } catch (error) {
+     *   console.error('Failed to retrieve data:', error.message);
+     * }
+     * ```
+     */
+    getItem(key: string): Promise<ResumeData>;
+    /**
+     * Stores resume data for an upload session.
+     *
+     * @param key - Unique identifier for the upload
+     * @param data - Resume data containing upload progress information
+     * @returns Promise resolved when data is successfully cached
+     * @throws {UploadCacheError} If quota is exceeded or data is invalid
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await adapter.setItem('upload-123', {
+     *     fileId: 'file-abc',
+     *     fileName: 'video.mp4',
+     *     fileSize: 10737418240,
+     *     uploadedChunks: 45,
+     *     lastChunkIndex: 44,
+     *     lastBytePosition: 47185920,
+     *     chunkSize: 1048576
+     *   });
+     *   console.log('Data successfully saved');
+     * } catch (error) {
+     *   console.error('Storage error:', error.message);
+     * }
+     * ```
+     */
+    setItem(key: string, data: ResumeData): Promise<void>;
+    /**
+     * Removes resume data for a specific upload.
+     *
+     * @param key - Unique identifier for the upload
+     * @returns Promise resolved after removal
+     *
+     * @example
+     * ```typescript
+     * await adapter.removeItem('upload-123');
+     * ```
+     */
+    removeItem(key: string): Promise<void>;
+    /**
+     * Clears all cached resume data.
+     *
+     * @returns Promise resolved after complete cleanup
+     *
+     * @example
+     * ```typescript
+     * await adapter.clear();
+     * console.log('Cache cleared');
+     * ```
+     */
+    clear(): Promise<void>;
+    /**
+     * Returns the number of entries currently in cache.
+     *
+     * @returns Number of cache entries
+     */
+    get size(): number;
+    /**
+     * Returns cache usage as a percentage.
+     *
+     * @returns Usage percentage (0-100)
+     */
+    get usage(): number;
+}
+/**
+ * Custom error for upload cache operations.
+ *
+ * @example
+ * ```typescript
+ * throw new UploadCacheError('Resume data not found', 'NOT_FOUND');
+ * ```
+ */
+declare class UploadCacheError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+
+export { DefaultUploadResumeCacheAdapter, UploadCacheError, type UploadResumeCacheInterface };

package/dist/cjs/cache/index.js

@@ -0,0 +1,318 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cache_exports = {};
+__export(cache_exports, {
+  DefaultUploadResumeCacheAdapter: () => DefaultUploadResumeCacheAdapter,
+  UploadCacheError: () => UploadCacheError
+});
+module.exports = __toCommonJS(cache_exports);
+class DefaultUploadResumeCacheAdapter {
+  static {
+    __name(this, "DefaultUploadResumeCacheAdapter");
+  }
+  cache = /* @__PURE__ */ new Map();
+  maxCacheSize = 100;
+  constructor() {
+    this.validateEnvironment();
+  }
+  /**
+   * Validates that the runtime environment is appropriate.
+   * 
+   * @private
+   * @throws {UploadCacheError} If the environment is incompatible
+   */
+  validateEnvironment() {
+    if (typeof window === "undefined") {
+      console.warn(
+        "[UploadResumeCacheAdapter] Server-side execution detected. Consider a server-compatible adapter for persistent storage."
+      );
+    }
+  }
+  /**
+   * Validates resume data according to strict criteria.
+   * 
+   * @private
+   * @param data - The data to validate
+   * @throws {UploadCacheError} If the data is invalid
+   */
+  validateResumeData(data) {
+    if (!data || typeof data !== "object") {
+      throw new UploadCacheError(
+        "Resume data must be a valid object",
+        "INVALID_DATA"
+      );
+    }
+    const requiredFields = [
+      "fileId",
+      "fileName",
+      "fileSize",
+      "uploadedChunks",
+      "lastChunkIndex",
+      "lastBytePosition",
+      "chunkSize"
+    ];
+    for (const field of requiredFields) {
+      if (!(field in data)) {
+        throw new UploadCacheError(
+          `Required field '${field}' is missing`,
+          "MISSING_FIELD"
+        );
+      }
+    }
+    if (typeof data.fileId !== "string" || !data.fileId.trim()) {
+      throw new UploadCacheError(
+        "fileId must be a non-empty string",
+        "INVALID_FILE_ID"
+      );
+    }
+    if (typeof data.fileName !== "string" || !data.fileName.trim()) {
+      throw new UploadCacheError(
+        "fileName must be a non-empty string",
+        "INVALID_FILE_NAME"
+      );
+    }
+    if (!Number.isFinite(data.fileSize) || data.fileSize <= 0) {
+      throw new UploadCacheError(
+        "fileSize must be a positive number",
+        "INVALID_FILE_SIZE"
+      );
+    }
+    if (!Number.isFinite(data.chunkSize) || data.chunkSize <= 0) {
+      throw new UploadCacheError(
+        "chunkSize must be a positive number",
+        "INVALID_CHUNK_SIZE"
+      );
+    }
+    if (!Number.isInteger(data.uploadedChunks) || data.uploadedChunks < 0) {
+      throw new UploadCacheError(
+        "uploadedChunks must be a non-negative integer",
+        "INVALID_UPLOADED_CHUNKS"
+      );
+    }
+    if (!Number.isInteger(data.lastChunkIndex) || data.lastChunkIndex < -1) {
+      throw new UploadCacheError(
+        "lastChunkIndex must be an integer >= -1",
+        "INVALID_LAST_CHUNK_INDEX"
+      );
+    }
+    if (!Number.isFinite(data.lastBytePosition) || data.lastBytePosition < 0) {
+      throw new UploadCacheError(
+        "lastBytePosition must be a non-negative number",
+        "INVALID_BYTE_POSITION"
+      );
+    }
+    if (data.uploadedChunks > 0 && data.lastBytePosition === 0) {
+      throw new UploadCacheError(
+        "lastBytePosition cannot be 0 if chunks have been uploaded",
+        "INCONSISTENT_DATA"
+      );
+    }
+    const expectedMaxChunks = Math.ceil(data.fileSize / data.chunkSize);
+    if (data.uploadedChunks > expectedMaxChunks) {
+      throw new UploadCacheError(
+        `uploadedChunks (${data.uploadedChunks}) exceeds maximum expected (${expectedMaxChunks})`,
+        "INCONSISTENT_DATA"
+      );
+    }
+  }
+  /**
+   * Retrieves resume data for a specific upload.
+   * 
+   * @param key - Unique identifier for the upload
+   * @returns Promise resolved with the resume data
+   * @throws {UploadCacheError} If the key does not exist or data is corrupted
+   * 
+   * @example
+   * ```typescript
+   * try {
+   *   const data = await adapter.getItem('upload-123');
+   *   console.log(`${data.uploadedChunks}/${Math.ceil(data.fileSize / data.chunkSize)} chunks`);
+   * } catch (error) {
+   *   console.error('Failed to retrieve data:', error.message);
+   * }
+   * ```
+   */
+  async getItem(key) {
+    return new Promise((resolve, reject) => {
+      try {
+        if (!key || typeof key !== "string") {
+          reject(new UploadCacheError(
+            "Key must be a non-empty string",
+            "INVALID_KEY"
+          ));
+          return;
+        }
+        const data = this.cache.get(key);
+        if (!data) {
+          reject(new UploadCacheError(
+            `Resume data for key '${key}' was not found`,
+            "NOT_FOUND"
+          ));
+          return;
+        }
+        resolve(JSON.parse(JSON.stringify(data)));
+      } catch (error) {
+        reject(new UploadCacheError(
+          `Error retrieving data: ${error instanceof Error ? error.message : String(error)}`,
+          "RETRIEVAL_ERROR"
+        ));
+      }
+    });
+  }
+  /**
+   * Stores resume data for an upload session.
+   * 
+   * @param key - Unique identifier for the upload
+   * @param data - Resume data containing upload progress information
+   * @returns Promise resolved when data is successfully cached
+   * @throws {UploadCacheError} If quota is exceeded or data is invalid
+   * 
+   * @example
+   * ```typescript
+   * try {
+   *   await adapter.setItem('upload-123', {
+   *     fileId: 'file-abc',
+   *     fileName: 'video.mp4',
+   *     fileSize: 10737418240,
+   *     uploadedChunks: 45,
+   *     lastChunkIndex: 44,
+   *     lastBytePosition: 47185920,
+   *     chunkSize: 1048576
+   *   });
+   *   console.log('Data successfully saved');
+   * } catch (error) {
+   *   console.error('Storage error:', error.message);
+   * }
+   * ```
+   */
+  async setItem(key, data) {
+    return new Promise((resolve, reject) => {
+      try {
+        if (!key || typeof key !== "string") {
+          reject(new UploadCacheError(
+            "Key must be a non-empty string",
+            "INVALID_KEY"
+          ));
+          return;
+        }
+        this.validateResumeData(data);
+        if (this.cache.size >= this.maxCacheSize && !this.cache.has(key)) {
+          reject(new UploadCacheError(
+            `Cache limit (${this.maxCacheSize} entries) has been reached. Remove obsolete entries or use an adapter with persistent storage.`,
+            "CACHE_LIMIT_EXCEEDED"
+          ));
+          return;
+        }
+        this.cache.set(key, JSON.parse(JSON.stringify(data)));
+        resolve();
+      } catch (error) {
+        if (error instanceof UploadCacheError) {
+          reject(error);
+        } else {
+          reject(new UploadCacheError(
+            `Error storing data: ${error instanceof Error ? error.message : String(error)}`,
+            "STORAGE_ERROR"
+          ));
+        }
+      }
+    });
+  }
+  /**
+   * Removes resume data for a specific upload.
+   * 
+   * @param key - Unique identifier for the upload
+   * @returns Promise resolved after removal
+   * 
+   * @example
+   * ```typescript
+   * await adapter.removeItem('upload-123');
+   * ```
+   */
+  async removeItem(key) {
+    return new Promise((resolve, reject) => {
+      try {
+        if (!key || typeof key !== "string") {
+          reject(new UploadCacheError(
+            "Key must be a non-empty string",
+            "INVALID_KEY"
+          ));
+          return;
+        }
+        this.cache.delete(key);
+        resolve();
+      } catch (error) {
+        reject(new UploadCacheError(
+          `Error removing data: ${error instanceof Error ? error.message : String(error)}`,
+          "DELETION_ERROR"
+        ));
+      }
+    });
+  }
+  /**
+   * Clears all cached resume data.
+   * 
+   * @returns Promise resolved after complete cleanup
+   * 
+   * @example
+   * ```typescript
+   * await adapter.clear();
+   * console.log('Cache cleared');
+   * ```
+   */
+  async clear() {
+    return new Promise((resolve) => {
+      this.cache.clear();
+      resolve();
+    });
+  }
+  /**
+   * Returns the number of entries currently in cache.
+   * 
+   * @returns Number of cache entries
+   */
+  get size() {
+    return this.cache.size;
+  }
+  /**
+   * Returns cache usage as a percentage.
+   * 
+   * @returns Usage percentage (0-100)
+   */
+  get usage() {
+    return this.cache.size / this.maxCacheSize * 100;
+  }
+}
+class UploadCacheError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "UploadCacheError";
+  }
+  code;
+  static {
+    __name(this, "UploadCacheError");
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DefaultUploadResumeCacheAdapter,
+  UploadCacheError
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cache/index.ts"],"sourcesContent":["/*\n * This file is part of the project by AGBOKOUDJO Franck.\n *\n * (c) AGBOKOUDJO Franck <internationaleswebservices@gmail.com>\n * Phone: +229 0167 25 18 86\n * LinkedIn: https://www.linkedin.com/in/internationales-web-apps-services-120520193/\n * Company: INTERNATIONALES WEB APPS & SERVICES\n *\n * For more information, please feel free to contact the author.\n */\n\nimport { ResumeData } from \"../types\"\n\n/**\n * Interface for caching upload resume data.\n * \n * This interface extends the base cache functionality to specifically\n * handle resume data for file uploads, allowing uploads to be paused\n * and resumed across browser sessions.\n * \n * \n * @example\n * ```typescript\n * const cache: UploadResumeCacheInterface = new LocalStorageUploadResumeCache();\n * \n * // Save progress\n * await cache.setItem('video.mp4', {\n *   uploadedChunks: 45,\n *   totalChunks: 100,\n *   lastBytePosition: 47185920\n * });\n * \n * // Resume later\n * const data = await cache.getItem('video.mp4');\n * console.log(`Resume from chunk ${data.uploadedChunks}`);\n * ```\n */\nexport interface UploadResumeCacheInterface {\n    /**\n     * Retrieves cached resume data for a specific upload.\n     * \n     * @param key - Unique identifier for the upload (typically filename or file hash)\n     * @returns Promise resolving to the cached resume data\n     * @throws {Error} If the key doesn't exist or data is corrupted\n     */\n    getItem(key: string): Promise<ResumeData>;\n\n    /**\n     * Stores resume data for an upload session.\n     * \n     * @param key - Unique identifier for the upload\n     * @param data - Resume data containing upload progress information\n     * @returns Promise that resolves when data is successfully cached\n     * @throws {Error} If storage quota is exceeded or data is invalid\n     */\n    setItem(key: string, data: ResumeData): Promise<void>;\n}\n\n/**\n * Default adapter for caching resume data during file uploads.\n * \n * Implements an in-memory storage strategy with secure serialization,\n * strict data validation, and comprehensive error handling.\n * \n * This implementation serves as a foundation for specialized adapters\n * (localStorage, IndexedDB, sessionStorage, etc.).\n * \n * @implements {UploadResumeCacheInterface}\n * \n * @example\n * ```typescript\n * const adapter = new DefaultUploadResumeCacheAdapter();\n * \n * // Save resume data\n * await adapter.setItem('upload-123', {\n *   fileId: 'file-abc',\n *   fileName: 'document.pdf',\n *   fileSize: 5242880,\n *   uploadedChunks: 12,\n *   lastChunkIndex: 11,\n *   lastBytePosition: 1258291,\n *   chunkSize: 1048576\n * });\n * \n * // Retrieve and resume\n * const resumeData = await adapter.getItem('upload-123');\n * console.log(`Resume from chunk ${resumeData.uploadedChunks}`);\n * \n * // Remove specific item\n * await adapter.removeItem('upload-123');\n * \n * // Clear all cache\n * await adapter.clear();\n * ```\n */\nexport class DefaultUploadResumeCacheAdapter implements UploadResumeCacheInterface {\n\n    private cache: Map<string, ResumeData> = new Map();\n    private readonly maxCacheSize: number = 100;\n\n    constructor() {\n        this.validateEnvironment();\n    }\n\n    /**\n     * Validates that the runtime environment is appropriate.\n     * \n     * @private\n     * @throws {UploadCacheError} If the environment is incompatible\n     */\n    private validateEnvironment(): void {\n        if (typeof window === 'undefined') {\n            console.warn(\n                '[UploadResumeCacheAdapter] Server-side execution detected. ' +\n                'Consider a server-compatible adapter for persistent storage.'\n            );\n        }\n    }\n\n    /**\n     * Validates resume data according to strict criteria.\n     * \n     * @private\n     * @param data - The data to validate\n     * @throws {UploadCacheError} If the data is invalid\n     */\n    private validateResumeData(data: ResumeData): void {\n        if (!data || typeof data !== 'object') {\n            throw new UploadCacheError(\n                'Resume data must be a valid object',\n                'INVALID_DATA'\n            );\n        }\n\n        // Validate required fields\n        const requiredFields: (keyof ResumeData)[] = [\n            'fileId',\n            'fileName',\n            'fileSize',\n            'uploadedChunks',\n            'lastChunkIndex',\n            'lastBytePosition',\n            'chunkSize'\n        ];\n\n        for (const field of requiredFields) {\n            if (!(field in data)) {\n                throw new UploadCacheError(\n                    `Required field '${field}' is missing`,\n                    'MISSING_FIELD'\n                );\n            }\n        }\n\n        // Validate types\n        if (typeof data.fileId !== 'string' || !data.fileId.trim()) {\n            throw new UploadCacheError(\n                'fileId must be a non-empty string',\n                'INVALID_FILE_ID'\n            );\n        }\n\n        if (typeof data.fileName !== 'string' || !data.fileName.trim()) {\n            throw new UploadCacheError(\n                'fileName must be a non-empty string',\n                'INVALID_FILE_NAME'\n            );\n        }\n\n        // Validate numbers\n        if (!Number.isFinite(data.fileSize) || data.fileSize <= 0) {\n            throw new UploadCacheError(\n                'fileSize must be a positive number',\n                'INVALID_FILE_SIZE'\n            );\n        }\n\n        if (!Number.isFinite(data.chunkSize) || data.chunkSize <= 0) {\n            throw new UploadCacheError(\n                'chunkSize must be a positive number',\n                'INVALID_CHUNK_SIZE'\n            );\n        }\n\n        if (!Number.isInteger(data.uploadedChunks) || data.uploadedChunks < 0) {\n            throw new UploadCacheError(\n                'uploadedChunks must be a non-negative integer',\n                'INVALID_UPLOADED_CHUNKS'\n            );\n        }\n\n        if (!Number.isInteger(data.lastChunkIndex) || data.lastChunkIndex < -1) {\n            throw new UploadCacheError(\n                'lastChunkIndex must be an integer >= -1',\n                'INVALID_LAST_CHUNK_INDEX'\n            );\n        }\n\n        if (!Number.isFinite(data.lastBytePosition) || data.lastBytePosition < 0) {\n            throw new UploadCacheError(\n                'lastBytePosition must be a non-negative number',\n                'INVALID_BYTE_POSITION'\n            );\n        }\n\n        // Validate logical consistency\n        if (data.uploadedChunks > 0 && data.lastBytePosition === 0) {\n            throw new UploadCacheError(\n                'lastBytePosition cannot be 0 if chunks have been uploaded',\n                'INCONSISTENT_DATA'\n            );\n        }\n\n        const expectedMaxChunks = Math.ceil(data.fileSize / data.chunkSize);\n        if (data.uploadedChunks > expectedMaxChunks) {\n            throw new UploadCacheError(\n                `uploadedChunks (${data.uploadedChunks}) exceeds maximum expected (${expectedMaxChunks})`,\n                'INCONSISTENT_DATA'\n            );\n        }\n    }\n\n    /**\n     * Retrieves resume data for a specific upload.\n     * \n     * @param key - Unique identifier for the upload\n     * @returns Promise resolved with the resume data\n     * @throws {UploadCacheError} If the key does not exist or data is corrupted\n     * \n     * @example\n     * ```typescript\n     * try {\n     *   const data = await adapter.getItem('upload-123');\n     *   console.log(`${data.uploadedChunks}/${Math.ceil(data.fileSize / data.chunkSize)} chunks`);\n     * } catch (error) {\n     *   console.error('Failed to retrieve data:', error.message);\n     * }\n     * ```\n     */\n    async getItem(key: string): Promise<ResumeData> {\n        return new Promise((resolve, reject) => {\n            try {\n                if (!key || typeof key !== 'string') {\n                    reject(new UploadCacheError(\n                        'Key must be a non-empty string',\n                        'INVALID_KEY'\n                    ));\n                    return;\n                }\n\n                const data = this.cache.get(key);\n\n                if (!data) {\n                    reject(new UploadCacheError(\n                        `Resume data for key '${key}' was not found`,\n                        'NOT_FOUND'\n                    ));\n                    return;\n                }\n\n                // Return a deep copy to prevent external mutations\n                resolve(JSON.parse(JSON.stringify(data)));\n            } catch (error) {\n                reject(new UploadCacheError(\n                    `Error retrieving data: ${error instanceof Error ? error.message : String(error)}`,\n                    'RETRIEVAL_ERROR'\n                ));\n            }\n        });\n    }\n\n    /**\n     * Stores resume data for an upload session.\n     * \n     * @param key - Unique identifier for the upload\n     * @param data - Resume data containing upload progress information\n     * @returns Promise resolved when data is successfully cached\n     * @throws {UploadCacheError} If quota is exceeded or data is invalid\n     * \n     * @example\n     * ```typescript\n     * try {\n     *   await adapter.setItem('upload-123', {\n     *     fileId: 'file-abc',\n     *     fileName: 'video.mp4',\n     *     fileSize: 10737418240,\n     *     uploadedChunks: 45,\n     *     lastChunkIndex: 44,\n     *     lastBytePosition: 47185920,\n     *     chunkSize: 1048576\n     *   });\n     *   console.log('Data successfully saved');\n     * } catch (error) {\n     *   console.error('Storage error:', error.message);\n     * }\n     * ```\n     */\n    async setItem(key: string, data: ResumeData): Promise<void> {\n        return new Promise((resolve, reject) => {\n            try {\n                if (!key || typeof key !== 'string') {\n                    reject(new UploadCacheError(\n                        'Key must be a non-empty string',\n                        'INVALID_KEY'\n                    ));\n                    return;\n                }\n\n                this.validateResumeData(data);\n\n                // Check cache limit\n                if (this.cache.size >= this.maxCacheSize && !this.cache.has(key)) {\n                    reject(new UploadCacheError(\n                        `Cache limit (${this.maxCacheSize} entries) has been reached. ` +\n                        'Remove obsolete entries or use an adapter with persistent storage.',\n                        'CACHE_LIMIT_EXCEEDED'\n                    ));\n                    return;\n                }\n\n                // Store a deep copy\n                this.cache.set(key, JSON.parse(JSON.stringify(data)));\n                resolve();\n            } catch (error) {\n                if (error instanceof UploadCacheError) {\n                    reject(error);\n                } else {\n                    reject(new UploadCacheError(\n                        `Error storing data: ${error instanceof Error ? error.message : String(error)}`,\n                        'STORAGE_ERROR'\n                    ));\n                }\n            }\n        });\n    }\n\n    /**\n     * Removes resume data for a specific upload.\n     * \n     * @param key - Unique identifier for the upload\n     * @returns Promise resolved after removal\n     * \n     * @example\n     * ```typescript\n     * await adapter.removeItem('upload-123');\n     * ```\n     */\n    async removeItem(key: string): Promise<void> {\n        return new Promise((resolve, reject) => {\n            try {\n                if (!key || typeof key !== 'string') {\n                    reject(new UploadCacheError(\n                        'Key must be a non-empty string',\n                        'INVALID_KEY'\n                    ));\n                    return;\n                }\n\n                this.cache.delete(key);\n                resolve();\n            } catch (error) {\n                reject(new UploadCacheError(\n                    `Error removing data: ${error instanceof Error ? error.message : String(error)}`,\n                    'DELETION_ERROR'\n                ));\n            }\n        });\n    }\n\n    /**\n     * Clears all cached resume data.\n     * \n     * @returns Promise resolved after complete cleanup\n     * \n     * @example\n     * ```typescript\n     * await adapter.clear();\n     * console.log('Cache cleared');\n     * ```\n     */\n    async clear(): Promise<void> {\n        return new Promise((resolve) => {\n            this.cache.clear();\n            resolve();\n        });\n    }\n\n    /**\n     * Returns the number of entries currently in cache.\n     * \n     * @returns Number of cache entries\n     */\n    get size(): number {\n        return this.cache.size;\n    }\n\n    /**\n     * Returns cache usage as a percentage.\n     * \n     * @returns Usage percentage (0-100)\n     */\n    get usage(): number {\n        return (this.cache.size / this.maxCacheSize) * 100;\n    }\n}\n\n/**\n * Custom error for upload cache operations.\n * \n * @example\n * ```typescript\n * throw new UploadCacheError('Resume data not found', 'NOT_FOUND');\n * ```\n */\nexport class UploadCacheError extends Error {\n    constructor(\n        message: string,\n        public readonly code: string\n    ) {\n        super(message);\n        this.name = 'UploadCacheError';\n    }\n}\n"],"mappings":"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","names":[]}