express-storage 1.0.0 → 1.1.3

package/dist/drivers/base.driver.d.ts

@@ -1,69 +1,170 @@
-import { IStorageDriver, FileUploadResult, PresignedUrlResult, StorageConfig } from '../types/storage.types.js';
+import { Readable } from 'stream';
+import { IStorageDriver, FileUploadResult, PresignedUrlResult, StorageConfig, BlobValidationOptions, BlobValidationResult, ListFilesResult, UploadOptions, DeleteResult } from '../types/storage.types.js';
 /**
- * Abstract base class for all storage drivers
+ * BaseStorageDriver - The foundation that all storage drivers build upon.
+ *
+ * This abstract class provides common functionality that every driver needs:
+ * filename generation, file validation, content reading, and result formatting.
+ *
+ * If you're building a custom driver, extend this class and implement the
+ * abstract methods. You'll get all the helper methods for free.
  */
 export declare abstract class BaseStorageDriver implements IStorageDriver {
     protected config: StorageConfig;
     constructor(config: StorageConfig);
     /**
-     * Upload a single file
+     * Builds the full storage path by combining the bucket path with the filename.
+     * For example: 'uploads' + 'photo.jpg' = 'uploads/photo.jpg'
      */
-    abstract upload(file: Express.Multer.File): Promise<FileUploadResult>;
+    protected buildFilePath(fileName: string): string;
     /**
-     * Upload multiple files
+     * Returns the configured bucket path, cleaned up and ready to use.
      */
-    uploadMultiple(files: Express.Multer.File[]): Promise<FileUploadResult[]>;
+    protected getBucketPath(): string;
     /**
-     * Generate upload URL (for presigned drivers)
+     * Uploads a single file. Each driver implements this differently.
      */
-    abstract generateUploadUrl(fileName: string): Promise<PresignedUrlResult>;
+    abstract upload(file: Express.Multer.File, options?: UploadOptions): Promise<FileUploadResult>;
     /**
-     * Generate view URL (for presigned drivers)
+     * Uploads multiple files with smart concurrency control.
+     * Processes up to 10 files at a time to balance speed and system resources.
      */
-    abstract generateViewUrl(fileName: string): Promise<PresignedUrlResult>;
+    uploadMultiple(files: Express.Multer.File[], options?: UploadOptions): Promise<FileUploadResult[]>;
     /**
-     * Generate multiple upload URLs
+     * Creates a presigned URL for uploading.
+     * Each cloud provider has its own way of doing this.
      */
-    generateMultipleUploadUrls(fileNames: string[]): Promise<PresignedUrlResult[]>;
+    abstract generateUploadUrl(fileName: string, contentType?: string, fileSize?: number): Promise<PresignedUrlResult>;
     /**
-     * Generate multiple view URLs
+     * Creates a presigned URL for viewing/downloading.
      */
-    generateMultipleViewUrls(fileNames: string[]): Promise<PresignedUrlResult[]>;
+    abstract generateViewUrl(fileName: string): Promise<PresignedUrlResult>;
     /**
-     * Delete a single file
+     * Deletes a file from storage.
      */
     abstract delete(fileName: string): Promise<boolean>;
     /**
-     * Delete multiple files
+     * Lists files with optional filtering and pagination.
+     */
+    abstract listFiles(prefix?: string, maxResults?: number, continuationToken?: string): Promise<ListFilesResult>;
+    /**
+     * Deletes multiple files with smart concurrency control.
+     * Returns detailed results so you know exactly what happened with each file.
      */
-    deleteMultiple(fileNames: string[]): Promise<boolean[]>;
+    deleteMultiple(fileNames: string[]): Promise<DeleteResult[]>;
     /**
-     * Generate unique filename with timestamp
+     * Creates a unique filename that won't collide with existing files.
+     * Format: {timestamp}_{random}_{original_name}.{ext}
      */
     protected generateFileName(originalName: string): string;
     /**
-     * Create success result
+     * Builds a success response for upload operations.
      */
     protected createSuccessResult(fileName: string, fileUrl?: string): FileUploadResult;
     /**
-     * Create error result
+     * Builds an error response for upload operations.
      */
     protected createErrorResult(error: string): FileUploadResult;
     /**
-     * Create presigned success result
+     * Builds a success response for presigned URL operations.
      */
     protected createPresignedSuccessResult(uploadUrl?: string, viewUrl?: string): PresignedUrlResult;
     /**
-     * Create presigned error result
+     * Builds an error response for presigned URL operations.
      */
     protected createPresignedErrorResult(error: string): PresignedUrlResult;
     /**
-     * Validate file before upload
+     * Validates a file before upload.
+     *
+     * Checks for common issues:
+     * - Missing file
+     * - No original name
+     * - No MIME type
+     * - Empty content
+     *
+     * Works with both Multer memory storage (file.buffer) and disk storage (file.path).
      */
     protected validateFile(file: Express.Multer.File): string[];
     /**
-     * Get presigned URL expiry time
+     * Reads the file content, whether it's in memory or on disk.
+     *
+     * Note: For disk storage, this reads the file but doesn't delete it.
+     * Call cleanupTempFile() afterward if you need to remove the temp file.
+     *
+     * @warning **MEMORY IMPLICATIONS**: This method loads the ENTIRE file into memory.
+     * For large files, this can cause memory exhaustion and application crashes.
+     *
+     * **ALWAYS call `shouldUseStreaming(file)` first** and use `getFileStream()`
+     * for files larger than 100MB. Example:
+     *
+     * ```typescript
+     * if (this.shouldUseStreaming(file)) {
+     *   return this.uploadWithStream(file);
+     * }
+     * const content = this.getFileContent(file); // Safe for smaller files
+     * ```
+     *
+     * Memory usage: A 1GB file will allocate ~1GB of heap memory.
+     * Node.js default heap limit is ~1.5GB, so large files WILL crash your app.
+     *
+     * @param file - The Multer file object
+     * @returns Buffer containing the entire file contents
+     * @throws Error if file has neither buffer nor path
+     */
+    protected getFileContent(file: Express.Multer.File): Buffer;
+    /**
+     * Returns a readable stream for the file content.
+     *
+     * Use this instead of getFileContent() for large files to avoid
+     * loading the entire file into memory. Particularly useful for
+     * files larger than 100MB.
+     *
+     * @param file - The Multer file object
+     * @returns A readable stream of the file content
+     */
+    protected getFileStream(file: Express.Multer.File): Readable;
+    /**
+     * Determines if a file should use streaming based on its size.
+     *
+     * Files larger than 100MB benefit from streaming to reduce memory usage.
+     *
+     * @param file - The Multer file object
+     * @returns true if the file should use streaming
+     */
+    protected shouldUseStreaming(file: Express.Multer.File): boolean;
+    /**
+     * Gets the file size, reading from disk if necessary.
+     *
+     * @param file - The Multer file object
+     * @returns The file size in bytes
+     */
+    protected getFileSize(file: Express.Multer.File): number;
+    /**
+     * Removes a temporary file created by Multer disk storage.
+     *
+     * Call this after a successful upload if you're using disk storage
+     * and want to clean up. Memory storage doesn't need this — the
+     * garbage collector handles cleanup automatically.
+     *
+     * @returns true if the file was deleted, false otherwise
+     */
+    cleanupTempFile(file: Express.Multer.File): boolean;
+    /**
+     * Returns how long presigned URLs should be valid (in seconds).
+     *
+     * Clamps the value to stay within cloud provider limits:
+     * - Minimum: 1 second
+     * - Maximum: 7 days (604800 seconds)
+     * - Default: 10 minutes (600 seconds)
      */
     protected getPresignedUrlExpiry(): number;
+    /**
+     * Confirms that an upload completed successfully.
+     *
+     * The default implementation just checks if the file exists.
+     * Azure overrides this to validate file properties since Azure
+     * doesn't enforce constraints at the presigned URL level.
+     */
+    validateAndConfirmUpload(reference: string, _options?: BlobValidationOptions): Promise<BlobValidationResult>;
 }
 //# sourceMappingURL=base.driver.d.ts.map

package/dist/drivers/base.driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/base.driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGhH;;GAEG;AACH,8BAAsB,iBAAkB,YAAW,cAAc;IAC/D,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEpB,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAErE;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAkB/E;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAEzE;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAEvE;;OAEG;IACG,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkBpF;;OAEG;IACG,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkBlF;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAEnD;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAe7D;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAIxD;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAWnF;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAO5D;;OAEG;IACH,SAAS,CAAC,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB;IAahG;;OAEG;IACH,SAAS,CAAC,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB;IAOvE;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE;IAuB3D;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,MAAM;CAG1C"}
+{"version":3,"file":"base.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/base.driver.ts"],"names":[],"mappings":"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"}

package/dist/drivers/base.driver.js

@@ -1,92 +1,94 @@
-import { generateUniqueFileName } from '../utils/file.utils.js';
+import fs from 'fs';
+import { Readable } from 'stream';
+import { generateUniqueFileName, withConcurrencyLimit } from '../utils/file.utils.js';
+/** Threshold for using streaming uploads (100MB) */
+const STREAM_THRESHOLD = 100 * 1024 * 1024;
 /**
- * Abstract base class for all storage drivers
+ * BaseStorageDriver - The foundation that all storage drivers build upon.
+ *
+ * This abstract class provides common functionality that every driver needs:
+ * filename generation, file validation, content reading, and result formatting.
+ *
+ * If you're building a custom driver, extend this class and implement the
+ * abstract methods. You'll get all the helper methods for free.
  */
 export class BaseStorageDriver {
     constructor(config) {
         this.config = config;
     }
     /**
-     * Upload multiple files
+     * Builds the full storage path by combining the bucket path with the filename.
+     * For example: 'uploads' + 'photo.jpg' = 'uploads/photo.jpg'
      */
-    async uploadMultiple(files) {
-        const results = [];
-        for (const file of files) {
-            try {
-                const result = await this.upload(file);
-                results.push(result);
-            }
-            catch (error) {
-                results.push({
-                    success: false,
-                    error: error instanceof Error ? error.message : 'Upload failed',
-                });
-            }
+    buildFilePath(fileName) {
+        const bucketPath = this.config.bucketPath?.trim();
+        if (!bucketPath || bucketPath === '' || bucketPath === '/') {
+            return fileName;
         }
-        return results;
+        const normalizedPath = bucketPath.replace(/^\/+|\/+$/g, '');
+        return `${normalizedPath}/${fileName}`;
     }
     /**
-     * Generate multiple upload URLs
+     * Returns the configured bucket path, cleaned up and ready to use.
      */
-    async generateMultipleUploadUrls(fileNames) {
-        const results = [];
-        for (const fileName of fileNames) {
-            try {
-                const result = await this.generateUploadUrl(fileName);
-                results.push(result);
-            }
-            catch (error) {
-                results.push({
-                    success: false,
-                    error: error instanceof Error ? error.message : 'Failed to generate upload URL',
-                });
-            }
-        }
-        return results;
+    getBucketPath() {
+        return this.config.bucketPath?.trim()?.replace(/^\/+|\/+$/g, '') || '';
     }
     /**
-     * Generate multiple view URLs
+     * Uploads multiple files with smart concurrency control.
+     * Processes up to 10 files at a time to balance speed and system resources.
      */
-    async generateMultipleViewUrls(fileNames) {
-        const results = [];
-        for (const fileName of fileNames) {
+    async uploadMultiple(files, options) {
+        if (!files || files.length === 0) {
+            return [];
+        }
+        return withConcurrencyLimit(files, async (file) => {
             try {
-                const result = await this.generateViewUrl(fileName);
-                results.push(result);
+                return await this.upload(file, options);
             }
             catch (error) {
-                results.push({
+                return {
                     success: false,
-                    error: error instanceof Error ? error.message : 'Failed to generate view URL',
-                });
+                    error: error instanceof Error ? error.message : 'Failed to upload file',
+                };
             }
-        }
-        return results;
+        }, { maxConcurrent: 10 });
     }
     /**
-     * Delete multiple files
+     * Deletes multiple files with smart concurrency control.
+     * Returns detailed results so you know exactly what happened with each file.
      */
     async deleteMultiple(fileNames) {
-        const results = [];
-        for (const fileName of fileNames) {
+        if (!fileNames || fileNames.length === 0) {
+            return [];
+        }
+        return withConcurrencyLimit(fileNames, async (fileName) => {
             try {
-                const result = await this.delete(fileName);
-                results.push(result);
+                const success = await this.delete(fileName);
+                const result = { success, fileName };
+                if (!success) {
+                    result.error = 'File not found or already deleted';
+                }
+                return result;
             }
             catch (error) {
-                results.push(false);
+                return {
+                    success: false,
+                    fileName,
+                    error: error instanceof Error ? error.message : 'Failed to delete file',
+                };
             }
-        }
-        return results;
+        }, { maxConcurrent: 10 });
     }
     /**
-     * Generate unique filename with timestamp
+     * Creates a unique filename that won't collide with existing files.
+     * Format: {timestamp}_{random}_{original_name}.{ext}
      */
     generateFileName(originalName) {
         return generateUniqueFileName(originalName);
     }
     /**
-     * Create success result
+     * Builds a success response for upload operations.
      */
     createSuccessResult(fileName, fileUrl) {
         const result = {
@@ -99,7 +101,7 @@ export class BaseStorageDriver {
         return result;
     }
     /**
-     * Create error result
+     * Builds an error response for upload operations.
      */
     createErrorResult(error) {
         return {
@@ -108,7 +110,7 @@ export class BaseStorageDriver {
         };
     }
     /**
-     * Create presigned success result
+     * Builds a success response for presigned URL operations.
      */
     createPresignedSuccessResult(uploadUrl, viewUrl) {
         const result = {
@@ -123,7 +125,7 @@ export class BaseStorageDriver {
         return result;
     }
     /**
-     * Create presigned error result
+     * Builds an error response for presigned URL operations.
      */
     createPresignedErrorResult(error) {
         return {
@@ -132,7 +134,15 @@ export class BaseStorageDriver {
         };
     }
     /**
-     * Validate file before upload
+     * Validates a file before upload.
+     *
+     * Checks for common issues:
+     * - Missing file
+     * - No original name
+     * - No MIME type
+     * - Empty content
+     *
+     * Works with both Multer memory storage (file.buffer) and disk storage (file.path).
      */
     validateFile(file) {
         const errors = [];
@@ -146,16 +156,192 @@ export class BaseStorageDriver {
         if (!file.mimetype) {
             errors.push('File must have a MIME type');
         }
-        if (!file.buffer || file.buffer.length === 0) {
-            errors.push('File buffer is empty');
+        // Check for file content (could be in memory or on disk)
+        const hasBuffer = (file.buffer?.length ?? 0) > 0;
+        const hasPath = typeof file.path === 'string' && file.path.length > 0;
+        const hasEmptyBuffer = file.buffer !== null && file.buffer !== undefined && file.buffer.length === 0;
+        if (hasEmptyBuffer && !hasPath) {
+            errors.push('File is empty (0 bytes)');
+        }
+        else if (!hasBuffer && !hasPath) {
+            errors.push('File must have either buffer (memory storage) or path (disk storage)');
+        }
+        // For disk storage, verify the file exists and isn't empty
+        if (hasPath && !hasBuffer) {
+            try {
+                const stats = fs.statSync(file.path);
+                if (stats.size === 0) {
+                    errors.push('File is empty (0 bytes)');
+                }
+                if (!file.size || file.size === 0) {
+                    file.size = stats.size;
+                }
+            }
+            catch {
+                errors.push('Cannot read file from disk storage path');
+            }
         }
         return errors;
     }
     /**
-     * Get presigned URL expiry time
+     * Reads the file content, whether it's in memory or on disk.
+     *
+     * Note: For disk storage, this reads the file but doesn't delete it.
+     * Call cleanupTempFile() afterward if you need to remove the temp file.
+     *
+     * @warning **MEMORY IMPLICATIONS**: This method loads the ENTIRE file into memory.
+     * For large files, this can cause memory exhaustion and application crashes.
+     *
+     * **ALWAYS call `shouldUseStreaming(file)` first** and use `getFileStream()`
+     * for files larger than 100MB. Example:
+     *
+     * ```typescript
+     * if (this.shouldUseStreaming(file)) {
+     *   return this.uploadWithStream(file);
+     * }
+     * const content = this.getFileContent(file); // Safe for smaller files
+     * ```
+     *
+     * Memory usage: A 1GB file will allocate ~1GB of heap memory.
+     * Node.js default heap limit is ~1.5GB, so large files WILL crash your app.
+     *
+     * @param file - The Multer file object
+     * @returns Buffer containing the entire file contents
+     * @throws Error if file has neither buffer nor path
+     */
+    getFileContent(file) {
+        if ((file.buffer?.length ?? 0) > 0) {
+            return file.buffer;
+        }
+        if (file.path) {
+            return fs.readFileSync(file.path);
+        }
+        throw new Error('File has neither buffer nor path - cannot read content');
+    }
+    /**
+     * Returns a readable stream for the file content.
+     *
+     * Use this instead of getFileContent() for large files to avoid
+     * loading the entire file into memory. Particularly useful for
+     * files larger than 100MB.
+     *
+     * @param file - The Multer file object
+     * @returns A readable stream of the file content
+     */
+    getFileStream(file) {
+        if ((file.buffer?.length ?? 0) > 0) {
+            return Readable.from(file.buffer);
+        }
+        if (file.path) {
+            return fs.createReadStream(file.path);
+        }
+        throw new Error('File has neither buffer nor path - cannot create stream');
+    }
+    /**
+     * Determines if a file should use streaming based on its size.
+     *
+     * Files larger than 100MB benefit from streaming to reduce memory usage.
+     *
+     * @param file - The Multer file object
+     * @returns true if the file should use streaming
+     */
+    shouldUseStreaming(file) {
+        const size = file.size || 0;
+        return size > STREAM_THRESHOLD;
+    }
+    /**
+     * Gets the file size, reading from disk if necessary.
+     *
+     * @param file - The Multer file object
+     * @returns The file size in bytes
+     */
+    getFileSize(file) {
+        if (file.size && file.size > 0) {
+            return file.size;
+        }
+        if (file.buffer?.length) {
+            return file.buffer.length;
+        }
+        if (file.path) {
+            try {
+                const stats = fs.statSync(file.path);
+                return stats.size;
+            }
+            catch {
+                return 0;
+            }
+        }
+        return 0;
+    }
+    /**
+     * Removes a temporary file created by Multer disk storage.
+     *
+     * Call this after a successful upload if you're using disk storage
+     * and want to clean up. Memory storage doesn't need this — the
+     * garbage collector handles cleanup automatically.
+     *
+     * @returns true if the file was deleted, false otherwise
+     */
+    cleanupTempFile(file) {
+        if (file.path && fs.existsSync(file.path)) {
+            try {
+                fs.unlinkSync(file.path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        return false;
+    }
+    /**
+     * Returns how long presigned URLs should be valid (in seconds).
+     *
+     * Clamps the value to stay within cloud provider limits:
+     * - Minimum: 1 second
+     * - Maximum: 7 days (604800 seconds)
+     * - Default: 10 minutes (600 seconds)
      */
     getPresignedUrlExpiry() {
-        return this.config.presignedUrlExpiry || 600; // Default 10 minutes
+        const MAX_EXPIRY = 604800;
+        const MIN_EXPIRY = 1;
+        const DEFAULT_EXPIRY = 600;
+        const expiry = this.config.presignedUrlExpiry;
+        if (expiry === undefined || expiry === null || Number.isNaN(expiry)) {
+            return DEFAULT_EXPIRY;
+        }
+        if (expiry < MIN_EXPIRY) {
+            return MIN_EXPIRY;
+        }
+        if (expiry > MAX_EXPIRY) {
+            return MAX_EXPIRY;
+        }
+        return expiry;
+    }
+    /**
+     * Confirms that an upload completed successfully.
+     *
+     * The default implementation just checks if the file exists.
+     * Azure overrides this to validate file properties since Azure
+     * doesn't enforce constraints at the presigned URL level.
+     */
+    async validateAndConfirmUpload(reference, _options) {
+        const viewResult = await this.generateViewUrl(reference);
+        if (viewResult.success) {
+            const result = {
+                success: true,
+                reference,
+                expiresIn: this.getPresignedUrlExpiry(),
+            };
+            if (viewResult.viewUrl) {
+                result.viewUrl = viewResult.viewUrl;
+            }
+            return result;
+        }
+        return {
+            success: false,
+            error: viewResult.error || 'File not found',
+        };
     }
 }
 //# sourceMappingURL=base.driver.js.map

package/dist/drivers/base.driver.js.map

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