express-storage 1.0.0 → 1.1.3

package/dist/factory/driver.factory.d.ts

@@ -1,55 +1,61 @@
 import { StorageConfig, IStorageDriver } from '../types/storage.types.js';
 /**
- * Factory class for creating storage drivers
+ * StorageDriverFactory - Creates and caches storage driver instances.
+ *
+ * Drivers are cached to avoid recreating connections for the same configuration.
+ * The cache is limited to 100 drivers to prevent memory issues in long-running apps.
+ *
+ * When the cache is full, the least recently used driver gets evicted.
  */
 export declare class StorageDriverFactory {
     private static drivers;
     /**
-     * Create and return a storage driver based on configuration
+     * Gets or creates a driver for the given configuration.
+     *
+     * If a driver for this exact configuration already exists, it's reused.
+     * Otherwise, a new driver is created and cached.
      */
     static createDriver(config: StorageConfig): IStorageDriver;
     /**
-     * Create a new driver instance
+     * Removes the oldest (least recently accessed) driver from the cache.
      */
-    private static createNewDriver;
-    /**
-     * Create S3 driver
-     */
-    private static createS3Driver;
-    /**
-     * Create S3 presigned driver
-     */
-    private static createS3PresignedDriver;
-    /**
-     * Create GCS driver
-     */
-    private static createGCSDriver;
-    /**
-     * Create GCS presigned driver
-     */
-    private static createGCSPresignedDriver;
+    private static evictLRU;
     /**
-     * Create OCI driver
+     * Creates a new driver instance based on the config's driver type.
      */
-    private static createOCIDriver;
+    private static createNewDriver;
     /**
-     * Create OCI presigned driver
+     * Creates a fingerprint of a string for cache key comparison.
+     * Uses triple hash approach (length + two FNV-1a hashes + checksum) for maximum collision resistance.
+     *
+     * The triple hash approach with length and checksum significantly reduces collision probability:
+     * - Single 32-bit hash: ~77k items for 50% collision probability
+     * - This approach: effectively ~128+ bits of entropy, negligible collision probability
+     *
+     * For credentials, we also include a prefix checksum to detect similar keys early.
      */
-    private static createOCIPresignedDriver;
+    private static secureHash;
     /**
-     * Generate unique key for driver caching
+     * Generates a unique cache key for a configuration.
+     * Includes all properties that affect driver behavior.
      */
     private static getDriverKey;
     /**
-     * Clear cached drivers
+     * Clears all cached drivers.
+     * Useful in tests or when you've rotated credentials.
      */
     static clearCache(): void;
     /**
-     * Get cached driver count
+     * Returns the number of cached drivers.
+     */
+    static getCacheSize(): number;
+    /**
+     * Removes a specific driver from the cache.
+     * Useful when credentials have changed for a specific configuration.
      */
-    static getCachedDriverCount(): number;
+    static removeFromCache(config: StorageConfig): boolean;
     /**
-     * Get available drivers
+     * Returns a list of all supported driver types.
      */
     static getAvailableDrivers(): string[];
 }

package/dist/factory/driver.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.factory.d.ts","sourceRoot":"","sources":["../../src/factory/driver.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAM1E;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,OAAO,CAA0C;IAEhE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc;IAiB1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA4B9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAItC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAIvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAIvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM;IAIrC;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,MAAM,EAAE;CAWvC"}
+{"version":3,"file":"driver.factory.d.ts","sourceRoot":"","sources":["../../src/factory/driver.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAa1E;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAsC;IAE5D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc;IAuB1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IAgBvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAqB9B;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAmCzB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAsB3B;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM;IAI7B;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAKtD;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,MAAM,EAAE;CAWvC"}

package/dist/factory/driver.factory.js

@@ -1,105 +1,165 @@
 import { LocalStorageDriver } from '../drivers/local.driver.js';
 import { S3StorageDriver, S3PresignedStorageDriver } from '../drivers/s3.driver.js';
 import { GCSStorageDriver, GCSPresignedStorageDriver } from '../drivers/gcs.driver.js';
-import { OCIStorageDriver, OCIPresignedStorageDriver } from '../drivers/oci.driver.js';
+import { AzureStorageDriver, AzurePresignedStorageDriver } from '../drivers/azure.driver.js';
+const MAX_CACHED_DRIVERS = 100;
 /**
- * Factory class for creating storage drivers
+ * StorageDriverFactory - Creates and caches storage driver instances.
+ *
+ * Drivers are cached to avoid recreating connections for the same configuration.
+ * The cache is limited to 100 drivers to prevent memory issues in long-running apps.
+ *
+ * When the cache is full, the least recently used driver gets evicted.
  */
 export class StorageDriverFactory {
     /**
-     * Create and return a storage driver based on configuration
+     * Gets or creates a driver for the given configuration.
+     *
+     * If a driver for this exact configuration already exists, it's reused.
+     * Otherwise, a new driver is created and cached.
      */
     static createDriver(config) {
         const driverKey = this.getDriverKey(config);
-        // Return cached driver if exists
-        if (this.drivers.has(driverKey)) {
-            return this.drivers.get(driverKey);
+        const existing = this.drivers.get(driverKey);
+        if (existing) {
+            existing.lastAccess = Date.now();
+            return existing.driver;
+        }
+        if (this.drivers.size >= MAX_CACHED_DRIVERS) {
+            this.evictLRU();
         }
-        // Create new driver
         const driver = this.createNewDriver(config);
-        // Cache the driver
-        this.drivers.set(driverKey, driver);
+        this.drivers.set(driverKey, {
+            driver,
+            lastAccess: Date.now(),
+        });
         return driver;
     }
     /**
-     * Create a new driver instance
+     * Removes the oldest (least recently accessed) driver from the cache.
+     */
+    static evictLRU() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.drivers.entries()) {
+            if (entry.lastAccess < oldestTime) {
+                oldestTime = entry.lastAccess;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.drivers.delete(oldestKey);
+        }
+    }
+    /**
+     * Creates a new driver instance based on the config's driver type.
      */
     static createNewDriver(config) {
         switch (config.driver) {
             case 'local':
                 return new LocalStorageDriver(config);
             case 's3':
-                return this.createS3Driver(config);
+                return new S3StorageDriver(config);
             case 's3-presigned':
-                return this.createS3PresignedDriver(config);
+                return new S3PresignedStorageDriver(config);
             case 'gcs':
-                return this.createGCSDriver(config);
+                return new GCSStorageDriver(config);
             case 'gcs-presigned':
-                return this.createGCSPresignedDriver(config);
-            case 'oci':
-                return this.createOCIDriver(config);
-            case 'oci-presigned':
-                return this.createOCIPresignedDriver(config);
+                return new GCSPresignedStorageDriver(config);
+            case 'azure':
+                return new AzureStorageDriver(config);
+            case 'azure-presigned':
+                return new AzurePresignedStorageDriver(config);
             default:
                 throw new Error(`Unsupported storage driver: ${config.driver}`);
         }
     }
     /**
-     * Create S3 driver
-     */
-    static createS3Driver(config) {
-        return new S3StorageDriver(config);
-    }
-    /**
-     * Create S3 presigned driver
-     */
-    static createS3PresignedDriver(config) {
-        return new S3PresignedStorageDriver(config);
-    }
-    /**
-     * Create GCS driver
-     */
-    static createGCSDriver(config) {
-        return new GCSStorageDriver(config);
-    }
-    /**
-     * Create GCS presigned driver
+     * Creates a fingerprint of a string for cache key comparison.
+     * Uses triple hash approach (length + two FNV-1a hashes + checksum) for maximum collision resistance.
+     *
+     * The triple hash approach with length and checksum significantly reduces collision probability:
+     * - Single 32-bit hash: ~77k items for 50% collision probability
+     * - This approach: effectively ~128+ bits of entropy, negligible collision probability
+     *
+     * For credentials, we also include a prefix checksum to detect similar keys early.
      */
-    static createGCSPresignedDriver(config) {
-        return new GCSPresignedStorageDriver(config);
-    }
-    /**
-     * Create OCI driver
-     */
-    static createOCIDriver(config) {
-        return new OCIStorageDriver(config);
-    }
-    /**
-     * Create OCI presigned driver
-     */
-    static createOCIPresignedDriver(config) {
-        return new OCIPresignedStorageDriver(config);
+    static secureHash(str) {
+        if (!str)
+            return '0:0:0:0';
+        const length = str.length;
+        // First hash with standard FNV-1a offset basis
+        const FNV_OFFSET_BASIS_1 = 2166136261;
+        const FNV_PRIME = 16777619;
+        let hash1 = FNV_OFFSET_BASIS_1;
+        for (let i = 0; i < str.length; i++) {
+            hash1 ^= str.charCodeAt(i);
+            hash1 = Math.imul(hash1, FNV_PRIME);
+        }
+        // Second hash with different seed (XOR first hash into offset basis)
+        // This creates a completely different hash even for similar strings
+        const FNV_OFFSET_BASIS_2 = 0x811c9dc5 ^ (hash1 >>> 0);
+        let hash2 = FNV_OFFSET_BASIS_2;
+        for (let i = str.length - 1; i >= 0; i--) { // Reverse direction for different bit mixing
+            hash2 ^= str.charCodeAt(i);
+            hash2 = Math.imul(hash2, FNV_PRIME);
+        }
+        // Third component: simple additive checksum of character codes
+        // Provides additional collision resistance with minimal computation
+        let checksum = 0;
+        for (let i = 0; i < str.length; i++) {
+            checksum = (checksum + str.charCodeAt(i) * (i + 1)) >>> 0;
+        }
+        // Return length:hash1:hash2:checksum format - collision requires matching all four
+        return `${length}:${(hash1 >>> 0).toString(16)}:${(hash2 >>> 0).toString(16)}:${(checksum >>> 0).toString(16)}`;
     }
     /**
-     * Generate unique key for driver caching
+     * Generates a unique cache key for a configuration.
+     * Includes all properties that affect driver behavior.
      */
     static getDriverKey(config) {
-        return `${config.driver}_${config.bucketName || 'local'}_${config.localPath || 'default'}`;
+        const keyParts = [
+            config.driver,
+            config.bucketName || 'local',
+            config.localPath || 'default',
+            config.bucketPath || '',
+            (config.presignedUrlExpiry || 600).toString(),
+            (config.maxFileSize || 5368709120).toString(),
+            config.awsRegion || '',
+            this.secureHash(config.awsAccessKey || ''),
+            this.secureHash(config.awsSecretKey || ''),
+            config.gcsProjectId || '',
+            this.secureHash(config.gcsCredentials || ''),
+            config.azureAccountName || '',
+            config.azureContainerName || '',
+            this.secureHash(config.azureConnectionString || ''),
+            this.secureHash(config.azureAccountKey || ''),
+        ];
+        return keyParts.join('_');
     }
     /**
-     * Clear cached drivers
+     * Clears all cached drivers.
+     * Useful in tests or when you've rotated credentials.
      */
     static clearCache() {
         this.drivers.clear();
     }
     /**
-     * Get cached driver count
+     * Returns the number of cached drivers.
      */
-    static getCachedDriverCount() {
+    static getCacheSize() {
         return this.drivers.size;
     }
     /**
-     * Get available drivers
+     * Removes a specific driver from the cache.
+     * Useful when credentials have changed for a specific configuration.
+     */
+    static removeFromCache(config) {
+        const driverKey = this.getDriverKey(config);
+        return this.drivers.delete(driverKey);
+    }
+    /**
+     * Returns a list of all supported driver types.
      */
     static getAvailableDrivers() {
         return [
@@ -108,8 +168,8 @@ export class StorageDriverFactory {
             's3-presigned',
             'gcs',
             'gcs-presigned',
-            'oci',
-            'oci-presigned'
+            'azure',
+            'azure-presigned'
         ];
     }
 }

package/dist/factory/driver.factory.js.map

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

package/dist/index.d.ts

@@ -1,29 +1,30 @@
-import { StorageManager } from './storage-manager.js';
+/**
+ * Express Storage
+ *
+ * Unified file upload and storage management for Express.js.
+ * One API for local disk, AWS S3, Google Cloud Storage, and Azure Blob Storage.
+ *
+ * @example
+ * import { StorageManager } from 'express-storage';
+ *
+ * // Initialize (reads from environment variables)
+ * const storage = new StorageManager();
+ *
+ * // Upload a file
+ * const result = await storage.uploadFile(req.file);
+ *
+ * // Generate presigned URL for client-side upload
+ * const url = await storage.generateUploadUrl('photo.jpg', 'image/jpeg', 12345);
+ */
 export { StorageManager } from './storage-manager.js';
 export { StorageDriverFactory } from './factory/driver.factory.js';
-export type { StorageDriver, FileUploadResult, PresignedUrlResult, StorageConfig, FileInput, SingleFileInput, MultipleFilesInput, IStorageDriver, StorageRequest, ValidationResult, EnvironmentConfig } from './types/storage.types.js';
-export { loadAndValidateConfig, validateStorageConfig } from './utils/config.utils.js';
-export { generateUniqueFileName, sanitizeFileName, createMonthBasedPath, ensureDirectoryExists, formatFileSize, validateFileSize, validateFileType, createLocalFileUrl, getFileExtension, isImageFile, isDocumentFile } from './utils/file.utils.js';
+export type { StorageDriver, FileUploadResult, DeleteResult, PresignedUrlResult, StorageConfig, StorageOptions, StorageCredentials, FileValidationOptions, UploadOptions, FileMetadata, FileInput, SingleFileInput, MultipleFilesInput, IStorageDriver, ValidationResult, EnvironmentConfig, BlobValidationOptions, BlobValidationResult, ListFilesResult, FileInfo, Logger, RateLimitOptions } from './types/storage.types.js';
+export { loadAndValidateConfig, validateStorageConfig, initializeDotenv, resetDotenvInitialization } from './utils/config.utils.js';
+export { generateUniqueFileName, sanitizeFileName, validateFileName, createMonthBasedPath, ensureDirectoryExists, formatFileSize, validateFileSize, validateFileType, getFileExtension, isImageFile, isDocumentFile, withRetry, sleep, withConcurrencyLimit } from './utils/file.utils.js';
+export type { RetryOptions, ConcurrencyOptions } from './utils/file.utils.js';
 export { BaseStorageDriver } from './drivers/base.driver.js';
 export { LocalStorageDriver } from './drivers/local.driver.js';
 export { S3StorageDriver, S3PresignedStorageDriver } from './drivers/s3.driver.js';
 export { GCSStorageDriver, GCSPresignedStorageDriver } from './drivers/gcs.driver.js';
-export { OCIStorageDriver, OCIPresignedStorageDriver } from './drivers/oci.driver.js';
-/**
- * Get or create default storage manager instance
- */
-export declare function getStorageManager(): StorageManager;
-/**
- * Initialize default storage manager with custom config
- */
-export declare function initializeStorageManager(config?: any): StorageManager;
-/**
- * Convenience functions for quick usage
- */
-export declare function uploadFile(file: Express.Multer.File): Promise<import("./types/storage.types.js").FileUploadResult>;
-export declare function uploadFiles(files: Express.Multer.File[]): Promise<import("./types/storage.types.js").FileUploadResult[]>;
-export declare function generateUploadUrl(fileName: string): Promise<import("./types/storage.types.js").PresignedUrlResult>;
-export declare function generateViewUrl(fileName: string): Promise<import("./types/storage.types.js").PresignedUrlResult>;
-export declare function deleteFile(fileName: string): Promise<boolean>;
-export declare function deleteFiles(fileNames: string[]): Promise<boolean[]>;
+export { AzureStorageDriver, AzurePresignedStorageDriver } from './drivers/azure.driver.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAKtF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,cAAc,CAGrE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,gEAEzD;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,kEAE7D;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,kEAEvD;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,kEAErD;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,oBAEhD;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,sBAEpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,QAAQ,EACR,MAAM,EACN,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAGpI,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,SAAS,EACT,KAAK,EACL,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,53 +1,33 @@
-// Main exports
-import { StorageManager } from './storage-manager.js';
+/**
+ * Express Storage
+ *
+ * Unified file upload and storage management for Express.js.
+ * One API for local disk, AWS S3, Google Cloud Storage, and Azure Blob Storage.
+ *
+ * @example
+ * import { StorageManager } from 'express-storage';
+ *
+ * // Initialize (reads from environment variables)
+ * const storage = new StorageManager();
+ *
+ * // Upload a file
+ * const result = await storage.uploadFile(req.file);
+ *
+ * // Generate presigned URL for client-side upload
+ * const url = await storage.generateUploadUrl('photo.jpg', 'image/jpeg', 12345);
+ */
+// Main class
 export { StorageManager } from './storage-manager.js';
+// Factory
 export { StorageDriverFactory } from './factory/driver.factory.js';
-// Utility exports
-export { loadAndValidateConfig, validateStorageConfig } from './utils/config.utils.js';
-export { generateUniqueFileName, sanitizeFileName, createMonthBasedPath, ensureDirectoryExists, formatFileSize, validateFileSize, validateFileType, createLocalFileUrl, getFileExtension, isImageFile, isDocumentFile } from './utils/file.utils.js';
-// Driver exports
+// Configuration utilities
+export { loadAndValidateConfig, validateStorageConfig, initializeDotenv, resetDotenvInitialization } from './utils/config.utils.js';
+// File utilities
+export { generateUniqueFileName, sanitizeFileName, validateFileName, createMonthBasedPath, ensureDirectoryExists, formatFileSize, validateFileSize, validateFileType, getFileExtension, isImageFile, isDocumentFile, withRetry, sleep, withConcurrencyLimit } from './utils/file.utils.js';
+// Driver classes (for custom implementations or direct use)
 export { BaseStorageDriver } from './drivers/base.driver.js';
 export { LocalStorageDriver } from './drivers/local.driver.js';
 export { S3StorageDriver, S3PresignedStorageDriver } from './drivers/s3.driver.js';
 export { GCSStorageDriver, GCSPresignedStorageDriver } from './drivers/gcs.driver.js';
-export { OCIStorageDriver, OCIPresignedStorageDriver } from './drivers/oci.driver.js';
-// Default instance
-let defaultStorageManager = null;
-/**
- * Get or create default storage manager instance
- */
-export function getStorageManager() {
-    if (!defaultStorageManager) {
-        defaultStorageManager = new StorageManager();
-    }
-    return defaultStorageManager;
-}
-/**
- * Initialize default storage manager with custom config
- */
-export function initializeStorageManager(config) {
-    defaultStorageManager = StorageManager.initialize(config);
-    return defaultStorageManager;
-}
-/**
- * Convenience functions for quick usage
- */
-export async function uploadFile(file) {
-    return getStorageManager().uploadFile(file);
-}
-export async function uploadFiles(files) {
-    return getStorageManager().uploadFiles(files);
-}
-export async function generateUploadUrl(fileName) {
-    return getStorageManager().generateUploadUrl(fileName);
-}
-export async function generateViewUrl(fileName) {
-    return getStorageManager().generateViewUrl(fileName);
-}
-export async function deleteFile(fileName) {
-    return getStorageManager().deleteFile(fileName);
-}
-export async function deleteFiles(fileNames) {
-    return getStorageManager().deleteFiles(fileNames);
-}
+export { AzureStorageDriver, AzurePresignedStorageDriver } from './drivers/azure.driver.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAiBnE,kBAAkB;AAClB,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,mBAAmB;AACnB,IAAI,qBAAqB,GAA0B,IAAI,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,qBAAqB,GAAG,IAAI,cAAc,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAY;IACnD,qBAAqB,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAyB;IACxD,OAAO,iBAAiB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAA4B;IAC5D,OAAO,iBAAiB,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,OAAO,iBAAiB,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,OAAO,iBAAiB,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,OAAO,iBAAiB,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAmB;IACnD,OAAO,iBAAiB,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,UAAU;AACV,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA4BnE,0BAA0B;AAC1B,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpI,iBAAiB;AACjB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,SAAS,EACT,KAAK,EACL,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAG/B,4DAA4D;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC"}