express-storage 2.0.2 → 3.0.0

package/dist/drivers/s3.driver.js

@@ -1,387 +0,0 @@
-import { S3Client, PutObjectCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command } from '@aws-sdk/client-s3';
-import { Upload } from '@aws-sdk/lib-storage';
-import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
-import { BaseStorageDriver } from './base.driver.js';
-/**
- * S3StorageDriver - Handles file operations with Amazon S3.
- *
- * Supports two authentication methods:
- * 1. Explicit credentials (AWS_ACCESS_KEY + AWS_SECRET_KEY)
- * 2. IAM roles (when running on AWS infrastructure)
- *
- * If you don't provide credentials, the AWS SDK automatically uses
- * IAM roles, environment variables, or the shared credentials file.
- */
-export class S3StorageDriver extends BaseStorageDriver {
-    constructor(config) {
-        super(config);
-        this.bucketName = config.bucketName;
-        this.region = config.awsRegion;
-        const s3Options = {
-            region: this.region,
-        };
-        // Only set explicit credentials if provided — otherwise use IAM/default chain
-        if (config.awsAccessKey && config.awsSecretKey) {
-            s3Options.credentials = {
-                accessKeyId: config.awsAccessKey,
-                secretAccessKey: config.awsSecretKey,
-            };
-        }
-        this.s3Client = new S3Client(s3Options);
-    }
-    /**
-     * Uploads a file directly to S3.
-     * Handles both memory and disk storage from Multer.
-     *
-     * For large files (>100MB), uses streaming multipart upload to reduce
-     * memory usage and improve reliability.
-     */
-    async upload(file, options) {
-        try {
-            const validationErrors = this.validateFile(file);
-            if (validationErrors.length > 0) {
-                return this.createErrorResult(validationErrors.join(', '));
-            }
-            const fileName = this.generateFileName(file.originalname);
-            const fileKey = this.buildFilePath(fileName);
-            const fileSize = this.getFileSize(file);
-            // Use streaming upload for large files to reduce memory usage
-            if (this.shouldUseStreaming(file)) {
-                return this.uploadWithStream(file, fileKey, fileSize, options);
-            }
-            // Standard upload for smaller files
-            const fileContent = this.getFileContent(file);
-            const commandInput = {
-                Bucket: this.bucketName,
-                Key: fileKey,
-                Body: fileContent,
-                ContentType: options?.contentType || file.mimetype,
-                ContentLength: fileContent.length,
-            };
-            if (options?.cacheControl) {
-                commandInput.CacheControl = options.cacheControl;
-            }
-            if (options?.contentDisposition) {
-                commandInput.ContentDisposition = options.contentDisposition;
-            }
-            if (options?.metadata) {
-                commandInput.Metadata = options.metadata;
-            }
-            const uploadCommand = new PutObjectCommand(commandInput);
-            await this.s3Client.send(uploadCommand);
-            // Build the public URL with proper encoding
-            const encodedKey = fileKey.split('/').map(segment => encodeURIComponent(segment)).join('/');
-            const fileUrl = `https://${this.bucketName}.s3.${this.region}.amazonaws.com/${encodedKey}`;
-            return this.createSuccessResult(fileKey, fileUrl);
-        }
-        catch (error) {
-            return this.createErrorResult(error instanceof Error ? error.message : 'Failed to upload file to S3');
-        }
-    }
-    /**
-     * Uploads a large file using streaming multipart upload.
-     *
-     * This method uses the @aws-sdk/lib-storage Upload class which handles
-     * multipart uploads automatically. It's more memory-efficient for large
-     * files as it streams data in chunks rather than loading everything into memory.
-     */
-    async uploadWithStream(file, fileKey, fileSize, options) {
-        const fileStream = this.getFileStream(file);
-        const uploadParams = {
-            Bucket: this.bucketName,
-            Key: fileKey,
-            Body: fileStream,
-            ContentType: options?.contentType || file.mimetype,
-        };
-        // Include content length if known (helps with progress tracking)
-        if (fileSize > 0) {
-            uploadParams.ContentLength = fileSize;
-        }
-        if (options?.cacheControl) {
-            uploadParams.CacheControl = options.cacheControl;
-        }
-        if (options?.contentDisposition) {
-            uploadParams.ContentDisposition = options.contentDisposition;
-        }
-        if (options?.metadata) {
-            uploadParams.Metadata = options.metadata;
-        }
-        const upload = new Upload({
-            client: this.s3Client,
-            params: uploadParams,
-            // Use 10MB parts for multipart upload (minimum is 5MB)
-            partSize: 10 * 1024 * 1024,
-            // Upload up to 4 parts concurrently
-            queueSize: 4,
-        });
-        await upload.done();
-        // Build the public URL with proper encoding
-        const encodedKey = fileKey.split('/').map(segment => encodeURIComponent(segment)).join('/');
-        const fileUrl = `https://${this.bucketName}.s3.${this.region}.amazonaws.com/${encodedKey}`;
-        return this.createSuccessResult(fileKey, fileUrl);
-    }
-    /**
-     * Creates a presigned URL for uploading directly to S3.
-     *
-     * The URL enforces:
-     * - Exact content type (baked into the signature)
-     * - Exact file size (if provided)
-     *
-     * Clients that try to upload different content will get a 403.
-     */
-    async generateUploadUrl(fileName, contentType, fileSize) {
-        // Security: Defense-in-depth validation (StorageManager also validates)
-        // Decode URL-encoded characters first to catch encoded traversal attempts like %2e%2e%2f
-        let decodedFileName;
-        try {
-            decodedFileName = decodeURIComponent(fileName);
-        }
-        catch {
-            return this.createPresignedErrorResult('Invalid fileName: malformed URL encoding');
-        }
-        if (decodedFileName.includes('..') || decodedFileName.includes('\0')) {
-            return this.createPresignedErrorResult('Invalid fileName: path traversal sequences are not allowed');
-        }
-        try {
-            const resolvedContentType = contentType || 'application/octet-stream';
-            const commandInput = {
-                Bucket: this.bucketName,
-                Key: decodedFileName,
-                ContentType: resolvedContentType,
-            };
-            if (fileSize !== undefined) {
-                commandInput.ContentLength = fileSize;
-            }
-            const uploadCommand = new PutObjectCommand(commandInput);
-            const uploadUrl = await getSignedUrl(this.s3Client, uploadCommand, {
-                expiresIn: this.getPresignedUrlExpiry(),
-                signableHeaders: new Set(['content-type', 'content-length']),
-            });
-            return this.createPresignedSuccessResult(uploadUrl);
-        }
-        catch (error) {
-            return this.createPresignedErrorResult(error instanceof Error ? error.message : 'Failed to generate upload URL');
-        }
-    }
-    /**
-     * Creates a presigned URL for downloading/viewing a file.
-     */
-    async generateViewUrl(fileName) {
-        // Security: Defense-in-depth validation
-        // Decode URL-encoded characters first to catch encoded traversal attempts like %2e%2e%2f
-        let decodedFileName;
-        try {
-            decodedFileName = decodeURIComponent(fileName);
-        }
-        catch {
-            return this.createPresignedErrorResult('Invalid fileName: malformed URL encoding');
-        }
-        if (decodedFileName.includes('..') || decodedFileName.includes('\0')) {
-            return this.createPresignedErrorResult('Invalid fileName: path traversal sequences are not allowed');
-        }
-        try {
-            const getCommand = new GetObjectCommand({
-                Bucket: this.bucketName,
-                Key: decodedFileName,
-            });
-            const viewUrl = await getSignedUrl(this.s3Client, getCommand, {
-                expiresIn: this.getPresignedUrlExpiry(),
-            });
-            return this.createPresignedSuccessResult(undefined, viewUrl);
-        }
-        catch (error) {
-            return this.createPresignedErrorResult(error instanceof Error ? error.message : 'Failed to generate view URL');
-        }
-    }
-    /**
-     * Deletes a file from S3.
-     * Returns false if the file doesn't exist, throws on real errors.
-     */
-    async delete(fileName) {
-        // Security: Defense-in-depth validation
-        // Decode URL-encoded characters first to catch encoded traversal attempts like %2e%2e%2f
-        let decodedFileName;
-        try {
-            decodedFileName = decodeURIComponent(fileName);
-        }
-        catch {
-            return false;
-        }
-        if (decodedFileName.includes('..') || decodedFileName.includes('\0')) {
-            return false;
-        }
-        const headCommand = new HeadObjectCommand({
-            Bucket: this.bucketName,
-            Key: decodedFileName,
-        });
-        try {
-            await this.s3Client.send(headCommand);
-        }
-        catch (error) {
-            const errorName = error?.name;
-            const httpStatusCode = error?.$metadata?.httpStatusCode;
-            if (httpStatusCode === 404 || errorName === 'NotFound' || errorName === 'NoSuchKey') {
-                return false;
-            }
-            throw error;
-        }
-        const deleteCommand = new DeleteObjectCommand({
-            Bucket: this.bucketName,
-            Key: decodedFileName,
-        });
-        await this.s3Client.send(deleteCommand);
-        return true;
-    }
-    /**
-     * Confirms an upload and optionally validates the file.
-     *
-     * For S3, validation is optional since constraints are enforced at URL level.
-     * But you can still use this to verify the file matches expectations.
-     */
-    async validateAndConfirmUpload(reference, options) {
-        const deleteOnFailure = options?.deleteOnFailure !== false;
-        try {
-            const headCommand = new HeadObjectCommand({
-                Bucket: this.bucketName,
-                Key: reference,
-            });
-            const headResult = await this.s3Client.send(headCommand);
-            const actualContentType = headResult.ContentType;
-            const actualFileSize = headResult.ContentLength;
-            // Validate content type if expected
-            if (options?.expectedContentType && actualContentType !== options.expectedContentType) {
-                if (deleteOnFailure) {
-                    await this.delete(reference);
-                }
-                const errorResult = {
-                    success: false,
-                    error: `Content type mismatch: expected '${options.expectedContentType}', got '${actualContentType}'${deleteOnFailure ? ' (file deleted)' : ' (file kept for inspection)'}`,
-                };
-                if (actualContentType)
-                    errorResult.actualContentType = actualContentType;
-                if (actualFileSize !== undefined)
-                    errorResult.actualFileSize = actualFileSize;
-                return errorResult;
-            }
-            // Validate file size if expected
-            if (options?.expectedFileSize !== undefined && actualFileSize !== options.expectedFileSize) {
-                if (deleteOnFailure) {
-                    await this.delete(reference);
-                }
-                const errorResult = {
-                    success: false,
-                    error: `File size mismatch: expected ${options.expectedFileSize} bytes, got ${actualFileSize} bytes${deleteOnFailure ? ' (file deleted)' : ' (file kept for inspection)'}`,
-                };
-                if (actualContentType)
-                    errorResult.actualContentType = actualContentType;
-                if (actualFileSize !== undefined)
-                    errorResult.actualFileSize = actualFileSize;
-                return errorResult;
-            }
-            const viewResult = await this.generateViewUrl(reference);
-            const result = {
-                success: true,
-                reference,
-                expiresIn: this.getPresignedUrlExpiry(),
-            };
-            if (viewResult.viewUrl) {
-                result.viewUrl = viewResult.viewUrl;
-            }
-            if (actualContentType) {
-                result.actualContentType = actualContentType;
-            }
-            if (actualFileSize !== undefined) {
-                result.actualFileSize = actualFileSize;
-            }
-            return result;
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : 'File not found or access denied';
-            return {
-                success: false,
-                error: errorMessage,
-            };
-        }
-    }
-    /**
-     * Lists files in the bucket with optional prefix filtering and pagination.
-     *
-     * Note: S3's list API doesn't return content types. Use validateAndConfirmUpload()
-     * if you need content type information for specific files.
-     */
-    async listFiles(prefix, maxResults = 1000, continuationToken) {
-        try {
-            const validatedMaxResults = Math.floor(Math.max(1, Math.min(Number.isNaN(maxResults) ? 1000 : maxResults, 1000)));
-            const command = new ListObjectsV2Command({
-                Bucket: this.bucketName,
-                Prefix: prefix || undefined,
-                MaxKeys: validatedMaxResults,
-                ContinuationToken: continuationToken || undefined,
-            });
-            const response = await this.s3Client.send(command);
-            const files = (response.Contents || []).map(item => {
-                const fileInfo = { name: item.Key || '' };
-                if (item.Size !== undefined)
-                    fileInfo.size = item.Size;
-                if (item.LastModified)
-                    fileInfo.lastModified = item.LastModified;
-                return fileInfo;
-            });
-            const result = {
-                success: true,
-                files,
-            };
-            if (response.NextContinuationToken) {
-                result.nextToken = response.NextContinuationToken;
-            }
-            return result;
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: error instanceof Error ? error.message : 'Failed to list files',
-            };
-        }
-    }
-}
-/**
- * S3PresignedStorageDriver - S3 driver that returns presigned URLs from upload().
- *
- * Use this when you want clients to upload directly to S3 without
- * the file passing through your server.
- */
-export class S3PresignedStorageDriver extends S3StorageDriver {
-    constructor(config) {
-        super(config);
-    }
-    /**
-     * Instead of uploading the file, returns a presigned URL for the client to use.
-     *
-     * The returned fileUrl is the presigned upload URL.
-     * After the client uploads, use validateAndConfirmUpload() to get a view URL.
-     *
-     * Note: The `options` parameter (metadata, cacheControl, etc.) is NOT applied
-     * when using presigned uploads. These options must be set by the client when
-     * making the actual upload request to S3, or configured via bucket policies.
-     * For server-side uploads with full options support, use the regular 's3' driver.
-     */
-    async upload(file, _options) {
-        try {
-            const validationErrors = this.validateFile(file);
-            if (validationErrors.length > 0) {
-                return this.createErrorResult(validationErrors.join(', '));
-            }
-            const fileName = this.generateFileName(file.originalname);
-            const filePath = this.buildFilePath(fileName);
-            const presignedResult = await this.generateUploadUrl(filePath, file.mimetype, file.size);
-            if (!presignedResult.success) {
-                return this.createErrorResult(presignedResult.error || 'Failed to generate presigned URL');
-            }
-            return this.createSuccessResult(filePath, presignedResult.uploadUrl);
-        }
-        catch (error) {
-            return this.createErrorResult(error instanceof Error ? error.message : 'Failed to generate presigned URL');
-        }
-    }
-}
-//# sourceMappingURL=s3.driver.js.map

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

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

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

@@ -1,62 +0,0 @@
-import { StorageConfig, IStorageDriver } from '../types/storage.types.js';
-/**
- * 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;
-    /**
-     * 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;
-    /**
-     * Returns a list of all supported driver types.
-     */
-    static getAvailableDrivers(): string[];
-}
-//# sourceMappingURL=driver.factory.d.ts.map

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

@@ -1 +0,0 @@
-{"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,177 +0,0 @@
-import { LocalStorageDriver } from '../drivers/local.driver.js';
-import { S3StorageDriver, S3PresignedStorageDriver } from '../drivers/s3.driver.js';
-import { GCSStorageDriver, GCSPresignedStorageDriver } from '../drivers/gcs.driver.js';
-import { AzureStorageDriver, AzurePresignedStorageDriver } from '../drivers/azure.driver.js';
-const MAX_CACHED_DRIVERS = 100;
-/**
- * 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 {
-    /**
-     * 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);
-        }
-    }
-    /**
-     * 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 new S3StorageDriver(config);
-            case 's3-presigned':
-                return new S3PresignedStorageDriver(config);
-            case 'gcs':
-                return new GCSStorageDriver(config);
-            case 'gcs-presigned':
-                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}`);
-        }
-    }
-    /**
-     * 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 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)}`;
-    }
-    /**
-     * 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() {
-        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'
-        ];
-    }
-}
-StorageDriverFactory.drivers = new Map();
-//# sourceMappingURL=driver.factory.js.map

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

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