@wlindabla/file_uploader 1.0.0 → 2.0.1

package/dist/esm/chunk-PFALORWQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cache/index.ts"],"names":[],"mappings":"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","file":"chunk-PFALORWQ.js","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"]}