express-storage 2.0.3 → 3.0.0

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

@@ -1,62 +1,43 @@
 import { StorageConfig, IStorageDriver } from '../types/storage.types.js';
 /**
- * StorageDriverFactory - Creates and caches storage driver instances.
+ * Creates a driver instance for the given configuration (no caching).
  *
- * 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.
+ * Presigned variants (e.g., 's3-presigned') map to the same driver class
+ * as their direct counterparts — the base class detects presigned mode
+ * from the driver string and adjusts upload() behavior accordingly.
+ */
+export declare function createDriver(config: StorageConfig): IStorageDriver;
+/**
+ * Returns a list of all supported driver type strings.
+ */
+export declare function getAvailableDrivers(): string[];
+/**
+ * StorageDriverFactory - Simple driver cache for reusing SDK client connections.
+ *
+ * Each instance maintains its own private Map of driver instances keyed by
+ * a SHA-256 hash of the config. Use this when you want multiple components
+ * to share the same driver instance for a given configuration.
+ *
+ * StorageManager does NOT use this — each manager creates its own driver
+ * via `createDriver()`, ensuring full isolation. The factory exists for
+ * advanced use cases like multi-tenant driver pools.
  *
- * When the cache is full, the least recently used driver gets evicted.
+ * @example
+ * const factory = new StorageDriverFactory();
+ * const driver1 = factory.getOrCreate(config); // creates new
+ * const driver2 = factory.getOrCreate(config); // returns cached
  */
 export declare class StorageDriverFactory {
-    private static drivers;
-    /**
-     * 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;
-    /**
-     * Removes the oldest (least recently accessed) driver from the cache.
-     */
-    private static evictLRU;
-    /**
-     * Creates a new driver instance based on the config's driver type.
-     */
-    private static createNewDriver;
-    /**
-     * 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 secureHash;
-    /**
-     * Generates a unique cache key for a configuration.
-     * Includes all properties that affect driver behavior.
-     */
-    private static getDriverKey;
-    /**
-     * Clears all cached drivers.
-     * Useful in tests or when you've rotated credentials.
-     */
-    static clearCache(): void;
-    /**
-     * 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 removeFromCache(config: StorageConfig): boolean;
+    private readonly drivers;
+    private hashConfig;
+    getOrCreate(config: StorageConfig): IStorageDriver;
     /**
-     * Returns a list of all supported driver types.
+     * Destroys all cached drivers and clears the cache.
+     * Always call this instead of letting the factory be garbage-collected,
+     * otherwise cloud SDK connections may leak.
      */
+    clearCache(): void;
+    getCacheSize(): number;
     static getAvailableDrivers(): string[];
 }
 //# sourceMappingURL=driver.factory.d.ts.map

package/dist/cjs/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;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"}
+{"version":3,"file":"driver.factory.d.ts","sourceRoot":"","sources":["../../../src/factory/driver.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAM1E;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAgBlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAU9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,OAAO,CAAC,UAAU;IAIlB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc;IAWlD;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAOlB,YAAY,IAAI,MAAM;IAItB,MAAM,CAAC,mBAAmB,IAAI,MAAM,EAAE;CAGvC"}

package/dist/cjs/factory/driver.factory.js

@@ -1,181 +1,101 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StorageDriverFactory = void 0;
+exports.createDriver = createDriver;
+exports.getAvailableDrivers = getAvailableDrivers;
+const crypto_1 = __importDefault(require("crypto"));
 const local_driver_js_1 = require("../drivers/local.driver.js");
 const s3_driver_js_1 = require("../drivers/s3.driver.js");
 const gcs_driver_js_1 = require("../drivers/gcs.driver.js");
 const azure_driver_js_1 = require("../drivers/azure.driver.js");
-const MAX_CACHED_DRIVERS = 100;
 /**
- * StorageDriverFactory - Creates and caches storage driver instances.
+ * Creates a driver instance for the given configuration (no caching).
  *
- * 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.
+ * Presigned variants (e.g., 's3-presigned') map to the same driver class
+ * as their direct counterparts — the base class detects presigned mode
+ * from the driver string and adjusts upload() behavior accordingly.
+ */
+function createDriver(config) {
+    switch (config.driver) {
+        case 'local':
+            return new local_driver_js_1.LocalStorageDriver(config);
+        case 's3':
+        case 's3-presigned':
+            return new s3_driver_js_1.S3StorageDriver(config);
+        case 'gcs':
+        case 'gcs-presigned':
+            return new gcs_driver_js_1.GCSStorageDriver(config);
+        case 'azure':
+        case 'azure-presigned':
+            return new azure_driver_js_1.AzureStorageDriver(config);
+        default:
+            throw new Error(`Unsupported storage driver: ${config.driver}`);
+    }
+}
+/**
+ * Returns a list of all supported driver type strings.
+ */
+function getAvailableDrivers() {
+    return [
+        'local',
+        's3',
+        's3-presigned',
+        'gcs',
+        'gcs-presigned',
+        'azure',
+        'azure-presigned'
+    ];
+}
+/**
+ * StorageDriverFactory - Simple driver cache for reusing SDK client connections.
+ *
+ * Each instance maintains its own private Map of driver instances keyed by
+ * a SHA-256 hash of the config. Use this when you want multiple components
+ * to share the same driver instance for a given configuration.
  *
- * When the cache is full, the least recently used driver gets evicted.
+ * StorageManager does NOT use this — each manager creates its own driver
+ * via `createDriver()`, ensuring full isolation. The factory exists for
+ * advanced use cases like multi-tenant driver pools.
+ *
+ * @example
+ * const factory = new StorageDriverFactory();
+ * const driver1 = factory.getOrCreate(config); // creates new
+ * const driver2 = factory.getOrCreate(config); // returns cached
  */
 class StorageDriverFactory {
-    /**
-     * 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);
-        const existing = this.drivers.get(driverKey);
-        if (existing) {
-            existing.lastAccess = Date.now();
-            return existing.driver;
-        }
-        if (this.drivers.size >= MAX_CACHED_DRIVERS) {
-            this.evictLRU();
-        }
-        const driver = this.createNewDriver(config);
-        this.drivers.set(driverKey, {
-            driver,
-            lastAccess: Date.now(),
-        });
-        return driver;
-    }
-    /**
-     * 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);
-        }
+    drivers = new Map();
+    hashConfig(config) {
+        return crypto_1.default.createHash('sha256').update(JSON.stringify(config)).digest('hex');
     }
-    /**
-     * Creates a new driver instance based on the config's driver type.
-     */
-    static createNewDriver(config) {
-        switch (config.driver) {
-            case 'local':
-                return new local_driver_js_1.LocalStorageDriver(config);
-            case 's3':
-                return new s3_driver_js_1.S3StorageDriver(config);
-            case 's3-presigned':
-                return new s3_driver_js_1.S3PresignedStorageDriver(config);
-            case 'gcs':
-                return new gcs_driver_js_1.GCSStorageDriver(config);
-            case 'gcs-presigned':
-                return new gcs_driver_js_1.GCSPresignedStorageDriver(config);
-            case 'azure':
-                return new azure_driver_js_1.AzureStorageDriver(config);
-            case 'azure-presigned':
-                return new azure_driver_js_1.AzurePresignedStorageDriver(config);
-            default:
-                throw new Error(`Unsupported storage driver: ${config.driver}`);
-        }
+    getOrCreate(config) {
+        const key = this.hashConfig(config);
+        const existing = this.drivers.get(key);
+        if (existing)
+            return existing;
+        const driver = createDriver(config);
+        this.drivers.set(key, driver);
+        return 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.
+     * Destroys all cached drivers and clears the cache.
+     * Always call this instead of letting the factory be garbage-collected,
+     * otherwise cloud SDK connections may leak.
      */
-    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);
+    clearCache() {
+        for (const driver of this.drivers.values()) {
+            driver.destroy();
         }
-        // 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)}`;
-    }
-    /**
-     * Generates a unique cache key for a configuration.
-     * Includes all properties that affect driver behavior.
-     */
-    static getDriverKey(config) {
-        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('_');
-    }
-    /**
-     * Clears all cached drivers.
-     * Useful in tests or when you've rotated credentials.
-     */
-    static clearCache() {
         this.drivers.clear();
     }
-    /**
-     * Returns the number of cached drivers.
-     */
-    static getCacheSize() {
+    getCacheSize() {
         return this.drivers.size;
     }
-    /**
-     * 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 [
-            'local',
-            's3',
-            's3-presigned',
-            'gcs',
-            'gcs-presigned',
-            'azure',
-            'azure-presigned'
-        ];
+        return getAvailableDrivers();
     }
 }
 exports.StorageDriverFactory = StorageDriverFactory;
-StorageDriverFactory.drivers = new Map();
 //# sourceMappingURL=driver.factory.js.map

package/dist/cjs/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":";;;;;;AAcA,oCAgBC;AAKD,kDAUC;AA7CD,oDAA4B;AAE5B,gEAAgE;AAChE,0DAA0D;AAC1D,4DAA4D;AAC5D,gEAAgE;AAEhE;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,MAAqB;IAChD,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,OAAO;YACV,OAAO,IAAI,oCAAkB,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,IAAI,CAAC;QACV,KAAK,cAAc;YACjB,OAAO,IAAI,8BAAe,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,KAAK,CAAC;QACX,KAAK,eAAe;YAClB,OAAO,IAAI,gCAAgB,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,OAAO,CAAC;QACb,KAAK,iBAAiB;YACpB,OAAO,IAAI,oCAAkB,CAAC,MAAM,CAAC,CAAC;QACxC;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO;QACL,OAAO;QACP,IAAI;QACJ,cAAc;QACd,KAAK;QACL,eAAe;QACf,OAAO;QACP,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAa,oBAAoB;IACd,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IAE1D,UAAU,CAAC,MAAqB;QACtC,OAAO,gBAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC;IAED,WAAW,CAAC,MAAqB;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,mBAAmB;QACxB,OAAO,mBAAmB,EAAE,CAAC;IAC/B,CAAC;CACF;AArCD,oDAqCC"}

package/dist/cjs/index.d.ts

@@ -7,24 +7,20 @@
  * @example
  * import { StorageManager } from 'express-storage';
  *
- * // Initialize (reads from environment variables)
- * const storage = new StorageManager();
- *
- * // Upload a file
+ * const storage = new StorageManager({ driver: 'local' });
  * const result = await storage.uploadFile(req.file);
  *
- * // Generate presigned URL for client-side upload
- * const url = await storage.generateUploadUrl('photo.jpg', 'image/jpeg', 12345);
+ * if (result.success) {
+ *   console.log(result.reference); // stored file path
+ * }
+ *
+ * // Advanced imports:
+ * // import { withRetry, formatFileSize } from 'express-storage/utils';
+ * // import { BaseStorageDriver } from 'express-storage/drivers';
+ * // import { validateStorageConfig } from 'express-storage/config';
  */
 export { StorageManager } from './storage-manager.js';
-export { StorageDriverFactory } from './factory/driver.factory.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 { InMemoryRateLimiter } from './utils/rate-limiter.js';
+export type { StorageDriver, StorageErrorCode, FileUploadResult, FileUploadSuccess, FileUploadError, DeleteResult, DeleteSuccess, DeleteError, PresignedUrlResult, PresignedUrlSuccess, PresignedUrlError, PresignedUploadUrlResult, PresignedUploadUrlSuccess, PresignedViewUrlResult, PresignedViewUrlSuccess, BlobValidationResult, BlobValidationSuccess, BlobValidationError, ListFilesResult, ListFilesSuccess, ListFilesError, StorageConfig, PublicStorageConfig, StorageOptions, StorageCredentials, FileValidationOptions, UploadOptions, FileMetadata, IStorageDriver, ValidationResult, EnvironmentConfig, BlobValidationOptions, FileInfo, Logger, RateLimitOptions, RateLimiterAdapter, StorageHooks, HookErrorContext, BatchOptions, } from './types/storage.types.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 { AzureStorageDriver, AzurePresignedStorageDriver } from './drivers/azure.driver.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cjs/index.js

@@ -8,57 +8,24 @@
  * @example
  * import { StorageManager } from 'express-storage';
  *
- * // Initialize (reads from environment variables)
- * const storage = new StorageManager();
- *
- * // Upload a file
+ * const storage = new StorageManager({ driver: 'local' });
  * const result = await storage.uploadFile(req.file);
  *
- * // Generate presigned URL for client-side upload
- * const url = await storage.generateUploadUrl('photo.jpg', 'image/jpeg', 12345);
+ * if (result.success) {
+ *   console.log(result.reference); // stored file path
+ * }
+ *
+ * // Advanced imports:
+ * // import { withRetry, formatFileSize } from 'express-storage/utils';
+ * // import { BaseStorageDriver } from 'express-storage/drivers';
+ * // import { validateStorageConfig } from 'express-storage/config';
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AzurePresignedStorageDriver = exports.AzureStorageDriver = exports.GCSPresignedStorageDriver = exports.GCSStorageDriver = exports.S3PresignedStorageDriver = exports.S3StorageDriver = exports.LocalStorageDriver = exports.BaseStorageDriver = exports.withConcurrencyLimit = exports.sleep = exports.withRetry = exports.isDocumentFile = exports.isImageFile = exports.getFileExtension = exports.validateFileType = exports.validateFileSize = exports.formatFileSize = exports.ensureDirectoryExists = exports.createMonthBasedPath = exports.validateFileName = exports.sanitizeFileName = exports.generateUniqueFileName = exports.resetDotenvInitialization = exports.initializeDotenv = exports.validateStorageConfig = exports.loadAndValidateConfig = exports.StorageDriverFactory = exports.StorageManager = void 0;
-// Main class
+exports.InMemoryRateLimiter = exports.StorageManager = void 0;
+// Core class
 var storage_manager_js_1 = require("./storage-manager.js");
 Object.defineProperty(exports, "StorageManager", { enumerable: true, get: function () { return storage_manager_js_1.StorageManager; } });
-// Factory
-var driver_factory_js_1 = require("./factory/driver.factory.js");
-Object.defineProperty(exports, "StorageDriverFactory", { enumerable: true, get: function () { return driver_factory_js_1.StorageDriverFactory; } });
-// Configuration utilities
-var config_utils_js_1 = require("./utils/config.utils.js");
-Object.defineProperty(exports, "loadAndValidateConfig", { enumerable: true, get: function () { return config_utils_js_1.loadAndValidateConfig; } });
-Object.defineProperty(exports, "validateStorageConfig", { enumerable: true, get: function () { return config_utils_js_1.validateStorageConfig; } });
-Object.defineProperty(exports, "initializeDotenv", { enumerable: true, get: function () { return config_utils_js_1.initializeDotenv; } });
-Object.defineProperty(exports, "resetDotenvInitialization", { enumerable: true, get: function () { return config_utils_js_1.resetDotenvInitialization; } });
-// File utilities
-var file_utils_js_1 = require("./utils/file.utils.js");
-Object.defineProperty(exports, "generateUniqueFileName", { enumerable: true, get: function () { return file_utils_js_1.generateUniqueFileName; } });
-Object.defineProperty(exports, "sanitizeFileName", { enumerable: true, get: function () { return file_utils_js_1.sanitizeFileName; } });
-Object.defineProperty(exports, "validateFileName", { enumerable: true, get: function () { return file_utils_js_1.validateFileName; } });
-Object.defineProperty(exports, "createMonthBasedPath", { enumerable: true, get: function () { return file_utils_js_1.createMonthBasedPath; } });
-Object.defineProperty(exports, "ensureDirectoryExists", { enumerable: true, get: function () { return file_utils_js_1.ensureDirectoryExists; } });
-Object.defineProperty(exports, "formatFileSize", { enumerable: true, get: function () { return file_utils_js_1.formatFileSize; } });
-Object.defineProperty(exports, "validateFileSize", { enumerable: true, get: function () { return file_utils_js_1.validateFileSize; } });
-Object.defineProperty(exports, "validateFileType", { enumerable: true, get: function () { return file_utils_js_1.validateFileType; } });
-Object.defineProperty(exports, "getFileExtension", { enumerable: true, get: function () { return file_utils_js_1.getFileExtension; } });
-Object.defineProperty(exports, "isImageFile", { enumerable: true, get: function () { return file_utils_js_1.isImageFile; } });
-Object.defineProperty(exports, "isDocumentFile", { enumerable: true, get: function () { return file_utils_js_1.isDocumentFile; } });
-Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return file_utils_js_1.withRetry; } });
-Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return file_utils_js_1.sleep; } });
-Object.defineProperty(exports, "withConcurrencyLimit", { enumerable: true, get: function () { return file_utils_js_1.withConcurrencyLimit; } });
-// Driver classes (for custom implementations or direct use)
-var base_driver_js_1 = require("./drivers/base.driver.js");
-Object.defineProperty(exports, "BaseStorageDriver", { enumerable: true, get: function () { return base_driver_js_1.BaseStorageDriver; } });
-var local_driver_js_1 = require("./drivers/local.driver.js");
-Object.defineProperty(exports, "LocalStorageDriver", { enumerable: true, get: function () { return local_driver_js_1.LocalStorageDriver; } });
-var s3_driver_js_1 = require("./drivers/s3.driver.js");
-Object.defineProperty(exports, "S3StorageDriver", { enumerable: true, get: function () { return s3_driver_js_1.S3StorageDriver; } });
-Object.defineProperty(exports, "S3PresignedStorageDriver", { enumerable: true, get: function () { return s3_driver_js_1.S3PresignedStorageDriver; } });
-var gcs_driver_js_1 = require("./drivers/gcs.driver.js");
-Object.defineProperty(exports, "GCSStorageDriver", { enumerable: true, get: function () { return gcs_driver_js_1.GCSStorageDriver; } });
-Object.defineProperty(exports, "GCSPresignedStorageDriver", { enumerable: true, get: function () { return gcs_driver_js_1.GCSPresignedStorageDriver; } });
-var azure_driver_js_1 = require("./drivers/azure.driver.js");
-Object.defineProperty(exports, "AzureStorageDriver", { enumerable: true, get: function () { return azure_driver_js_1.AzureStorageDriver; } });
-Object.defineProperty(exports, "AzurePresignedStorageDriver", { enumerable: true, get: function () { return azure_driver_js_1.AzurePresignedStorageDriver; } });
+// Rate limiter (needed for StorageOptions.rateLimiter)
+var rate_limiter_js_1 = require("./utils/rate-limiter.js");
+Object.defineProperty(exports, "InMemoryRateLimiter", { enumerable: true, get: function () { return rate_limiter_js_1.InMemoryRateLimiter; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,aAAa;AACb,2DAAsD;AAA7C,oHAAA,cAAc,OAAA;AAEvB,UAAU;AACV,iEAAmE;AAA1D,yHAAA,oBAAoB,OAAA;AA4B7B,0BAA0B;AAC1B,2DAAoI;AAA3H,wHAAA,qBAAqB,OAAA;AAAE,wHAAA,qBAAqB,OAAA;AAAE,mHAAA,gBAAgB,OAAA;AAAE,4HAAA,yBAAyB,OAAA;AAElG,iBAAiB;AACjB,uDAe+B;AAd7B,uHAAA,sBAAsB,OAAA;AACtB,iHAAA,gBAAgB,OAAA;AAChB,iHAAA,gBAAgB,OAAA;AAChB,qHAAA,oBAAoB,OAAA;AACpB,sHAAA,qBAAqB,OAAA;AACrB,+GAAA,cAAc,OAAA;AACd,iHAAA,gBAAgB,OAAA;AAChB,iHAAA,gBAAgB,OAAA;AAChB,iHAAA,gBAAgB,OAAA;AAChB,4GAAA,WAAW,OAAA;AACX,+GAAA,cAAc,OAAA;AACd,0GAAA,SAAS,OAAA;AACT,sGAAA,KAAK,OAAA;AACL,qHAAA,oBAAoB,OAAA;AAItB,4DAA4D;AAC5D,2DAA6D;AAApD,mHAAA,iBAAiB,OAAA;AAC1B,6DAA+D;AAAtD,qHAAA,kBAAkB,OAAA;AAC3B,uDAAmF;AAA1E,+GAAA,eAAe,OAAA;AAAE,wHAAA,wBAAwB,OAAA;AAClD,yDAAsF;AAA7E,iHAAA,gBAAgB,OAAA;AAAE,0HAAA,yBAAyB,OAAA;AACpD,6DAA4F;AAAnF,qHAAA,kBAAkB,OAAA;AAAE,8HAAA,2BAA2B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,aAAa;AACb,2DAAsD;AAA7C,oHAAA,cAAc,OAAA;AAEvB,uDAAuD;AACvD,2DAA8D;AAArD,sHAAA,mBAAmB,OAAA"}