express-storage 1.0.0 → 1.1.2

package/dist/utils/file.utils.js

@@ -1,35 +1,97 @@
 import path from 'path';
 import fs from 'fs';
+import crypto from 'crypto';
 /**
- * Generate unique filename with unix timestamp
+ * Creates a unique filename that won't collide with existing files.
+ *
+ * Format: {timestamp}_{random}_{sanitized_name}.{extension}
+ * Example: 1769104576000_a1b2c3d4e5_my_image.jpeg
+ *
+ * The random part uses crypto.randomBytes() for extra collision resistance
+ * in high-throughput scenarios.
  */
 export function generateUniqueFileName(originalName) {
-    const timestamp = Math.floor(Date.now() / 1000); // Unix timestamp
-    const extension = path.extname(originalName);
-    const sanitizedName = sanitizeFileName(originalName);
-    const baseName = path.basename(sanitizedName, extension);
-    return `${timestamp}_${baseName}${extension}`;
+    const timestamp = Date.now();
+    const randomSuffix = crypto.randomBytes(6).toString('hex').substring(0, 10);
+    // Handle dotfiles like .gitignore or .env (they have no extension)
+    let extension;
+    let baseName;
+    if (originalName.startsWith('.') && !originalName.slice(1).includes('.')) {
+        extension = '';
+        baseName = sanitizeFileName(originalName);
+    }
+    else {
+        extension = path.extname(originalName).toLowerCase();
+        const sanitizedName = sanitizeFileName(originalName);
+        baseName = path.basename(sanitizedName, path.extname(sanitizedName));
+    }
+    if (!baseName || baseName.trim() === '') {
+        baseName = 'file';
+    }
+    return `${timestamp}_${randomSuffix}_${baseName}${extension}`;
 }
 /**
- * Sanitize filename to prevent security issues
+ * Makes a filename safe for storage by removing problematic characters.
+ *
+ * Replaces anything that isn't alphanumeric, a dot, or a hyphen with underscores.
+ * This ensures compatibility with all filesystems and cloud storage providers.
+ *
+ * Note: Unicode characters like Chinese or emojis become underscores.
+ * If you need to preserve these, consider using your own sanitization function.
  */
 export function sanitizeFileName(fileName) {
-    return fileName
-        .replace(/[^a-zA-Z0-9.-]/g, '_') // Replace special characters with underscore
-        .replace(/_{2,}/g, '_') // Replace multiple underscores with single
-        .replace(/^_+|_+$/g, ''); // Remove leading/trailing underscores
+    const sanitized = fileName
+        .normalize('NFC')
+        .replace(/[^a-zA-Z0-9.-]/g, '_')
+        .replace(/_{2,}/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return sanitized || 'file';
 }
 /**
- * Create month-based directory path
+ * Checks if a filename is safe to use.
+ *
+ * Rejects:
+ * - Empty filenames
+ * - Filenames over 255 characters
+ * - Path traversal attempts (../, /, \)
+ * - Null bytes
+ *
+ * Returns an error message if invalid, null if OK.
+ */
+export function validateFileName(fileName) {
+    if (!fileName || typeof fileName !== 'string') {
+        return 'Filename is required';
+    }
+    const trimmed = fileName.trim();
+    if (trimmed.length === 0) {
+        return 'Filename cannot be empty';
+    }
+    if (trimmed.length > 255) {
+        return 'Filename is too long (max 255 characters)';
+    }
+    if (trimmed.includes('..') || trimmed.includes('/') || trimmed.includes('\\')) {
+        return 'Filename cannot contain path separators or traversal sequences';
+    }
+    if (trimmed.includes('\0')) {
+        return 'Filename cannot contain null bytes';
+    }
+    return null;
+}
+/**
+ * Creates a date-based folder path: YYYY/MM
+ *
+ * Uses UTC to keep things consistent across timezones.
+ * Example: For January 2026 -> 'uploads/2026/01'
  */
 export function createMonthBasedPath(basePath) {
     const now = new Date();
-    const month = now.toLocaleString('en', { month: 'long' }).toLowerCase();
-    const year = now.getFullYear();
-    return path.join(basePath, month, year.toString());
+    const year = now.getUTCFullYear();
+    const month = String(now.getUTCMonth() + 1).padStart(2, '0');
+    return path.join(basePath, year.toString(), month);
 }
 /**
- * Ensure directory exists, create if it doesn't
+ * Creates a directory if it doesn't exist.
+ * Also creates any parent directories needed (recursive).
  */
 export function ensureDirectoryExists(dirPath) {
     if (!fs.existsSync(dirPath)) {
@@ -37,48 +99,72 @@ export function ensureDirectoryExists(dirPath) {
     }
 }
 /**
- * Get file size in human readable format
+ * Converts bytes to a human-readable string.
+ *
+ * Examples:
+ * - 1024 -> "1 KB"
+ * - 1048576 -> "1 MB"
+ * - 0 -> "0 Bytes"
  */
 export function formatFileSize(bytes) {
     const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
-    if (bytes === 0)
+    if (typeof bytes !== 'number' || Number.isNaN(bytes)) {
+        return 'Invalid size';
+    }
+    if (!Number.isFinite(bytes)) {
+        return bytes > 0 ? 'Infinite' : 'Invalid size';
+    }
+    if (bytes < 0) {
+        return 'Invalid size (negative)';
+    }
+    if (bytes === 0) {
         return '0 Bytes';
-    const i = Math.floor(Math.log(bytes) / Math.log(1024));
-    return Math.round(bytes / Math.pow(1024, i) * 100) / 100 + ' ' + sizes[i];
+    }
+    let i = 0;
+    let size = bytes;
+    while (size >= 1024 && i < sizes.length - 1) {
+        size /= 1024;
+        i++;
+    }
+    return Math.round(size * 100) / 100 + ' ' + sizes[i];
 }
 /**
- * Validate file size
+ * Checks if a file size is within the allowed limit.
  */
 export function validateFileSize(fileSize, maxSize) {
     return fileSize <= maxSize;
 }
 /**
- * Validate file type
+ * Checks if a MIME type is in the allowed list.
  */
 export function validateFileType(mimeType, allowedTypes) {
     return allowedTypes.includes(mimeType);
 }
 /**
- * Create relative URL for local files
- */
-export function createLocalFileUrl(filePath, baseUrl = '') {
-    const relativePath = filePath.replace(/^public\//, '');
-    return `${baseUrl}/${relativePath}`.replace(/\/+/g, '/');
-}
-/**
- * Get file extension from filename
+ * Extracts the file extension (lowercase, includes the dot).
+ *
+ * Examples:
+ * - 'photo.jpg' -> '.jpg'
+ * - '.gitignore' -> '' (dotfiles have no extension)
+ * - 'archive.tar.gz' -> '.gz' (only the last extension)
  */
 export function getFileExtension(fileName) {
+    if (!fileName)
+        return '';
+    // Dotfiles like .gitignore don't have extensions
+    if (fileName.startsWith('.') && !fileName.slice(1).includes('.')) {
+        return '';
+    }
     return path.extname(fileName).toLowerCase();
 }
 /**
- * Check if file is an image
+ * Checks if a MIME type indicates an image.
  */
 export function isImageFile(mimeType) {
     return mimeType.startsWith('image/');
 }
 /**
- * Check if file is a document
+ * Checks if a MIME type indicates a document (PDF, Word, Excel, etc.).
  */
 export function isDocumentFile(mimeType) {
     const documentTypes = [
@@ -92,4 +178,101 @@ export function isDocumentFile(mimeType) {
     ];
     return documentTypes.includes(mimeType);
 }
+/**
+ * Retries an async operation with exponential backoff.
+ *
+ * Great for cloud operations that might fail due to network blips
+ * or rate limiting.
+ *
+ * @example
+ * // Retry up to 3 times with increasing delays
+ * const result = await withRetry(() => storage.uploadFile(file));
+ *
+ * // More aggressive retry strategy
+ * const result = await withRetry(() => fetchData(), {
+ *   maxAttempts: 5,
+ *   baseDelay: 500
+ * });
+ */
+export async function withRetry(operation, options = {}) {
+    const { maxAttempts = 3, baseDelay = 1000, maxDelay = 10000, exponentialBackoff = true, } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < maxAttempts) {
+                const delay = exponentialBackoff
+                    ? Math.min(baseDelay * Math.pow(2, attempt - 1), maxDelay)
+                    : baseDelay;
+                await sleep(delay);
+            }
+        }
+    }
+    throw lastError || new Error(`Operation failed after ${maxAttempts} attempts`);
+}
+/**
+ * Pauses execution for the specified number of milliseconds.
+ */
+export function sleep(ms) {
+    return new Promise(resolve => globalThis.setTimeout(resolve, ms));
+}
+/**
+ * Processes an array with a concurrency limit.
+ *
+ * Prevents overwhelming APIs or running out of resources by limiting
+ * how many operations run at once.
+ *
+ * Implementation uses pre-assigned chunk-based processing to avoid any
+ * potential race conditions with shared index counters. Each worker gets
+ * its own set of indices to process.
+ *
+ * Note: The input array is snapshotted at the start to prevent issues
+ * if the caller modifies it during processing.
+ *
+ * @example
+ * // Upload 100 files, but only 10 at a time
+ * const results = await withConcurrencyLimit(
+ *   files,
+ *   (file) => uploadFile(file),
+ *   { maxConcurrent: 10 }
+ * );
+ */
+export async function withConcurrencyLimit(items, operation, options = {}) {
+    const { maxConcurrent = 10 } = options;
+    if (items.length === 0) {
+        return [];
+    }
+    // Snapshot the array to prevent issues if caller modifies it during processing
+    const itemsCopy = [...items];
+    const itemCount = itemsCopy.length;
+    // For small batches, just process everything at once
+    if (itemCount <= maxConcurrent) {
+        return Promise.all(itemsCopy.map((item, index) => operation(item, index)));
+    }
+    const results = new Array(itemCount);
+    const workerCount = Math.min(maxConcurrent, itemCount);
+    // Pre-assign indices to each worker to avoid any race conditions
+    // Each worker gets a dedicated set of indices: worker 0 gets [0, workerCount, 2*workerCount, ...],
+    // worker 1 gets [1, workerCount+1, 2*workerCount+1, ...], etc.
+    const createWorker = (workerId) => {
+        return (async () => {
+            for (let index = workerId; index < itemCount; index += workerCount) {
+                const item = itemsCopy[index];
+                if (item !== undefined) {
+                    results[index] = await operation(item, index);
+                }
+            }
+        })();
+    };
+    // Start all workers with their pre-assigned index ranges
+    const workers = [];
+    for (let i = 0; i < workerCount; i++) {
+        workers.push(createWorker(i));
+    }
+    await Promise.all(workers);
+    return results;
+}
 //# sourceMappingURL=file.utils.js.map

package/dist/utils/file.utils.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "express-storage",
-  "version": "1.0.0",
-  "description": "A simple and powerful file upload and storage management package for Express.js applications. Supports multiple storage drivers including S3, GCS, OCI, and local storage with presigned URL support.",
+  "version": "1.1.2",
+  "description": "Secure, unified file upload and cloud storage management for Express.js. One API for AWS S3, Google Cloud Storage, Azure Blob Storage, and local disk. Built-in security with path traversal prevention, file validation, presigned URLs, and automatic filename sanitization. Switch storage providers with zero code changes — just update your environment variables.",
   "homepage": "https://github.com/th3hero/express-storage#readme",
   "bugs": {
     "url": "https://github.com/th3hero/express-storage/issues"
@@ -30,26 +30,48 @@
     "express",
     "file-upload",
     "storage",
+    "upload",
+    "file-storage",
+    "cloud-storage",
     "s3",
+    "aws-s3",
+    "amazon-s3",
     "gcs",
-    "oci",
+    "google-cloud-storage",
+    "azure",
+    "azure-blob",
+    "azure-blob-storage",
+    "blob-storage",
     "presigned-url",
-    "typescript",
+    "presigned-upload",
+    "direct-upload",
+    "secure-upload",
+    "file-validation",
     "multer",
-    "cloud-storage"
+    "multer-storage",
+    "typescript",
+    "nodejs",
+    "expressjs",
+    "file-manager",
+    "upload-manager",
+    "storage-driver",
+    "multi-cloud",
+    "hybrid-cloud",
+    "file-security",
+    "upload-security"
   ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
     "format": "prettier --write src/**/*.ts",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "peerDependencies": {
     "express": "^4.21.2"
@@ -57,26 +79,28 @@
   "engines": {
     "node": ">=16.0.0"
   },
-  "devDependencies": {
-    "@types/express": "^5.0.3",
-    "@types/jest": "^30.0.0",
-    "@types/multer": "^2.0.0",
-    "@types/node": "^24.1.0",
-    "@typescript-eslint/eslint-plugin": "^8.38.0",
-    "@typescript-eslint/parser": "^8.38.0",
-    "eslint": "^9.32.0",
-    "jest": "^30.0.5",
-    "prettier": "^3.6.2",
-    "ts-jest": "^29.4.0",
-    "typescript": "^5.8.3"
-  },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.856.0",
-    "@aws-sdk/s3-request-presigner": "^3.856.0",
-    "@google-cloud/storage": "^7.16.0",
-    "dotenv": "^17.2.1",
+    "@aws-sdk/client-s3": "^3.975.0",
+    "@aws-sdk/lib-storage": "^3.975.0",
+    "@aws-sdk/s3-request-presigner": "^3.975.0",
+    "@azure/identity": "^4.13.0",
+    "@azure/storage-blob": "^12.30.0",
+    "@google-cloud/storage": "^7.18.0",
+    "dotenv": "^17.2.3",
     "multer": "^2.0.2",
-    "oci-sdk": "^2.114.0",
     "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^25.0.10",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.39.2",
+    "memfs": "^4.56.10",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }

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

@@ -1,37 +0,0 @@
-import { BaseStorageDriver } from './base.driver.js';
-import { FileUploadResult, PresignedUrlResult } from '../types/storage.types.js';
-/**
- * Oracle Cloud Infrastructure storage driver (placeholder implementation)
- */
-export declare class OCIStorageDriver extends BaseStorageDriver {
-    private bucketName;
-    private region;
-    constructor(config: any);
-    /**
-     * Upload file to OCI (placeholder)
-     */
-    upload(file: Express.Multer.File): Promise<FileUploadResult>;
-    /**
-     * Generate presigned upload URL (placeholder)
-     */
-    generateUploadUrl(_fileName: string): Promise<PresignedUrlResult>;
-    /**
-     * Generate presigned view URL (placeholder)
-     */
-    generateViewUrl(_fileName: string): Promise<PresignedUrlResult>;
-    /**
-     * Delete file from OCI (placeholder)
-     */
-    delete(_fileName: string): Promise<boolean>;
-}
-/**
- * Oracle Cloud Infrastructure presigned driver
- */
-export declare class OCIPresignedStorageDriver extends OCIStorageDriver {
-    constructor(config: any);
-    /**
-     * Override upload to return presigned URL instead of direct upload
-     */
-    upload(file: Express.Multer.File): Promise<FileUploadResult>;
-}
-//# sourceMappingURL=oci.driver.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"oci.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/oci.driver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEjF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,GAAG;IAOvB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsBlE;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIvE;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIrE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAIlD;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,MAAM,EAAE,GAAG;IAIvB;;OAEG;IACY,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAyB5E"}

package/dist/drivers/oci.driver.js

@@ -1,84 +0,0 @@
-// OCI SDK imports - simplified for now
-// Note: OCI SDK structure may vary, this is a placeholder implementation
-import { BaseStorageDriver } from './base.driver.js';
-/**
- * Oracle Cloud Infrastructure storage driver (placeholder implementation)
- */
-export class OCIStorageDriver extends BaseStorageDriver {
-    constructor(config) {
-        super(config);
-        this.bucketName = config.bucketName;
-        this.region = config.ociRegion;
-    }
-    /**
-     * Upload file to OCI (placeholder)
-     */
-    async upload(file) {
-        try {
-            // Validate file
-            const validationErrors = this.validateFile(file);
-            if (validationErrors.length > 0) {
-                return this.createErrorResult(validationErrors.join(', '));
-            }
-            // Generate unique filename
-            const fileName = this.generateFileName(file.originalname);
-            // Placeholder implementation
-            const fileUrl = `https://objectstorage.${this.region}.oraclecloud.com/b/${this.bucketName}/o/${fileName}`;
-            return this.createSuccessResult(fileName, fileUrl);
-        }
-        catch (error) {
-            return this.createErrorResult(error instanceof Error ? error.message : 'Failed to upload file to OCI');
-        }
-    }
-    /**
-     * Generate presigned upload URL (placeholder)
-     */
-    async generateUploadUrl(_fileName) {
-        return this.createPresignedErrorResult('OCI presigned URLs not implemented yet');
-    }
-    /**
-     * Generate presigned view URL (placeholder)
-     */
-    async generateViewUrl(_fileName) {
-        return this.createPresignedErrorResult('OCI presigned URLs not implemented yet');
-    }
-    /**
-     * Delete file from OCI (placeholder)
-     */
-    async delete(_fileName) {
-        // Placeholder implementation
-        return true;
-    }
-}
-/**
- * Oracle Cloud Infrastructure presigned driver
- */
-export class OCIPresignedStorageDriver extends OCIStorageDriver {
-    constructor(config) {
-        super(config);
-    }
-    /**
-     * Override upload to return presigned URL instead of direct upload
-     */
-    async upload(file) {
-        try {
-            // Validate file
-            const validationErrors = this.validateFile(file);
-            if (validationErrors.length > 0) {
-                return this.createErrorResult(validationErrors.join(', '));
-            }
-            // Generate unique filename
-            const fileName = this.generateFileName(file.originalname);
-            // Generate presigned upload URL
-            const presignedResult = await this.generateUploadUrl(fileName);
-            if (!presignedResult.success) {
-                return this.createErrorResult(presignedResult.error || 'Failed to generate presigned URL');
-            }
-            return this.createSuccessResult(fileName, presignedResult.uploadUrl);
-        }
-        catch (error) {
-            return this.createErrorResult(error instanceof Error ? error.message : 'Failed to generate presigned URL');
-        }
-    }
-}
-//# sourceMappingURL=oci.driver.js.map

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

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